Leonardo Installation Guide - cs.huji.ac.il

Leonardo Installation Guide

Release 4.2

Copyright

Copyright © 1991-1998 Exemplar Logic, Inc.

All Rights Reserved

are

c.nc.

Trademarks

Exemplar Logic® is a registered trademark of Exemplar Logic, Inc. Galileo™, Galileo Extreme™, Leonardo™, Extreme Technology™, and MODGEN™trademarks or servicemarks of Exemplar Logic, Inc.V-System/VHDL™ and V-System/Verilog™ are trademarks of Model Technology, InVerilog® and Verilog-XL® are registered trademarks of Cadence Design Systems, IAll other trademarks remain the property of their respective owners.

Disclaimer

Although Exemplar Logic, Inc. has tested the software and reviewed the documentation, Exemplar Logic, Inc. makes no warranty or representation, either express or implied, with respect to this software and documentation, its quality, performance, merchantability, or fitness for a particular purpose.

Exemplar Logic, Inc.6503 Dumbarton CircleFremont, CA 94555Telephone: 800-632-3742email: [email protected]

Part No: EL-60030-R

Contents

1

1-1

-1

1-1

1-2

1-2

1-2

1-2

-3

1

2-1

2-2

-2

2-2

2-3

1. Quick Installation of Leonardo . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-

PC Windows NT and Windows 95 . . . . . . . . . . . . . . . . . . . . . . . . . .

Additional Instructions for Windows NT Users . . . . . . . . . . . . . 1

Sun OS 4.1.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Solaris 2.x.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HP Series 700 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Licensing Leonardo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Authorization Codes: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting Environment Variables for All Unix Users: . . . . . . . . . . 1

2. Installing Leonardo on a Windows PC . . . . . . . . . . . . . . . . . . . . . 2-

Hardware and Software Requirements . . . . . . . . . . . . . . . . . . . . . . .

Installing Leonardo from a CD-ROM . . . . . . . . . . . . . . . . . . . . . . . .

Additional Instructions for Windows NT Users . . . . . . . . . . . . . 2

Setting Up Your Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Steps for Setting Environment Variables on Windows NT . . . . .

iii

2-4

2-4

2-5

2-5

2-6

2-7

2-9

-10

-12

1

3-1

3-1

3-1

3-2

3-2

3-2

3-3

3-3

3-4

3-4

3-6

3-6

-6

3-7

Licensing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Steps for Setting Up a Non-Server, Node-Locked License . . . . .

Steps for Setting Up a Server-based Node-Locked License . . . .

Steps for Setting Up a Floating (Networked) License . . . . . . . . .

Authorization Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Editing the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Location of the License File . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Running the License Manager (FLEXlm) . . . . . . . . . . . . . . . . . . 2

Adding Support for TCP/IP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

3. Installing Leonardo on a Sun SPARCstation . . . . . . . . . . . . . . . . 3-

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


For SunOS 4.1.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

For Solaris 2.x. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting Up Your Environment . . . . . . . . . . . . . . . . . . . . . . . . . . .

Licensing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Editing The License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Installing the License Manager . . . . . . . . . . . . . . . . . . . . . . . . . .

Starting the License Manager Automatically at Boot Time. . . . . 3

Multiple License Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

iv Leonardo Installion Guide

3-8

-1

4-1

4-1

4-1

4-2

4-2

4-3

4-3

4-4

4-5

4-5

-6

4-6

4-7

1

-1

5-1

5-4

5-4

5-5

5-5

5-5

5-6

Stopping and Starting FLEXlm. . . . . . . . . . . . . . . . . . . . . . . . . .

4. Installing Leonardo on a HP Series 700. . . . . . . . . . . . . . . . . . . . . 4

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Setting Up Your Environment . . . . . . . . . . . . . . . . . . . . . . . . . . .

Licensing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Editing The License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Installing the License Manager . . . . . . . . . . . . . . . . . . . . . . . . . .

Starting the License Manager Automatically at Boot Time. . . . . 4

Multiple License Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Stopping and Starting FLEXlm. . . . . . . . . . . . . . . . . . . . . . . . . .

5. FLEXlm License Administration . . . . . . . . . . . . . . . . . . . . . . . . . . 5-

Version Compatibility in FLEXlm . . . . . . . . . . . . . . . . . . . . . . . . . . 5

User Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

License Administration Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LMDOWN Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LMREMOVE Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LMREREAD Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LMSTAT Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Backup (Redundant) Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Leonardo Installation Guide v

5-6
Common Licensing Questions and Problems . . . . . . . . . . . . . . . . . .
vi Leonardo Installion Guide

Quick Installation of Leonardo 1

ms.

r

m

This chapter provides quick installation steps for your PC, Linux, and Unix platfor

PC Windows NT and Windows 951. Load the CD-ROM in your local drive or your network drive.

2. Run the install.exe program. Type:<cdrom drive>:\install.exe

Additional Instructions for Windows NT Users

Windows NT users also need to install the Rainbow Security device driver (version 5.17 olater). See the README file in the \rainbow directory for more information. You must have systeadministrator privileges to install this driver.

1. Type: \rainbow\win_nt\install.bat

2. Select install driver from the Function menu.

Sun OS 4.1.x1. Insert the Leonardo CD-ROM.

2. Create a directory called /cdrom .

3. If necessary, type the following command to mount the CD:

/etc/mount -rt hsfs /dev/sr0 /cdrom

1-1

1

e. In g

ur

4. If necessary, create a directory to install Leonardo.

5. In the Leonardo installation directory, type:

tar xvf /cdrom/sunos4.tar

Solaris 2.x.x1. Insert the Leonardo CD-ROM.


3. If necessary, type the following command to mount the CD:/etc/mount -rF hsfs /dev/sr0 /cdrom


5. In the Leonardo installation directory, type:tar xvf /cdrom/cdrom0/sunos5.tar

HP Series 7001. Insert the Leonardo CD-ROM.


3. If necessary, type the following command to mount the CD:/etc/mount -rt cdfs /dev/dsk/ <SCSI id of CD-ROM drive>s0/cdrom


5. In the Leonardo installation directory, type:tar xvf /cdrom/”hp.tar;1”

Licensing Leonardo

Authorization Codes:

1. Contact Exemplar to obtain your authorization codes by FAX: 510-337-3799 oremail: [email protected] with your hostid, name, address, email, and phonaddition, please provide your type of platform, your fax number, and if a floatinlicense or node-locked license is needed.

2. When you receive your license file, install it in the default location:PC: C:\FLEXLM\LICENSE.DATUnix: $EXEMPLAR/license/license.datIf you install the license anywhere except the default location, you must set yoLM_LICENSE_FILE environment variable to point to the license file.

1-2 Leonardo Installation Guide

1

t

Setting Environment Variables for All Unix Users:

As shown in the following example, set your EXEMPLAR and path environmenvariables to point to your installation directory (for example, /usr/local/exemplar ):

