Activation

LexFloatServer needs to be activated using a license of type on-premise-floating before it can be used. It can be activated using its local dashboard, command-line options, or its API endpoints.

Using the local dashboard

LexFloatServer provides a web-based local dashboard that can be used to activate the server license.

Online activation

Open the dashboard by visiting http://localhost:8090 in your browser. Go to the Settings page and enter the license key to activate the server.

Offline activation

To activate offline, click SWITCH TO OFFLINE ACTIVATION on the Settings page. Enter the license key to generate the offline activation request file.

After generating the offline response from the Cryptlex admin portal for this request, paste the offline response file contents in the input to activate the server.

Using command-line options

Online activation

To activate, pass the -a option along with the license key. If the product file path is not set in the config.yml file, pass it too using the --product-file option:

lexfloatserver -a --license-key LICENSE_KEY --product-file FILEPATH

Offline activation

To activate offline, pass the -g option to generate the offline activation request:

lexfloatserver -g --license-key LICENSE_KEY --offline-request FILEPATH

After generating the offline response from the admin portal, pass it along with the -a option to activate the server:

lexfloatserver -a --license-key=LICENSE_KEY --offline-response=FILEPATH

Using the API endpoints

LexFloatServer exposes a few API endpoints that can also be used to activate the server.

Online activation

Send a POST request to the /api/server/activate API endpoint with a JSON request body containing the license key and optionally the activation metadata.

POST http://localhost:8090/api/server/activate

Request body

Sample response:

  {
  "message": "Server license activation successful!",
  "code": "SERVER_LICENSE_ACTIVATED"
}

Offline activation

Send a POST request to the /api/server/offline-activation-request API endpoint with a JSON request body containing the license key and optionally the activation metadata.

Generate the offline activation request

POST http://localhost:8090/api/server/offline-activation-request

Request body

  {
  "offlineRequest": "U7l69tNy8..."
}

After generating the offline response from the admin portal, send a POST request to the /api/server/offline-activate API endpoint with a JSON request body containing the license key and the offline response.

Activate the server offline

POST http://localhost:8090/api/server/offline-activate

Request body

Sample response:

  {
  "message": "Server offline license activation successful!",
  "code": "SERVER_LICENSE_ACTIVATED"
}

Applying license changes to an offline-activated server

A LexFloatServer activated offline holds the license data from the response file it consumed, so nothing you change on the license in the admin portal reaches it on its own. A renewal, a change to the allowed floating clients, suspension, or revocation applies only once the server picks up new license data, in one of two ways:

• Exchange a fresh offline request and response. Generate a new offline activation request on the server, create a response for it in the admin portal, and apply it, exactly as you did when activating the server.
• Give the machine temporary internet access. LexFloatServer then syncs with Cryptlex and pulls the changes at its next sync. Restart LexFloatServer to sync immediately instead of waiting for the next one.