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:

  1. Download the oXygen License Servlet from the following oXygen website:
  2. Copy the oxygenLicenseServlet.war file to the following directory:
    %TomcatDir%\webapps
    Where %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.
  3. Copy the floating license file (license.txt) provided by oXygen to the following directory:
    %TomcatDir%/webapps/oxygenLicenseServlet/WEB-INF/license
    Note: The actual path may vary according to your deployment.
  4. To configure the required security roles for the license, open the following file in an XML editor:
    %TomcatDir%/conf/tomcat-users.xml
    Note: The actual path may vary according to your deployment.
  5. Add the following line to the file, in the <tomcat-users> element:
    <user username="license" password="license" roles="standard,manager"/>
    For example:
    <tomcat-users>
    	<user username="license" password="license" roles="standard,manager"/>
    </tomcat-users>
  6. Restart the Tomcat service.
  7. 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:
    http://acmetomcatserver:8090/oxygenLicenseServlet/

    The <oXygen/> XML License Server page is displayed:

    oXygen XML License Server
  8. 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.