IdEM 12

Setting up IdEM license - Linux

Copyright ® 2007-2018
IdemWorks s.r.l., a Dassault Systèmes company
All rights reserved.
 Table of contents
Introduction ........................................................................................................................... 3
Installing the license .............................................................................................................. 4
1. License Server Configuration ......................................................................................... 4
1.1. Manual start of the license server ............................................................................... 4
1.2. Automatic start of the license server ........................................................................... 4
2. IdEM license file ............................................................................................................. 5
3. Pointing to the correct license server ............................................................................. 6
4. Firewalls set up .............................................................................................................. 6
5. Note ............................................................................................................................... 6

3DS.COM/SIMULIA © Dassault Systèmes | Confidential Information | 5/23/14 | ref.: 3DS_Document_2014

2
 Introduction
This document describes the procedure for configuring and starting IdEM license manager
and for correctly pointing to your license server.

3DS.COM/SIMULIA © Dassault Systèmes | Confidential Information | 5/23/14 | ref.: 3DS_Document_2014

3
 Installing the license
1. License Server Configuration

The following instructions given in current section 1 apply in case the IdEM license
has been provided as a standalone file.
Conversely, this procedure has to be skipped in case your IdEM license has been
activated together with CST Studio Suite through the CST License Manager (see the
CST Studio Suite User's Guide for further information about license management).
In this case please proceed to Section 2.
Please follow the instructions below to install the license server on the host machine which is

3DS.COM/SIMULIA © Dassault Systèmes | Confidential Information | 5/23/14 | ref.: 3DS_Document_2014

referenced in the license file.

1.1. Manual start of the license server

Start lmgrd from a terminal command line using the following syntax:
<PATH TO lmgrd>/lmgrd -c license_file_list -L [+]debug_log_path

where license_file_list is one or more of the following:

 the absolute path to a single license file

 a directory, including all *.lic/*.dat files which must be used
and debug_log_path is the absolute path to the debug log file.

Prepending debug_log_path with the + character appends logging entries.

Please note that lmgrd does not require root permissions, so please run it from a non-root
user. If lmgrd must be started by the root user, use the su command:
su username -c "<PATH TO lmgrd>/lmgrd -c license_file_list -l
debug_log_path"

where username is a non-privileged user. You must ensure that the vendor daemons listed
in the license file have execute permissions for username. The paths to all the vendor
daemons in the license file are listed on each VENDOR line.

1.2. Automatic start of the license server

In order to have the license automatically up and running at each boot time, you need to set
the license manager. To do this, edit the appropriate boot script, which should be one of the
following: /etc/rc.local,/etc/rc.boot,/etc/rc2.d/Sxxx,/sbin/rc2.d/Sxxxx.

4
 In the script you are editing, please add the following line:

<PATH TO lmgrd>/lmgrd -c <PATH TO LICENSE

FILE>/idem_license.dat –L [+]<PATH TO LOG FILE>/idem.log

Prepending the path to the log file with the + character appends logging entries.

Save the script and reboot your machine.

Please note that:

 all paths are assumed as absolute since no default paths have been defined at boot
time.

 the vendor daemon cstd must be stored in the same directory as lmgrd. IdEM
vendor daemon (cstd) can be found in the Flex toolkit provided with the installation
package (License Manager folder). In case, IdEM is already installed in the host

3DS.COM/SIMULIA © Dassault Systèmes | Confidential Information | 5/23/14 | ref.: 3DS_Document_2014

machine, the cstd daemon can be also found under
$IDEMROOT/IdemWorks/IdEM/12/Flex directory.

 lmgrd does not require root permissions, so please run it from a non-root user. If
lmgrd must be started by the root user, use the su command:
su username -c "<PATH TO lmgrd>/lmgrd -c <PATH TO LICENSE
FILE>/idem_license.dat –L [+]<PATH TO LOG FILE>/idem.log"

where username is a non-privileged user. You must ensure that the vendor
daemons listed in the license file have execute permissions for username. The paths
to all the vendor daemons in the license file are listed on each VENDOR line.

Note
This script does not start the vendor daemon until you reboot the system.

2. IdEM license file

IdEM license files are generated with SERVER lines with the following format:

SERVER this_host ‹hostid› 27000

The license server is the machine that will host the licenses on the network, and whose
Ethernet MAC address appears on the SERVER line.
By default, IdEM license files are provided with TCP port 27000.
If you need, you can modify this port number.

5
 3. Pointing to the correct license server

To run IdEM and to check out a license from a server where the license service has been set,
the environment variable CSTD_LICENSE_FILE should be properly defined.
If a floating license is set up on a remote server, the user can change CSTD_LICENSE_FILE
by taking into account the following rules:

 In case the TCP port number in the SERVER line of the license file (see section 2) has
not been modified, the environment variable should be set as:
CSTD_LICENSE_FILE=27000@‹hostname›

 In case the TCP port number has not been specified, then the license server will use
the first available TCP port number in the range 27000 to 27009.
The CSTD_LICENSE_FILE should then be set as follows.

3DS.COM/SIMULIA © Dassault Systèmes | Confidential Information | 5/23/14 | ref.: 3DS_Document_2014

CSTD_LICENSE_FILE=@‹hostname›

4. Firewalls set up

If the license server and client are on opposite sides of a firewall, the firewall can block
requests from the client despite the server being operational. To work around this, first define
the ports to be used by both the lmgrd and cstd license server daemons, and then reconfigure
the firewall to allow accesses to these ports.
Modify the top of the license file to include port numbers for both the SERVER and VENDOR
lines:
SERVER ‹hostname› ‹hostid› 27000
VENDOR cstd port=‹portnumber›

5. Note

It is advised to not change the date on the license server or client machine. Doing so will
prohibit IdEM product from running. Restoring the system to its original state prior to the date
change may require significant effort.