How floating (concurrent) licenses work

If all the floating licenses are used in the same local network the installation procedure of floating licenses is the same as for the Named User licenses. Within the same network the license management is done by communication between the instances of <oXygen/> that are connected to the same local network and that run at the same time. Any new instance of <oXygen/> that is started after the number of running instances is equal with the number of purchased licenses will display a warning message and will disable the open file action.

If the floating licenses are used on machines connected to different local networks a separate license server must be started and the licenses deployed on it. Contact the <oXygen/> Support Team at to request the license server kit.

Procedure 2.4. Floating license server setup

  1. Contact the <oXygen/> Support Team at to request the license server kit.

  2. Unzip the zip archive containing the license server in a folder on your server machine. After that if you want to install the license server as a Windows service go to the special section which describes that.

  3. You have to configure the server to look into a license directory (by default is [Server License Install Directory]/licenses) and use a certain TCP/IP port for communication (by default port 12346 is used). The license directory will contain the license files to be managed. A license file must begin with "license" and it has to have the extension "txt". It is the job of the license server to sum up the total number of licenses contained in the license files from the licenses directory.

    To change the default configuration of the license server the following parameters have to be used:

    • -licenseDir followed by the path of the directory where the license files will be placed;

    • -port followed by the port number used to communicate with <oXygen/> instances.

After the floating license server is set up the <oXygen/> application can be started and configured to request a license from it:

Procedure 2.5. Request a floating license from the license server

  1. Start Eclipse.

  2. Go to Window -> Preferences -> oXygen -> Register... . The license dialog is displayed.

  3. Check the Use a license server checkbox.

  4. Fill-in the Host text field with the host name or IP address of the license server.

  5. Fill-in the Port text field with the port number used for communicating with the license server. Default is 12346.

  6. Click the Register button. If the maximum number of available licenses was not exceeded a license key is received from the floating license server and registered in <oXygen/>. If the maximum number of licenses was exceeded a warning dialog will pop up letting the user know about the problem.

    Figure 2.2. Floating license number exceeded

    Floating license number exceeded


    The error message contains information about the users who requested and successfully received the floating licenses.

How to install the <oXygen/> license server as a Windows service

In order to install the <oXygen/> license server as a Windows service run the following command from the command line in the install folder of the license server:

installWindowsService.bat

After installing the server as a Windows service, use the following two commands to start and stop the license server:

startWindowsService.bat
stopWindowsService.bat

Uninstallation of the Windows service requires the following command:

uninstallWindowsService.bat

The installService.bat script installs the <oXygen/> license server as a Windows service with the name "oXygenLicenseServer" and accepts two parameters: the path of the folder containing the floating license key files and the local port number on which the server accepts connections from instances of the <oXygen/> XML Editor. The parameters are optional. The default values are:

licenses
for the license file folder
12555
for the local port number

The JAVA_HOME variable must point to the home folder of a Java runtime environment installed on your Windows system.

The startService.bat script starts the Windows service so that the license server can accept connections from <oXygen/> clients.

The stopService.bat script stops the Windows service. The license server is shut down and it cannot accept connections from <oXygen/> clients.

The uninstallService.bat script uninstalls the Windows service created by the installService.bat script.

The license server creates two log files in the directory where the license server is installed:

outLicenseServer.log
the standard output stream of the server
errLicenseServer.log
the standard error stream of the server

The license server must be installed in a folder which does not contain space characters in the path name. Also the path set as the value of the JAVA_HOME environment variable must not contain space characters. Otherwise the install script fails.