setenv EXEMPLAR /usr/local/exemplarset path=($EXEMPLAR/bin/<platform> $path)

Quick Installation of Leonardo 1-3

1


Installing Leonardo on a Windows PC 2

for he

e to

This chapter describes:

• Hardware and software requirements

• Installation procedures

• Licensing

Hardware and Software Requirements

Table 1-1, System Requirements, shows the recommended system requirementsproper operation of Exemplar synthesis tools. The recommendations depend on tuser’s design and coding style.

Table 1-1. System Requirements

Note: A system with less than the recommended requirements may run slower dumemory swapping.

Design Size RAM, MB

Number of Gates Look Up Tables (LUTs) Flip-Flops

up to 15,000 1,100 500 64

15,000 to 75,000 4,000 and up 3,000 128

75,000 and up 5,000 5,000 256

2-1

2

plan

n .

s

Note: In addition to the requirements in Table 1-1, the following requirements arerecommended:

• An IBM PC compatible computer with a 486, Pentium, or Pentium-Pro CPU.

• 100 Mbytes of disk space for Leonardo programs and data files. In addition, for 50 MB for your own design files and intermediate files.

• Leonardo requires Windows 95 or Windows NT version 3.51 or later.

Installing Leonardo from a CD-ROM

1. Begin by loading the CD-ROM in your local or network CD-ROM drive. For example, to install Leonardo, type:

2. Then follow the instructions displayed on the screen.

Additional Instructions for Windows NT Users

Windows NT users also need to install the Rainbow Security device driver (versio5.17 or later). See the README file in the /rainbow directory for more informationYou must have system administrator privileges to install this driver. To install the Rainbow Security device driver, type:

3. Next, select install driver from the Function menu. Restart Windows NT ainstructed.

Setting Up Your Environment

1. Optional: Add %EXEMPLAR%\bin\win32 to your path This command may be used for running gc from a DOS command prompt or a batch file.

<cdrom drive>:\install.exe

<cdrom drive>:\rainbow\win_nt\install.bat

path=%EXEMPLAR%\bin\win32;%PATH%


2

e (see

the e

o set the the

r.

em e les:

ists,

m

2. If you purchased a floating license, or have a server-based node-locked licens“Licensing” below), add the license manager directory to your path.

Note – The examples in this chapter show how to set environment variables usingset and path commands in a command window. Under normal circumstances, thInstallation program handles the setting of these environment variables for you. Tor modify them manually, on Windows NT (version 3.51), use the System dialog inControl Panel on your PC (see instructions below); on Windows 95, add or modifyset and path commands as shown above in your autoexec.bat file. Refer to the documentation that accompanies your operating system or contact your system administrator for further details.

Steps for Setting Environment Variables on Windows NT

1. On NT 3.51, bring up the System dialog:(Program Manager->Main->Control Panel->System).

On Windows 4.0, bring up the System Properties dialog:(Start->Settings->Control Panel->Systems) and click on the Environment folde

2. If you want these changes to apply to all users of the system, modify the SystEnvironment Variables according to the following instructions. If you want theschanges to apply only to the current user, modify the User Environment Variab

a. Select the variable from the appropriate list (System or User) if it already exor select another variable from that list and change the Variable name to the one you are setting (EXEMPLAR, Path or LM_LICENSE_FILE).

b. Enter the value of the variable in the Value field. If you are setting the Path environment variable, you do not need to enter %PATH%; also, if you are modifying the User Environment Path, you do not need to repeat the SysteEnvironment Path setting (this variable is automatically concatenated so it includes both the System and the User values).

c. Click on the Set button to add your new setting to the appropriate listbox (System or User).

3. Click on the OK button to apply your changes.

path=%EXEMPLAR%\license\win32;%PATH%

Installing Leonardo on a Windows PC 2-3

2

c

n in

the is re

nse

d

he

lar

Licensing

Licensing for Leonardo can be either a network (floating) license, where a specifinumber of licenses are available to any system on the network, or a node-lockedlicense, which can only be used by one machine with a dongle (hardware key) attached.

Note: Floating License - If Leonardo is installed in a directory with SPACES theensure that your exemplard.exe is installed in a directory WITHOUT SPACES the path. For example:

C:\exemplar\exemplard

The daemon line in the license file must point to this directory.

You are required to run a License Manager if your license file has SERVER and DAEMON lines. Currently, your license file will not have SERVER and DAEMON lines for node-locked licenses, but this may change in the future. Leonardo uses FLEXlm License Manager. Refer to “Running the License Manager (FLEXlm)” in thchapter and the “FLEXlm License Administration,” Chapter 6, in this guide for moinformation on running FLEXlm.

If you have a node-locked license which does not require a License Manager (noSERVER or DAEMON lines in the license file), you need to be sure that your licefile can be located (either in the default location, or by setting your LM_LICENSE_FILE environment variable), and you need to have TCP/IP installe(see below), but you will not have to run a License Manager.

Steps for Setting Up a Non-Server, Node-Locked License

If you have a node-locked license with no SERVER or DAEMON lines, here are tsteps you will need to do to set up your licensing:

1. Determine the host ID of your dongle by looking at the dongle or by double-clicking on the pchostid icon in the Exemplar program group, and obtain yourlicense from Exemplar Logic (see “Authorization Codes” below).

2. Create or edit your license file with the FEATURE lines given to you by Exemp(see “Editing the License File” below).

3. Copy or move your license file to C:\flexlm\license.dat, and/or set your LM_LICENSE_FILE environment variable to point to the license file (see “Location of the License File” below).


2

try

e

ng ill r,

es

nager

try er).

up

se

es

4. If your PC is not on a network, and if you get a Communication Error when youto start Leonardo, install TCP/IP per instructions (refer to Adding Support for TCP/IP in this chapter).

Steps for Setting Up a Server-based Node-Locked License

If you have a node-locked license with SERVER and DAEMON lines, here are thsteps you will need to do to set up your licensing:

1. Determine the host ID of your dongle by looking at the dongle or double-clickion the pchostid icon in the Exemplar program group. If your license server wbe a different (Unix or NT) machine, determine the host ID of the license serveand obtain your license from Exemplar Logic (see “Authorization Codes” in thischapter).

2. Create or edit your license file with the SERVER, DAEMON and FEATURE lingiven to you by Exemplar (see “Editing the License File” in this chapter).

3. Copy or move your license file to C:\flexlm\license.dat, or set your LM_LICENSE_FILE environment variable (see “Location of the License File” inthis chapter).

4. Start the License Manager on the license server (see “Running the License Ma(FLEXlm)” in this chapter)

