ICE - Dassault Systèmesmedia.3ds.com/.../FlexLM_61_manual_English.pdfChapter 2 Overview 2-1 Chapter 2 Overview ICEM uses a license file found in //lic/license.dat

ICETechnologies

ICEM Licensing

with FLEXlm™ 6.1

General Information and User’s Guide

July 2001

© ICEM Technologies GmbH 2001

Copyright Information

Copyright © 2001 Parametric Technology Corporation. All Rights Reserved.

User and training documentation from Parametric Technology Corporation (PTC) is subject to the copyright laws of the United Statesand other countries and is provided under a license agreement that restricts copying, disclosure, and use of such documentation. PTChereby grants to the licensed user the right to make copies in printed form of this documentation if provided on software media, butonly for internal/personal use and in accordance with the license agreement under which the applicable software is licensed. Any copymade shall include the PTC copyright notice and any other proprietary notice provided by PTC. This documentation may not be dis-closed, transferred, modified, or reduced to any form, including electronic media, or transmitted or made publicly available by anymeans without the prior written consent of PTC and no authorization is granted to make copies for such purposes.

Information described herein is furnished for general information only, is subject to change without notice, and should not be construedas a warranty or commitment by PTC. PTC assumes no responsibility or liability for any errors or inaccuracies that may appear in thisdocument.

The software described in this document is provided under written license agreement, contains valuable trade secrets and proprietaryinformation, and is protected by the copyright laws of the United States and other countries. UNAUTHORIZED USE OF SOFTWAREOR ITS DOCUMENTATION CAN RESULT IN CIVIL DAMAGES AND CRIMINAL PROSECUTION.

Registered Trademarks of Parametric Technology Corporation or a Subsidiary

CADDS, Parametric Technology, Parametric Technology Corporation, Pro/ENGINEER, and Windchill.

Trademarks of Parametric Technology Corporation or a Subsidiary

3DPAINT, Associative Topology Bus, DIVISION, e/ENGINEER, e-Series, Flexible Engineering, ICEM, Import Data Doctor, Informationfor Innovation, I-Series, Pro/DESIGNER, Pro/PHOTORENDER, Pro/PHOTORENDER TEXTURE LIBRARY, Pro/SCAN-TOOLS, Pro/SURFACE, PTC I-Series, Shaping Innovation, Shrinkwrap, The Product Development Company, Virtual Design Environment, Wind-chill e-Catalog, Windchill e-Series, Windchill ProjectLink, DIVISION logo, and ICEM logo.

Third-Party Trademarks

Oracle is a registered trademark of Oracle Corporation. Windows and Windows NT are registered trademarks of Microsoft Corpora-tion. Java and all Java based marks are trademarks or registered trademarks of Sun Microsystems, Inc. Adobe is a registered trade-mark of Adobe Systems. Metaphase is a registered trademark of Metaphase Technology Inc. Unigraphics is a registered trademark ofEDS Corp. I-DEAS is a registered trademark of SDRC. AutoCAD is a registered trademark of Autodesk, Inc. CADAM and CATIA areregistered trademarks of Dassault Systems. IRIX is a registered trademark of Silicon Graphics, Inc. PDGS is a registered trademark ofFord Motor Company. FLEXlm is a registered trademark of GLOBEtrotter Software, Inc. HOOPS graphics system is a proprietary soft-ware product of, and is copyrighted by, Tech Soft America, Inc. All other brand or product names are trademarks or registered trade-marks of their respective holders.

UNITED STATES GOVERNMENT RESTRICTED RIGHTS LEGEND

This document and the software described herein are Commercial Computer Documentation and Software, pursuant to FAR12.212(a)-(b) or DFARS 227.7202-1(a) and 227.7202-3(a), and are provided to the Government under a limited commercial licenseonly. For procurements predating the above clauses, use, duplication, or disclosure by the Government is subject to the restrictions setforth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software Clause at DFARS 252.227-7013 or CommercialComputer Software-Restricted Rights at FAR 52.227-19, as applicable.

Parametric Technology Corporation, 140 Kendrick Street, Needham, Massachusetts 02494 USA2 April 2001

Contents

Contents

Chapter 1 Introduction 1-1

1.1 Licensing Security Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1.2 License Server Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

1.3 FLEXlm Version Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Chapter 2 Overview 2-1

Chapter 3 Obtaining License Information 3-1

Chapter 4 Activating Licensing 4-1

Chapter 5 Installation Verification 5-1

Chapter 6 User’s Guide 6-1

6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.2 Components of ICEM Licensing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.2.1 Borrowing console Licenses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6.2.2 License Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

6.3 License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6.3.1 Example License Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

6.3.2 Modifying the License File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

6.3.3 Alternate License File Path. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

6.4 Customization Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

6.5 Three Server Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

6.6 The License Daemon /<install_path>/lic/lmgrd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6.7 The ICEM Daemon /<install path>/lic/icem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6.8 The License Finder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6.8.1 Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6.8.2 License Finder Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

6.9 Other Utilities in /<install_path>/lic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

6.9.1 autlook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

6.9.2 optdef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6.9.3 lmcksum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6.9.4 lmdiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6.9.5 lmdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

6.9.6 lmhostid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6.9.7 lmremove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

6.9.8 lmreread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

1

Contents

6.9.9 lmstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-14

6.9.10 lmswitchr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-14

6.9.11 lmver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15

6.9.12 S99license (UNIX only). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15

6.10 The License Daemon Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15

Chapter 7 License Management and Error Messages 7-1

7.1 The Program autlook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-1

7.2 The Program optdef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-3

7.3 Sample License Daemon Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-4

7.4 License Daemon Log File Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-7

7.5 Licensing Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-10

2

Chapter 1 Introduction


This document describes ICEM Licensing which is based on FLEXlm licensing software. FLEXlm is a trademark of

