How to release a locked BRIGADE/Standard 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.
Running the lmremove
command looks a bit different depending on whether you want to check-in a BRIGADE/Standard or Brigade/Plus license token; see How to release a locked BRIGADE/Plus license token for how to do it for BRIGADE/Plus.
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/Standard
Start a command prompt. You can start it by writing cmd
in the search box next to the start menu in the Windows taskbar:
In the command prompt, change the work directory to the license
folder in the BRIGADE/Standard installation directory. If you’ve have installed BRIGADE/Standard 2024 in the default folder you can write:
cd C:\Program Files\Technia\BRIGADE Standard\2024\license
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:
lmstat -a -c [PORT]@[SERVER] -f [FEATURE]
[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/Standard there are two features:
brigade_standard - the GUI-feature. A brigade_standard tooken is checked out from the license server when the brigade standard application is started on the desktop/laptop.
solver - the solver feature. A solver token is checked out from the license server when an analysis is started.
So, for example if trying to look up the use of brigade_standard tokens, using a license server named SE-LT-000039 that uses port 270000 the following command can be run:
lmstat -a -c 27000@SE-LT-000039 -f brigade_standard
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 1 token of type brigade_standard from the server SE-LT-000039
on port 27000
the session started at a certain time
and has ID 401
To forcefully remove this checked-out token from the license server, use the following command:
lmremove -c [PORT]@[SERVER] -h [FEATURE] [SERVER] [PORT] [ID]
For the example above we get
lmremove -c 27000@SE-LT-000039 -h brigade_standard SE-LT-000039 27000 401
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.
Reference
For a complete description of the license management system (FlexNet) refer to the documentation included with the BRIGADE/Standard installation, e.g. for version 2024:
C:\Program Files\Technia\BRIGADE Standard\2024\doc\FNP_11.16.3_doclib.pdf
Summary
To forcefully check-in a license token that is locked/stuck, navigate to the following folder in a command line interface:
cd C:\Program Files\Technia\BRIGADE Standard\{VERSION}\license
use the commands:
lmstat -a -c [PORT]@[SERVER] -f [FEATURE]
lmremove -c [PORT]@[SERVER] -h [FEATURE] [SERVER] [PORT] [ID]
Keywords
BRIGADE/Standard, Analysis, JOB, LICENSE, TOKENS
TECHNIA CONFIDENTIAL