Post on 28-Nov-2021
1
Industry
Simcenter Samcef
RLM Licensing on Windows
Contents Section 1: How to install the RLM server for the first time .................................................................... 2
Step 1: Copy the license file to your disk ............................................................................................ 2
Step 2: Start the RLM installer ............................................................................................................ 2
Step 3: Define the options .................................................................................................................. 6
Step 4: Install a dongle driver (optional)............................................................................................. 7
Step 5: Adapt the firewall settings ...................................................................................................... 8
Step 6: Complete the installation ....................................................................................................... 9
Section 2. How to update the server license file .................................................................................. 10
Step 1: Copy the license file to your disk .......................................................................................... 10
Step 2: Restart the server ................................................................................................................. 10
Section 3. How to install a RLM license on a client host ....................................................................... 13
Section 4. How to manage an uncounted nodelock license ................................................................. 13
Section 5. How to uninstall the RLM server .......................................................................................... 13
Section 6. Troubleshooting ................................................................................................................... 14
Copyright © 2019 Siemens Product Lifecycle Management Software Inc. All rights reserved.
Siemens and the Siemens logo are registered trademarks of Siemens AG.
All other trademarks, registered trademarks or service marks belong to their respective holders.
2
Section 1: How to install the RLM server for the first time An installation procedure must be executed on each system that will act as a license server. In this
view, for each new release, an installation package is included and can be downloaded from the
support website. If the license server is used to distribute licenses over the network, the availability
of these systems is essential for the functionality of the software, so that these systems are always
present in the network.
The license file required by the license server is recognizable by the fact that it contains one and only
one line starting with the keyword HOST. E.g.:
HOST lx64-4.samtech.com 00605c8ba241
The second item is the name of the host where the RLM server is to be installed and the third item is
its hostid (often a MAC address). The host name must be the fully qualified name, including the
domain. The host name is not an input to the license key signature algorithm, and thus can be
changed at any time.
Before the license server can be started, you must be in possession of the license file for your license
servers. The name of the license file has the form LMS_<HOSTNAME>_<HOSTID>.lic. Once the
license server is running, you can access your licenses for your product. The license file will be
delivered by e-mail by Siemens PLM.
We will further describe the different steps of the installation by presenting the available options.
Step 1: Copy the license file to your disk When you receive the license file from Siemens PLM, copy it to your disk. During the installation
process, you will be prompted to indicate the folder where this file is.
Step 2: Start the RLM installer The installation of a RLM server requires Administrator privileges. The RLM installer files can be
found in the folder RLM on the product DVD. You can start the RLM installer either by clicking on the
RLM link on the splash screen of the product installer or by running as Administrator the file
RLMLicenseServer.exe in the folder RLM_installer.
Then the following window appears, indicating that the Setup Wizard loads its components:
3
Click on Next> button to start the Setup Wizard.
4
You are then prompted to select the installation folder. A default folder is proposed:
It is recommended to use the default folder. Click on Next> to specify your RLM license file:
5
In the top input field of the window you have the possibility to select the license file used by the license server. When requesting a license file for a license server, Siemens PLM will provide you with a file "LMS_<HOSTNAME>_<HOSTID>.lic". The file will be copied in the bottom part of the dialog of the installation.
Note: If you don't have any license file yet, you can leave the input field blank.
Once you have retrieved the license file, you can copy it by hand in the mentioned folder. To easily
find this place, the installer will create a shortcut to it in the start menu. After installation, see start >
LMS RLM 13.0 License Server >Tools >LMS license folder.
This window also allows you to specify the destination of the license file, i.e. the license file folder.
This is the folder where the server will look for a license file. There is also the highly recommended
option to configure the license server to look for license files in
CommonAppDataFolder\LMS\Licensing and copy the license file to this location..
The default location of the license file is the folder {Common Application
Data}\LMS\Licensing.
Note: Common Application Data can be different depending on the Operating
System.
On Windows 7, the license file is stored in the folder ‘C:\ProgramData\LMS\Licensing’. On Windows
XP, the location is ‘C:\Documents and Settings\All Users\Application Data\LMS\Licensing’. When the
option is selected, the desired file will be copied to that folder. As an option, you can also configure
the license server to look for license files in a specific directory and copy the license file to this
location.
If you want to override the default location, you can select this option, and browse to an existing
folder. The installation will copy the earlier mentioned license file to this location, and the server will
use this folder to look for license files.
Note: If no license file is available, you can still continue with the software installation. Simply clear the input field and click Next> to continue. The server will look for license files in the Application Data folder.
When the location of the license file is defined, click on Next> to define the options.
6
Step 3: Define the options
When selecting the top option “Do not allow…”, the user will be unable to shut down the license
server anymore. The only way to shut down the server is to use the command line capabilities of
RLM, or to uninstall the server.
The lower options allow the user to define the location of the server log file and the location of the
daemon log file. The server log file records the events related to the server rlm.exe: starts,
shutdowns… The daemon log file records the license usage: check-in, checkout… The name of the
daemon is lms.exe. It is recommended to save the log files at the same location as the license file.
This is proposed by default.
A convenient way to monitor the instant license usage is to open a web-based interface in your
preferred web browser. The default URL of this interface is:
http://<HOSTNAME>:5054
<HOSTNAME> being the name of the host where the RLM license server is running. When logged on
the server host itself, the name localhost can be used. After specifying the log files, click on
Next>.
7
Step 4: Install a dongle driver (optional)
Note: The FlexLM based dongles are not supported by Samcef.
Click on Next> to continue.
8
Step 5: Adapt the firewall settings
Selecting the “Adapt the firewall settings to allow the licensing daemon to pass" will alter the
firewall settings on your computer. The daemon will be allowed to pass the firewall for domain,
home/work and public. Click on Next> and the installation can be started or aborted:
9
Step 6: Complete the installation A status bar shows the progress of the installation:
When all the files are installed, the following window appears:
Click on Finish to exit the Setup Wizard.
10
Section 2. How to update the server license file This chapter describes the steps to update the license server.
Step 1: Copy the license file to your disk When you receive a new license file from Siemens PLM, copy it to the license file folder. This folder
was specified during the installation of the server. By default, the license file folder is the folder
C:\ProgramData\LMS\Licensing.
Step 2: Restart the server Open the web server in a web browser. On the license server host, the address of the web server is
http://localhost:5054. Enter the username and password chosen for the license server manager and
click on LOGIN button. By default, the username is admin and the password is left blank:
11
Once logged in, click on Reread/Restart Servers button:
12
Select the server lms and click on REREAD/RESTART button to confirm the restart:
13
Section 3. How to install a RLM license on a client host The installation of a RLM client requires Administrator privileges. You have to set the environment
variable LMS_LICENSE to the value:
port@hostname
where port is the communication port of the server and hostname is the name of the computer
where the RLM server is running. The default port number is 5053. The environment variables are
defined in the Advanced system settings of Windows.
Section 4. How to manage an uncounted nodelock license Nodelock licenses are counted in general and they require the installation of a license server, as for
any floating licenses. Exceptionally, nodelock licenses can be uncounted and no license server is then
required.
The installation of an uncounted nodelock license requires that you copy the license file to the
license file folder ‘C:\Program Files (x86)\LMS\nodelock’ and that you set the variable LMS_LICENSE
to that location (= path + file name).
To update an uncounted nodelock license file, either repeat the preceding procedure or simply
replace the license file in the license file folder.
Section 5. How to uninstall the RLM server To uninstall a RLM license server, you must run the following uninstall procedure:
• Open the “Control Panel” and click on “Uninstall a program”;
• In the list of programs, locate the item “LMS RLM 13.0 License server”;
• Right-click on this item and select “Uninstall”;
14
Section 6. Troubleshooting Licenses are driven by one or more of the following variables:
• LMS_LICENSE = path to RLM (path, path+LMS*.lic, and/or servers port@hostname)
• SAM_CLE = path to file SAMCEF.CLE (free demo license file)
• SAM_USE_UGS = switch to Flexlm UGS license server, when set to 1 (no other value allowed)
• SPLM_LICENSE_SERVER = path to a Flexlm UGS license (path+ugslmd*.lic, and/or
servers port@hostname)
• SAM_USE_FLEXLM = switch to legacy Flexlm SAMTECH license server, when set to 1 (no
other value allowed)
• SAMTECH_LICENSE_FILE = path to a legacy Flexlm SAMTECH license (path+SAMTECH.LIC
and/or servers port@hostname)
Situation 1: If no variable is defined, the error message is similar to the following one in SAMCEF:
------------------------------------------------------------------
%%% SECURITY ERROR [LICENSE FILE] %%%
------------------------------------------------------------------
License file not found:
"/tmp/SAMCEF.CLE"
------------------------------------------------------------------
0%%%E31-FMOPE1, OPEN ERROR (RCODE: 901 ) ON LOGICAL UNIT 93
FILE NAME: </tmp/SAMCEF.CLE>
CURRENT DIRECTORY: </disk1/user3/tmp7>
SYSTEM ERROR: <No such file or directory>
+-----------------------------------------------------------------
! SAM_CLE : "/tmp"
! Key file : "/tmp/SAMCEF.CLE"
+-----------------------------------------------------------------
0%%%E07-SMAIN, SEVERE ERROR NUMBER 20 - CONTACT SAMCEF SUPPORT
In other Samtech products, if no license variable exists, the message is rather the following:
%%% SECURITY ERROR [LICENSE FILE] %%%
(14) RLM: No server list provided
%%% SECURITY ERROR [LICENSE FILE] %%%
0%%%E07-SMAIN, SEVERE ERROR NUMBER 20 - CONTACT SAMCEF SUPPORT
Situation 2: If SAM_CLE is defined, either it is valid, either not. If not, message such as the following
is output:
-------------------------------------------------------------------------------
%%% SECURITY ERROR [LICENSE FILE] %%%
-------------------------------------------------------------------------------
This version number is not authorized: 16
-------------------------------------------------------------------------------
+-----------------------------------------------------------------------------+
! SAM_CLE : "/disk1/user3"
! Key file : "/disk1/user3/SAMCEF.CLE"
! Expires : 30-06-2014
! SAMCEF : V 15
! Module : BACON
+-----------------------------------------------------------------------------+
0%%%E07-SMAIN, SEVERE ERROR NUMBER 20 - CONTACT SAMCEF SUPPORT
15
Situation 3: If LMS_LICENSE is set to the RLM file or server, the program starts. The variable
LMS_LICENSE takes precedence over the variable SAM_CLE. If it is wrongly defined (nonexistent file
or server), the following message appears:
%%% SECURITY ERROR [LICENSE FILE] %%%
(8) RLM: Cannot checkout license
server 5053@host1 reported for feature LMS_BACON_0(LMS_BACON:1): Bad server hos
tname in license file or port@host. (RLM error -43)
%%% SECURITY ERROR [LICENSE FILE] %%%
0%%%E07-SMAIN, SEVERE ERROR NUMBER 20 - CONTACT SAMCEF SUPPORT
Situation 4: If SAMTECH_LICENSE_FILE is set to a Flexlm file or server, and if SAM_USE_FLEXLM is
set to 1, the program starts. This combination of 2 variables takes precedence over the variable
LMS_LICENSE. If the variable SAMTECH_LICENSE_FILE is wrongly defined (nonexistent file or
server), the following message appears:
Environment variable SAM_USE_SAMTECH is switched on
%%% SECURITY ERROR [LICENSE FILE] %%%
License server machine is down or not responding.
See the system adminstrator about starting the license server system, or
make sure you're referring to the right host (see LM_LICENSE_FILE).
Feature: BACON
Hostname: host1
License path: @host1:/usr/Samv99/SAMTECH.LIC
FLEXnet Licensing error:-96,7. System Error: 2 "No such file or directory"
%%% SECURITY ERROR [LICENSE FILE] %%%
0%%%E07-SMAIN, SEVERE ERROR NUMBER 20 - CONTACT SAMCEF SUPPORT
Be aware however that this message may not appear and the programs starts normally, if there is a
resource file .flexlmrc in your home directory, with a path to a valid file or server, coming from a
previous use of Flexlm.
Situation 5: The check-out of licenses is slower than usual.
The variables LMS_LICENSE and SAMTECH_LICENSE_FILE contain a list of license servers and/or
paths to license files. If this list contains servers that are not currently available, the check-out of
licenses can be unusually slow. This is true even if the first server of the list is available and if it has
valid licenses. Actually, the complete list of servers is scanned each time a program starts and if a
server is down, the program will hang until a timeout is elapsed.
FOR ADDITIONAL INFORMATION, READ THE FILE RLM_License_Administration.pdf, OR DIRECTLY
CONSULT THE USER DOCUMENTATION ON THE SITE www.reprisesoftware.com
Samtech SA, a Siemens Company
Digital Factory Division Product Lifecycle Management Simulation and Test Solutions
Liège Science Park Rue des Chasseurs Ardennais, 8 4031 Angleur (Belgium) T +32 4 361 69 69
Web site: https://www.plm.automation.siemens.com
Support: CAESupport.Liege.plm@siemens.com