Floating licenses: Install, deploy, and configure the oXygen License Servlet
Floating licenses are configured by installing and deploying a servlet that handles the oXygen licenses.
To install the oXygen License Servlet:
Download the oXygen License Servlet from the following oXygen website:
Note: For more information about running oXygen with floating licenses, see http://www.oxygenxml.com/license_server.html.
Copy the oxygenLicenseServlet.war file to the following directory:
%TomcatDir%\webappsWhere %TomcatDir% is the location where you installed Tomcat. For example:
C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps (Windows) /opt/tomcat6/webapps (Linux)Tomcat will deploy it automatically and the webapps directory now contains the oxygenLicenseServlet directory.Note: If the application does not get deployed after a few minutes, restart the Tomcat service.
Copy the floating license file (license.txt) provided by
oXygen to the following directory:
%TomcatDir%/webapps/oxygenLicenseServlet/WEB-INF/licenseNote: The actual path may vary according to your deployment.
To configure the required security roles for the license, open the following file
in an XML editor:
%TomcatDir%/conf/tomcat-users.xmlNote: The actual path may vary according to your deployment.
Add the following line to the file, in the <tomcat-users>
<user username="license" password="license" roles="standard,manager"/>For example:
<tomcat-users> <user username="license" password="license" roles="standard,manager"/> </tomcat-users>
- Restart the Tomcat service.
To test your installation, enter the following URL in a web browser:
http://<tomcatserver:port>/oxygenLicenseServlet/Where <tomcatserver> is the address of the Tomcat server. For example:
The <oXygen/> XML License Server page is displayed:
Click here, enter the username and password set in the
tomcat-users.xml file (for example, license,
license), and click Login.
The <oXygen/> XML Floating License Server page is displayed, indicating that the servlet was installed correctly.