5. If your PC is not on a network, and if you get a Communication Error when youto start Leonardo, install TCP/IP (see “Adding Support for TCP/IP” in this chapt

Steps for Setting Up a Floating (Networked) License

If you purchased a floating license, here are the steps you will need to do to set your licensing:

1. Determine the host ID of the (Unix or NT) license server, and obtain your licenfrom Exemplar Logic (see “Authorization Codes” below).

2. Create or edit your license file with the SERVER, DAEMON and FEATURE lingiven to you by Exemplar (see “Editing the License File” below).


2

r e

P

from ng

is

a

3. Copy or move your license file to C:\flexlm\license.dat (if using an NT license server) or to $EXEMPLAR/license/license.dat (if using a Unix license server), oset your LM_LICENSE_FILE environment variable (see “Location of the LicensFile” below).

4. Start the License Manager on the License Server (see “Running the License Manager (FLEXlm)” below)

5. If you get a Communication Error when you try to start Leonardo, install TCP/I(see “Adding Support for TCP/IP” below).

Authorization Codes

To run Leonardo, you must obtain authorization codes for each feature purchasedExemplar Logic. You will need to have the host ID of the license server (for floatilicenses and server-based node-locked licenses) or the local PC (for node-lockedlicenses) to get your authorization codes.

Leonardo uses dongle-based host IDs for PCs. To determine the host ID of your dongle, you can double-click on the pchostid program in the Exemplar Logic Program Group (the host ID is also printed on the dongle). It will be a four-digit hexadecimal number (consisting of the digits 0-9 and/or the letters a-f or A-F). Thhost ID can be used for either node-locked or floating licenses.

If you have purchased a floating license, you will need the host ID of the license server, which may be a Window NT, Sun or HP Workstation. Again, use the pchostid program to obtain the correct host ID for a Windows NT server. The FLEXlm utility lmutil lmhostid may be used to obtain the correct host ID for Unix server.

Contact Exemplar Logic with your host ID by email ([email protected] ), fax (510-337-3799) or phone (510-337-3700) to obtain your authorization codes.


2

as a \)

e

/IP ry.

ly as

imal e

d of

Editing the License File

Following is the standard format for a floating license file:

Some node-locked license files do not require the SERVER line and the DAEMON line. Node-locked FEATURE lines have the following format:

