Floating License Server

Wikis > AlgoQuant > Setup > Floating License Server

Floating License

For personal use, a user needs a valid license file (namely, numericalmethod.lic) to use SuanShu on his/her fixed machine. In case, the machines on which SuanShu is used are not fixed, floating licenses provide an alternative solution. This solution is suitable for a group of users working in the same organization, in which they share a predetermined number of licenses. Floating license is supported since version 3.7.0.

License Server

A predetermined number of floating licenses are managed by a dedicated license server. Users from any machine can connect to the server in order to obtain the licenses for using SuanShu.

To start the license server, under Windows, double-click the file start-floating-license-server.bat (or, run the script start-floating-license-server.sh under Linux). The script file is packaged with SuanShu distribution (see the file structure below).

Configuration

The port number used by the license server is 8080 by default. To change the port number, one can change the value by editing the configuration file floating.server.conf.

License

The license server itself needs a license file floating.server.lic (under the same folder as the SuanShu jar file) to run. Please contact our sales team to obtain the license file.

Run at Startup

License server can be configured to start at machine startup by the following steps:

  • Windows 7 or earlier versions
    1. Create a shortcut of the batch script by right-clicking the file and selecting “Create shortcut”.
    2. Click “Start” menu and locate “Startup”.
    3. Right-click “Startup” and select “Explore”.
    4. Copy and paste the created shortcut into the Startup folder.
  • Windows 8 or later versions
    1. Create a shortcut of the batch script by right-clicking the file and selecting “Create shortcut”.
    2. Press Windows key + R.
    3. Type “shell:startup” into the Run dialog, and press Enter.
    4. Copy and paste the created shortcut into the Startup folder.
  • Mac OS X
    1. Click “Apple” menu, and select “System Preferences”.
    2. Click “Users & Groups” icon, and click “Login Items”.
    3. Click “+” button at the bottom to add the .sh script file in SuanShu folder.
  • Linux
    1. Edit the file “~/.bash_profile”.
    2. Add a line to call “location_of_suanshu_folder/start-floating-license-server.sh” into the file, and save it.

Floating Users

A floating user with a valid floating numericalmethod.lic can use SuanShu on any machine (as long as it can connect to the license server).

Configuration

The IP address and the port number of the license server can be configured via the configuration file floating.user.conf.

Note that the port number configured here must match the one used by the server.

License

Floating users also need special license file numericalmethod.lic (under the same folder as the SuanShu jar file). Such license file can be replicated to any machine. Please contact our sales team to obtain the license file.