Tecnomatix License Mechanism

Installation Instructions

for
Version 10.1 Tecnomatix Applications

using

FLEXnet Licensing™ Version 11.9

 COPYRIGHT
Proprietary & Restricted Rights Notice

This software and related documentation are proprietary to Tecnomatix

Technologies Ltd.
© 2012 Tecnomatix Technologies Ltd. All rights reserved.
Portions of this manual are proprietary to Siemens Industry Software Inc.
© Copyright 2012 Siemens Industry Software Inc. All Rights Reserved.
All trademarks belong to their respective holders.
3D Labs is a registered mark or trademark of 3Dlabs, Inc. or its subsidiaries in the
US and other countries.
Adobe is a registered mark or trademark of Adobe Systems Incorporated or its
subsidiaries in the US and other countries.
Apache is a registered mark or trademark of The Apache Software Foundation or its
subsidiaries in the US and other countries.
ATI is a registered mark or trademark of ATI Technologies Inc. or its subsidiaries in
the US and other countries.
AutoCAD is a registered mark or trademark of Autodesk, Inc. or its subsidiaries in
the US and other countries.
Flexera is a registered mark or trademark of Flexera Software, Inc. or its subsidiaries
in the US and other countries.
HP is a registered mark or trademark of Hewlett-Packard Company or its
subsidiaries in the US and other countries.
IBM is a registered mark or trademark of International Business Machines
Corporation or its subsidiaries in the US and other countries.
Intel is a registered mark or trademark of Intel Corporation or its subsidiaries in the
US and other countries.
Java and iPlanet are registered marks or trademarks of Sun Microsystems, Inc. or its
subsidiaries in the US and other countries.
Microsoft is a registered mark or trademark of Microsoft Corporation or its
subsidiaries in the US and other countries.
Microstation is a registered mark or trademark of Bentley Systems, Incorporated or
its subsidiaries in the US and other countries.
Netscape is a registered mark or trademark of Netscape Communications Corp. or
its subsidiaries in the US and other countries.
NVIDIA is a registered mark or trademark of NVIDIA Corporation or its subsidiaries
in the US and other countries.
Oracle is a registered mark or trademark of Oracle Corporation or its subsidiaries in
the US and other countries.
Siemens is a registered mark or trademark of Siemens Corp. or its subsidiaries in
the US and other countries.
TiCon is a registered mark or trademark of MTM or its subsidiaries in Germany and
other countries.
UNIX is a registered mark or trademark of The Open Group or its subsidiaries in the
US and other countries.
RAMSIS is a trademark of Human Solutions. The Software is sub-licensed by
Human Solutions GmbH, Kaiserslautern, Germany.
Body Builder is a trademark of Human Solutions. The Software is sub-licensed by
Human Solutions GmbH, Kaiserslautern, Germany.
 Tecnomatix License Mechanism Installation Instructions

Table Of Contents

1. System Requirements ......................................................................................... 4

1.1 TCP/IP Protocol ....................................................................................................... 4
2. Licensing Tecnomatix Applications Version 10.1 ............................................ 4
2.1 Floating (“Concurrent”) Licenses .......................................................................... 4
2.2 Named-User Licenses............................................................................................. 4
2.3 Node-Locked Licenses ........................................................................................... 5
2.4 Computer-Dependent/Mobile Licenses ................................................................. 5
2.5 License Borrowing .................................................................................................. 5
2.6 Redundant License Servers ..................................................................................10
3. Receiving Your Licenses from Siemens PLM Software ................................. 11
3.1 Installation of the License-Server Application .....................................................11
3.2 Obtaining your Machine ID ....................................................................................11
3.3 Contacting Your local Customer Service Department ........................................13
3.4 Receiving your Licenses .......................................................................................13
4. Using WIBU Dongles ......................................................................................... 14
5. Setting-Up Licenses .......................................................................................... 15
5.1 Floating Licenses...................................................................................................15
5.2 Named-User Licenses............................................................................................18
5.3 Node-Locked Licenses ..........................................................................................19
5.4 Moving WIBU-Dongle and License Files to Another Computer ..........................19
6. Starting the License Server Manager on UNIX Platforms .............................. 20
6.1 Manual Start ...........................................................................................................20
6.2 Automatic Start ......................................................................................................20
6.3 Supported Linux Platforms ...................................................................................22
7. License File Content, Utilities and Diagnostics .............................................. 22
7.1 Utilities and Diagnostics .......................................................................................22
7.2 The License File .....................................................................................................22
7.3 Steps to Setup Named-User Licenses ..................................................................23
7.4 Options File Example.............................................................................................25

3
 Tecnomatix License Mechanism Installation Instructions

