How to release a locked BRIGADE/Plus license token

Background

Due to different reasons, a BRIGADE license token might get stuck/locked. For example, if the contact with the license server is lost during an analysis the license server will not get a signal from the BRIGADE client running the analysis when it is done with the analysis. Hence, the license server will not be able to release the license token.

Solution

One way to release a lingering license is to restart the license server, which isn't always practical for a BRIGADE user that does not have administration access to the license server. A better option is using the command lmremove from a command prompt to forcefully check in the license token. Normally, any BRIGADE client can use the command. If not, it is recommended that you discuss it with your IT-administrator.

Below you will find guide on how to use the lmremove utility to check in license tokens and a brief description of how the BRIGADE License Server works and the various arguments used.

Step-by-Step guide for BRIGADE/Plus

Start a command prompt. You can start it by writing cmd in the search box next to the start menu in the Windows taskbar:

Open

In the command prompt, change the work directory to the bin folder in the BRIGADE/Plus installation directory, e.g. if you’ve have installed BRIGADE/Plus 2024 in the default folder you can write:

Open

From here you can run the command lmstat. It is a command that retrieve license information from the license server. The general syntax for the command that needs to be run to retrieve the needed information from the license server is:

[PORT], [SERVER] and [FEATURE] are attributes that are specific to each user environmental.

• A [PORT] number is a numeric label given to particular processes or services on a device, enabling it to differentiate between various types of network communications. The default [PORT] number used by the BRIGADE license service is 27000. It can be changed in the license file at any time (without regenerating the license file). Contact your IT-administrator if you do not know the [PORT] number.

• [SERVER] refers to the server name, i.e. the name of the computer that the license server is running on.

• [FEATURE] refers to the specific feature used by BRIGADE. For BRIGADE/Plus there are four features:

  • brigade_plus - the GUI-feature. 20 brigade_plus tokens ares checked out from the license server when the BRIGADE/Plus application is started on the desktop/laptop.

  • job - the job-processor feature. 20 job-tokens are checked out from the license server when the BRIGADE/Plus job processor is started.

  • execute_fe - the solver feature. 100 execute_fe tokens are checked out from the license server when an FE-analysis is started. (For any additional CPUs on the same job, 20 additional tokens are check our)

  • execute_calc - the live load and load combination feature. 100 execute_calc tokens are checked out from the license server when an Load Combination analysis is started. (For any additional CPUs on the same job, 20 additional tokens are check our)

So, for example if trying to look up the use of execute_fe tokens, using a license server named SE-LT-000039 that uses port 270000 the following command can be run:

Open

Output results from the command gives us the following information:

• user phas01

• on client computer SE-LT-000039 (same as the server name in this example since the server is installed on the same computer as the license server)

• has checked out 100 tokens of type execute_fe from the server SE-LT-000039

• on port 27000

• the session started at a certain time

• and has ID 503

To forcefully remove this checked-out token from the license server, use the following command:

For the example above we get

Open

The command returns: lmremove - Copyright (c) 1989-2019 Flexera. All Rights Reserved.

To check if the token has been released, the same command as earlier can be used. And in this example we can now see that 0 licenses are used.

Open

Reference

For a complete description of the license management system (FlexNet), refer to the documentation included with the BRIGADE installation by clicking on the Licensing Reference Documentation shortcut in the BRIGADE/Plus folder of your start-menu.

Summary

To forcefully check-in a license token that is locked/stuck, navigate to the following folder in a command line interface:

and use the commands:

Keywords

BRIGADE/Plus, Analysis, JOB, LICENSE, TOKENS