Installing Floating Codewords for ICCAP 2004 on PC =================================================== 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 ------------- Floating licenses are served by a license server on a network. Any machine on the network can checkout a license up to the total number of licenses. The license server doesn't have to have ICCAP installed on it. All it needs to have is the FLEXlm software (lmgrd and lmutil), and the Agilent EEsof EDA vendor daemon (agileesofd). All these files are located under the C:/iccap_2004/licenses folder. If your license server will serve both ADS and ICCAP licenses, make sure you use the agileesofd vendor daemon that came with ADS 2003A or higher. If your license server is a PC, the license server information on the SERVER line contains either the ethernet address or hardware key ID of your license server. IMPORTANT: If you are using a hardware key on the license server (PC only), please make sure the latest version of the FLEXID drivers are loaded. You can load them by running the 'flexid.exe' program included on the ICCAP 2004 Installation CD-ROM. Alternatively, you can download flexid.exe from our web site: http://eesof.tm.agilent.com/support/supp203.html Look for the Hardware Key Drivers download. Note: ADS and ICCAP use the same flexid drivers. 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: cd /d c:\iccap_2004\licenses\bin 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's host ID is specified on the SERVER line in your license.lic file. If you have more than one SERVER line, you need to follow steps 2 through 4 on each of the license servers. If ICCAP is installed on the license server, you can place the license.lic in the licenses folder of the ICCAP installation. For example: c:\iccap_2004\licenses\license.lic 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 FLEXID=8-5E700097C123 We often send the license.lic file with hostname set to 'unknown'. This MUST be changed to the correct hostname. You can determine your license server's hostname using the following command from a DOS command window: c:\>ipconfig /all Optionally, you may want to specify a TCP port for the license server to listen 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 FLEXID=8-5E700097C123 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 c:\iccap_2004\licenses\bin\agileesofd.exe Be sure to specify the actual location on your license server. 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 /d c:\iccap_2004\licenses\bin lmgrd -app -c ..\license.lic -l ..\flexlog.txt 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 flexlog.txt. 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. Please see Chapter 2 of the Installation and Customization Guide for a way to automate the startup of lmgrd. 5. You should now be ready to run ICCAP. Any machine that will run ICCAP (client) 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 one of the following environment variables in the system or user environment: AGILEESOFD_LICENSE_FILE=@joshua If a TCP port was specified on the SERVER line, set the environment variable as follows: AGILEESOFD_LICENSE_FILE=27005@joshua You will want to use the actual TCP port number you specified on your SERVER line. For help with setting environment variables in Windows, please select Start > Help, select the Index tab and enter 'environment variables', then select 'adding' or 'changing' as appropriate. Note: AGILEESOFD_LICENSE_FILE will override any settings specifed by the environment variable LM_LICENSE_FILE. In ICCAP 2004, the AGILEESOFD_LICENSE_FILE variable is recognized on the PC & Unix clients. 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 "hostid of this system does not match the hostid specified in the license file. Feature: iccap_env Hostid: FLEXID=7-36c7c388 FLEXIm error -9,57" To fix this problem, load the new Sentinel drivers by running the flexid.exe executable on the ICCAP 2004 Installation CD-ROM. You will find flexid.exe in the top-level directory of the CD-ROM. You can also download flexid.exe from the web site mentioned in the prerequisites section above. o "invalid host" error To fix this problem, load the new Sentinel drivers by running the flexid.exe executable on the ICCAP 2004 Installation CD-ROM. You will find flexid.exe in the top-level directory of the CD-ROM. You can also download flexid.exe from the Web as described in the prerequisites section above. o Check the flexlog.txt file on the license server for errors. o Be sure you have set the AGILEESOFD_LICENSE_FILE environment variable correctly. Remember that AGILEESOFD_LICENSE_FILE overrides any LM_LICENSE_FILE setting on PC and Unix. o Attempt to checkout the 'iccap_env' license using the chksec utility supplied with ICCAP. From a command prompt: cd /d c:\iccap_2004\licenses\bin chksec -d -c 27005@joshua iccap_env 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 c:\iccap_2004\licenses\license.lic iccap_env 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_env > 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 2 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.05252004