1. System Requirements
Please consult the system requirements document which is part of your program package.

1.1 TCP/IP Protocol

The license mechanism uses the TCP/IP protocol to communicate with Tecnomatix applications.
Before installing Tecnomatix applications on your computer, make sure that TCP/IP protocol has
been installed and that your computer has a valid TCP/IP address. In the event that no TCP/IP
protocol is installed, it is recommended to contact your system administrator.

2. Licensing Tecnomatix Applications Version 10.1

The license mechanism for version 10.1 Tecnomatix products is based on the FLEXnet
Licensing™ mechanism (previously called FLEXlm™) Version 11.9 by Flexera Software
Inc. For more information, refer to License Borrowing on page 5.
If you are already using FLEXnet Licensing for products other than Tecnomatix, you can
use existing FLEXnet installations to license Tecnomatix applications as well. For details,
contact your local Customer Service Department.
Depending on the Tecnomatix products you purchased, Tecnomatix provides Floating,
Named-User or Node-Locked licenses.

2.1 Floating (“Concurrent”) Licenses

Floating licenses are available to any single user on your computer network. Floating
licenses are provided by a license server computer on the network. If you purchased a
number of Floating licenses, that same number of users may work with the Tecnomatix
licenses installed on the license server computer. You may run applications or application
servers from any computer in the network, including the license server computer.
The license server application which is installed as a system service on the license server
computer allows the configuration of Tecnomatix License Manager. This service must be
started in order to assign and manage licenses. It uses license files that specify all
available licenses. It is not required to run the Tecnomatix License Manager on individual
client computers that operate Tecnomatix applications.

2.2 Named-User Licenses

A Named-User license is a Floating license dedicated to an individual user. The license
server computer on the network provides Named-User licenses. These licenses utilize the
login name of the user for the local area network which must be the same name that
appears in TECNO.opt file. Refer to section 7.4.1 for instructions on editing the contents of
TECNO.opt.
The license server application which is installed on the license server computer allows the
configuration of the Tecnomatix License Manager. This service must be started in order to
assign and manage licenses. It uses license files that specify all available licenses. It is
not required to run the Tecnomatix License Manager on individual client computers that
operate Tecnomatix applications.

4
 Tecnomatix License Mechanism Installation Instructions

2.3 Node-Locked Licenses

Node-Locked licenses are for use only on local computers that contain Tecnomatix
application installations. These licenses do not require the installation of the license server
application on the local computer.
The license mechanism uses a license file on the local computer that specifies all
available licenses.
When using WIBU dongles, you may move licenses and dongles to a different computer at
any time.

2.4 Computer-Dependent/Mobile Licenses

License files use the computer’s ID to become activated (the ID of the license server
computer for Floating and Named-user licenses, for Node-locked licenses – the ID of the
local computer). The ID can be either computer-dependent or the ID of a mobile WIBU
dongle. When you request your licenses from your local Customer Service Department,
choose one of the following IDs:
• Ethernet ID (“MAC address”) – Computer-dependent ID for standard use.
Changes only when you replace your network card.
• WIBU Dongle ID – WIBU dongles are small plugs which you attach to the USB
port on your computer. Using a WIBU dongle enables you to move the dongle and
the license files to various machines. This is useful for cases when you replace or
reinstall the license server computer, or disconnect it from the network – the
portable dongle allows you to make licenses available again quickly and easily.

2.5 License Borrowing

License borrowing is a function of the FLEXnet license mechanism. This allows users to
check out floating or named-user licenses from a license server computer to a local
computer for a specific period of time. The checked-out licenses are still available on the
local computer after disconnecting from the network.

2.5.1 License Borrowing for FactoryCAD and Teamcenter Manufacturing

License borrowing is available for FactoryCAD and Teamcenter Manufacturing. Both
products use the NX license mechanism. To borrow licenses for FactoryCAD and
Teamcenter Manufacturing, refer to their installation instructions.

2.5.2 License Borrowing for Tecnomatix products

The following Tecnomatix products support license borrowing:
• Plant Simulation
• Process Designer
• Process Simulate
• Human Simulations
• Press Line Simulation
• Machining Line Planner
• RealNC

5
 Tecnomatix License Mechanism Installation Instructions

