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 <support@oxygenxml.com>
to request the license server kit.
Procedure 2.10. Floating license server setup
Contact the <oXygen/> Support Team at <support@oxygenxml.com>
to request the license server kit.
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.
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.11. Request a floating license from the license server
Click Help -> Register.... The license dialog is displayed.
Check the Use a license server checkbox.
Fill-in the Host text field with the host name or IP address of the license server.
Fill-in the Port text field with the port number used for communicating with the license server. Default is 12346.
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.
The error message contains information about the users who requested and successfully received the floating licenses.
In order to install the <oXygen/> license server as a Windows service run the following commands from the command line in the install folder of the license server:
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:
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:
The license server should be installed in a folder which does not contain blank spaces in the path name. Otherwise the install script fails.