All feature lines must be entered on a single line. The back slash (\) can be usedcontinuation character to split FEATURE lines if desired. If used, the back slash (must come after the password field, and be the last character on the line.

Use any text editor (such as Notepad) to make the following changes to the licensfile you receive from Exemplar Logic:

1. If your license has a SERVER line, edit the SERVER line by entering the name of the system used as the license server and its host ID. 1700 is the default TCPport. Contact your System Administrator to change the TCP/IP port if necessa

2. If your license has a DAEMON line, edit the DAEMON line by entering the Leonardo installation directory .

3. Make certain each FEATURE line is on a single line (or uses the back slash continuation character at the end of the first line to break a FEATURE line intomultiple parts). If you are typing these lines, make sure they are entered exactyou received them. All entries are case-sensitive.

Note – Both the authorization codes (passwords) and the host IDs are in hexadecformat, meaning they can only contain the digits 0-9 and the letters a-f (or A-F). Bcareful not to enter the letter O (instead of the number zero) or the letter l (insteathe number one).

SERVER server-name EKEY=hostid 1700 DAEMON exemplard installation directory\license\win32FEATURE feature exemplard version expiration date # users password ““ ck= checksum

FEATURE feature exemplard version expiration date # users password \ HOSTID=EKEY= hostid ck= checksum


2

u

the

nd of

The following example lists a typical floating license file:

The following example lists a typical non-server node-locked license file:

4. If you have any problems with your license file, recheck to make sure that:

a. There are no typos in these FEATURE lines

b. The case (upper case vs. lower case) exactly matches what was sent to yo

c. Your host ID and Authorization Codes do not contain the letter O (instead ofnumber zero 0) or the lower-case letter l (instead of the number one 1).

d. Each feature line is on a single line (or use the back slash character at the eone line to break it into multiple lines, as shown in the example above)

SERVER mycomputer EKEY=1b9b 1700DAEMON exemplard c:\leonardo\license\win32 FEATURE leonardo exemplard 1998.06 30-jun-98 1 3B3C20D1CF558A20A1CB ck=14FEATURE leo_FPGA_pkg exemplard 1998.06 30-jun-98 1 3B2C80D1997F6C55C444 \ ck=249FEATURE leo_vhdl_pkg exemplard 1998.06 30-jun-98 1 BBFC60919808E526D6D3 \ ck=9FEATURE leo_time_pkg exemplard 1998.06 30-jun-98 1 FB8CF0817FCF12A0A7A5 ck=21

FEATURE netscope exemplard 1998.06 30-jun-98 1 EB7C2011A7FDC9A2012A ck=83

FEATURE leonardo exemplard 1998.06 11-aug-98 0 6B9CC051E0642CF72114 \ HOSTID=EKEY=1B9B ck=14

FEATURE leo_FPGA_pkg exemplard 1998.06 11-aug-98 0 AB7C40C1F16A268F0598 \ HOSTID=EKEY=1B9B ck=32

FEATURE leo_vhdl_pkg exemplard 1998.06 11-aug-98 0 2BAC00C13A557952AB31 \ HOSTID=EKEY=1B9B ck=250

FEATURE leo_time_pkg exemplard 1998.06 11-aug-98 0 AB6C50D18F3D59E232E0 \ HOSTID=EKEY=1B9B ck=244

FEATURE netscope exemplard 1998.06 11-aug-98 0 2B1CE031CC5E2DF9CF3F \ HOSTID=EKEY=1B9B ck=32


2

r

lt

t

l

e

er

Location of the License File

The FLEXlm license manager (lmgrd.exe ) and the Leonardo software both look fothe license file in the following default location:

It is recommended that you install (move or copy) your license file into the defaulocation. If you choose to use a different location, you must set the environment variable LM_LICENSE_FILE to include the full pathname (including file name) of your license file. For example:

For more than one license file, type:

FLEXlm sometimes has significant delays finding the license file in the default location if the environment variable LM_LICENSE_FILE has not been set. Set the environment variable LM_LICENSE_FILE even when the license file is in the defauldirectory to get around this problem.

Note – The example given above shows how to set your LM_LICENSE_FILE environment variable using the set command in a command window. Under normacircumstances, the Installation program handles the setting of this environment variable for you. To set or modify LM_LICENSE_FILE manually, on Windows NT use the System dialog in the Control Panel on your PC (see “Steps for Setting Environment Variables on Windows NT” above); on Windows 95, add or modify thset command in your autoexec.bat file. Refer to the documentation that accompanies your operating system or contact your system administrator for furthdetails.

c:\flexlm\license.dat

set LM_LICENSE_FILE=c:\admin\licenses\leonardo.lic

set LM_LICENSE_FILE= file1 ; file2 ;...; filen


2

ou

you d de-

t

PC he

Running the License Manager (FLEXlm)

The FLEXlm executable files are located in the %EXEMPLAR%\license\win32 directory.

Non-Server Node-locked License

Verify that the license is located in the default location c:\flexlm\license.dat or that the environment variable LM_LICENSE_FILE is set to the full license file pathname. In addition, if your license file contains SERVER and DAEMON lines, ywill need to run the FLEXlm license manager.

As a Client

If you have a floating license, you will need to do the following on each machine want to use to run Leonardo. If you have a node-locked license with SERVER anDAEMON lines, you will need to do the following on the machine the license is nolocked to:

Set the environment variable LM_LICENSE_FILE to:

For example, if the license server hostname is master and uses TCP/IP port 1700 forthe license manager daemon, type:

If you prefer, you can copy the license file from the license server to the default location c:\flexlm\license.dat or to the location specified by the environmenvariable LM_LICENSE_FILE .

Note – If the license server is a Windows NT machine and the client is any other based machine, then you should copy the license file from the license server to tdefault location c:\flexlm\license.dat or to the location specified by the environment variable LM_LICENSE_FILE.

server TCP/IP port@server hostname

set LM_LICENSE_FILE=1700@master


2

Note – The license server can be running on any platform that is supported by Leonardo (SPARC, HP-700, or PCs running Windows NT; Windows 95 is not currently supported as a license server).

As a License Server

If you have either a floating license or a node-locked license with SERVER and DAEMON lines, you will need to do the following on the license server:

To set up lmgrd as a service on Windows NT:

1. Log in as a user with administrator's privilege.

2. Copy all lmgr325*.dll files from Leonardo’s license\win32 directory to your Windows System32 directory (usually c:\windows\system32 ).

3. Verify that the license file is in the default location c:\flexlm\license.dat .

4. Run the lmgrd installation program from a DOS Command Prompt. Change directories to Leonardo’s license\win32 directory and type:

Note: Type install to receive a usage message. This path sets lmgrd as a service, which starts automatically whenever the system is booted. To start lmgrd as a service without rebooting the system, use the Services icon in the Control Panel (ProgramManager->Main->Control Panel->Services):

1. Select FLEXlm License Server from the Services list.

2. Click on the Start button.

Note: to remove FLEXlm License Server change directories to Leonardo’s license\win32 directory and type:

Note – The lmgrd.log file is located in your Windows System32 directory.

install -e %EXEMPLAR%\license\win32\lmgrd.exe

install remove


2

. If PC

g

se

To run lmgrd as an application instead of a service on Windows NT:

If the license file is in the default location c:\flexlm\license.dat, change directories to Leonardo’s license\win32 directory and type the following from a DOS Command Prompt:

Or, if the license file is located somewhere else, type:

Note – You will have to repeat this procedure every time you boot up under Windows NT, if you have not set up lmgrd as a service

Adding Support for TCP/IP

TCP/IP is required to run Leonardo, even if you are not using a License Manageryour PC is on a network, you will probably not have to make any changes. If youris not on a network, or if you see the following error message then you must addTCP/IP support:

Add TCP/IP support to your Windows environment as follows:

1. Double-click on the Network icon in the Control Panel of your PC that is runninWindows 95 or NT to display your network settings. Check that the following Network Software has been installed:

• TCP/IP Protocol

• Windows 95 only: EITHER a network adapter OR Dial-Up Adaptor

2. Windows 95 only: if neither a network adapter OR dial-up adaptor is installed, uthe following procedures to install the dial-up adapter:

lmgrd -app

lmgrd -app -c license filename

Communication Errorcouldn’t open socket: address family not supported by protocol familyPlease be sure TCP/IP network protocol is enabled


2

to

e

a. Bring up the Network dialog (Start->Settings->Control Panel->Network)

b. From the Configuration folder of the Network dialog, click on the Add button. This will bring up the Select Network Component Type dialog.

c. Select Adapter and click on the Add button. This will bring up the Select Network adapters dialog.

d. Select Microsoft from the Manufacturers list, then select Dial-up Adapter from the Network Adapters list, and press OK

e. Press OK on the Network dialog, and follow the instructions on the screen tocomplete the installation

3. If TCP/IP Protocol is not installed, use the following procedures to install it:

On Windows 95:a. Bring up the Network dialog (Start->Settings->Control Panel->Network)

b. From the Configuration folder of the Network dialog, click on the Add button. This will bring up the Select Network Component Type dialog.

c. Select Protocol and click on the Add button. This will bring up the Select Network Protocol dialog.

d. Select Microsoft from the Manufacturers list, then select TCP/IP from the Network Protocols list, and press OK

e. Press OK on the Network dialog, and follow the instructions on the screen complete the installation

On Windows NT 3.51 (administrator’s privilege may be needed):a. Bring up the Network Settings dialog (Program Manager->Main->Control

Panel->Network)

b. Click on the Add Software button

c. Select TCP/IP Protocol and related components and click on the Continue button. The Windows NT TCP/IP Installation Options dialog will bdisplayed.

d. Select Simple TCP/IP Services , and press Continue

e. Follow the instructions on the screen to complete the installation


2

On Windows NT 4.0 (administrator’s privilege may be needed):a. Bring up the Network dialog (Start->Settings->Control Panel->Network)

b. From the Protocols folder of the Network dialog, click on the Add button. This will bring up the Select Network Protocol Type dialog.

c. Select TCP/IP Protocol from the Network Protocol list, and press OK

d. Follow the instructions on the screen to complete the installation


Installing Leonardo on a Sun SPARCstation 3

e. iles.

p




• Licensing

Requirements

Hardware Requirements

• Leonardo programs and data files require about 100 Mbytes of hard disk spacPlan for about half as much in addition for your own design and intermediate f

• 32 Mbytes of RAM is the recommended minimum, with at least 64 Mbytes swaspace.

Software Requirements

Leonardo requires SunOS 4.1 or later or Solaris 2.4 or later.

3-1

3

to


Contact your System Administrator for help installing Leonardo if necessary.

For SunOS 4.1.x

1. Insert the Leonardo CD.


3. Mount the CD by typing (requires you to be superuser):

4. If necessary, create the directory in which you want to install Leonardo.

5. In the directory that you want to install Leonardo, type:

This completes the installation of Leonardo.

For Solaris 2.x



3. If your drive did not mount automatically, mount the CD by typing (requires yoube superuser):


/etc/mount -rt hsfs /dev/sr0 /cdrom

tar xvf /cdrom/SunOS4.tar

/etc/mount -rF hsfs /dev/sr0 /cdrom


3

ber




Set the EXEMPLAR environment variable to the name of the directory into whichLeonardo is installed (e.g., /usr/local/exemplar ). The EXEMPLAR environment variable is used by Leonardo to locate parameter and library files. Add installation_directory/bin/SunOS4 or SunOS5 (e.g., /usr/local/exemplar/bin/SunOS4 ) to your UNIX search path. This enables you to run Leonardo programs from any other directory.

For example, under SunOS4 type the following commands in a C shell:

Note – The new path does not take effect until the rehash command is executed.

These commands should be added to your.cshrc startup file.

Licensing

Licensing for Leonardo is always a network (floating) license, where a specific numof licenses are available to any system on the network.

Call Exemplar Logic at 510-337-3700 or send e-mail to [email protected] to obtain your authorization codes.

Leonardo uses the FLEXlm License Manager. Refer to “Installing the License Manager” below and Chapter 5, “FLEXlm License Administration” for more information on running FLEXlm.

tar xvf /cdrom/cdrom0/SunOS5.tar

setenv exemplar /usr/local/exemplar set path=($path $EXEMPLAR/bin/SunOS4)

Installing Leonardo on a Sun SPARCstation 3-3

3

ense

from

ou

n”

Leonardo uses Version 5.0 of the FLEXlm License Manager. If the following errormessage is displayed while running Leonardo on a workstation with an existing licmanager:

you must stop the FLEXlm License Manager using the lmutil lmdown command; then restart the FLEXlm License Manager using the lmgrd executable from this software release.

Authorization Codes

To run Leonardo, you must obtain authorization codes for each feature purchasedExemplar Logic. You can contact Exemplar Logic Customer Service by e-mail ([email protected] ), fax (510-337-3799) or phone (510-337-3700). Have the host ID of the workstation running the license manager daemon ready when ycall.

Use the SunOS command hostid or the FLEXlm utility lmutil lmhostid to determine the correct host ID. For example:

where platform is either SunOS4 or SunOS5. If you are using backup (redundant)servers, go to “Backup (Redundant) Servers” section in the “FLEXlm Administratiochapter for more details.

Editing The License File

The sample license file, license.default , is located in the $EXEMPLAR/license directory. It consists of the following lines:

Security Error -12: Checkout of leonardo failed, incorrect data returned from license server.

$EXEMPLAR/license/ platform/lmutil lmhostid

SERVER server-name host-id 1700 DAEMON exemplard installation dir/license/ platformFEATURE feature exemplard version exp-date #users password ““ \ck= check sum


3

as a )