Support for license borrowing is automatically enabled in version 8 license files and is
automatically available for all customers at no extra cost.
License Borrowing is available for floating and named-user licenses. A borrow license can
be borrowed from a license server computer via a special checkout and used later to run
an application on a client computer that is no longer connected to the license server.
To use license borrowing, enable borrowing in the FLEXlm tools utility on the client
machine. You can specify the expiration date by which borrowed licenses must be
returned. When you run applications, the network stores borrowing information on the
license server and the client computer. The license server notes that the borrowed license
is checked out.
On the client machine, applications automatically use the local borrowing data to perform
checkout during the borrow period.
You can return borrowed licenses before the borrow period expires.
When the borrow period expires or upon the early return of a borrowed license, the local
borrowing data ceases to authorize checkout of the license and the license server system
returns the borrowed license to the pool of available licenses.
No clock synchronization is required between the license server machine and the machine
running the application.
To check out or check in licenses from the server on the client machine:
1. On the client machine, launch the LMTools utility from the Windows Start menu:
Start > Programs > Tecnomatix > License > lmtools.exe.

2. From the Borrowing tab of LMTools, enter the Vendor Name TECNO, specify the
Return Date (and optionally Return Time) and click Set Borrow Expiration. The
licenses will be returned automatically on the specified date.

6
 Tecnomatix License Mechanism Installation Instructions

Note: The Return Date format is dd-mmm-yyyy, for example 15-oct-2011 and the
maximum borrowing period is 120 days.
3. Launch all the applications for which you wish to borrow licenses. For example, for
Plant Simulation it is necessary to open or create a model to allocate a license.
You can close all the applications afterwards.

7
 Tecnomatix License Mechanism Installation Instructions

4. Disconnect from the network. Your computer still holds the licenses that you have
borrowed.
To list all the currently checked out licenses:
From the Borrowing tab of LMTools, click List Currently Borrowed.
You can also view the log file on the license server to verify that licenses have been
checked in.

Note: Always use the newest software versions and patches.

For more information on license borrowing, refer to the Flexnet Licensing End User Guide
(Enduserguide.Pdf), located in the installation directory of the FLEXnet software
(C:\Program Files\Tecnomatix\License by default).

2.5.3 License Borrowing for Robcad

Note: Robcad UNIX does not support license borrowing.
Robcad license borrowing enables you to withdraw a license temporarily from the license
server in order to run Robcad on a PC that is no longer connected to the server, For
example, to run Robcad on a laptop computer at a customer site. License borrowing is
available only when using FlexLM floating or named-user licenses and only when running
Robcad on a PC.
License borrowing is supported by Robcad PC version 8.0 and higher. In order to be able
to use license borrowing you must first install Patch_46_License_Borrowing. For
information on how to use borrowing for Robcad PC, refer to License Borrowing for
Robcad.pdf.
Perform the following on the computer before disconnecting it from the license server.
To borrow a Robcad license:
1. Set the Robcad variable USE_FLEX_BORROWING to On.

8
 Tecnomatix License Mechanism Installation Instructions

Important: USE_FLEX_BORROWING must be set to On both when withdrawing the

license while connected to the license server and when running Robcad with the borrowed
license after disconnecting from the server.
2. From Start > All Programs > Tecnomatix > License > FlexLM Tools, open FlexLM
Tools and select the Borrowing tab.
3. Change the Vendor Name from All to Tecno unless you wish to borrow application
licenses from other vendors in addition to Tecnomatix.
4. Enter the desired Return Date in dd-mmm-yyyy format.
5. Optionally, enter a Return Time in 24-hour format (hh:mm). If Return Time is
unspecified, the license return time will be at the end of the specified return date.
6. Click Set Borrow Expiration.

7. While your computer is still connected to the server, load Robcad and open each of
the features you wish to use after disconnecting from the license server.
For example, if you wish to borrow licenses for the following SPOT menus: Via_locs,
Weld_locs Spot_simulation, and you also require Gun Search from the Toolbox manager,
launch the relevant functions while the computer is connected to the license server via the
network. It is not sufficient to disconnect from the license server and switch to the Spot
menu. Rather, you must first open the required features whilst still connected to the
server.
Some features are automatically borrowed. You do not need to open these features
before disconnecting from the license server as they do not require a special license. The
following is a partial list of these features:
• Workcell menus: Setup, Layout, Query.

9
 Tecnomatix License Mechanism Installation Instructions

• Toolbox Manager: Report Creator, Mechanism Status, View Manager,

Tree, Note Editor, Motion, Placement Editor, Path Editor, Layers,
Attribute Editor, macROSE, Autoplace, Collision Setup.
If you do not know whether a feature possesses automatic borrowing, open it in any case
while still connected to the license server.
8. Close Robcad and disconnect from the license server.
Note: Running Robcad with USE_FLEX_BORROWING set to On causes all Robcad
menus and Toolbox manager icons to be displayed. Therefore, you will see menus that
may not be included in your license file. You will not be able to use these features.
To list all the currently checked out Robcad licenses:
From the Borrowing tab of LMTools, click List Currently Borrowed.
To block borrowing of further licenses:
Click Don't Borrow Anymore Today.
Notes:
• All FlexLM Tools operations can be executed from the command line.
For more information, refer to FlexLM End User Manual.
• The borrowed features remain checked out for the full borrow period.
The borrow period cannot be renewed until the initial period has expired.

