Simcenter Samcef - Siemens

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:

http://localhost:5054/

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:


(14) RLM: No server list provided



Situation 2: If SAM_CLE is defined, either it is valid, either not. If not, message such as the following

is output:

-------------------------------------------------------------------------------


-------------------------------------------------------------------------------

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

+-----------------------------------------------------------------------------+


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:


(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)



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


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"



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: [email protected]

https://www.plm.automation.siemens.com/

Simcenter Samcef - Siemens

Documents

Transcript of Simcenter Samcef - Siemens