ing

o

two u

mal e

d of

u

the

nd of

All feature lines must be entered on a single line. The backslash (\) can be used continuation character to split FEATURE lines if desired. If used, the backslash (\must come after the password field, and be the last character on the line.

This is the standard format of a license file. Use any text editor to make the followchanges to the license file you receive from Exemplar Logic:

1. Edit the SERVER line by entering the server name and host ID that were used tobtain your authorization codes.

2. Edit the DAEMON line by entering the pathname to the Exemplar daemon (e.g. /usr/local/exemplar/license/SunOS4 ).

3. Make certain each FEATURE line is on a single line (or use the backslash continuation character at the end of the first line to break a FEATURE line into parts). If you are typing these lines, make sure they are entered exactly as yoreceived them. All entries are case sensitive.

Note – Both the authorization codes (passwords) and the host ID are in hexadeciformat, meaning they can only contain the digits 0-9 and the letters a-f (or A-F). Bcareful not to enter the letter O (instead of the number zero) or the letter l (insteathe number one).

4. To check the integrity of the license file, type:

If this utility displays any “BAD” FEATURE lines, recheck to make sure that:



c. Your host ID and authorization codes do not contain the letter O (instead ofnumber zero) or the letter l (instead of the number one)

d. Each feature line is on a single line (or use the backslash character at the eone line to break it into multiple lines, as shown in the sample above).

5. Name the license file license.dat .

lmutil lmcksum -c license_file


3

file is

mon

re


The default location of the license file is $EXEMPLAR/license/license.dat (or /usr/local/exemplar/license/license.dat if the EXEMPLAR environment variable is not set). If this location is changed, you must set the environment variable LM_LICENSE_FILE to include the new pathname (you may concatenate the new pathname to an existing pathname if more than one licensebeing used; see “Multiple License Files” on page 7 for additional information).

Installing the License Manager

Install the license manager before using Leonardo. Start the license manager daeby typing the following commands (all on one line)

Redirecting of output to a log file is helpful when debugging licensing problems. Platform is SunOS5 or SunOS4.

Note – If you already have a license manager daemon running, refer to “Multiple License Files” on page 7 for further information.

Other options available with the lmgrd command are:

• -t timeout Specify the time interval (in seconds) that daemons must complete connections to each other. The default value is 10seconds. A longer value may be desirable if the daemons abeing run on busy systems and/or a very heavily loaded network.

• -s interval Specify the log file time stamp interval (in minutes). The default is 360 minutes.

Starting the License Manager Automatically at Boot Time

• You may want to copy or link the license manager daemon lmgrd, the exemplar daemon exemplard , and/or the license file to a local directory, such as /etc . Make sure that you change the pathname accordingly.

$EXEMPLAR/license/ platform/lmgrd -c $EXEMPLAR/license/license.dat > $EXEMPLAR/license/license.log &


3

ger

s

o

e

ation

ant).

• Under SunOS4, you can add the same command that starts the license manadaemon lmgrd to the file /etc/rc.local or /etc/rc.boot on the license server.

• Under Solaris, create a shell script containing the same command, name it S99license.serv (or similar) and install in it the directory /etc/rc2.d. The license manager daemon will start automatically when you boot at runlevel 2 or higher.

Multiple License Files

If you are already running the FLEXlm License Manager daemon lmgrd, you can choose to merge the Exemplar license file into the current license file, or to use separate license files.

Merging License Files

To merge the Exemplar license file into an existing license file, copy the edited DAEMON and FEATURE lines from Exemplar's license.dat file into the existing license file. In addition, the existing server name and host ID must be the same athose used to obtain the Exemplar passwords. (The last number on the SERVER line in the existing file can be different from that on the list of authorization codes sent tyou; the default is 1700).

The environment variable LM_LICENSE_FILE must be set to the complete pathnamof the merged license file, or a link must be created from $EXEMPLAR/license/license.da t to the merged license file.

Separate License Files

To use separate license files, the Leonardo license file must be in the default loc$EXEMPLAR/license/license.da t, or your LM_LICENSE_FILE environment variable must be set to include both locations. For example:

where license_file_1 is the full pathname of the first license file, and license_file_2 is the full pathname of the second license file (or vice versa; the order is not signific

setenv LM_LICENSE_FILE license_file_1 : license_file_2


3

the

. If e the 700,

must is

ndor

lmgrd needs to be run explicitly on each license file by specifying the location of correct version of lmgrd and license file. For example:

Each lmgrd command, along with its options and the redirect, goes on a single linedifferent license managers are run on the same server machine, you must changport number on the server line of at least one of the license files (the default is 1change to 1701 or any other unused port).

Stopping and Starting FLEXlm

For a merged license file, if the license manager daemon is already running, you stop the license manager daemon and then restart it. Check to see if the daemonrunning by typing:

If lmgrd is running, stop the daemon by using the lmdown utility as follows:

You can also kill the process identified by the ps ax command:

However, this method is not recommended because it does not shut down any vedaemons already running, causing problems when you try to restart the license manager.

Once the shutdown is complete, restart the daemon as shown above using the lmgrd command.

/usr/local/exemplar/license/ platform/lmgrd -c license_file_1 > /usr/local/license1.log &/usr/local/old_flexlm/lmgrd -c license_file_2 > /usr/local/license2.log &

ps ax | grep lmgrd | grep -v grep

lmutil lmdown -c license file pathname

kill pid


Installing Leonardo on a HP Series 700 4

e. In

ap




• Licensing

Requirements

Hardware Requirements

• Leonardo programs and data files require about 100 MBytes of hard disk spacaddition, plan for 50 MBytes for your own design files and intermediate files.

• 32 Mbytes of RAM is the recommended minimum with at least 64 Mbytes of swspace.

Software Requirements

Leonardo requires HP UX 9.0 or later for HP700 environments.

4-1

4

m


Contact your Systems Administrator for help installing Leonardo if necessary.



3. Mount the CD by typing (requires you to be superuser):





Set the EXEMPLAR environment variable to the name of the directory into whichLeonardo is installed (e.g., /usr/local/exemplar ). The EXEMPLAR environment variable is used by Leonardo to locate parameter and library files. Add installation_directory/bin/HP-UX09 (e.g., /usr/local/exemplar/bin/HP-UX09) to your UNIX search path. This enables you to run Leonardo programs froany directory.

For example, type the following commands in a C shell:

Note – The new path does not take effect until the rehash command is executed.

These commands should be added to your. cshrc startup file.

/etc/mount -rt cdfs /dev/dsk/< SCSI id of CD-ROM drive>s0/cdrom

tar xvf /cdrom/HP-UX09.tar

setenv exemplar /usr/local/exemplar set path=($path $EXEMPLAR/bin/HP-UX09)


4

ber

ense

from

ou

” in

Licensing

Licensing for Leonardo is always a network (floating) license, where a specific numof licenses are available to any system on the network.

Call Exemplar Logic at 510-337-3700 or send email to [email protected] to obtain your authorization codes.

Leonardo uses the FLEXlm License Manager. Refer to “Installing the License Manager” on page 5 and Chapter 5, “FLEXlm License Administration” for more information on running FLEXlm.

Leonardo uses Version 5.0 of the FLEXlm license manager. If the following error message is displayed while running Leonardo on a workstation with an existing licmanager:

you must stop the FLEXlm License Manager using the lmutil lmdown command, then restart the FLEXlm License Manager using the lmgrd executable from this software release.

Authorization Codes

To run Leonardo, you must obtain authorization codes for each feature purchasedExemplar Logic. You can contact Exemplar Logic Customer Service by e-mail ([email protected] ), fax (510-337-3799) or phone (510-337-3700). Have the host ID of the workstation running the license manager daemon ready when ycall.

Run the FLEXlm utility lmutil lmhostid to determine the correct host ID. For example:

If you are using backup (redundant) servers, go to “Backup (Redundant) ServersChapter 5, “FLEXlm License Administration” for more details.

Security Error -12: Checkout of leonardo failed, incorrect data returned from license server.

$EXEMPLAR/license/HP-UX09/lmutil lmhostid

Installing Leonardo on a HP Series 700 4-3

4

as a \)

o

wo

they the er l

Editing The License File

The sample license file, license.default, is located in the $EXEMPLAR/license directory. It consists of the following lines:

All feature lines must be entered on a single line. The back slash (\) can be usedcontinuation character to split FEATURE lines if desired. If used, the back slash (must come after the password field, and be the last character on the line.

This is the standard format for a floating license. Use any text editor to make thefollowing changes to the license file you receive from Exemplar Logic:

1. Edit the SERVER line by entering the server name and host ID that were used tobtain your authorization codes.

2. Edit the DAEMON line by entering the pathname to the Exemplar daemon (e.g. /usr/local/exemplar/license/HP-UX09 ).

3. Make certain that each FEATURE line is on a single line (or use the back slash continuation character at the end of the first line to break a FEATURE line into tparts). If you are typing these lines, make sure they are entered exactly as youreceived them. All entries are case sensitive.

Note – The authorization codes (passwords) are in hexadecimal format, meaning can only contain the digits 0-9 and the letters a-f (or A-F). Be careful not to enterupper or lower case letter O (instead of the number zero 0) or the lower case lett(instead of the number one 1).

4. To check the integrity of the license file, type:

If this utility displays any “BAD” FEATURE lines, recheck to make sure that:


SERVER server-name host-id 1700 DAEMON exemplard installation dir/license/ platform FEATURE feature exemplard version exp-date #users password “” \ck= check sum



4

u

e the

nd of

file is

mon


c. Your host ID and authorization codes do not contain the upper or lower casletter O (instead of the number zero 0) or the lower case letter l (instead ofnumber one 1)

d. Each feature line is on a single line (or use the back slash character at the eone line to break it into multiple lines, as shown in the sample above).

5. Name the license file license.dat .


The default location of the license file is $EXEMPLAR/license/license.dat (or /usr/local/exemplar/license/license.dat if the EXEMPLAR environment variable is not set). If this location is changed, you must set the environment variable LM_LICENSE_FILE to include the new pathname (you may concatenate the new pathname to an existing pathname if more than one licensebeing used; see “Multiple License Files” on page 6 for additional information).

Installing the License Manager

Install the license manager before using Leonardo. Start the license manager daeby typing the following commands (all on one line):

Redirecting of output to a log file is helpful when debugging licensing problems.

Note – If you already have a license manager daemon running, refer to “Multiple License Files” on page 6 below for further information.

$EXEMPLAR/license/HP-UX09/lmgrd -c $EXEMPLAR/license/license.dat > $EXEMPLAR/license/license.log &


4

s

s

o

e

Other options available with the lmgrd command are:

• -t timeout Specify the time interval (in seconds) that daemons must complete connections to each other. The default value is 10 seconds. A longer value may be desirable if the daemonare being run on busy systems and/or a very heavily loadednetwork.

• -s interval Specify the log file time stamp interval (in minutes). The default is 360 minutes.

Starting the License Manager Automatically at Boot Time

• You may want to copy or link the license manager daemon lmgrd, the exemplar daemon exemplard , and/or the license file, license.dat, to a local directory, such as /etc . Make sure that you change the pathname accordingly.

• Add the same command that starts the license manager daemon lmgrd to the file /etc/rc for your system.

Multiple License Files

If you are already running the FLEXlm License Manager daemon lmgrd , you can choose to merge the Exemplar license file into the current license file, or to use separate license files.

Merging License Files

To merge the Exemplar license file into an existing license file, copy the edited DAEMON and FEATURE lines from Exemplar's license.dat file into the existing license file. In addition, the existing server name and host ID must be the same athose used to obtain the Exemplar passwords. (The last number on the SERVER line in the existing file can be different from that on the list of authorization codes sent tyou; the default is 1700.)

The environment variable LM_LICENSE_FILE must be set to the complete pathnamof the merged license file, or a link must be created from $EXEMPLAR/license/license.da t to the merged license file.


4

ation

ant).