2.6 Redundant License Servers

If you use Floating or Named-User licenses, you have the option to operate three
redundant license servers to significantly increase the stability of licenses and their
availability. The redundant servers are three separate computers in the network using the
same license file and TECNO.opt files.
Full redundancy is achieved when at least two of the three computers are operating in the
network, ensuring that all licenses are available.

10
 Tecnomatix License Mechanism Installation Instructions

3. Receiving Your Licenses from Siemens PLM Software

When you install Tecnomatix applications for the first time, proceed as described below.
When you have a valid maintenance contract and a new release of Tecnomatix
applications is available, you will receive the software and new license files (if required)
automatically.

3.1 Installation of the License-Server Application

Logon to the license server computer for which you wish to receive licenses (administrator
privileges required).
• Run the setup program from the DVD
• In the DVD Browser, select Install Tecnomatix License Server

3.2 Obtaining your Machine ID

After installing the license server:
• Select Start > Program Files > Tecnomatix > License > License Setup to
start the license setup application.

11
 Tecnomatix License Mechanism Installation Instructions

• Determine whether the Tecnomatix applications will get the license from
a license file or from a license server. If you select both options, set one
at higher priority.
• Fill in up to three license servers, and/or
• Copy the computer name from the Hostname field and the Ethernet
address from the Ethernet Address field or the ID of your green WIBU
dongle (you can find it printed on the dongle) and paste these in an email
requesting the license files for this computer.
• If you entered both license server(s) and a license file, set the license
method priority:

12
 Tecnomatix License Mechanism Installation Instructions

3.3 Contacting Your local Customer Service Department

• In addition to your machine ID data, add the following information to
your email:
Your Sold-To ID
Names of the Tecnomatix applications in use
Version No.
Number of licenses
License types that you purchased
• Send this email to your local Customer Service Department.
Note: To receive a license for redundant license servers (see section 2.6 “Redundant
License Servers”), include the hostname and Ethernet address/WIBU dongle ID of all
three computers in the email.

3.4 Receiving your Licenses

You will receive an email in return with the license files attached. These files include:
o The License file - TECNOMATIX.lic
o For User-Named licenses - TECNO.opt

If you are working with WIBU dongles, proceed to Section 4. Otherwise proceed to Section 5,
Setting-Up Licenses to continue configuring your licenses.

13
 Tecnomatix License Mechanism Installation Instructions

4. Using WIBU Dongles

Tecnomatix supports dongles by WIBU Systems. Dongles are hardware sticks that
connect to a USB port on your computer and provide an ID number, similar to the
Ethernet-ID/MAC address of computer specific licenses. The dongle works with a standard
license file.
Dongles can be used with node-locked, floating, and named-user licenses.
You can easily move the dongle and the license to a different computer. This is helpful for
mobile users. Additionally, if a machine is replaced, there is no need for a new license file,
just move the dongle and the license file to the new computer.
If the license server goes offline for maintenance purposes, the dongle can be transferred
to a backup computer. In this case, both the primary and the backup license servers must
be listed as license servers in the license setup utility of the client computers.
Dongles are available for the following products:
• Process Designer
• Process Simulate
• Human Simulations
• Press Line Simulation
• Machining Line Planner
• Plant Simulation
• RealNC
WIBU-dongles support 32-bit and 64-bit systems Windows platforms only.
Before using a dongle, install the WIBU drivers on the computer. The required drivers are
available on the Tecnomatix DVD in the Add-Ons\Drivers folder. You require administrator
privileges to install drivers.
After the installation of the WIBU drivers, the WIBU-KEY icon appears in the control panel.
This lists the currently installed WIBU dongles and their ID numbers.
Install the license file as described in the License Installation Instructions document.
If you have not yet installed WIBU drivers on your computer, install version 6.00a:
• Log on with administrator privileges.
• Double-click WkRuntime_6.00a.exe, located in the Add-Ons\Drivers
folder on the Tecnomatix DVD.
• Reboot your computer.
If you have already installed a lower version of the WIBU drivers:
• Perform the same procedure to upgrade your installation.
• Reboot your computer.
To install WIBU dongles on your computer:
• Attach the WIBU dongle to the appropriate port on your computer in the
direction indicated by the arrow on the dongle:
▪ Dongle description WIBU BOX /P or WIBU BOX /RP: parallel port
▪ Dongle description WIBU BOX /SP: serial port
▪ Dongle description WIBU BOX /M: PCMCIA port

