Installing Flexlm Network License Manager on 64 Bit Linux OS

You should install and configure the flexlm license manager prior to installing Artwork's Qckvu3 and Care Area Wizard application.

Download the flexlm for Linux 64 from Artwork's support page. The download link is flexlm.linux64.v113.tar

Create a directory to hold the flexlm license manager executables, utlities and license file. In this example we are using a directory called /opt/flexlm. Copy the flexlm tarball to this directory.

$ cd /opt
$ mkdir flexlm
$ chmod 777 flexlm
$ cd flexlm
$ cp /home/downloads/flexlm.linux64.v113.tar  .

$ tar xvf flexlm.linux64.v113.tar

You will see a number of files extracted from the tar ball.

artwork        artwork's daemon
liseater       test utility (artwork's)
liseater.dyn   test utility (artwork's)
lmborrow       used to "borrow" a license
lmdiag         used to diagnose an installation
lmdown         used to shut down license manager
lmgrd          the license manager service
lmhostid       use to obtain a machine's hostid
lminstall      
lmpath
lmremove      
lmreread       ese to reread a license file
lmstat         use to obtain license server status
lmswitch
lmswitchr
lmutil         flexlm utilty
lmver          use to get version

The license file you received from Artwork must be customized in order to work. First you must customize the SERVER line to make sure it contains your machine's hostname, hostid and a port on which the license server will listen.

Second, you must customize the VENDOR line in order to properly start up the artwork daemon.

For example, suppose your license server machine is named asmsc37 and you have determined that the hostid of your machine is 00142a9bed4f (by using the utility lmhostid). You request a license from Artwork for this machine and you receive by email the following codes:

SERVER enter_server_name 00142a9bed4f
VENDOR artwork enter_path_to_daemon

# QCKVU3 GDSII
FEATURE ACS58IO artwork 1.0 01-nov-2008 3 SIGN="0084 D858 0251 62AE \
52B2 9E7E 1BFD 7A00 9799 2BAF C01F 72A9 FB26 1DA3 7DC9"

# QCKVU3 OASIS
FEATURE ACS583O artwork 1.0 01-nov-2008 3 SIGN="000B 17CE 97C7 558D \
C105 753F 41F5 D000 7BC4 A820 91EE 313D 9AE4 88F9 E353"

We paste this into a file called license.dat and place it in the /opt/flexlm directory. The we edit the SERVER line to match our hostname and select a port for the license manager to use. In our example we are going to select port 1703. The server line now looks like:

SERVER asmsc37 00142a9bed4f 1703

Now we have to configure the VENDOR line so that the artwork daemon starts up. We do this by proper ly entering the path and daemon name.

VENDOR artwork /opt/flexlm/artwork

Our customized license file, license.dat, now looks like:

SERVER asmsc37 00142a9bed4f 1703
VENDOR artwork /opt/flexlm/artwork

# QCKVU3 GDSII
FEATURE ACS58IO artwork 1.0 01-nov-2008 3 SIGN="0084 D858 0251 62AE \
52B2 9E7E 1BFD 7A00 9799 2BAF C01F 72A9 FB26 1DA3 7DC9"

# QCKVU3 OASIS
FEATURE ACS583O artwork 1.0 01-nov-2008 3 SIGN="000B 17CE 97C7 558D \
C105 753F 41F5 D000 7BC4 A820 91EE 313D 9AE4 88F9 E353"

Starting Up the License Manager for the First Time

It is a good idea to manually start up the license manager and then test it. Once you have done this successfully, you can write a small start up script so that each time this machine is rebooted, the license manager automatically starts.

$  /opt/flexlm/lmgrd   -c /opt/flexlm/license.dat   -l /tmp/flexlm.log

If you have done everything correctly the lmgrd process will start up, it will read the license file called license.dat and that will start up the artwork vendor daemon. A log file in tmp will be opened called flexlm.log.

If you open the flexlm.log file you will find some messages that tell you that the license manager is up and the daemon is up and which products are licensed. An excerpt is shown below:

17:32:50 (lmgrd) FLEXnet Licensing (v11.3.0 build 28877) started on asmsc37 (linux) (10/1/2008)
17:32:50 (lmgrd) Copyright (c) 1988-2006 Macrovision Corporation. All Rights Reserved.
17:32:50 (lmgrd) US Patents 5,390,297 and 5,671,412.
17:32:50 (lmgrd) World Wide Web:  http://www.macrovision.com
17:32:50 (lmgrd) License file(s): license.dat
17:32:50 (lmgrd) lmgrd tcp-port 1703
17:32:50 (lmgrd) Starting vendor daemons ... 
17:32:50 (artwork) FLEXnet Licensing version v11.3.0 build 28877
17:32:50 (lmgrd) Started artwork (internet tcp_port 33672 pid 12237)
17:32:50 (artwork) Server started on asmsc37 for:       ACS58IO
17:32:50 (artwork) ACS583O
17:32:50 (lmgrd) artwork using TCP-port 33672

Troubleshooting

If the lmgrd or the artwork daemon does not start up there are several likely problems:

• license codes - verify that you have correctly copied the license codes (we highly recommend that you cut and paste as opposed to actually typing them in) and that you have not inadvertently dropped a line or a character or introduced a line break where none should be.

• hostid - verify that you have supplied the correct hostid to Artwork and that this hostid is reflected on the SERVER line. Make sure that you use the lmhostid utility to obtain the hostid and not some other method.

• Customizing - verify that you have correctly customized the SERVER line for your machine and customized the VENDOR line to point to the location of the artwork daemon.

• Permissions - verify that lmgrd and artwork have execute permissions and license.dat has read permissions and that when you start them you have sufficient permissions to do so.

• 32/64 - verify that you downloaded the 64 bit version of flexlm if you are running a 64 bit Linux OS.

• Environment Variable - while this does not affect start up, if your applications cannot find the license manage r or if they find the "wrong" license manager make sure the environment variable, LM_LICENSE_FILE, is set to the correct port and server. In this example LM_LICENSE_FILE=1703@asmsc37.