Manage the Floating License Server from the command line

Use this guide for advanced administration of an installed Floating License Server through Command Prompt.

The License Server Manager is the recommended interface for normal license activation and management. Use the command line only for automation, scripting, or advanced troubleshooting.

For the standard process, see Activate licenses on the Floating License Server.


Before you begin

You need:

  • Administrator rights on the Floating License Server computer;
  • access to the extracted Floating License Server files;
  • administrator credentials for the License Server;
  • a valid 32-character Activation ID for each license you want to add.

The commands in this guide use the default local server address:

http://localhost:7070/api/1.0/instances/~

If your server uses a different port or you are managing it remotely, update the address accordingly.


Step 1: Open Command Prompt

Search for Command Prompt in Windows.

Right-click it and select Run as administrator.

Navigate to the Server folder in the extracted Floating License Server files:

cd <extracted folder>\Server


Step 2: Confirm the License Server is running

Check the status of the License Server:

flexnetls.bat -status

If it is not running, start it:

flexnetls.bat -start


Step 3: Activate licenses online

Use this method when the Floating License Server has internet access.

Check connectivity

Online activation requires access to the licensing service.

Run:

curl -I https://flex13015.compliance.flexnetoperations.eu/deviceservices

If the connection is blocked, see Online activation cannot connect, use offline activation, or ask your IT team whether proxy configuration is required.

Activate the licenses

Navigate to the Enterprise folder:

cd <extracted folder>\Enterprise

Run:

  1. flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -activate -id <activationID> -count <number>

Replace:

  • <password> with the License Server administrator password;
  • <activationID> with the 32-character Activation ID;
  • <number> with the number of licenses to activate.

To activate multiple Activation IDs in one command, repeat:

-activate -id <activationID> -count <number>

Verify the activation

Run:

flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -features

Confirm that the activated licenses are listed.


Step 4: Activate licenses offline

Use this method when the Floating License Server cannot access the internet.

Generate an offline request

Navigate to the Enterprise folder:

cd <extracted folder>\Enterprise

Run:

  1. flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -activate -id <activationID> -count <number> -o server-request.bin

To include multiple Activation IDs, repeat:

-activate -id <activationID> -count <number>

The request file is saved as server-request.bin.

Process the request in the End-User Portal

On a computer with internet access:

  1. Open the Materialise End-User Portal.
  2. Select Offline License (De)activation.
  3. Under Upload type, select Generate license or confirm license reduction or return.
  4. Upload server-request.bin.
  5. Download the response file generated by the portal.
  6. Transfer the response file back to the Floating License Server computer.

Import the response

Run the following command, replacing <response-file> with the name of the downloaded file:

flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -activate -load <response-file>

Verify the activation

Run:

flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -features

Confirm that the activated licenses are listed.


Step 5: Review licenses

Navigate to the Enterprise folder and run:

flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <password> -licenses -verbose

This displays detailed information about the licenses on the server.


Step 6: Manage the server remotely

To manage the Floating License Server from another computer, replace the local server address in the commands:

http://localhost:7070/api/1.0/instances/~

with:

http://<license-server-hostname>:<port>/api/1.0/instances/~

By default, the Floating License Server uses port 7070, unless it was explicitly reconfigured during installation.

The remote computer must be able to reach the configured port on the Floating License Server.

If the connection fails, see Workstation cannot connect to the Floating License Server.


Step 7: Change the administrator password

To change the default administrator password, navigate to the Enterprise folder and run:

flexnetlsadmin.bat -server http://localhost:7070/api/1.0/instances/~ -authorize admin <current-password> -users -edit admin <new-password>

Replace:

  • <current-password> with the current administrator password;
  • <new-password> with the new password.

Store the new password securely.


Something not working?

‹ Back to: Quick start guide

Was this article helpful?

Can’t find what you’re looking for?

Our customer service team is happy to help!