14
 Tecnomatix License Mechanism Installation Instructions

▪ Dongle description WIBU BOX /U or WIBU BOX /RU: USB port

If you are using a dongle for the serial port (WIBU BOX /SP) activate the driver
configuration for the port, such as COM1, under Start > Settings > Control Panel >
WIBU-KEY on the Settings tab.

5. Setting-Up Licenses
After you have received license files from your local Customer Service Department, you
should set up the licenses for the products you purchased. The set-up procedure varies
slightly for the different types of licenses: Floating, Named-User and Node-Locked.
Note: If the license file you received has a file extension other than “.LIC”, change the
extension to “.LIC”.

5.1 Floating Licenses

5.1.1 Installation on the License Server Computer

Installation of the Tecnomatix License Manager Application

The Tecnomatix License Manager application must be installed on the license server
computer. If it is not installed, please refer to Section 3.1.
Installation of the License Files
• Copy the license files you received to the Tecnomatix license folder on
the license server computer, for example: C:\Program Files\Tec-
nomatix\License.
Configuring and Running the Tecnomatix License Manager Service
The Tecnomatix License Manager must run on the license server computer in order to
assign and manage licenses. To configure and run the license service, follow the steps
below:
• Select Start > Programs > Tecnomatix > License > FLEXlm Tools and
select Configuration using Services.

15
 Tecnomatix License Mechanism Installation Instructions

• Click the Configuration using Services options and select the Config
Services tab.

• If the path to the files displayed in the dialog is not correct, use the
Browse buttons to navigate to the relevant locations for the lmgrd.exe
and TECNOMATIX.lic files.
• Make sure the Use Services and Start Server at Power Up options are
checked.
• If you changed any of the settings, click Save Service.

16
 Tecnomatix License Mechanism Installation Instructions

• Select the Start/Stop/Reread tab and click Stop Server and then Start
Server.

The Tecnomatix License Manager is now running. You can close the LMTOOLS window.

Installation on Redundant License Servers

To use redundant license servers (see section 2.6 “Redundant License Servers”),
install the Tecnomatix License Manager and the license files, as described above, on
all three license server computers.

5.1.2 Installation on Client Computers

On client computers, the Tecnomatix License Manager is not required. So, you will
proceed as follows:
• Select Start > Programs > Tecnomatix > License > License Setup and
select the License type License Server / Redundant License Server.
• Enter the names of the license server computer(s). By default, the
license mechanism uses the port 27006 to communicate with the license
server computer. Enter a different port in the field Port if required.
• Click OK.

17
 Tecnomatix License Mechanism Installation Instructions

Redundant License Servers

To use redundant license servers (see section 2.6 “Redundant License Servers”),
enter the names of all three license server computers in the License setup application,
as described above and Click OK.

5.2 Named-User Licenses

Installation on the License Server and Client Computer

The installation procedure for Named-User licenses on both the license server and the
client computers is identical to that of the Floating license. Additionally however, on the
license server computer, the TECNO.opt file has to be placed in the same folder as
the TECNOMATIX.lic file, for example: C:\Program Files\Tecnomatix\License
folder.
Refer to Section 7.4.1 to edit the TECNO.opt syntax.

18
 Tecnomatix License Mechanism Installation Instructions

Warning!: If you change the contents of the TECNO.opt file, you must stop and re-start
the license server. If you only re-read the license file (and TECNO.opt), new
licenses/users become unavailable only after 12 hours. We recommend to start/stop the
license service when you replace the license file/options file instead of rereading the
license file. Starting/stopping the license service can be done during daily work, normally
users currently working will not be disturbed.

5.3 Node-Locked Licenses

5.3.1 Installation of the License Files

• Copy the license files you received to the license folder, for example:
C:\Program Files\Tecnomatix\License on the local computer.
• Select Start > Programs > Tecnomatix > License > License Setup and select
the License type License File.
• Make sure the path to the license file is displayed correctly. Click Browse and
select the correct path if necessary.
• Click OK.

5.4 Moving WIBU-Dongle and License Files to Another Computer

Use the following steps when you are using a WIBU dongle and wish to move your
licenses to a different computer:
• Logon to the new computer with administrator privileges.
• Install the WIBU drivers as described in the Using WIBU dongles section
above.
• Copy the license files to the Tecnomatix license folder, for example:
C:\Program Files\Tecnomatix\License, and attach the WIBU dongle to the
relevant port.
• Open the license files (with Notepad or similar text editor) and change the
computer name in the first line of the License file to “THIS_HOST” if it shows a
different name.