Globetrotter Inc. (http://www.globetrotter.com/home.htm). Much of this manual is adopted from the “FLEXlm

End User Manual”

(http://www.globetrotter.com/manual.htm).

The files associated with ICEM Licensing are in the /<install path>/lic directory. On UNIX, a Bill of Materials

for Licensing is found in the file bom_lic in that directory. On Windows, the FLEXlm utility LMUTIL is found in the /

<install path>/bin directory.

Note:All file paths are shown in UNIX format with the forward slash, ”/”, separator. Windows users should convert them to

backslashes, ”\”, for their use. The Windows users should also prefix the file paths with the hard-drive indicator, typi-

cally ”C:”.

1.1 Licensing Security Notice

FLEXlm has reported a potential security risk with running the licensing daemons with super-user privileges. There-

fore, we recommend that the ICEM Licensing utilities are not owned or run by the root user. See chapter Chapter 4

“Activating Licensing”, Seite 1, steps 1 and 7.

1.2 License Server Platforms

The ICEM Licensing daemons for the Alpha, HP, IBM, SGI, Sun, and Windows NT platforms will all be distributed

with releases on any of those platforms. This will allow the license administrator to select which platform to use as the

license server, which in a large network is typically a file server which may not be the same platform type of the ICEM

software. The default installation will be the licensing daemons for the platform being installed.

1.3 FLEXlm Version Notice

ICEM Surf can still operate under FLEXlm 5.12. However, if you want to use the Direct translators ICEM CATIA,

ICEM CADDS, or ICEM Unigraphics either from within ICEM Surf or in standalone mode, you need to have

FLEXlm 6.x running.

For ICEM DDN and its associated products and applications, it is recommended that you install the FLEXlm version

that is distributed together with the DDN software.

1-1


1-2

Chapter 2 Overview

Chapter 2 Overview

ICEM uses a license file found in /<install path>/lic/license.dat (where /<install path> is typically /icem,

this is also the default). The license file defines who can use an application or one of its options, and how many users

may use them concurrently. The license file may contain both counted and uncounted licenses. Counted licenses use

license server daemons to keep track of and limit the number of concurrent users for an option and allow usage of an

option on any machine in the network.

If the license file contains served licenses there will be lines at the beginning of the file which start with the keywords

SERVER and DAEMON. If a SERVER line is present the licensing daemons lmgrd and icem must be run on the

machine named for the served licenses to be usable. If there are three SERVER lines, the daemons must be run on at

least two of the named machines.

If you have served licenses you should go through the steps described in chapter Chapter 4 “Activating Licensing”,

Seite 1.

If there are no SERVER or DAEMON lines in the license file, then you have a non-served license. Non-served

licenses are identified by the number of users "0" in the FEATURE line. Non-served licenses are also referred to as

node-locked licenses since a hostid is required to lock it to a particular machine. The hostid is specified at the end of a

FEATURE line.

A node-locked license may be used only on the machine specified by the hostid. Base licenses are non-served node-

locked licenses. Floating and Additional Access licenses are served licenses. A license file may contain both served

and non-served licenses.

All licenses have an expiration date specified in a FEATURE or INCREMENT line in the format dd-mm-yy or dd-mm-

yyyy, such as 31-dec-99. Licenses which expire in the year 2000 or later must use the second format, such as 31-dec-

2001.

Also, there are demonstration licenses that you can get for testing purposes and demonstrations. Typically a demon-

stration license will have a comment in the first line indicating that it is a demonstration license. A demonstration

license is usually a node-locked non-served license for a specific machine mentioned in the FEATURE lines, but may

also be a served (floating) license for any machine which is served from a machine specified in the SERVER line(s).

The demonstration license has an expiration date in the very near future.

2-1

Chapter 2 Overview

2-2

Chapter 3 Obtaining License Information


Please collect hostname, hostid, operating system name and level, and serial number for each machine that needs a

license for ICEM products. If you have purchased Floating or Additional Access licenses, please note the TCP/IP port

number as well. To collect this information perform the following steps on each machine to be used as a license server.

Then your software distributor can obtain a new license for you before the old license expires. If you have purchased

Base licenses for some products to run only on specific machines, you will also need to supply the hostname, hostid,

operating system name and level, serial number and eventually the TCP/IP port number for each of those machines, if

you have not done so already.

Step 1

Log in as the machine administrator on the machine to be used as a license server.

Step 2

Windows IPX/SPX network driver setup.

This step is necessary when the Windows machine uses an ethernet node-locked license or when it is running the

ICEM Licensing daemons to serve Floating licenses.

• Windows 2000 Workstations

One of either NetBIOS service or NWLink IPX/SPX protocol must be running on the machine for FLEXlm to find

the ethernet number for served or ethernet node-locked licenses on Windows.

Check whether the NetBIOS or the IPX/SPX Interface is installed as follows.

1. Put the Windows NT system disk in the CDROM drive.

2. Select ”Start”

3. Select ”Settings”

4. Select "Control Panel"

5. Select "Network and Dial-up connections"

6. Right-click a local area connection

7. Select "Properties"

8. See whether the NetBIOS or the IPX/SPX Interface is installed

If the NetBIOS or the NWLink IPX/SPX driver is not installed, install it as follows.

1. Select "Install"

2. Mark "Protocol"

3. Select "Add"

4. Select "Net BIOS Interface" or "NWLink IPX SPX driver"

5. Select "OK"

• Windows NT 4.0 Workstations

One of either NetBIOS service or NWLink IPX/SPX protocol must be running on the machine for FLEXlm to find

the ethernet number for served or ethernet node-locked licenses on Windows.

3-1


The NetBIOS Interface is installed as follows.





5. Select "Network"

6. Select "Services"

7. Select "Add"

8. Select "NetBIOS Interface"

The NWLink IPX/SPX driver is installed as follows.





5. Select "Network"

6. Select "Protocol"

7. Select "Add"

8. Select "NWLink IPX SPX driver"

Restart the computer.


1. Put the Windows 95 system disk in the CDROM drive.

2. Select ”Main”

3. Select ”Control Panel”

4. Select ”Network”

5. Select ”Configuration”

6. Select ”Add”

7. Select ”Protocol”

8. Select ”Microsoft”

9. Select ”IPX/SPX Compatible protocol”

10. You will then be prompted to restart the computer.

Step 3

Obtain and record the machine's hostname, hostid and operating system level. It depends on your hardware which

commands will apply.

3-2


• SGI Workstations

1. hostname:

/usr/bsd/hostname or

uname -n

2. hostid:

/<install path>/lic/lmhostid or

echo ‘/etc/sysinfo -s‘ 16o p | dc or

/usr/sbin/lmhostid

On Crimson, Challenge, and Onyx workstations you must use the program lmhostid (after installation of

ICEM Licensing), because the sysinfo command does not deliver unique numbers on these machines.

3. operating system level:

uname -sr

• HP Workstations

1. hostname:

/usr/bsd/hostname or

uname -n

2. hostid:


echo ‘uname -i‘ 16o p | dc

ICEM Licensing no longer supports the ethernet address for license hostid on HP machines.


uname -srv

• IBM Workstations

1. hostid:

/<install path>/lic/lmhostid

2. hostname/hostid/operating system level:

uname -a

Information similar to the following will be displayed:

AIX ibm_1 2 3 000017133700

where

AIX = operating system name

ibm_1 = hostname

2 3 = operating system level 3.2.x

171337 = hostid

(the last two zeros and any zeros before the first non-zero digit will not be used)

3-3


• SUN Workstations

1. hostname:

/usr/ucb/hostname or

uname -n

2. hostid:


hostid


uname -srv

• DEC Alpha Workstations

1. hostname:

/usr/bin/hostname or

uname -n

2. hostid:


pfstat

This machine uses the 12 digit ethernet address as the hostid. The command pfstat delivers several lines of

information. Read the "Interface Address" line to obtain the ethernet address.


uname -srv


1. hostname:

Select ”Start”

Select ”Settings”

Select ”Control Panel”

Select ”Network and Dial-up Connections”

Select the link ”Network Identification”

Select the tab ”Network Identification”

Record the computer name.

2. hostid:

Open a command prompt (MS/DOS) window and enter the following command

/<install path>/BIN/LMUTIL.EXE lmhostid

Record the computer name. If this results in the hostid ”ffffffff”, you must setup the IPX/SPX network driver

(see step 2) and redo the steps 1 and 3 or

/winnt/system32/ipconfig /ALL

Record the ”Physical Address” and ignore the dashes.


3-4


Select ”Start”



Select ”System”

Select the tab ”General”

Record the computer operating system level.

• Windows NT 4.0 Workstations

1. hostname:

Select ”Start”



Select ”Network”


2. hostid:



Record the computer name. If this results in the hostid ”ffffffff”, you must setup the IPX/SPX network driver

(see step 2) and redo the steps 1 and 3 or

/winnt/system32/ipconfig /ALL

Record the ”Physical Address” and ignore the dashes.


Select ”Start”



Select ”System”



• Windows 95

1. hostname:

Select ”Start”



Select ”Network”

Select ”Identification”


2. hostid:



or

3-5


winipcfg

Record the ”Adapter Address” and ignore the dashes.


Select ”Start”



Select ”System”



• Output from lmhostid

The output from lmhostid will be similar to the following (independent of hardware):

lmhostid - Copyright (C) 1989-1998, Globetrotter Software, Inc.

The FLEXlm host ID of this machine is "1200abcd"

Step 4

cat /etc/services

The output from this command will look something like the following:

#

#Network services, Internet style

#

tcpmux 1/tcp #TCP port multiplexer (RFC 1078)

echo 2/tcp

The second field contains the port number (e.g. 1/tcp is for port 1). Check the file for the ICEM Licensing daemon

default port number 1733. (If you have already received a license file the port number assigned is the fourth field on

the SERVER line.) If you do not find the default/assigned port number in the services file then it may be used for

ICEM Licensing. If it is found then any other available port number between 1733 and 6000 may be used. (You may

change the assigned port number in the license file if there is a conflicting entry in the services file. See section 6.3.2

“Modifying the License File”, Seite 4). It is recommended that the same port number be used for all of ICEM Licens-

ing server machines in the network.

It is recommended that the following line be added to the /etc/services file on each server machine in the network

as a place holder for the ICEM Licensing daemon. Substitute the appropriate port number you have selected for the

ICEM Licensing daemon.

icem 1733/tcp #ICEM Licensing daemon port

If you have purchased Floating or Additional Access licenses and are using a UNIX server, obtain and record the TCP/

IP port number to be used by the application to communicate with the licensing daemon on the server machines in

your network. For Windows servers, this step is not necessary, and the default port number of 1733 should be used.

Under UNIX, use the following command to identify port numbers currently being used on the server machine.

Step 5

Please note the serial number of your workstation. It can be found on the rear side of the workstation on a label with a

bar code.

3-6


Step 6

When your ICEM software distributor receives the hostname(s), hostid(s), operating system name(s) and level(s),

TCP/IP port number(s), and serial number(s) a license file can be created.

3-7


3-8

Chapter 4 Activating Licensing


The licensing daemons must be activated on each workstation that is a license server.

Note:If you have FLEXlm type license files from other vendors you may want to combine them. See section “Combining

License Files from Multiple Vendors”, Seite 4 before continuing.

Step 1

Log in on each machine to be used as a license server as the user which owns the directory and files where ICEM

Licensing was installed. For UNIX, this user should not have super-user privileges on any of these machines because

there is a potential security risk with running a non-secure daemon, licensing included, as a privileged user. This

potential security problem is related to the nature of network daemons and not the ICEM software itself. Therefore,

these files should not be owned or run by the root user. If any licensing related files or directories are owned by the

root user change their group to the administrator’s group with the chgrp command and their ownership to the admin-

istrator user with the chown command. This user also needs to belong to the group lmadmin. If this group does not exist

it needs to be created.

Step 2

Change to the directory in which ICEM Licensing was installed.

cd /<install path>/lic

Step 3

If you have previously moved an existing license file to prevent installation from overwriting it, move it back now and

continue with Step 5.

Step 4

If you will be using the license file that was just installed (/<install path>/lic/license.dat), examine it to see if

it requires the licensing daemon. The licensing daemons do not need to be activated for license files which do not con-

tain lines that begin with "SERVER" and "DAEMON". If this is the case, you should skip to chapter Chapter 5 “Instal-

lation Verification”, Seite 1. Otherwise, continue with Step 5.

Step 5

Make sure that the /<install path>/lic/license.dat file is accessible on all machines which will be running

ICEM software. This file must be identical on all machines using the licensing daemons.

Examine whether the server hostname in the second field of the SERVER line is correct. It may be unknown during

license creation; then the name in the license file is "UNKNOWN", "hostname" or something similar. If the server

hostname is not correct, modify the SERVER line and enter the correct hostname (case sensitive).

Step 6

All machines using the ICEM software which are to be served by the licensing daemons must be connected to the net-

work and able to communicate with the server(s). Review the hosts file on each machine using ICEM software and

make sure that all servers are referenced in the file. On UNIX, the host file is in /etc/hosts. On Windows, the host

file is the hosts Domain Name System (DNS) or lmhosts Windows Internet Name Service (WINS) in the directory /

4-1


winnt/system32/drivers/etc. If you are using the network software Domain Name System (DNS) on UNIX, exam-

ine the connection with the server(s) using the command nslookup <hostname>. If you are using the network software

Network Information Service (NIS) on UNIX, examine the connection with the server(s) using the command ypmatch

<hostname> hosts.

If you are using Network File System (NFS) or Network Information Service (NIS) to mount the /<install path>

directory on a server machine you should create a separate local licensing directory, lic, on the server machine itself.

The ICEM Licensing utilities must reside in /<some_path>/lic. This will insure availability of the licensing utilities

in case the machine with the mounted disk goes down. This local directory should not be in the boot directory. Copy

the following files (as applicable) to this lic directory.

You should then edit the license.dat file and change the path to the icem daemon on the DAEMON line (third field)

to use the local lic directory. Subsequent references herein to /<install path> should be substituted with the path to

this local lic directory on the server machine.

On UNIX, the FLEXlm utilities for all UNIX platforms supported by ICEM Licensing have been delivered with this

software. The utilities are found in platform specific sub-directories of the /<install path>/lic directory. The sub-

directories are identified as follows.

By default, the installation process installs the FLEXlm utilities in /<install path>/lic for the platform on which it

is installed. If you are running the FLEXlm utilities from a platform type different from the installed platform, you

will need to copy the utilities from one of these directories to that machine.

Step 7

For UNIX edit the S99license file. If the Licensing files belong to a user other than the root user change the

”user=root” line to reference the owner of the licensing files, for example, user=icem. If the Licensing files belong to

the root user, change the line ”check_user=1” to ”check_user=0”.

S99license lmcksum lmgrd lmreread lmver

icem lmdiag lmhostid lmstat

license.dat lmdown lmremove lmswitchr

Subdirectory Name Platform and Operating System Level

alpha_u3 DEC Alpha OSF1

hp700_u9 HP, HP-UX

i86_n3 Intel, Windows 95/NT/2000

rs6000_u3 IBM, AIX

sgi32_u5 SGI, IRIX 5, IRIX 6

sun4_u5 SUN, SunOS 5 (Solaris)

4-2


Step 8

For Windows, the licensing daemons are installed as part of the application installation process. This process sets up

the server machine to start the daemons as a service each time the machine is restarted.

For UNIX, change the boot files to cause the ICEM Licensing daemons to be started whenever the UNIX server

machine is re-booted. The boot process is platform dependent.

For IRIX, Solaris, Alpha, and HP-UX 10 machines create a symbolic link from S99license to the boot directory.

Use a symbolic link so that when a new copy of the license utility is installed the boot process will automatically use

the latest version.

• IRIX and Solaris Workstations

ln -s /<install path>/lic/S99license /etc/rc2.d/S99license

• Alpha and HP-UX 10 Workstations

ln -s /<install path>/lic/S99license /sbin/rc2.d/S99license

Use a symbolic link so that when a new copy of the license utility is installed the boot process will automatically use

the latest version.

On HP-UX 8 and HP-UX 9 workstations edit the file /etc/rc. Add the following lines before the two last lines.

• HP-UX Workstations

# Startup ICEM Licensing daemons

if [ -x /<install path>/lic/S99license ]

then

/<install path>/lic/S99license start

fi

For AIX add the following lines to the end of the /etc/inittab file.

• AIX Workstations

: Start ICEM License daemons

s99license:2:once:/<install path>/lic/S99license start

Step 9

Activate the license manager.

• UNIX Workstations

cd /<install path>/lic

./S99license start

• Windows Workstations

Restart your computer.

The license daemon lmgrd is started and a log file is created. On UNIX, if a license log existed previously it is

renamed with the current date and time appended, e.g license.log-06-27-98.14:09. On Windows, any previous log

file is overwritten.

Note:The next time the server is booted the license daemon will automatically be started.

4-3


Step 10

Review the license daemon log file.


more /<install path>/lic/license.log


Open a command prompt (MS/DOS) window and enter the following command:

more </winnt/system32/lmgrd.log

Refer to chapter Chapter 6 “User’s Guide”, Seite 1 in the ICEM Licensing Administrator’s Guide for full details on

the license daemon log file.

Note:Each served license checked out and checked in will be recorded in the log file. Over time this can produce a rather

large log file. It is recommended that the license daemon be periodically stopped and restarted to produce a new log

file. Old log files may be discarded. On UNIX, a cron job may be setup to do this on a weekly or monthly basis.

4-4

Chapter 5 Installation Verification


Step 1

Log in to a user’s account which has been set up for using an ICEM application.

Step 2

Enter the following commands to verify that ICEM Licensing has been activated for all purchased ICEM products:


setenv LM_LICENSE_FILE /<install path>/lic/license.dat

/<install path>/lic/autlook | more

For each installed product autlook displays:

1. the number of installed and available licenses,

2. the expiration date,

3. the host ID (if a product is only available on a specified host), and

4. a list of users currently using the product.

See section 7.1 “The Program autlook”, Seite 1 for a full description of autlook.


Open a command prompt (MS/DOS) window and enter the following commands:

cd /<install path>/bin

lmutil lmstat -a -c /<install path>/lic/license.dat

The lmstat utility only displays served licenses. You will need to look at the license file directly to verify non-

served node-locked licenses.

Verify that the products and the number of licenses you have purchased are listed.

5-1


5-2

Chapter 6 User’s Guide

Chapter 6 User’s Guide

6.1 Introduction

The Flexible License Manager (FLEXlm™) is a network-wide floating licensing package that allows a software appli-

cation to be licensed on a concurrent-usage, as well as on a per-computer, basis. With FLEXlm the use of ICEM soft-

ware packages may be restricted to:

• a single specified computer, node-locked Base licenses.

• a specified number of users in a network containing heterogeneous computer systems, Floating or Additional

Access licenses.

• any combination of the above.

When Floating or Additional Access licenses are used FLEXlm requires a pair of daemons to be active on one or three

servers in the network. If no redundancy is required, then these daemons run on one server node. If your network has

only a single file server which contains all user files, there is no advantage in having redundant daemons. If redun-

dancy is desired, FLEXlm allows three server nodes operating as a single “logical” server node. If you have split your

data among two or more server nodes and work is still possible when one of these nodes goes down or off the network,

three server nodes can be employed. Only in very volatile situations or in very large networks should more than one

server node be required. With three server nodes network licensing remains fully functional if at least two of the serv-

ers are running. In either case, an effort should be made to select stable machines as server nodes, not machines that

are frequently rebooted or shut down.

When there are licensing errors, error messages will be output in the window in which the application was executed. A

listing of these messages may be found in section 7.5 “Licensing Error Messages” on page 10.

6.2 Components of ICEM Licensing

The components of ICEM Licensing are located in the /<install path>/lic directory. On UNIX, a complete sum-

mary of these files is given in the bom_lic (Bill of Materials for Licensing) file found in this directory. Some of the

key files in this directory follow.

Note:On Windows, only the lmgrd, icem, and license.dat files are found in this directory. The FLEXlm utilities are con-

tained in the single file lmutil found in the /<install path>/bin directory.

README ICEM Licensing Readme file

S99license ICEM license daemon start/stop procedure

autlook ICEM Program to look at your authorizations

bom_lic License utilities bill of materials

icem ICEM license daemon program

license.dat License file

lmcksum License manager program to checksum the license file

6-1

6.2 Components of ICEM Licensing

A complete description of all the files in the lic directory follows later.

6.2.1 Borrowing console Licenses

In ICEM DDN, non-console display (Xterminal) users normally use Additional Access licenses. When an Additional

Access license is unavailable ICEM DDN automatically checks to see if a corresponding served (Floating) console

license is available. If so, it is checked out.

The ICEM DDN license code distinguishes between node-locked (Base) and served licenses (Floating or Additional

Access). ICEM DDN requires a served license whenever the terminal display is not local to the machine on which

ICEM DDN is running.

6.2.2 License Sharing

ICEM DDN allows license sharing. This feature allows an ICEM DDN user with Floating licenses to share a single

license when multiple ICEM DDN sessions are run on the same workstation at the same display device. That is, with

this option, a user may have an unlimited number of ICEM DDN sessions running at one display and they will be

using only one Floating license for all of them.

There is one restriction with this option. All ICEM DDN users must either turn it on or leave it off. The FLEXlm

licensing daemons do not allow mixing of shared and non-shared licenses. If an attempt is made to run ICEM DDN

sessions simultaneously, with and without License Sharing, the first session accepted by the licensing daemons will

dictate. Users running in the other mode will receive the following error message.

License error 37: Duplicate selection mismatch for this feature

This also means that use of License Sharing is not backward compatible with versions of ICEM DDN before version

3.3.

This option is available on the ICEM DDN command line and as a global setting.

The ICEM DDN command line invocation is done by using the License Sharing option ls on the command line. For

example

icemddn tt ls

The global invocation is via a license_sharing file in $ICEM_ACN/lic, as in

/<install path>/lic/license_sharing

lmdiag License manager program to diagnose license problems

lmdown License manager program to bring license daemons down

lmgrd License manager daemon program

lmhostid License manager hostid generation program

lmremove License manager program to remove a single user’s license for a product

lmreread License manager program to update the license daemon on the fly

lmstat License manager program to report license usage statistics

lmswitchr License manager program to switch the license reporting log file

lmver License manager program to display the FLEXlm version of an executable

6-2

6.3 License File

If this file exists, license sharing will be used by all ICEM DDN sessions. When this file exists there is no way to turn

off License Sharing. This file is a convenient way to make License Sharing globally available to a user base once all

users are converted from versions of ICEM DDN before version 3.3.

6.3 License File

The license file contains descriptions of the server nodes that run your license daemon, your ICEM daemon, and the

specific ICEM products you have purchased. The following is an example license file. It is fully explained below.

# Example ICEM 3.4 license file

SERVER garfield 69062932 1733

DAEMON icem /icem/lic/icem

FEATURE DD icem 3.400 31-jul-2000 0 9B0C2471CB995C24AD5E "Design Drafting" \

690717c7

FEATURE DD icem 3.400 31-dec-2000 2 5B5C543BDD1B41A02649 "Design Drafting"

FEATURE DDX icem 3.400 31-dec-2000 2 0BCC040BE0E683D59F73 "Design Drafting"

FEATURE AD icem 3.400 31-jul-2000 0 8B6C24A12806FDE87C0B "Curves and Surfaces" \

690717c7

FEATURE AD icem 3.400 31-dec-2000 2 4BFCC4FBEC89A970BAAA "Curves and Surfaces"

FEATURE ADX icem 3.400 31-dec-2000 2 6B3C341BBAB8FBA4833E "Curves and Surfaces"

FEATURE NRB icem 3.400 31-dec-2000 2 AB8C849B1A5678EAACB9 "NURBS Geometries"

FEATURE NRBX icem 3.400 31-dec-2000 2 8B4C447182F39D557ED8 "NURBS Geometries"

FEATURE IGE icem 3.400 31-dec-2000 2 8B5C443BB6C90C37F8F2 "IGES Interface"

FEATURE TVD icem 3.400 31-dec-2000 2 DBDC54BBD9179DC9FE24 "VDA/FS Interface"

6.3.1 Example License Summary

The example license is an ICEM 3.4 license file. It contains both served and non-served licenses. The license daemons

must be run on the machine garfield with the hostid 69062932. The applications will communicate with the license

daemons over port number 1733. There is one license daemon defined, icem, which is located in file /icem/lic/icem.

There is no FLEXlm daemon options file. The ”\” denotes continuation to FLEXlm and the remaining license data is

continued on the next line.

Node-locked licenses ("non-served")

Machine-specific licenses are node-locked and are usually non-served licenses, because they have a user count of

zero. This indicates that an unlimited number of users may use this license. Therefore, the license daemons do not

manage the use of licenses with zero users. There are two non-served licenses in the sample license file above, one for

DD and one for AD. These may be used through July 31, 2000 and may only be used on machine 690717c7.

Network licenses ("served"; "Floating" or "Additional Access")

Served licenses are also called network licenses, because the license may be used by anyone in the network. The

license daemon keeps a count of the number of served licenses in use and distributes available licenses to the users in

the network. There are eight served licenses (features) in the sample license file above for DD, DDX, AD, ADX,

NRB, NRBX, IGE, and TVD. Each allows two concurrent users on any machine in the network. These licenses may

be used through December 31, 2000.

6-3

6.3 License File

These licenses are subdivided into floating (console) licenses and Additional Access (non-console) licenses. The

DDX, ADX, and NURBX features may be used by non-console (typically X-Terminal) users. These Additional

Access licenses can be recognized because they have an "X" after the feature identifier. The served DD, AD, NRB,

IGE, and TVD features are for console use but may also be used by non-console users, if they are not already being

used.

6.3.2 Modifying the License File

The license file may be modified if necessary. There are only five items which can be modified in the lines of the

license file (they are described in more detail below):

• the server host name on the SERVER line may be changed

• the order of the SERVER lines may be rearranged (to designate the preferred master and primary backup)

• the port number on the SERVER line(s) may be changed

• the path to the ICEM daemon on the DAEMON line may be changed

• a daemon options file may be added to the DAEMON line

Combining License Files from Multiple Vendors

Note:Do not combine license files for any vendor products which use FLEXlm versions prior to FLEXlm version 2.4.

You may combine FLEXlm type license files if they use the same set of server nodes. To combine them copy the

license files into one file and then remove the extra SERVER lines leaving just one unique set of SERVER lines. Since

the other vendors probably use a different location for their license file you will have to either select one location to

store the combined file or copy it to the default location of each vendor. It is recommended that a neutral location be

selected and that the licensing files from all vendors be copied there. This will require changing the DAEMON line in

the license file to point to the new location where the vendor daemon may be found. It is recommended that the high-

est version of the FLEXlm license manager daemon, lmgrd, and its utilities (e.g. lmhostid and so on) be used to man-

age combined licenses. You can determine the version of the various lmgrd and utilities files you have by running the

following commands.

<install_path>/lic/lmgrd -v

<install_path>/lic/lmhostid -v

etc.

Whenever you receive a new version of vendor software using FLEXlm licensing you should run the above commands

to see whether the new FLEXlm daemon and utilities should be used in place of the current ones.

For ICEM products, if a location other than /icem/lic is used for the licensing files then the LM_LICENSE_FILE envi-

ronment variable will need to be set for the users (see below) in the system login file.

On UNIX, only one boot procedure (see S99license below) should be installed in the system boot directory/file. You

will need to review the various vendor boot procedures and determine which one best suits your needs.

COMMENT Lines

Lines beginning with "#" are considered comment lines and ignored.

6-4

6.3 License File

SERVER Lines

SERVER lines identify which servers are required to use served licenses. They only exist in the license file when it

contains served licenses. A SERVER line consists of 4 fields; keyword, host name, hostid, and port number. There will

be one or three server lines. They may not be deleted when served licenses are present in the license file. The server

host name field may be changed. It must be correct for the machine identified in the hostid field. The order of the

SERVER lines may be rearranged to indicate priority for selecting the master server. The hostid is hardware depen-

dent. On some machines it may be the ethernet address. In general, it is the number received via the utility /<install

path>/lic/lmhostid. The port number may be changed, it should be the same on all SERVER lines.

USE_SERVER Lines

The USE_SERVER line tells the client application to retrieve all subsequent license information from the license dae-

mon. The remainder of the license file is ignored. A SERVER line must precede the USE_SERVER line in the license

file. This method is recommended when licenses are distributed across many machines. When this method is used

only the server license needs to be updated when changes occur.

DAEMON Line

The DAEMON line identifies information about the icem licensing daemon. It only exists in the license file when it

contains a SERVER line. A DAEMON line consists of 4 fields; keyword, daemon name, daemon path, and an optional

FLEXlm daemon options file path. Only the path to the ICEM daemon may be changed if the icem daemon is located

somewhere other than that given. That is, if /<install path> is not /icem, then this field probably needs to be

changed. A daemon options file, field 4, may be added to the DAEMON line.

See the Customization Options section below for use of the daemon options file. More than one DAEMON line may

exist in the license file if all daemons use the same servers.

FEATURE Lines

FEATURE lines identify the features, or products, which are licensed to be used by you. A FEATURE line may con-

sist of two formats, as follows.

FEATURE feature daemon version expiration_date number_of_users ..

encryption_key "description" [hostid]

or

FEATURE feature daemon version expiration_date number_of_users \

encryption_key [VENDOR_STRING="description"] [HOSTID=hostid] \

[OVERDRAFT=nnn]

There may be an unlimited number of feature lines. None of the fields may be changed. The feature name identifies

the product for which you are licensed. The daemon name identifies the vendor daemon to contact when checking out

a served license. The version identifies the highest level version of the product which may be used with this license.

The expiration date allows usage of the product through the date shown. The number of allowed users identifies how

many users may use the product concurrently. The licensing daemons keep track of this information. If the number of

allowed users is zero, then the license is a non-served license and any number of users may use the product on the

machine specified in the hostid field. The encryption field incorporates all of the SERVER, DAEMON, and FEA-

TURE information (except that which may be changed as described above) to prevent misuse of the license. The

description field contains the feature description and sometimes customer information. The hostid field may or may

not be present. If it is present then the license may be used only on that machine. If it is not present, the license may be

6-5

6.3 License File

used on any machine. Base licenses are node-locked. On Floating and Additional Access licenses the hostid field will

not be present. This means the license may be used on any machine which is connected to a server which is mentioned

in the SERVER line and has this license file installed.

INCREMENT Lines

INCREMENT lines identify additions to licensed features which are defined in the license file. They are issued to

increase the number of users of a FEATURE for a limited period of time. They are only effective when the corre-

sponding FEATURE or UPGRADE line already exists in the license file. The syntax for an INCREMENT line is iden-

tical to that of a FEATURE line.

6.3.3 Alternate License File Path

The default license file path is /<install path>/lic/license.dat for ICEM Licensing. This name can be overrid-

den by setting the environment variable LM_LICENSE_FILE to the pathname of the license file, either on the client

machines, on the server machines, or both:


setenv LM_LICENSE_FILE [:<port@host>][:<port@host2>]<license_file_path>[:<license_file_path2>]

where:

– <port@host>

Port number and host where to obtain license file information from the license manager daemon.

– <port@host2>

Alternative port number and host where to obtain license file information from the license manager daemon.

– <license_file_path>

Full path to the license file.

– <license_file_path2>

Full path to an alternative license file.

Note:

The information <port@host> must be the first information in a row of several location specifiers. It can be followed

by an arbitrary number of other <port@host> or <license_file_path> specifiers. There must be at least one location

specifier that points to a valid license file or license manager daemon. Examples:

setenv LM_LICENSE_FILE /icem/lic/license.dat or

setenv LM_LICENSE_FILE /icem/lic/license.dat /home/joe/license.dat or

setenv LM_LICENSE_FILE 1733@james:/icem/lic/license.dat or

setenv LM_LICENSE_FILE 1733@james:1733@beluga:/icem/lic/license.dat

The ":" (colon) separated location specifier list may be used when multiple vendor license files are used.


Set the LM_LICENSE_FILE environment variable in the System Properties option of the Control Panel. Use the same

syntax as for the ”UNIX Workstations” above, except that the file separator for Windows is a ”;” (semi colon)

rather than a colon.

6-6

6.4 Customization Options

Note:Most FLEXlm utilities will accept a "-c <license_file>" option to specify a different license file location.

Note:Using the "port@host" method of retrieving the license file information will add to network traffic and may cause

some application startup delay on heavily used networks or if the license file exceeds 250 lines. License information

will be retrieved only once per session.

6.4 Customization Options

You have two customization options. You can create individual user options files, or a daemon options file for any

ICEM application.

For ICEM DDN you can create an options file, icemopt_310. This file limits the options checcked out at startup of

ICEM DDN to the options defined in the file. The program which creates and maintains this binary file is optdef. See

section 7.2 “The Program optdef” on page 3 for a full description of optdef.

ICEM DDN tries to locate the file icemopt_310 in the following order:

1. ICEM DDN will check for an environment variable ICEMOPT_310. If it finds this environment variable it will use

the path contained in the variable as the path of the icemopt_310 file.

2. Next, ICEM DDN will check for a user’s icemopt_310 file in modals/icemopt_310 in the current working direc-

tory.

3. Then, ICEM DDN will check for a default icemopt_310 file in $ICEM_ACN/ddn/modals/icemopt_310 where

$ICEM_ACN defaults to /icem when not defined.

You can also customize the use of the ICEM software via the daemon options file supported by FLEXlm. This options

file should not be confused with the icemopt_310 file described above. These two files are completely separate and

distinct.

The daemon options file allows you to reserve licenses for specified users or groups of users, to allow or disallow use

of the software to certain people, and to log activity. This file is created on site by your ICEM Licensing administrator.

Note:Without a daemon options file, anyone having access to your license file can use your licenses.

This file may contain the following options.

EXCLUDE allows you to exclude certain users use of the ICEM software.

EXCLUDEALL allows you to exclude certain users use of all ICEM software.

GROUP allows the specification of a group of users for use in the other commands.

HOST_GROUP allows the specification of a group of hosts for use in the other commands.

INCLUDE allows you to specify a list of users who are allowed access to the ICEM software.

INCLUDEALL allows you to specify a list of users who are allowed access to all ICEM software.

LINGER causes the vendor daemon to hold specified licenses for the user for a certain period of time after the they check them in.

NOLOG causes messages of the specified type to be filtered out of the daemon’s log output.

6-7

6.5 Three Server Configurations

In order to use the daemon options capability, you create a daemon options file and list its pathname as the fourth field

on the "DAEMON" line in the license file.

A daemon options file consists of lines in the following format:

EXCLUDE feature {USER | HOST | DISPLAY | GROUP} name

EXCLUDEALL {USER | HOST | DISPLAY | GROUP} name

GROUP groupname <list_of_users>

HOST_GROUP groupname <list_of_host_names>

INCLUDE feature {USER | HOST | DISPLAY | GROUP} name

INCLUDEALL {USER | HOST | DISPLAY | GROUP} name

LINGER feature interval_seconds

NOLOG {IN | OUT | DENIED | QUEUED}

REPORTLOG [+]file

RESERVE number feature {USER | HOST | DISPLAY | GROUP} name

Lines beginning with the character ’#’ are ignored, and can be used as comments. All entries in the daemon options file

are case sensitive. FLEXlm 2.4 limits line length to 200 characters. FLEXlm 4.1 limits line length to 2048 characters

and recognizes the "\" continuation character.

If the filename in the REPORTLOG line starts with a ’+’ character, the old report log file will be opened for append,

otherwise it will be overwritten.

For example, the following options file would reserve a copy of feature "NC" for user pat, a copy for user lee, and

three copies for anyone on a computer with the hostname terry. In addition, user joe would not be allowed to use the

"NC" feature:

RESERVE 1 NC USER pat

RESERVE 1 NC USER lee

RESERVE 3 NC HOST terry

EXCLUDE NC USER joe

If this data were in file /<install path>/lic/local.options, then you would modify the license file DAEMON line

to add a fourth field as follows:

DAEMON icem /<install path>/lic/icem /<install path>/lic/local.options

6.5 Three Server Configurations

When three server nodes are used one node becomes the master node, and the other two are backups. Generally, the

first server listed in the license file will be chosen as the master node when the servers are started. If there is a delay in

starting the first server node, or slow communications occur, it is possible that the second node will be chosen. Once a

master server is chosen it will remain the master unless it is shutdown or the system crashes. When the master server

is shutdown then the remaining servers determine if there is a quorum, and if so, normally the second server listed in

the license file will become the master server. Generally, this takes place within just a few moments. Occasionally,

REPORTLOG specifies that a logfile be written.

RESERVE insures that the ICEM application software will always be available to one or more users or on one or more host computer systems.

6-8

6.6 The License Daemon /<install_path>/lic/lmgrd

with a system crash, the remaining servers may not be aware of the loss of the master server for several minutes. Quo-

rum may take up to ten minutes to be re-established, but normally it is much quikker. Licenses may continue to be

checked out and in as long as at least two servers are running.

The order of the SERVER lines may be rearranged in the license file to take advantage of a more stable or higher per-

formance machine to be the master server.

Generally, the licensing daemons have little impact on network performance. The general load factor of the network

does, however, influence the licensing performance. On a highly loaded network, there may be delays in application

initialization, during license checkout, and listing license status (e. g. ICEM DDN menu f.1.17.5.1 or autlook).

6.6 The License Daemon /<install_path>/lic/lmgrd

Note:On UNIX, the license daemon is normally started by S99license (see below).

The license daemon lmgrd is a standard component of FLEXlm. It is the daemon process that sends client processes to

the ICEM daemon on the correct machine. This daemon does not dispense licenses; i. e., it processes no user requests

on its own, but forwards these requests to the icem daemon. The license daemon allows you to set the license file loca-

tion and the server-to-server connection timeout interval. These options are set by command line arguments when

starting lmgrd.

The command line for lmgrd is:

lmgrd [-app] [-2] [-p -2] [-c <license>] [-t <timeout>] [-s <interval>]

[-l <logfile>] [-x lmdown | lmremove] [-v] [-z]

where:

-app Windows only. Run lmgrd in a command prompt (MS-DOS) window. To shut down lmgrd, you will need to run lmdown in a second command prompt window.

-2 Use the FLEXlm v2.4 startup arguments.

-p -2 Restricts usage of lmdown, lmreread and lmremove to a FLEXlm administrator who is by default root if user lmadmin does not exist. Requires "-2" option.

-c <license> Is the pathname to the license file.

-t <timeout> Is the interval (in seconds) during which daemons must complete connections to each other. The default value is ten seconds. A longer value may be desirable if the daemons are being run on busy systems and/or a very heavily loaded network. S99license default is 15 seconds.

-s <interval> Is the logfile stamp interval, in minutes. The default is 360 minutes.

-l <logfile> Is the file where the output log is to be written. The default is standard output.

-x lmdown Disable lmdown command. Will require kill command to stop the licensing daemons.

-x lmremove Disable lmremove command. Will require stopping the licensing daemons to free licenses being held by non-existing processes.

-v Display FLEXlm version of lmgrd and exit.

-z Run lmgrd in foreground. Default at v4.1 is to run lmgrd in the background.

6-9

6.7 The ICEM Daemon /<install path>/lic/icem

6.7 The ICEM Daemon /<install path>/lic/icem

This is the daemon that dispenses licenses for requested ICEM products. It contains the ICEM Systems private

encryption code. It is started by the lmgrd daemon. This daemon is also called the "vendor daemon".

6.8 The License Finder

The license manager daemon, lmgrd, may also be run as a license finder. The license finder provides one interface to

access the license files. Rather than setup the LM_LICENSE_FILE environment variable for each user, the finder will tell

the application where to find the license files. This is particularly useful when the you want to use the "port@host"

method of retrieving the license file information rather than distributing new license files to each machine or setting

LM_LICENSE_FILE for each user.

Note:Using the license finder and the "port@host" method of retrieving the license file information will add to network traf-

fic and may cause some application startup delay on heavily used networks or if the license file exceeds 250 lines. The

finder will be contacted only once per session and license information will be retrieved once per session.

The following is the order of priority, in descending order, for finding the license file.

• Force usage of the license finder via existence of the environment variable FLEXLM_USE_FINDER. The variable's

content is irrelevant.

• Force license file search path via license file list in environment variable LM_LICENSE_FILE.

• Check /etc/hosts file for flexlm license finder aliases (see below) and if found attempt to contact the license

finder.

• If environment variable ICEM_ACN exists, use $ICEM_ACN/lic/license.dat for path to license file.

• Use /icem/lic/license.dat for path to license file.

6.8.1 Setup

By default, FLEXlm uses the "official" FLEXlm port number of 744 to connect to the license finder on the finder

server(s). If you do not want the finder running under root you will need to specify an alternate FLEXlm port number

above 1024 in the /etc/services file. You will need to add this entry in the /etc/services file on each finder server

and each machine contacting the finder server(s). If, for example, you were to select port 1734 instead, the

/etc/services entry on the finder server would look like the following.

FLEXlm 1734/tcp #FLEXlm license finder port

The finder server machine(s) may be different from the ICEM Licensing server machines.

Alias names must be added to the /etc/hosts file on each of the machines which will try to contact a finder server(s).

The alias names are:

flexlm_license_finder flexlm_license_finder2 flexlm_license_finder3

These names will be searched for in the above order. The application will contact the finder server and attempt to con-

nect to the finder.

6-10

6.9 Other Utilities in /<install_path>/lic

6.8.2 License Finder Usage

The command line for running lmgrd as a license finder is:

lmgrd -f <finder_file>

where:

The finder file format is:

DATA lfpath

<license_file_path1>[:<license_file_path2>][:<port@host>]

where:


The following files are provided by FLEXlm and ICEM Systems GmbH for various purposes.

Note:On Windows, the FLEXlm utilities are all combined into the single file lmutil, which is found in the /<install

path>/bin directory. To execute the FLEXlm commands described below, precede each command with the command

lmutil, for example:

lmutil lmhostid

6.9.1 autlook

The autlook utility can be used to obtain license options information. It displays the number of installed and available

licenses, the expiration date, the hostid if a license is only available on a specified host, a list of users and the number

of licenses held by the user. Refer to section 7.1 “The Program autlook” on page 1 for more information on the aut-

look program.

-f <finder_file> Specifies the path to license finder data file.

lfpath Finder keyword

<license_file_path1> Full path to the license file

<port@host> Port number and host where to obtain license file information from the license manager daemon

6-11


6.9.2 optdef

The program optdef can be used to define license option requirements for ICEM 3.4 Design/Drafting sessions. When

starting ICEM 3.4 Design/Drafting it will, by default, attempt to request all ICEM 3.4 modules. An option will be

available if you have purchased at least one license for it. By running the program optdef you can define a set of

license options and ICEM 3.4 Design/Drafting will only request this set of license options. See section 7.1 “The Pro-

gram autlook” on page 1 for a complete description of optdef.

6.9.3 lmcksum

The lmcksum utility does a FLEXlm context specific checksum of the license file. This is useful for checking the accu-

racy of distributed or modified license files against the one delivered.

lmcksum -c <license_file>

where:

6.9.4 lmdiag

The lmdiag utility allows you to diagnose problems when you can not checkout a license.

lmdiag -c <license_file> <feature>

where:

The <feature> is the name found in the field immediately after the FEATURE or INCREMENT keyword on FEA-

TURE or INCREMENT lines.

6.9.5 lmdown

Note:The lmdown utility is normally run by S99license (see below).

The lmdown utility allows for the graceful shutdown of all license daemons (both /<install path>/lic/lmgrd and /

<install path>/lic/icem) on all nodes.

lmdown -c <license_file>

where:

-c <license_file> Use specified license file.


<feature> Name of feature to diagnose.


6-12


You should protect the execution of lmdown, since shutting down the servers will cause loss of licenses.

6.9.6 lmhostid

The lmhostid program is used to print the correct host ID value on any machine supported by FLEXlm. FLEXlm uses

different machine identifications for different machine architectures. The output from lmhostid will be similar to the

following:

lmhostid - Copyright (C) 1989-1998 Globetrotter Software, Inc.

The FLEXlm host ID of this machine is "6907b241"

6.9.7 lmremove

The lmremove utility allows you to remove a single user’s license for a specified product. This could be required in the

case where a licensed user was running software on a node that subsequently crashed. This situation will sometimes

cause the license to remain unusable. lmremove will allow the license to return to the pool of licenses.

lmremove -c <license_file> <feature> <user> <host> <display>

where:

lmremove removes all instances of user on node host on display from usage of feature (product). You should protect

the execution of lmremove since removing a user’s license can be disruptive.

6.9.8 lmreread

The lmreread utility causes the license daemon to reread the license file. It is a signal to the ICEM daemon to reread

the license file for changes in feature (product) licensing information.

lmreread -c <license_file>

lmreread cannot be used to change server node names or port numbers.

Note:The license file specified on the lmreread command line is only used by lmreread to obtain the port number for con-

tacting the licensing daemons. The daemons will read from the license file path given at startup, not the license file

specified on this command line.


<feature> name of feature to remove

<user> name of user to remove feature from

<host> name of host where user is found

<display> name of display on host

6-13


6.9.9 lmstat

Note:The ICEM autlook utility provides a similar function displaying all information about current users.

License administration is simplified by the lmstat utility. It allows you to instantly monitor the status of all network

licensing activities and license management operations, including:

• which daemons are running

• users of individual products

• users of products served by the ICEM daemon

lmstat [-a] [-S [icem]] [-f [<feature>]] [-s [<server>]] \

[-t <value>] [-c <license_file>] \

[-A] [-l [<regular expression>]]

where:

6.9.10 lmswitchr

The lmswitchr utility switches the log file name for the report log

lmswitchr -c <license_file> <feature> <new_log_file>

where:

You should protect the execution of lmswitchr since it should only be used for administrative purposes.

-a displays everything

-S lists all users of the ICEM daemon’s (icem) features

-f <feature> lists users of feature(s)

-s <server> displays status of server node(s)

-t <value> sets lmstat timeout to "value"

-c <license_file> use specified license file

-A lists all active licenses

-l <regular expression> lists users of license(s) matching the regular expres-sion

-c <license_file> use specified license file

<feature> feature name to switch reporting on

<new_log_file> path to new report log file

6-14

6.10 The License Daemon Log File

6.9.11 lmver

The lmver utility displays the FLEXlm version of the libraries used when an executable was built.

lmver <filename>

where:

6.9.12 S99license (UNIX only)

The S99license utility is a startup script. If it is installed under a directory which is executed when the machine boots,

it starts the license daemon at boot time. S99license may also be used to manually shutdown and restart the license

daemon and ICEM daemon on a single server.

• S99license start

• S99license stop

• S99license down

Where start starts the ICEM license daemons on the current machine, stop stops (kills) the ICEM license daemons

only on the current machine. The down option shuts down the ICEM daemons on all machines in the network.

Be sure that S99license is always used with a valid license file path. We recommend naming the license file /

<install path>/lic/license.dat. If you want to use a different license file location, use the environment variable

LM_LICENSE_FILE to override the default location of the license file:

setenv LM_LICENSE_FILE <license_file_path>

where:

The startup script will automatically create a log file in /<install path>/lic/license.log each time it starts up the

daemon. If a license log file already exists at that location it will be moved to a name which includes the date and time

when moved. These backed up log files may be deleted when they are no longer of use.


The daemons all generate log files in the following format.

mm/dd hh:mm (<DAEMON NAME>) message

where:

<filename> name of executable to check

<license_file_path> is the full pathname to a copy of the license file

mm/dd hh:mm is the time that the message was logged

6-15


Log files can be used to:

• inform users of daemon status

• diagnose configuration problems

• diagnose daemon software errors

A sample license daemon log file is located in section 7.3 “Sample License Daemon Log File” on page 4. License dae-

mon messages are described in section 7.4 “License Daemon Log File Messages” on page 7.

<DAEMON NAME> is either the license daemon lmgrd or the ICEM daemon icem

message is the text of the message

6-16

Chapter 7 License Management and Error Messages

Chapter 7 License Management and Error Messages

7.1 The Program autlook

The program autlook can be used to get license options information. It displays the number of installed and available

licenses, the expiration date, the hostid if a license is only available on a specified host, a list of users and the number

of licenses held by the user.

Setup the autlook command execution as follows:

• UNIX command window:

setenv LM_LICENSE_FILE /<install_path>/lic/license.dat

/<install_path>/lic/autlook | more

• Windows MS-DOS command window:

set LM_LICENSE_FILE \<install_path>\lic\license.dat

\<install_path>\lic\autlook | more

The autlook output is organized by product number. The output for each product number is in three sections:

The #Lic. User, User Name, and Host Name are repeated for each license checked out for this product.

When started the program autlook gives the following kind of display:

For ICEM 3.4, the following options are installed/available at this time:

Product Description Installed\X Available\X

#Licenses Exp.-date Host ID

#Lic. User User name Host name

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

DD DESIGN/DRAFTING unlimited\2 2\1

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

Column Name Description

ProductDescriptionInstalled \XAvailable \X

Product numberSelf explanatoryTotal number of Console/Additional Access licenses you have installed for this productTotal number of Console/Additional Access licenses you have available to be used on this machine at this moment, e. g. not being used by someone

#LicensesExp. DateHost ID

Number of licenses installed by machineExpiration date for these licensesThe machine ID on which this license may be used. If "network" is displayed, it is a floating license which is usable on any machine in the network.

#Lic. User

User NameHost Name

Number of licenses for this product used by a particular user on a particular machine (always 1, multiple occurrences of the same user are listed multiple times)User name of user using product on a particular machineHost id of the machine on which the product is being used

7-1

7.1 The Program autlook

3 31-dec-2000 network

unlimited 31-dec-2000 9ee11504

2 31-dec-2000 xterm

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

1 abc mach01

1 xyz mach02

AD CURVES AND SURFACES unlimited 1

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



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

1 abc mach01

1 xyz mach02

NRB NURBS GEOMETRY unlimited 0

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


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

*** no user information ***

NC NC BASIC 1 1

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


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

*** no user information ***

The above example indicates that for Design/Drafting (DD) there are an unlimited number of Console licenses and 2

Additional Access licenses installed. Of these, 2 Console and 1 Additional Access licenses are available to this

machine at this time. There are three DD license entries in the license file which provide these licenses. The first entry

is a Floating (network) option, which licenses 3 console users on any machine in the network. The second is a Base

(node-locked, non-served) option which licenses an unlimited number of console users on machine 9ee11504. We

know it is a Base option because it licenses an unlimited number of users. The last entry is an Additional Access

(xterm) option which licenses 2 non-console users on any machine in the network. The counted licenses require use of

the licensing daemons. Currently, of the 2 licenses checked out, 1 is a Floating license and 1 is an Additional Access

license. There are 3 licenses available to this machine at this time, 2 Floating and 1 Additional Access. Actually,

because they are Floating and Additional Access options, they are available to any machine in this network. We know

the current machine is not 9ee11504, otherwise the number of Console licenses available to it would be shown as

unlimited. Because the 9ee11504 licenses are not served, we cannot know if anyone is using them. The ICEM daemon

keeps track of the licenses checked out and reports them to autlook. The two licenses are held by users abc on mach01

and xyz on mach02. We do not know from this information which is the console user and which is the Additional

Access user.

For Curves and Surfaces (AD) there are an unlimited number of Console licenses installed. Of these, 1 is available on

this machine at this time. There are no Additional Access licenses installed. There are two AD entries in the license

file which provide these licenses. The first entry is a Floating option, which licenses 3 console users. The second is a

Base option which licenses an unlimited number of console users on machine 9ee11504. Currently, of the 2 licenses

checked out, one is being used by a console user, the other by a non-console user. We know this from the DD licenses

above. Additional Access users may "borrow" available Floating licenses when an Additional Access license is

unavailable. Base licenses may not be "borrowed" by Additional Access users. They may only be used at the console.

7-2

7.2 The Program optdef

Again, because the 9ee11504 option is not served, we cannot know if anyone is using it. The two licenses are held by

users abc on mach01 and xyz on mach02. We do not know from this information which is the console user and which is

the additional access user.

For NURBS Geometry there is just one option installed, a Base option which licenses an unlimited number of console

users on machine 9ee11504. Again, we cannot know anything about its usage.

For NC Basic there is just one option installed, a Floating option which licenses one console user on any machine in

the network. Currently all licenses are available. No license is in use and therefore no user information is available.

7.2 The Program optdef

The program optdef can be used to define license option requirements for ICEM 3.4 Design/Drafting sessions. When

starting ICEM 3.4 Design/Drafting it will, by default, attempt to request all ICEM 3.4 modules. An option will be

available if you have purchased at least one license for it. By running the program optdef you can define a set of

license options and ICEM 3.4 Design/Drafting will only request this set of license options.

Setup the optdef command execution as follows:

• UNIX command window:

setenv LM_LICENSE_FILE /<install_path>/lic/license.dat

/<install_path>/bin/optdef

• Windows MS-DOS command window:

set LM_LICENSE_FILE \<install_path>\lic\license.dat

\<install_path>\bin\optdef

The optdef program displays the licensed option product mnemonic, description, the current availability and the

selection status. By keying in ordinals of options the user can select them. After every input line the display is repeated

with updated status. A selection can also be undone. Some options have prerequisites. When an option which requires

a prerequisite is selected, and that prerequisite has not been selected, the program automatically adds it to the list of

selections. An option cannot be selected if its prerequisite(s) are not available. When the program ends, the final status

is stored in the current working directory under modals/icemopt_310. If this file does not exist, ICEM 3.4 Design/

Drafting will request all options for which there is a license.

When optdef is started and the directory ‘modals’ does not exist under the current working directory, optdef termi-

nates with the following message:

DIRECTORY ’$cwd/modals’ DOES NOT EXIST

If the directory $cwd/modals exists, optdef prints something like the following:

ICEMDDN 3.4.0 options selection:

Ordinal Product Description Available Selected

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

1 DD DESIGN/DRAFTING X

2 AD CURVES AND SURFACES X

3 NRB NURBS/GEOMETRY X

4 NC NC BASIC

5 PAR 2D PARAMETRICS X

7-3

7.3 Sample License Daemon Log File

To select, key in the ordinals separated by spaces or "+".

To drop, use "-" before ordinal. Terminate by empty line:

The above example assumes that only the first 5 options are licensed, and that NC BASIC is not available currently

(used elsewhere).

If the input is not numeric, the following error message appears:

WRONG INPUT; SUPPLY 1 OR 2 DIGITS

If the input is numeric, but none of the choices is given above, the following error message appears:

WRONG INPUT; SUPPLY ONLY LISTED ORDINALS

Assume the user keys in "5-3" followed by carriage return. Then the display appears:

Ordinal Product Description Available Selected

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

1 DD DESIGN/DRAFTING X

2 AD CURVES AND SURFACES X

3 NRB NURBS/GEOMETRY X

4 NC NC BASIC

5 PAR 2D PARAMETRICS X

To select, key in the ordinals separated by spaces or "+".

To drop, use "-" before ordinal. Terminate by empty line:

To terminate the user presses the RETURN key without any input. This stores the current selection under $cwd/

modals/icemopt_310. The next call of optdef will read them again.

If no changes were made optdef ends with the message:

NO OPTIONS SPECIFIED; LEAVE ’$cwd/modals/icemopt_310’ UNCHANGED

If you do not want ICEM 3.4 Design/Drafting users to run optdef you should protect the execution of optdef.


The following sample license daemon log files illustrate the correct starting of the Flexible License Manger

FLEXlm™, with the license daemons lmgrd and the ICEM 3.4 daemon "icem". The example configuration based on a

license file with a set of three server nodes, any two of which must be running for the system to function. On sites with

multiple redundant servers, one of the servers is selected as the master node. The first server in the list which is avail-

able at the time a quorum is established will be the master. If the master is going down and a quorum is up the next

specified server will be the master.

The ICEM products Design/Drafting ("DD"), 2D Parametrics ("PAR"), Design Tools ("DTO"), and Curves and Sur-

faces ("AD") are all licensed for 10 users. This sample license file allows anyone on the network able to reach the

server nodes via TCP/IP to use this ICEM software up to the concurrent limit of 10 users. ICEM Licensing is installed

on the server nodes under /<install path>/lic.

Sample License File /<install path>/lic/license.dat

SERVER pat 69003456 1733

SERVER lee 69004355 1733

SERVER terry 69007ea8 1733

7-4


DAEMON icem /<install path>/lic/icem

FEATURE DD icem 3.4 31-dec-2000 10 1EF890030EABF324 "Design/Drafting"

FEATURE PAR icem 3.4 31-dec-2000 10 1E078451FE98BA07 "2D Parametrics"

FEATURE DTO icem 3.4 31-dec-2000 10 12A07F009E40B037 "Design Tools"

FEATURE AD icem 3.4 31-dec-2000 10 4B38F001109BF80A "Curves & Surfaces"

Sample License Daemon Log File /<install path>/lic/license.log (UNIX)or /winnt/system32/lmgrd.log (Windows) for License Server pat

Server "pat" is the first server in the list. It will be the master.

15:13:03 (lmgrd) ----------------------------------------------

15:13:03 (lmgrd) Please Note:

15:13:03 (lmgrd)

15:13:03 (lmgrd) This log is intended for debug purposes only.

15:13:03 (lmgrd) There are many details in licensing policies

15:13:03 (lmgrd) that are not reported in the information logged

15:13:03 (lmgrd) here, so if you use this log file for any kind

15:13:03 (lmgrd) of usage reporting you will generally produce

15:13:03 (lmgrd) incorrect results.

15:13:03 (lmgrd)

15:13:03 (lmgrd) ----------------------------------------------

15:13:03 (lmgrd)

15:13:03 (lmgrd)

15:13:03 (lmgrd) FLEXlm (v6.1) started on pat (hp 9000/730) (9/8/2000)

15:13:03 (lmgrd) FLEXlm Copyright 1988-2000, Globetrotter Software, Inc.

15:13:03 (lmgrd) World Wide Web: http://www.globetrotter.com

15:13:03 (lmgrd) License file: "/icem/lic/license.dat"

15:13:03 (lmgrd) Trying connection to terry

15:13:03 (lmgrd) Trying connection to lee

15:13:06 (lmgrd) Connected to lee

15:13:06 (lmgrd) CONNECTED, master is pat

15:13:06 (lmgrd) Starting vendor daemons ...

15:13:06(lmgrd) Started icem (internet tcp_port 1353 pid 3669

15:13:07 (icem) Server started on pat for: DD

15:13:07 (icem) PAR DTO AD

15:13:08 (icem) Trying connection to terry

15:13:08 (icem) Connected to lee

15:13:40 (lmgrd) Connected to terry

15:13:41 (icem) Connected to terry

15:18:41 (icem) OUT: "DD" user1@host1

15:18:41 (icem) OUT: "AD" user1@host1

15:18:42 (icem) OUT: "PAR" user1@host1

15:18:43 (icem) OUT: "DTO" user1@host1

15:18:51 (icem) IN: "DD" user1@host1

15:18:51 (icem) IN: "PAR" user1@host1

15:18:51 (icem) IN: "DTO" user1@host1

15:18:51 (icem) IN: "AD" user1@host1

Sample License Daemon Log File /<install path>/lic/license.log (UNIX) or /winnt/system32/lmgrd.log (Windows) for License Server "lee"

15:13:05 (lmgrd) ----------------------------------------------


15:13:05 (lmgrd)

7-5








15:13:05 (lmgrd)

15:13:05 (lmgrd) ----------------------------------------------

15:13:05 (lmgrd)

15:13:05 (lmgrd)

15:13:05 (lmgrd) FLEXlm (v6.1) started on lee (IBM RS/6000) (9/8/2000)




15:13:06 (lmgrd) Trying connection to terry

15:13:06 (lmgrd) Connected to pat


15:13:06 (lmgrd) Starting vendor daemons . . .

15:13:06 (lmgrd) Started icem (internet tcp_port 1050 pid 12593)

15:13:08 (icem) Trying connection to terry

15:13:08 (icem) Connected to pat

15:13:25 (lmgrd) Connected to terry

15:13:41 (icem) Connected to terry

Sample License Daemon Log File /<install path>/lic/license.log (UNIX)or /winnt/system32/lmgrd.log (Windows) for License Server "terry"

15:13:25 (lmgrd) ----------------------------------------------


15:13:25 (lmgrd)







15:13:25 (lmgrd)

15:13:25 (lmgrd) ----------------------------------------------

15:13:25 (lmgrd)

15:13:25 (lmgrd)

15:13:25 (lmgrd) FLEXlm (v6.1) started on terry (sgi IP22) (9/8/2000)




15:13:25 (lmgrd) Connected to pat

15:13:25 (lmgrd) Connected to lee

15:13:40 (lmgrd) selected (EXISTING) master pat


15:13:40 (lmgrd) Starting vendor daemons . . .

15:13:40 (lmgrd) Started icem (internet tcp_port 8366 pid 3727)

15:13:41 (icem) Connected to lee

15:13:41 (icem) Connected to pat

7-6

7.4 License Daemon Log File Messages


Note:The ICEM daemon "icem" is referred to as "vendor daemon" below.

License Daemon Log File Informational Messages

• Connected to <node>

The daemon is connected to its peer on node <node>.

• CONNECTED, master is <hostname>

The license daemons log this message when a quorum is up and everyone has selected a master.

• DEMO mode supports only one SERVER host!

An attempt was made to configure a demo version of the software for more than one server host.

• DENIED: <n> <feature> to <user> (<mm/dd/yy hh:mm>)

<user> was denied access to <n> licenses of <feature>.

• EXITING DUE TO SIGNAL <nnn>

• EXITING with code <nnn>

All daemons list the reason that the daemon has exited.

• EXPIRED: <feature>

<feature> has passed its expiration date

• FLEXlm started on <node>

The license daemon was started on node <node>

• IN: <feature> by <user> (<n> licenses) (used: <d:hh:mm:ss>)

<user> has checked back in <n> licenses of <feature> at <mm/dd/yy hh:mm>.

• IN server died: <feature> by <user> (<n> licenses) (used: <d:hh:mm:ss>)

<user> has checked in <n> licenses by virtue of the fact that his server died.

• Lost connection to <hostname>

A daemon can no longer communicate with its peer on node <hostname>, which may force the clients to have to

reconnect, or cause the number of daemons to go below the minimum number, in which case clients may start exit-

ing. If the license daemons lose the connection to the master, they will kill all the vendor daemons; vendor dae-

mons will shut themselves down.

• Lost quorum

The daemon lost quorum, so will process only connection requests from other daemons.

• MASTER SERVER died due to signal <nnn>

The license daemon received fatal signal <nnn>.

• MULTIPLE <xxx> servers running. Please kill, and restart license daemon

The license daemon has detected that multiple copies of vendor daemon <xxx> are running. The user should kill all

<xxx> daemon processes and re-start the license daemon.

• OUT: <feature> by <user> (<n> licenses) (<mm/dd/yy hh:mm>)

<user> has checked out <n> licenses of <feature> at <mm/dd/yy hh:mm>

• Removing clients of children

The top-level daemon logs this message when one of the child daemons dies.

7-7


• RESERVE <feature> for HOST <name>

• RESERVE <feature> for USER <name>

A license of <feature> is reserved for either user <name> or host <name>.

• REStarted <xxx> (internet port <nnn>)

Vendor daemon <xxx> was restarted at internet port <nnn>.

• Retrying socket bind (address in use)

The license servers try to bind their sockets for approximately 6 minutes if they detect "address in use" errors.

• Selected (EXISTING) master <node>.

This license daemon has selected an existing master <node> as the master.

• SERVER shutdown requested.

A daemon was requested to shut down via a user-generated kill command.

• Server started on <node> for: <feature><feature>....

A (possibly new) server was started for the features listed.

• Shutting down <xxx>

The license daemon is shutting down the vendor daemon <xxx>.

• SIGCHLD received. Killing child servers

A vendor daemon logs this message when a shutdown was requested by the license daemon.

• Started <name>

The license daemon logs this message whenever it starts a new vendor daemon.

• Trying connection to <node>

The daemon is attempting a connection to <node>.

• Using license file <license_file>

The license daemon is using the license file <license_file>.

License Daemon Log File Configuration Problems

• <hostname>: Not a valid server host, exiting

This daemon was run on an invalid <hostname>.

• <hostname>: Wrong hostid, exiting

The hostid is wrong for <hostname>.

• BAD CODE for <feature>

The specified <feature> has a bad encryption code.

• Couldn’t find a master

The daemons could not agree on a master.

• lmgrd: lost all connections

This message is logged when all the connections to a server are lost, which often indicates a network problem.

• lost lock, exiting

• Error closing lock file

• Unable to re-open lock file

The vendor daemon has a problem with its lock file, usually because of an attempt to run more than one copy of

the daemon on a single node. Locate the other daemon that is running via a ps command, and kill it with kill -9.

7-8


• NO DAEMON line for <daemon>

The license file does not contain a "DAEMON" line for <daemon>

• No <license> service found

The TCP <license> service did not exist in /etc/services.

• No license data for <feature>, feature unsupported

There is no feature line for <feature> in the license file.

• No features to serve!

A vendor daemon found no features to serve. This could be caused by bad data in the license file.

• UNSUPPORTED FEATURE <request>: <feature> by <user>

The user <user> has requested a <feature> that this vendor daemon does not support. This can happen for a num-

ber of reasons: the license file is bad, the feature has expired, or the daemon is accessing the wrong license file.

• Unknown host: <hostname>

The hostname specified on a "SERVER" line in the license file does not exist in the network database (probably /

etc/hosts).

• <license_server>: lost all connections

This message is logged when all the connections to a server are lost. This probably indicates a network problem.

• NO DAEMON lines, exiting

The license daemon logs this message if there are no "DAEMON" lines in the license file. Since there are no ven-

dor daemons to start, there is nothing to do.

• NO DAEMON line for <name>

A vendor daemon logs this error if it cannot find its own DAEMON <name> in the license file.

License Daemon Log File Daemon Software Errors

• accept: <message>

An error was detected in the "accept" system call.

• ATTEMPT TO START VENDOR DAEMON <xxx >with NO MASTER

A vendor daemon <xxx> was started with no master selected. This is an internal consistency error in the daemons.

• BAD PID message from <nnn>: pid: <xxx> (<message>)

A top-level vendor daemon received an invalid PID message from one of its children (daemon number <xxx>).

• BAD SCONNECT message: (<message>)

An invalid "server connect" message was received.

• Cannot create pipes for server communication

The "pipe" call failed.

• Can’t allocate server table space

A malloc error. Check swap space.

• Connection to <node> TIMED OUT

The daemon could not connect to <node>

• Error sending PID to master server

The vendor server could not send its PID to the top-level server in the hierarchy.

• Illegal connection request to <DAEMON>

A connection request was made to <DAEMON>, but this vendor daemon is not <DAEMON>

7-9

7.5 Licensing Error Messages

• Illegal server connection request

A connection request came in from another server without a DAEMON name.

• KILL of child failed, errno = <nnn>

A daemon could not kill its child.

• No internet port number specified

A vendor daemon was started without an internet port.

• Not enough descriptors to re-create pipes

The "top-level" daemon detected one of its sub-daemon's death. In trying to restart the chain of sub-daemons, it

was unable to get the file descriptors to set up the pipes to communicate. This is a fatal error, and the daemons

must be re-started.

• read: <error message>

An error in a "read" system call was detected.

• recycle_control BUT WE DIDN’T HAVE CONTROL

The hierarchy of vendor daemons has become confused over who holds the control token. This is an internal error.

• return_reserved: can’t find feature listhead

When a daemon is returning a reservation to the "free reservation" list, it could not find the listhead of features.

• select: <message>

An error in a select system call was detected.

• Server exiting

The server is exiting. This is normally due to an error.


If an ICEM application encounters errors when trying to checkout licenses or establish communications with the

licensing daemons, the following error messages may be output in the execution window. These are FLEXlm reported

error conditions. Depending upon the application, they may be displayed as either positive or negative numbers. There

are also ICEM specific licensing errors which are listed at the end of this section.

Error Code

Message Description

1 cannot find license file.The license file cannot be opened. FLEXlm attempted to open the file specified by the vendor (/<install path>/lic/license.dat or $ICEM_ACN/lic/license.dat), or the file spec-ified by the user in LM_LICENSE_FILE.

2 invalid license file syntax.A feature name is > MAX_FEATURE_LEN (30)A daemon name is > MAX_DAEMON_NAME (10)A server name is > MAX_SERVER_NAME (32)A feature specifies no hostid and # of licenses is <= 0.

3 cannot connect to a license server.The daemon name specified in the license file FEATURE line does not match the vendor daemon name.

4 licensed number of users already reached.The license number of users has been reached.

7-10


5 no such feature exists.The feature could not be found in the license file. A call was made to one of the software license working group usage metering functions (um_xxx_record()).

6 no TCP license service exists.This happens if a SERVER line does not specify a TCP/IP port num-ber and the TCP license service does not exist in /etc/services.

7 no socket connection to license manager server.lm_disconn() was called after the process had been disconnected from the socket. This error can also occur if an internal error happens within l_sndmsg() or l_rcvmsg().

8 encryption code in license file is inconsistent.The code in a license file line does not match the other data in the license file. This can happen when a FEATURE line has been moved from one license file to another which has different SERVER information. This may be the result of using dae-mons incompatible with the software being licensed.

9 invalid host.The hostid specified in the license file does not match the node on which the software is running. That is, the server does not know about the hostid specified in the license file.

10 feature has expired.The feature has expired, i.e., today’s date is after the expiration date in the license file.

11 invalid date format in license file.The start or expiration date in the license file is invalid.

12 invalid returned data from license server.The port number returned from lmgrd is invalid. The daemon did not send back a message within the timeout interval, possibly increase -t value on lmgrd command. An attempted connection to a vendor daemon did not result in a correct acknowledgment from the daemon. A message from the daemon had an invalid checksum.

13 no SERVER lines in license file.There is no SERVER line in the license file. All non-zero license count features need at least one SERVER line.

14 cannot find SERVER hostname in network database.Verify that all license files contain the same SERVER information. The gethostbyname() system call failed for the SERVER nodename in the license file. Check that /etc/hosts contains hostnames of all servers given in license file.

15 cannot connect to license server.The connect() system call failed, while attempting to connect to the daemon. The attempt to connect to the vendor daemon on all SERVER nodes was unsuccessful. Returned if the feature has been checked out but the program is in the process of reconnecting.

16 cannot read data from license server.The process cannot read data from the daemon within the timeout interval. The connection was reset by the daemon (usually because the daemon exited) before the process attempted to read data.

17 cannot write data to license server.The process could not write data to the daemon after the con-nection was established.

18 license server does not support this feature.The feature has expired (on the server node) or has not yet started, or the version is greater than the highest supported version.

19 error in select system call.Application internal error, contact ICEM support.

20 license server busy (no majority).The license server is busy establishing a quorum of server nodes so that licensing can start. This request should be retried.

21 license file does not support this version.The version requested is greater than the highest ver-sion supported in the license file FEATURE line.

Error Code

Message Description

7-11


22 feature checkin failure detected at license server.The checkin request did not receive a proper reply from the vendor daemon (the license might still be considered in use).

23 license server temporarily busy (new server connecting).The vendor daemon is in the process of establishing a quorum condition. New requests from clients are deferred during this period. This request should be retried.

24 users are queued for this feature.This error is similar to MAXUSERS, but supplies the additional information that there are other users in the queue for this feature.

25 license server does not support his version of this feature.The version specified in the checkout request is greater than the highest version number the daemon supports.

26 request for more licenses than this feature supports.A checkout request was made for more licenses than are supported in the license file. This request will never succeed.

27 cannot read /dev/kmem.The file /dev/kmem is not readable on this system. This error will only occur if using extended hostid checking

28 cannot read /vmunix.The file /vmunix is not readable on this system. This error will only occur if using extended hostid checking.

29 cannot find ethernet device.The ethernet device could not be located on this (VMS) system.

30 cannot read license file.

The license file could not be read (errno == EPERM or EACCES). Check user read permits on /<install path>/lic and /<install path>/lic/license.dat.

31 feature not yet available.The feature is not enabled yet (current date is before the feature start date).

32 No such attribute.The application specified an unknown attribute code.

33 Bad encryption handshake with daemon.The client performs an encryption handshake operation with the daemon prior to any licensing operations. This handshake operation failed.

34 Clock difference too large between client and server.The date on the client system does not agree closely enough with the date on the server (daemon) system. The amount of difference allowed is set by the software vendor.

35 In the queue for this feature.This checkout request has resulted in the process being placed in the queue for this feature. Subsequent calls to lm_status() will yield the status of this queued request.

36 Feature database corrupted in daemon.The daemon’s run-time feature data structures have become corrupted. This is an internal daemon error.

37 Duplicate selection mismatch for this feature.The checkout request for this feature has specified a duplicate mask that does not match the mask specified by an earlier checkout. This is probably the result of using different versions of your client software.

38 User/host on EXCLUDE list for feature.The user/host/display has been excluded from this feature by an end-user’s daemon option file.

39 User/host not on INCLUDE list for feature.The user/host/display has NOT been included in this feature by an end-user’s daemon option file.

40 Cannot allocate dynamic memory.The malloc() call failed to return sufficient memory. This can hap-pen while reading the features from the license file (especially if the user has an extremely long LM_LICENSE_FILE path set).

Error Code

Message Description

7-12


41 Feature was never checked out.Application internal error, contact ICEM support.

42 Invalid parameter.Application internal error, contact ICEM support.

43 No FLEXlm key data supplied in lm_init() call.Application internal error, contact ICEM support.

44 Invalid FLEXlm key data supplied.Application internal error, contact ICEM support.

45 FLEXlm function not available in this version.

Application internal error, contact ICEM support.

46 FLEXlm software is demonstration version.Application internal error, contact ICEM support.

47 Clock setting check not available in daemon.Application internal error, contact ICEM support.

48 FLEXlm platform not enabled.Application internal error, contact ICEM support.

49 Date too late for binary format. The expiration date format in FLEXlm licenses are good until the year 2027. This is probably a bogus date.

50 FLEXlm key data has expired.Application internal error, contact ICEM support.

51 FLEXlm not initialized.Application internal error, contact ICEM support.

52 Server did not respond to message.UDP communications failure. UDP communications are not guaranteed. Failure to recover lost or garbled message.

53 Request rejected by vendor-defined filter.The application checkout filter rejected the checkout request

54 No FEATURESET line present in license file.Application internal error, contact ICEM support.

55 Incorrect FEATURESET line in license file.Check FEATURESET line in license file.

56 Cannot compute FEATURESET line.This can happen because there’s no FEATUREs in the file.

57 socket() call failed.

This can occur when the UNIX OS runs out of system resources.

58 setsockopt() failed.The setsockopt() call has failed. This is likely due to an OS error

59 message checksum failure.Communications error – messages between client and server are encrypted and checksummed for security and integrity. The checksum will usually fail because of poor network-ing communications.

60 For Internal UseApplication internal error, contact ICEM support.

61 Cannot read license file from server.This occurs when the license file, via LM_LICENSE_FILE, is incorrectly defined. This occurs when LM_LICENSE_FILE is set to port@host.

62 Network software (TCP/IP) not available.This is reported on systems where this is detectable. Some systems may have this problem, but the error will not be reported as LM_NONETWORK-system calls will simply fail.

63 Not a license administrator.Various functions require that the user be a license administrator, depending on how lmgrd was started. See lmgrd(), lmremove() and lmdown().

64 lmremove request too soon.Application internal error, contact ICEM support.

65 Bad VENDORCORE struct passed to lc_init().Application internal error, contact ICEM support

Error Code

Message Description

7-13


66 FLEXlm include file/library mismatch.Application internal error, contact ICEM support.





71 Invalid TZ environment variable.

On some operating systems, the end-user can significantly change the date using the TZ environment variable. This error detects this type of theft.

72 ’Old-style’ vendor keys (3-word).Application internal error, contact ICEM support.

73 Local checkout filter requested request.Request was denied by an application specific restriction

74 Attempt to read beyond the end of LF path.An error occurred with the colon-separated list of license files in the LM_LICENSE_FILE environment variable.

75 SYS$SETIMR call failed.SYS$SETIMR is used on VMS to time out certain FLEXlm system calls.

76 Internal FLEXlm Error - Please report to Globetrotter Software.Application internal error, contact ICEM support.

77 Bad version number - must be floating point number, with no letters.Application internal error, contact ICEM support.

78 FLEXadmin API functions not available.Application internal error, contact ICEM support.




82 Invalid PACKAGE line in license file.PACKAGE missing or invalid COMPONENTS. A COMPO-NENT has number of users set, with OPTIONS=SUITE. A COMPONENT has number of users==0.

83 Server FLEXlm version older than client’s.The server daemons are older than the FLEXlm ver-sion used in the application. Upgrade the daemons.

84 Incorrect number of USERS/HOSTS INCLUDED in options file – see server log.The FLEXlm options file requests USERS/HOSTS inclusion exceeding the number of licenses in the file.

85 Server doesn't support this request.Application internal error, contact ICEM support.

86 This license object is already in use (Java only).Self explanatory.

87 Checkout exceeds MAX specified in options file.The FLEXlm options file being used limits the number of users for this feature. This limit has been exceeded.

88 System clock has been set back.Self explanatory.

89 This platform not authorized by license.This license does not permit use of this product on this hardware platform.

90 Future license file format or misspelling in the license file.Self explanatory.

91 ENCRYPTION_SEEDs are non-unique.Application internal error, contact ICEM support.

Error Code

Message Description

7-14


The following error messages are issued by the ICEM Licensing interface to FLEXlm. Depending upon the applica-

tion, these messages may appear as 900 series errors or simply as errors 1 through 12, in which case the FLEXlm error

numbers above will be negative numbers.

92 Server removed during reread, or server hostid mismatch with license.

Shutdown daemons and start them on the correct machines.

93 This feature is available in a different license pool.The application only supports one license pool.

94 Attempt to generate license with incompatible attributes.Application internal error, contact ICEM support.

95 Network connect to THIS_HOST failed.Application internal error, contact ICEM support.

96 Server node is down or not responding.Check status of license server.

97 The desired vendor daemon is down.Check status of vendor daemon or the vendor daemon lock file in /tmp/<daemon_name>. Remove the lock file if the vendor daemon is not running.

98 The FEATURE line can’t be converted to decimal format.Application internal error, contact ICEM support.

99 The decimal format license is typed incorrectly.Recheck license.

100 Cannot remove a lingering license.Wait for license to be freed.

101 All licenses are reserved for others.

The user is not listed in the options file.

Error Code

Message Description

901 Workstation License Customer Information data is missing.A "WL" workstation license is miss-ing the customer information. Contact ICEM support.

902 Feature License Customer Information data is missing.This license requires Customer Informa-tion included in the "Feature Description" string. Contact ICEM support.

903 Workstation and Feature License Customer Information data mismatch.The Customer Informa-tion in the “Feature Description” string does not match the information defined in the "WL" license. Contact ICEM support.

904 Permanent Feature invalid with Demo or Lease Workstation License.This permanent non-expir-ing feature can only be used with a permanent non-expiring "WL" license.

905 Workstation License is required to use this feature.A "WL" workstation license is required for this machine in order to use this license.

906 Maximum license file path length, 1024 characters, exceeded.

Shorten the license file path or combined paths in LM_LICENSE_FILE to less than 1024 characters.

907 Maximum DAEMON name length, 10 characters, exceeded.Application internal error, contact ICEM support.

Error Code

Message Description

7-15


908 Maximum FEATURE name length, 30 characters, exceeded.Application internal error, contact ICEM support.

909 Unknown Vendor DAEMON specified during initialization: ""Application internal error, contact ICEM support.

910 iautcc: Invalid action code.Application internal error, contact ICEM support.

911 Served or DEMO license required.The application will only accept a served or DEMO node-lokked license for this feature.

912 Served license required.The application will only accept a served license for this feature.

913 Cannot setup atexit processing for licensing.Application internal error, contact ICEM support.

Error Code

Message Description

7-16

Documents

ICE - Dassault Systèmesmedia.3ds.com/.../FlexLM_61_manual_English.pdfChapter 2 Overview 2-1 Chapter 2 Overview ICEM uses a license file found in //lic/license.dat