GeneSpring > Floating > Server

Instructions for upgrade of Floating License Server (FLS) from version 11.x to GeneSpring version 12.x

GeneSpring version 12.x contains new functions in the application and brand-new modules for multi-omics analysis and NGS/SureSelect target enrichment. Prior to GeneSpring 12.x, GeneSpring required only one Order ID for multiple modules to operate. For GeneSpring 12.x and future versions of GeneSpring, individual modules will have their own independent licenses (Order IDs). You will continue to get the full functionality and enhanced features of these multiple modules in GeneSpring 12.x clients by continuing to use the same Order ID for FLS. For additional modules, new Order ID(s) should be entered.

The key stages of the upgrade are:
a. Uninstallation of existing Floating server
b. Installation of Floating License Server v12
c. Activation of Floating server with Order ID(s)

A. Uninstallation

1. Login to the machine where the Floating License Server is installed and navigate to the Floating server installation directory () using a terminal (on Linux or Mac) or the Command Prompt (on Windows). The installation directory is where the Floating license server zip file was extracted. Stop the FLS by executing the command:

./ (on Linux or Mac)
lmdown.bat (on Windows)
Type y (yes) when asked for confirmation.

2. Navigate to the /bin/license directory
a) Backup the content from /bin/license directory.
b) Note down the Order ID from the /bin/license/server.conf file. This is a twelve character code like ABC1-2345-6789. You will need this in Step 7 below.
c) Check the /bin/license/strand.lic file to see if any changes were made to the file. The following changes could have been made:
(i) The port for the license daemon (the 'lmgrd' process) may have been changed at the end of the first line of the file. If so, make a note of it. The default port is 27000.
(ii) The port for the vendor daemon (the 'strand' process) could have been changed at the end of the second line of the file. If so, make a note of it. The default port is 27010.

3. Uninstall the old Floating License Server by deleting the folder.

B. Installation

4. Install the new Floating License Server. Though you can do so in any location of your choice, we recommend you install it in the same location as your previous Floating License Server.

C. Activation

5. The activation instructions would depend on your operating system.
• On Linux:
a) If you have X-server enabled, navigate to and run the command:
b) If you do not have X-Server enabled, follow the steps detailed in Step 7 below for a “silent” activation.

• On Windows:
Open a command prompt, navigate to the directory and run the command:

• On Mac:
Navigate to and run the command:

6. When the license activation dialog appears, you will notice that you have multiple modules, each with the option of entering a different Order ID.

a) Please enter the Order ID you have noted down in Step 2b above in the “GeneSpring GX” module. (Please note: For legacy reasons, we are not separating your existing Order ID into multiple Order IDs)
b) For any additional module, please enter the new Order ID into the appropriate field corresponding to that module.

c) Please also add any proxy information if your web access is through a proxy.
d) Go to Step 9 in all cases except a “silent” authentication.


7. This step is only for a “silent” activation of the Linux Floating License Server (mentioned in Step 5b for Linux above). Go to Step 9, if otherwise.

a) Create a file server.conf in the directory /bin/license
This file must have the Order ID that you have noted in Step 2b above and additional Order IDs for each additional module.
The file must have the line :
where ORDERID is the Order ID noted in Step 2b above. Refer to the below table for a list of the available module codes.
For example, if you have an additional GeneSpring NGS module, the line should look like:

b) If your web access is through a proxy, the file must additionally have proxy settings as described below. (each on a new line in server.conf) proxy=http://proxyserver
c) Run the command: ./ silent

8. This will contact the Agilent License Server and activate your FLS, generating different license files for each module (.lic extension) in the /bin/license directory. (Refer to the table above for the names of the license files).

9. All the license files have been explicitly been set to run the 'lmgrd' process at port 27000 and the 'strand' process at port 27010. If there were different ports set up in the original strand.lic file (Step 2c), then please modify the ports accordingly in all the license files. Please note that these ports will have to be open for clients to fetch a license.

10. In case you do not have web access from the machine or if you face problems activating the FLS automatically, you will need to activate it manually as follows:
a) From a browser, go to the Manual Activation page:
b) Enter the Order ID noted in Step 2b above in the “GeneSpring GX” field. Enter additional Order IDs in the appropriate fields.
c) Upload the activation key file manualActivation.txt from the bin/license folder.
d) In response, the multiple license files will be sent to the designated person (designated at the time of Order ID creation) via email as an attachment. This may not be you; if you do not receive the license via email, contact technical support ( ) with your Order IDs to look up the email address of the person who did receive the license via email.
e) Save these attachments into the bin/license folder.
f) If there were any changes to the port numbers in the old strand.lic file, make the changes accordingly in all the license files.

11. Start the Floating License Server by navigating to the using a terminal (on Linux or Mac) or the Command Prompt (on Windows) and executing the command:
./ (on Linux or Mac)
lmstart.bat (on Windows)

In case if you face any problems, please contact GeneSpring Technical Support at