Using Floating or Named-User Licenses

• Install the Tecnomatix License Manager as described above.
• Select Start > Programs > Tecnomatix > License > FLEXlm Tools and select
Configuration using Services.
• Select the Start/Stop/Reread tab and click Stop Server and Start Server.

Using Node-Locked Licenses

• Select Start > Programs > Tecnomatix > License > License Setup and select
the License Type License File.
• Click Next and verify that the path to the license file is displayed correctly.
Click Browse and select the correct path if necessary.
• Click OK.

19
 Tecnomatix License Mechanism Installation Instructions

6. Starting the License Server Manager on UNIX Platforms

If any licenses in the license file are counted (license count > 0), the license server
manager, and hence the license server, must be started before the FlexEnabled
application can be used.
The license server manager, lmgrd, is started either manually on the command line or
automatically at system startup. Both methods are discussed in the following sections.
Note: Start lmgrd only on the system specified on the SERVER line in the license file. If
you are running license servers configured for three-server redundancy, maintain an
identical copy of the license file (as well as the lmgrd and the vendor daemons binaries)
locally on each system rather than on a file server. If you do not do this, you lose all the
advantages of having redundant servers, as the file server holding these files becomes a
single point of failure.

6.1 Manual Start

Start lmgrd from the UNIX command line using the following syntax:
lmgrd -c license_file_list -L [+]debug_log_path
where
license_file_list is one or more of the following:
• the full path to a single license file
• a directory, where all files named *.lic in that directory are used
If the license_file_list value contains more than one license file or directory, they must be
separated by colons on
UNIX or semicolons on Windows.
debug_log_path is the full path to the debug log file
Prepending debug_log_path with the + character appends logging entries.
Start lmgrd by a user other than root since processes started by root can introduce
security risks. If lmgrd must be
started by the root user, use the su command to run lmgrd as a non-privileged user:
su username -c "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.

6.2 Automatic Start

On UNIX, edit the appropriate boot script, which may be /etc/rc.boot, /etc/rc.local,
/etc/rc2.d/Sxxx, /sbin/rc2.d/Sxxxx. Include commands similar to the following. See the
following notes for a full explanation.

/bin/su daniel -c 'echo starting lmgrd > \

/home/flexlm/v11/hp700_u9/boot.log'

20
 Tecnomatix License Mechanism Installation Instructions

/bin/nohup /bin/su daniel -c 'umask 022; \

/home/flexlm/v11/hp700_u9/lmgrd -c \
/home/flexlm/v11/hp700_u9/license.dat >> \
/home/flexlm/v11/hp700_u9/boot.log'

/bin/su daniel -c 'echo sleep 5 >> \

/home/flexlm/v11/hp700_u9/boot.log'

/bin/sleep 5
/bin/su daniel -c 'echo lmdiag >>\
/home/flexlm/v11/hp700_u9/boot.log'

/bin/su daniel -c '/home/flexlm/v11/hp700_u9/lmdiag -n -c\

/home/flexlm/v11/hp700_u9/license.dat >> \
/home/flexlm/v11/hp700_u9/boot.log'

/bin/su daniel -c 'echo exiting >>\

/home/flexlm/v11/hp700_u9/boot.log'

Please note the following about how this script was written:
• All paths are specified in full because no paths are assumed at boot time.
• Because no paths are assumed, the vendor daemon must be in the same
directory as lmgrd, or the VENDOR lines in the license file must be edited to
include the full path to the vendor daemon.
• The su command is used to run lmgrd as a non-root user, daniel. It is
recommended that lmgrd not be run as root since it is a security risk to run any
program as root that does not require root permissions. lmgrd does not require
root permissions.
• daniel has a csh login, so all commands executed as daniel must be in csh
syntax. All commands not executed as daniel must be in /bin/sh syntax since
that is what is used by the boot scripts.
• The use of nohup and sleep are required on some operating systems, notably
HP-UX. These are not needed on Solaris and some other operating systems,
but are safe to use on all.
• lmdiag is used as a diagnostic tool to verify that the server is running and
serving licenses.

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

21
 Tecnomatix License Mechanism Installation Instructions

6.3 Supported Linux Platforms

• 32bit
▪ i86_lsb (on x86)
▪ ppc_Isb (on Power PC)

• 64bit
▪ x64_Isb (on x64)
▪ ppc64_Isb (on Power PC)

7. License File Content, Utilities and Diagnostics

7.1 Utilities and Diagnostics

