Floating License Guide#

Server quick start guide:#

  • Activate: TurboFloatServer.exe -a="<your key here>"
    • Online activation uses port 80 (HTTP) or port 443 (HTTPS)

    • For offline activation, see Offline activation below

  • Deactivate: TurboFloatServer.exe -deact

  • Start: TurboFloatServer.exe -x
    • This will run the server without installing a service.

  • Install: TurboFloatServer.exe -i
    • This also starts the Windows service, named TurboFloatServer-5260, TurboFloatServer-6575, or TurboFloatServer-6576

    • This will require admin privileges

  • Uninstall: TurboFloatServer.exe -u
    • May require admin privileges

  • Configure: TurboFloatServer-config.xml
    • Connection port, thread count, lease length, logs, grace periods, and proxies

    • The server will listen for lease requests on the configured port (default port 13)

Client quick start guide:#

Hint

To open the LicenseManager in your software navigate as Help > License Manager

  • The LicenseManager allows connecting/disconnecting to the license server as well as acquiring/dropping a lease on demand

  • Using the LicenseManager
    • Enter server details under the tab for your license type, and connect to the server

    • After connecting to the server, you can safely close the license manager tab

    • The software will automatically acquire a lease after connecting to the server

    • The software will automatically drop a lease on exit

    • You can manually acquire and drop leases from the license manager

  • Using an environment variable
    • Create an environment variable with the appropriate name and server details
      • Name according to your product key:
        • Suite: JANGAFX_SUITE_SERVER

        • EmberGen: JANGAFX_EMBERGEN_SERVER

        • LiquiGen: JANGAFX_LIQUIGEN_SERVER

        • IlluGen: JANGAFX_ILLUGEN_SERVER

        • GeoGen: JANGAFX_GEOGEN_SERVER

      • Value: XXX.XXX.XXX.XXX:YYYY or example.com:12345

      • If the environment variable is set, do not use the license manager

      • The software will automatically acquire a lease if the environment variable is set

      • The software will automatically drop a lease on exit

  • Additional lease information:
    • A lease that is not dropped due to a crash or disconnect from the server can be re-acquired and extended by the same machine upon reconnecting

    • A lease that is not dropped due to a crash or disconnect from the server cannot be used by anyone else until the lease time is over

    • Leases cannot be “borrowed” (used offline, for extended periods of time)

Offline activation#

If you need offline activation, please contact us at support@jangafx.com and follow the steps below.

There are two steps to offline activation. You will send an activation request and receive a response:

  1. Generating the activation request

    • Pass in the product key and location for the activation request XML file

    • TurboFloatServer.exe -a="ABCD-EFGH-IJKL-MNOP-QRST-UVWX" -areq="C:\Location\To\Save\ActivationRequest.xml"

  2. Using the activation response * After submitting the activation request to us and receiving the activation response, you can activate the TurboFloat Server * TurboFloatServer.exe -a -aresp="C:\Location\To\ActivationResponse.xml"

Logs#

  • Detailed logs about connections and leases go into the tfs-log.txt file

  • Running the server using the -x flag, will show these messages directly in the console

  • You can configure the log level using the TurboFloatServer-config.xml configuration file
    • notification: records when leases are created, removed, expired, and other nonessential, but possibly interesting information. This level also includes all other level outputs (warning, error).

    • warning: records things that are wrong with your configuration or other things that need to be fixed. This level also includes the next level of output (error).

    • error: records when TurboFloat Server fails to do things it needs to do. For example, failures to load configuration data, failure to process data, etc.

    • none: No log file will be written


Troubleshooting#

For detailed information, and instructions for other platforms, visit https://wyday.com/limelm/help/turbofloat-server

If the information below doesn’t solve your problem, and you require any further support, please contact support@jangafx.com

The software can’t acquire or maintain an active lease#

If the license manager has connected to the license server, but the lease status in the license manager and in the software don’t match, you will need to close both the software and the license manager. Afterwards, reopen the software to acquire a lease.

Also, make sure that if you are trying to use the license manager to connect to the server, there are no environment variables named as described prior in this documentation.

Error connecting to the license server#

Some networks may be configured to block port 13. If you’re having trouble connecting to the license server, try to change this port to something that is allowed on your server.

Using different paths#

  • TurboFloatServer.exe assumes TurboActivate.dat and TurboFloatServer-config.xml are located with the server executable

  • Use -pdets and -config to pass custom paths:
    • TurboFloatServer.exe -a="Your Key" -pdets="YourTurboActivate.dat" -config="Config.xml"

Failed to uninstall the server:#

In case of error message: * Failed to remove this service from the Windows Firewall. 0x80070057

Try manually deleting the firewall rules in Windows Defender before trying to uninstall once more.

The rules will be named: <software> 1.x floating license server

Hint

Example for EmberGen: EmberGen 1.x floating license server