Page 1 of 1

Licensing Webhelp for command line only

Posted: Fri Feb 07, 2014 9:03 am
by euca_scottb
Hi - having trouble figuring out how to get the license activated for Oxygen webhelp. This will be used exclusively from a command line - I'm setting it up on my Mac initially for testing, but after that it will move to a server running CentOS.

I’ve copied the com.oxygenxml.webhelp directory from the Oxygen web help ZIP file to the content/tools/DITA-OT/plugins directory on my Macbook and am working on getting it integrated into our doc build…but am running into this error:

Code: Select all

check-license:

BUILD FAILED
/Users/scottb/Documents/git/documentation/content/en_us/build.xml:19: The following error occurred while executing this line:
/Users/scottb/Documents/git/documentation/content/en_us/admin-guide/build.xml:49: The following error occurred while executing this line:
/Users/scottb/Documents/git/documentation/tools/DITA-OT/build.xml:44: The following error occurred while executing this line:
/Users/scottb/Documents/git/documentation/tools/DITA-OT/plugins/com.oxygenxml.webhelp/build_common.xml:141: The Webhelp plugin does not contain all jar files. Please contact support@oxygenxml.com for more details.

Total time: 1 second
ScottBMacBook:en_us scottb$
Please help.

Thanks,
ScottB

Re: Licensing Webhelp for command line only

Posted: Fri Feb 07, 2014 1:07 pm
by sorin_ristache
Hello Scott,

Please place your Webhelp license key in a file called licensekey.txt and place this file in directory [DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp. This is specified in the README file in the Webhelp zip distribution which you downloaded from the Oxygen website.

The error message The Webhelp plugin does not contain all jar files is caused by a missing jar in the lib subdirectory of the above directory ([DITA-OT-install-dir]/plugins/com.oxygenxml.webhelp/lib). If you copied the entire content of the Webhelp zip archive in the [DITA-OT-install-dir]/plugins directory all the requisite files should be there. Particularly please check if the files license.jar and log4j.jar are in the lib subdirectory of com.oxygenxml.webhelp. For example can you open and browse these jar files with a zip archive application (WinZip, 7-Zip, WinRAR, etc)?


Regards,
Sorin

Re: Licensing Webhelp for command line only

Posted: Fri Feb 07, 2014 2:40 pm
by euca_scottb
That worked. Thanks Sorin!

Re: Licensing Webhelp for command line only

Posted: Wed Feb 26, 2014 3:18 am
by scotmarvin
This solution didn't work for me. I have the license in the right place, and the jar files are there. Is there a canonical documentation of everything we need to do in order to incorporate this into our existing ANT build system? Because, this plugin isn't working so easily for me after I integrated it.

Re: Licensing Webhelp for command line only

Posted: Wed Feb 26, 2014 11:33 am
by sorin_ristache
There is canonical documentation: a README text file in the Webhelp zip distribution that explains how the license key must be registered and how the Webhelp plugin should be integrated in an external process. What license do you have? Can you send us your license key or email it to us so we can test it?


Regards,
Sorin

Re: Licensing Webhelp for command line only

Posted: Thu Feb 27, 2014 3:23 am
by scotmarvin
I sent the license file from my email. Oddly enough, I was able to successfully build after editing the shell script. So, shell script built, but ANT did not. Weird.

Re: Licensing Webhelp for command line only

Posted: Thu Feb 27, 2014 11:22 am
by sorin_ristache
We need more details about the errors that you get in the ANT process. I asked about these details by email.


Regards,
Sorin