To check the contents of your license file you can:
• Select Start > Program Files > Tecnomatix > License > FLEXlm Tools and
select the Configuration using Services radio button.
• Use the various available options on the Server Status and Server
Diagnostics tabs to perform diagnostic tasks.
• Open a command prompt window and start the lmstat.exe –h program in
the same folder that you installed the licenses (by default, C:\Program
Files\Tecnomatix\License) The program lists the arguments you can use
for analyzing your license file.

7.2 The License File

The TECNOMATIX.lic file contains the following lines:
SERVER <Hostname> <Hostid> 27006
VENDOR TECNO
In addition, all license files contain one or more INCREMENT lines:
INCREMENT <product name> TECNO <version> <validity period> <quantity>
SUPERSEDE ISSUED=<date> NOTICE =”” SIGN=<license key> SIGN2=<license
key>
If you purchased Node-Locked licenses, your License file contains a HOSTID statement in
every INCREMENT line. If the file does not contain a HOSTID statement, your licenses
are either Floating licenses or Named-User licenses.
If you are using a License file that does not expire, the <validity period> has the value
“permanent”. If you are running a trial version, the expiration date has the format <day>-<
month - first 3 characters>-<year>, for example 5-jan-2007.
SIGN=<license key> SIGN2=<license key> are the license keys.

22
 Tecnomatix License Mechanism Installation Instructions

7.3 Steps to Setup Named-User Licenses

7.3.1 Create an Options File

To create an options file, create a simple text document on the license server computer in
the following folder: C:\Program Files\Tecnomatix\License or in the corresponding folder of
your installation. Make sure that the filename is TECNO.opt.

7.3.2 Identify Applications and Features in the License File

To assign applications and features to users, first identify these applications and features
in the license file.
For every product you purchased, there is a line in your license file which starts with the
keyword INCREMENT. If one of these lines contains the keyword USER_BASED, this
license is a named-user license. See the following example:
INCREMENT CAR_PLANTSIM_RESEARCH TECNO 9.0 permanent 5 USER_BASED \
SUPERSEDE DUP_GROUP=UHD user_info="Plant Simulation Research" \
ISSUED=17-07-2006 SIGN="01BF …" SIGN2="02F8 …"
Since every product can consist of several modules each requiring a separate license, we
use license packages for Tecnomatix products – one package for every Tecnomatix
product.
Therefore, every INCREMENT line in the license file contains a PACKAGE name which
defines the module licenses for each Tecnomatix product.
The name after the keyword INCREMENT is the package name for this product (Plant
Simulation Research license in the example below). In many cases, the package name
starts with a “CAR_” prefix for the base application and “FEA_” for optional products.
INCREMENT CAR_PLANTSIM_RESEARCH TECNO 9.0 permanent 5 USER_BASED \
SUPERSEDE DUP_GROUP=UHD user_info="Plant Simulation Research" \
ISSUED=17-07-2006 SIGN="01BF …" SIGN2="02F8 …"
Use this package name to assign users to applications and features in the options file.
The number before the keyword USER_BASED specifies the quantity of licenses acquired
for this product, which is the number of users you can assign to this product.
INCREMENT CAR_PLANTSIM_RESEARCH TECNO 9.0 permanent 5 USER_BASED \
SUPERSEDE DUP_GROUP=UHD user_info="Plant Simulation Research" \
ISSUED=17-07-2006 SIGN="01BF …" SIGN2="02F8 …"
Note that licenses are not available to any users until you assign them to the licenses.
Therefore we recommend checking at the end of the process whether users were actually
assigned to every INCREMENT line in the license file.
Consult your local Customer Service Department for help in identifying which products
belong to which package names.

23
 Tecnomatix License Mechanism Installation Instructions

7.3.3 Identify User Names

The license mechanism uses the local area network login name to identify the user.
Note that the license mechanism is case sensitive. To reveal the login name relevant to
the license mechanism, start the FLEXlm Tools utility from the Windows start menu:
Start > Programs > Tecnomatix > License > FLEXlm Tools
The relevant login name is listed in the “System Settings” tab under “Username”.

7.3.4 Identify Groups of Users

Usually, there are groups of users working with the same applications. Therefore you can
define groups in the options file and assign products to those groups.

7.3.5 Options File Syntax

To assign users (using login names) to products (using package names), use the keyword
INCLUDE in the options file. The syntax is:
INCLUDE <package name> USER <login name1> <login name2> <login name3> …
For example (assuming the login names of the users are BobM, VladimirK and
ManoharM):
INCLUDE CAR_PLANTSIM_RESEARCH USER BobM VladimirK ManoharM
If you would like to define groups, use the keyword GROUP followed by a group name of
your choice, followed by the login names. The syntax is:
GROUP <group name> <login name1> <login name2> <login name3> …
For example:
GROUP SimulationExperts BobM VladimirK ManoharM
Then you can assign products to groups:
INCLUDE CAR_PLANTSIM_RESEARCH GROUP SimulationExperts
Warning: By default, names of users in the GROUP statement are case sensitive. To
treat user names as case insensitive, add the following line to the options file:
GROUPCASEINSENSITIVE ON
Consult the FLEXnet End User Manual document for more details.