the

e. If e the 700,

must is

Separate License Files

To use separate license files, the Leonardo license file must be in the default loc$EXEMPLAR/license/license.da t, or your LM_LICENSE_FILE environment variable must be set to include both locations. For example:

where license_file_1 is the full pathname to the first license file, and license_file_2 is the full pathname to the second license file (or vice versa; the order is not signific

lmgrd needs to be run explicitly on each license file by specifying the location of correct version of lmgrd and the license file. For example:

Each lmgrd command, along with its options and the redirect, goes on a single lindifferent license managers are run on the same server machine, you must changport number on the server line of at least one of the license files (the default is 1change to 1701 or any other unused port).

Stopping and Starting FLEXlm

For a merged license file, if the license manager daemon is already running, you stop the license manager daemon and then restart it. Check to see if the daemonrunning by typing:

If lmgrd is running, stop the daemon by using the lmdown utility as follows:

setenv LM_LICENSE_FILE license_file_1 : license_file_2

/usr/local/exemplar/license/HP-UX09/lmgrd -c license_file_1 > /usr/local/license1.log &/usr/local/old_flexlm/lmgrd -c license_file_2 > /usr/local/license2.log &

ps ax | grep lmgrd | grep -v grep



4

ndor

You can also kill the process identified by the ps ax command:

However, this method is not recommended because it does not shut down any vedaemons already running, causing problems when you try to restart the license manager.

Once the shutdown is complete, restart the daemon as shown above using the lmgrd command.

kill pid


FLEXlm License Administration 5

r

h

te

tions

Version Compatibility in FLEXlm

There are two basic compatibility rules for FLEXlm:

• A newer lmgrd can be used with an older vendor daemon, but a newer vendodaemon might not work properly with an older lmgrd .

• A newer vendor daemon (or lmgrd ) can be used with an older client program (sucas Leonardo or a FLEXlm utility), but a newer client program might not work properly with an older vendor daemon.

Use the utility program lmutil lmver to determine the version of a daemon. Locathe program in the $EXEMPLAR/license/ platform directory and use lmutil lmver daemon name (see the License Administration Tools section below).

The new version of the utility lmutil shipped with Leonardo software may not workwith old daemons. However, the old utilities should work with both the old and thenew daemons.

User Options

You can customize the Exemplar license manager daemon by using a daemon opfile. Following are option file keywords:

• RESERVE Reserve a license for a specific user.

• INCLUDE Allow a user to use a feature.

5-1

5

.

on.

e.

the

• INCLUDEALL Allow a user to use all features served by this vendor daemon

• EXCLUDE Deny a user access to a feature.

• EXCLUDEALL Deny a user access to all features served by this vendor daem

• GROUP Define a group of users for use with other commands.

• TIMEOUT Allows licenses that are idle to be returned after a specific tim

• NOLOG Turn off logging certain items.

The syntax for this file is as follows:

• RESERVE Number feature type name.

• INCLUDE Feature type name.

• INCLUDEALL Type name.

• EXCLUDE Feature type name.

• EXCLUDEALL Type name.

• GROUP Name users.

• TIMEOUT Feature timeout_in_seconds.

• NOLOG { IN | OUT | DENIED | QUEUED }

Type is GROUP, USER, HOST or DISPLAY. Use any standard text editor to createoptions file. Lines beginning with the # sign are treated as comments and ignored.

For example, the following options file reserves a copy of feature lGen for user pat , and two copies of the feature leonardo for anyone on the computer with the host name terry . It causes queued messages to be omitted from the log file, and userjoe is not allowed to access the lGen feature:

RESERVE 1 lGen USER patRESERVE 2 leonardo HOST terryEXCLUDE lGen USER joeNOLOG QUEUED


5

to lt

Edit the DAEMON line of the license file and add the full pathname of the options filethe end of the line as an argument. For example, if the options file is in the defaulocation (with other Exemplar licensing files) and named license.options , the DAEMON line reads (all on one line):

DAEMON exemplard /usr/local/exemplar/license/ platform/usr/local/exemplar/license/license.options

FLEXlm License Administration 5-3

5

se

g n

.

License Administration Tools

The following license administration utilities are included in the $EXEMPLAR/license/ platform directory:

• lmutil lmdown Allows for shutdown of all license daemons (both lmgrd and all vendor daemons).

• lmutil lmremove Allows the system administrator to remove a single user's license for a specified feature.

• lmutil lmreread Causes the license daemon to reread the licenfile and start any new vendor daemons that have been added. In addition, all pre-existing daemons will re-read the license file for changes in feature licensing information.

• lmutil lmstat Monitors license activities, including daemonsrunning and users of individual features (see options below).

All of the above accept the -c license file pathname option that is used to ensure thecorrect license file is being read. For usage notes on these tools, see the followinsections. Usage of lmdown and lmremove should be restricted, as these utilities caseverely disrupt application program usage.

Use the following utilities for information:

• lmutil lmhostid Reports the exact host ID that the license manager expects to use on any given machine

• lmutil lmver filename Reports the license manager version of the license manager daemon (lmgrd ) or vendor daemon (such as exemplard ).

LMDOWN Usage

Use with lmgrd to stop and restart the license manager.

lmutil lmdown [-c license_file ]


5

s

t get cause

LMREMOVE Usage

Removes all instances of user on node host (on display display , if specified) from usage of feature . This is normally only required when the licensed user warunning the software on a node that crashed and left the license checked out.

LMREREAD Usage

Use instead of lmdown/lmgrd to allow for the updating of a license file with a newfeature or expiration date. However, there can be a timing problem in doing this (particularly with license files containing many daemons), so that a daemon mighthe message to shut down after the license manager has tried (unsuccessfully, beit's still running) to restart it. It is better to use lmdown followed by lmgrd .

LMSTAT Usage

For example, to check the users that are currently using the leonardo feature, type:

lmutil lmremove [-c license_file ] feature user host [ display ]

lmutil lmreread [-c license_file ]

lmutil lmstat [-c license_file ] [-a] [-S [ DAEMON]] [-f [ feature ]] [-s [ server ]] [-t value ]

-c license_file Use license file -a Display everything -S [ DAEMON] List all users of DAEMON's features -f [feature ] List users of feature (s) -s [ server ] Display status of server node(s) -t value Set connection timeout to value

lmutil lmstat -c /usr/local/exemplar/license/license.dat -f leonardo


5

ould tinue rs.

ple

. In d

rver

Backup (Redundant) Servers

If the Leonardo software is located on a single file server, only a single server shbe used. If the software is installed on two or more servers and if you want to conto work when one of the servers goes off-line, you may want to use backup serveOnly in very volatile situations or in very large networks should more than three servers be required, because the system remains fully functional as long as a simmajority of the servers are running.

To use backup servers, a copy of the license file must be located on each serveraddition, the lmgrd and exemplard daemons must be copied to each system, anthe license manager daemon must be running on each system.

Contact the Exemplar Logic Customer Support Hotline representative with the sename and host ID for each server when requesting authorization codes.

Common Licensing Questions and Problems

Q. Why do I have to use -c license file pathname?

A. The -c license file pathname option must be used to locate the license file if it is not in the FLEXlm default location:

Under UNIX: /usr/local/flexlm/licenses/license.dat

Under Windows: c:\flexlm\license.dat

This option is used when starting the license manager daemon lmgrd and when using the FLEXlm license utilities lmutil lmdown , lmreread , lmstat and lmremove . Note that this may not be required if your LM_LICENSE_FILE variable is set to the appropriate location, but it is still recommended for consistency and validation

Warning – The pathname specified must include the name of the file itself (e.g., license.dat) as well as the directory where this file resides.

Q. What if I don’t have a C:\flexlm directory on my Windows PC?

A. Create the directory using the mkdir command, as follows

mkdir c:\flexlm


5

on

he

see ou

Q. Do I have to set my LM_LICENSE_FILE environment variable?

A. You must set the LM_LICENSE_FILE environment variable to run Exemplar Logic's Leonardo software if the license file resides anywhere except the Leonardo default location $EXEMPLAR/license/license.dat (under UNIX), or c:\flexlm\license.dat (under Windows).

For the UNIX platform, this is true even if you are using FLEXlm's default locati/usr/local/flexlm/licenses/license.dat . This requirement can be avoided by creating a link from the Exemplar default to the actual location of tlicense file, as follows:

Under Windows, there may be a significant delay for lmgrd to recognize the license file in the default location if the environment variable LM_LICENSE_FILE is not set. It is therefore recommended to set the environment variable LM_LICENSE_FILE even when the license file is in the default location c:\flexlm\license.dat

Q. What if I have two different license files?

A. You may set your LM_LICENSE_FILE environment variable to a concatenatedpathname, as follows:

Q. How can I see the status of my license file?

A. Run the lmutil lmstat utility (in $EXEMPLAR/license/ platform) on the license server, as follows

This gives you the current status of all licenses in the named license file. If youany problems, look at the log file into which you redirected your output when ystarted the license manager daemon.

ln -s license file pathname $EXEMPLAR/license/license.dat

Under UNIX: setenv LM_LICENSE_FILE license file 1: license file 2Under Windows: set LM_LICENSE_FILE= license file 1; license file 2

lmutil lmstat -c license file pathname -a


5

log file. g wn, d

or

nds; nute

st

or d. The r to

Q. What if I don't have a log file?

A. If you are having problems with your license manager, and you do not have afile, bring the license manager daemon down and back up, this time with a logThe log file is the quickest and easiest method for determining what is causinproblems with a license file. To bring the current license manager daemon dodo the following (you should be logged in as root or the same user who startelmgrd ):

Then restart the license manager daemon as directed:

You can then review the log file to determine what is causing your problems. Fwindows, if you run lmgrd as a service, the log file is c:\windows\system32\lmgrd.log .

Q. When I bring down the license manager daemon, will this kill any programs currently using the license manager?

A. Most FLEXlm programs will attempt to reconnect to a vendor daemon if that connection is lost. FLEXlm's default is to check the connection every 30 secoif a lost connection is discovered, the default is to recheck five times at one miintervals. Although all of this may differ from one program to another, most programs do not have a problem when a connection is lost as long as the connection is reestablished within five minutes.

Q. Why do I have to bring the license manager down and back up, instead of juusing lmutil lmreread ?

A. There is a known problem with lmutil lmreread involving timing, particularly if your license file is large: the request to restart one or more venddaemons may be processed before the request to shut them down has finishenet result is that the vendor daemon is shut down, but not restarted. It is safeuse lmutil lmdown , followed by lmgrd .


lmgrd -c license file pathname > license file logname &


5

e host

u

e

and

ort

,

rver?

PC

Q. How do I know if it is OK to merge my license files?

A. You may merge all license files that run on the same server and have the samID specified on the SERVER line (if multiple SERVER lines are used, all must match). Note that it does not matter if the port number on the SERVER line does not match because this is user specified (the default is 1700).

Q. Why do I have to use lmutil lmdown , instead of just killing the lmgrd process?

A. When you kill the lmgrd process, the vendor daemons continue to run. Then,when you restart the lmgrd , the restart of the vendor daemons will fail, and yowill see messages like the following in your log file:

If you see such messages, you should kill all xxx daemon processes and restart thlicense manager.

Q. Do I have to restart the license manager when I just change expiration datespasswords?

A. It may not be necessary to stop and restart the license manager when a DAEMON or FEATURE line is added or changed. Instead, you may use the lmutil lmreread utility, as follows:

Note – lmutil lmreread may not be used to change the server hostname or pnumber, the path to the license file, or to have a vendor daemon reread its option file. In these cases, or if lmutil lmreread fails for any other reason (see above)you should stop and restart the license manager daemon as directed.

Q. Can a mixed network of Sun, HP and PC machines have a single license se

A. Yes, a single license server running on the network can service Sun, HP andmachines with floating licenses.

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

lmutil lmreread -c license file pathname


5

an er

m

can

the

Q. Does the license server for a mixed network have to be a Sun?

A. No, the server can be a Sun or an HP (or even a PC, if the UNIX machines caccess it) as long as you have purchased software for that platform. The servsoftware comes with Leonardo for that platform.

Under Windows, if you want to use a Unix license server, copy the license file frothe license server to the default location (c:\flexlm\license.dat ) or to the directory determined by the environment variable LM_LICENSE_FILE, after starting the license manager on the license server. Alternatively, on the client machine youset the environment variable LM_LICENSE_FILE to:

license server TCP/IP port@server hostname

For example, if the license server hostname is master and it uses TCP/IP port 1700 for the license manager daemon, type:

Q. Do I need a new license for my Sun to add an HP or a PC?

A. No, if you have an existing Sun license server, you can put the HP or PC on network. It can use the same LM_LICENSE_FILE as the Sun.

Q. I edited the license file, how do I make sure I did not accidentally corrupt it?

A. A quick way to check the integrity of the license files is:

Contact Exemplar Logic if the program reports any ”BAD” feature line.

set LM_LICENSE_FILE=1700@master



Documents

Leonardo Installation Guide - cs.huji.ac.il