Installing Nodelocked Codewords for ICCAP 2004 on Unix ======================================================= The following instructions outline a quick procedure for installing your new codewords. If you would like more detailed instructions, please refer to Chapter 2 of the "Installation and Customization" guide. Read the Prerequisites, follow the Procedure, and if you run into problems, please read the "Common Problems and More Help" sections and/or contact Technical Support at 1-800-473-3763, or at our website: http://eesof.tm.agilent.com/index.html Select The "Technical Support" link. Prerequisites ------------- Agilent EEsof EDA software can be nodelocked to your Unix workstation's unique host ID. The license server and the machine the license is locked to can be two different machines. You can determine the host ID of your Unix workstation using the command for your platform: HP-UX: uname -i SunOS: hostid If you will be serving ADS and ICCAP licenses from your license server, you must use the agileesofd vendor daemon that provided with ADS 2003 or later. The vendor daemon is available via the web from: http://eesof.tm.agilent.com/support/supp203.html Procedure --------- The following procedure assumes you are installing codewords for the first time. If you are adding codewords, you will want to simply append the INCREMENT lines from your new license file to your existing file in step 2. You can then use the lmreread command to notify your license server to reread the license file and enable the new licenses: lmutil lmreread -c ../license.lic It is strongly recommended that you remove any expired licenses from your license.lic file. Keeping the license file as short as possible will prevent confusion and trouble. 1. Save the license.lic attachment to a file on your machine. 2. Place the license.lic file on the license server. The license server may or may not be the machine to which your licenses are nodelocked. The license server's host ID is specified on the SERVER line in your license.lic file. If ICCAP is installed on the license server, you can place the license.lic in the $ICCAP_ROOT/licenses directory. For example: /apps/iccap_2004/licenses/license.lic The host ID that licenses are nodelocked to is specified on each INCREMENT line by 'HOSTID='. Remember, the host ID the license is locked to doesn't have to be the same as the license server's host ID. 3. Once you have the license.lic file in place on the license server, verify the correctness of the information on the SERVER and VENDOR lines. The SERVER line must contain the hostname of the license server and its host ID. For example: SERVER joshua 80fb214d We often send the license.lic file with hostname set to 'unknown'. This MUST be changed to the correct hostname. Optionally, you may want to specify a specific TCP port for the license server to listen to for license requests. If a TCP port is not specified, as in the example above, FLEXlm will default to the first available port in the range 27000 to 27009. To specify a TCP port, modify the SERVER line as follows: SERVER joshua 80fb214d 27005 In this example, the TCP port is set to 27005. The VENDOR line controls which vendor daemon will be started. It must contain the name of the vendor daemon. For example: VENDOR agileesofd As long as the vendor daemon exists in the same directory that lmgrd is started from, this is sufficient. You may want to specify the exact location of the agileesofd daemon executable as follows: VENDOR agileesofd /apps/iccap_2004/licenses/bin/agileesofd 4. Once the information on the SERVER and VENDOR lines is correct, start the FLEXlm license manager on the license server machine. For example, cd /apps/iccap_2004/licenses/bin ./lmgrd -c ../license.lic -l ../flex.log In this example, the lmgrd supplied with ICCAP is started. The path to the license.lic file is specified using the '-c' option and a log file is started using the '-l' option. You MUST use a version of lmgrd that is equal to or greater than the version of agileesofd. You can check the versions of lmgrd and agileesofd as follows: ./lmgrd -v ./agileesofd -v The latest version of lmgrd can be downloaded from the Globetrotter Software web site (see the URL in the More Help section below). You can also run a custom install of ICCAP and choose to only install the FLEXlm software. This is a good way to get all of the latest FLEXlm software for ICCAP. After starting lmgrd, wait about 10 to 15 seconds and then look at the contents of flex.log. You should not see any errors and you should see that agileesofd started successfully and has enabled the licenses contained in your license.lic file. 5. You should now be ready to run ICCAP from the machine(s) whose host ID matches the host ID the licenses are locked to. The client machine must be able to locate the license server. Continuing with the examples above, the license server is named joshua. If no TCP port was specified on the SERVER line, set the following environment variable: [Korn/Bourne Shell] LM_LICENSE_FILE=@joshua or AGILEESOFD_LICENSE_FILE=@joshua export LM_LICENSE_FILE or export AGILEESOFD_LICENSE_FILE [C Shell] setenv LM_LICENSE_FILE @joshua or setenv AGILEESOFD_LICENSE_FILE @joshua NOTE: the AGILEESOFD_LICENSE_FILE variable overides LM_LICENSE_FILE for ICCAP 2004. If a TCP port was specified on the SERVER line, set the environment variable as follows: [Korn/Bourne Shell] LM_LICENSE_FILE=27005@joshua export LM_LICENSE_FILE [C Shell] setenv LM_LICENSE_FILE 27005@joshua You will want to use the actual TCP port number you specified on your SERVER line. 6. You are now ready to run ICCAP. Common Problems --------------- If you are having trouble after following the procedure above, please check the following: o Check the flex.log file on the license server for errors. o Be sure you are starting ICCAP from the machine whose host ID is specified by 'HOSTID=' on the INCREMENT lines in the license.lic file. o Attempt to checkout the 'iccap_environmnt' license using the chksec utility supplied with ICCAP: cd $ICCAP_ROOT/licenses/bin chksec -d -c 27005@joshua iccap_environment Be sure to use the TCP port number and hostname of your license server. Alternatively, you can specify the full path to your license.lic file as in: chksec -d -c /apps/iccap_2004/licenses/license.lic iccap_environment The output will contain extra debugging information and can be very helpful in determining what the problem is. If you are unable to determine the problem, save the output from chksec as follows: chksec -d iccap_environment > csout.txt and send csout.txt, along with your license.lic file, to Agilent EEsof EDA Technical Support: eesof_support@agilent.com More Help --------- ICCAP Installation and Customization Guide, Chapter 5 http://eesof.tm.agilent.com/docs/ Technical Support Knowledge Center http://www.agilent.com/find/eesof-knowledgecenter Technical Support http://eesof.tm.agilent.com/assist/contact.html Globetrotter Software http://globetrotter.com/flexlm/lmgrd.shtml (latest lmgrd) http://www.globetrotter.com/manual.htm Rev.05242004