Setting up the floating license servlet.
Apache Tomcat 5.5 or higher is necessary. You can get it from:
Download the license servlet Web ARchive (.war)
from one of the download URLs included in the registration email message.
Go to the Tomcat Web Application Manager page. In the WAR file to
deploy section choose the WAR file and then press the
Deploy button. The oXygen License
Servlet should be up and running, but there is no licensing
To set the license key, log on the deployment machine, and go to the Tomcat
installation folder (usually /usr/local/tomcat). Then go to
the webapps/oXygenLicenseServlet/WEB-INF/license/ folder
and create a new file called license.txt. Copy the license
text that was sent to you via e-mail into this file and save it.
It is recommended to password protect your pages using a Tomcat Realm. Please
refer to the Tomcat Documentation for detailed info, like the Realm Configuration HOW-TO - Memory Based
Once you have defined a realm resource, you have to edit
webapps/oXygenLicenseServlet/WEB-INF/web.xml file to
configure user access rights on the license server. Note that Tomcat's standard
security roles are used, i.e.: standard for licensing and admin or
manager for the license usage report page.
By default, the license server is logging its activity in
To change the log file location, edit the
log4j.appender.R2.File property from the
Restart oXygen License Servlet from the Tomcat Web Application
Contact the Oxygen XML Editor plugin
support staff at email@example.com
and ask for a new license key if:
- you have multiple license keys for the same Oxygen XML Editor plugin version and you want to have all of them managed by the same server;
- you have a multiple-user floating license and you want to split it between
two or more license servers.