7.3.6 Restart License Service

The settings in the options file only take effect after restarting the license service on the
license server computer. To restart the license service:
1. Start the FLEXlm Tools utility from the Windows start menu:
Start > Programs > Tecnomatix > License > FLEXlm Tools
2. From the first tab (Service/License File), select Configuration using Services.
3. From the Start/Stop/Reread tab, click Stop Server and Start Server.

24
 Tecnomatix License Mechanism Installation Instructions

7.3.7 Trouble Shooting

If licenses are not available, write out a logfile on the license server computer.
To create a logfile:
1. Create a simple text document on the license server computer in the folder: C:\Program
Files\Tecnomatix\License or in the corresponding folder of your installation. Make sure
that the file extension is “.log”.
2. Start the FLEXlm Tools utility from the Windows start menu:
Start > Programs > Tecnomatix > License > FLEXlm Tools
3. From the first tab (Service/License File), select Configuration using Services.
4. From the Config Services tab, enter the path to the logfile under Path to the debug log
file.
5. From the Start/Stop/Reread tab, click Stop Server and Start Server.
6. Open the logfile and look for error/warning messages.
For additional information about the FLEXlm license mechanism, consult the FLEXlm End
User Manual in:
Start > Programs > Tecnomatix > License > FLEXlm End User Manual

7.4 Options File Example

7.4.1 File Syntax

The TECNO.opt file manages license allocation of named users according to your
purchase agreement.
For example, if you purchased the following products:
3 Named-user licenses for: Process Designer
2 Named-user licenses for: Line Balancing (Optional)

you may have received licenses for the following modules:

3 licenses of Process Designer (License ID: CAR_PROCESS_DESIGNER)

2 licenses of Line Balancing (License ID: FEA_PD_LINE_BAL)

The above modules allow three users for Process Designer, two of whom can also access
Line Balancing.

25
 Tecnomatix License Mechanism Installation Instructions

The bottom of the TECNO.opt fill (below the double line in this file) contains the following
text for the above combination (without symbols):

GROUP CAR_PROCESS_DESIGNER_users <user1> <user2> <user3>

GROUP FEA_PD_LINE_BAL_users <user1> <user2>
INCLUDE CAR_PROCESS_DESIGNER GROUP CAR_PROCESS_DESIGNER_users
INCLUDE FEA_PD_LINE_BAL GROUP FEA_PD_LINE_BAL_users

Note that <users> of Add-on modules ("FEA_...") are a subset of their own Base modules
("CAR_..."). For example, since the Add-on FEA_PD_LINE_BAL is executed from inside
the Base CAR_PROCESS_DESIGNER, we see that <user1> <user2> are common to the
first two GROUP statements.
Note that the type and number of your purchased modules determine the exact contents
of your TECNOMATIX.lic and TECNO.opt files.

7.4.2 WHAT YOU NEED TO DO!

You should edit the contents at the bottom of TECNO.opt file, replacing “<user1> <user2>“,
etc. with the login names of the employees who will use the modules. For example,
assuming that you have purchased products according to the following plan:

3 Process Designer for Rick Ryan John Dell Bob Rose

2 Line Balancing for Rick Ryan Bob Rose
you edit the contents at the bottom of TECNO.opt file as follows:

3 CAR_PROCESS_DESIGNER for Rick Ryan John Dell Bob Rose

2 FEA_PD_LINE_BAL for Rick Ryan Bob Rose

The final syntax of the TECNO.opt file for the example above should appear as follows:

GROUP CAR_PROCESS DESIGNER_users rickr johnd bobr

GROUP FEA_PD_LINE_BAL_users rickr bobr
INCLUDE CAR_PROCESS_DESIGNER GROUP CAR_PROCESS_DESIGNER_users
INCLUDE FEA_PD_LINE_BAL GROUP FEA_PD_LINE_BAL_users

Warning!: If you change the contents of the TECNO.opt file, you must stop and re-
start the license server. If you only re-read the license file (and TECNO.opt), changes
become unavailable only after 12 hours. We recommend to start/stop the license
service when you replace the license file/options file instead of rereading the license
file. Starting/stopping the license service can be done during daily work, normally
users currently working will not be disturbed.

26