Installing Nodelocked Codewords 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 3 of the "Installation on PC Systems" guide. Read the Prerequisites, follow the Procedure, and if you have trouble, please read the Common Problems and More Help sections. IMPORTANT: ---------------------------------------------------------------------------- If you have been using codeword packages or Limited Term Packages (LTP) in previous versions, you should be aware that license bundles have replaced PACKAGE codewords in ADS 2003A. You must now select the bundle(s) you want to use with the Agilent License Preference tool. See the section "Using the Preference Tool," bellow for quick instructions, or for more detailed information about selecting codeword bundles , please refer to the Installation Guide (ADS or RFDE), Chapter 4, "Using Advanced Design System". ---------------------------------------------------------------------------- Prerequisites ------------- Agilent EEsof EDA software can be nodelocked to your PC's ethernet address or to a hardware key or dongle. IMPORTANT: If you are using a hardware key, please make sure the latest version of the FLEXID drivers are loaded on your PC. You can load them by running the 'flexid.exe' program located in the root (top-level) directory of the ADS 2003A 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. 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. 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 PC. 2. Place the license.lic file into the licenses folder of your ADS installation. For example: c:\ads2003A\licenses\license.lic 3. Nodelocked licenses do not require you to start FLEXlm software. 4. By default, ADS will look for licenses in: c:\ads2003A\licenses\license.lic You may override this using the LM_LICENSE_FILE or AGILEESOFD_LICENSE_FILE environment variables. If LM_LICENSE_FILE is set, ADS will look for licenses in the file it points to. The LM_LICENSE_FILE environment variable may be overridden by setting AGILEESOFD_LICENSE_FILE. 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. Before launching ADS or RFDE, you need to set your license preferences, using the new "License Preference Tool". See the "Using the License Preference Tool" section bellow. 5. You should now be ready to run ADS. ------------------------------------------------------------------------------------------------------------ ***************** USING THE LICENSE PREFERENCE TOOL ************** ------------------------------------------------------------------------------------------------------------ ADS2003A has a new feature, "license preference tool" that will allow you to select what licenses to access when launching ADS, Dynamic Link or RFDE. This tool gives you more control over license usage than was previously available with license packages. You will need to know how to use the preference tool to choose bundles prior to running ADS, RFDE or Dynamic Link. To run the License Preference tool: UNIX There are two ways to start the License Preference tool. In a terminal window: When starting ADS, enter > ads -p This runs the License Preference tool, and then runs ADS after you finish choosing bundles. To run the tool as a stand-alone utility, enter: > $HPEESOF_DIR/bin/aglmpref. This runs only the License Preference tool. WINDOWS There are two ways to start the License Preference tool: Launch the tool in stand-alone mode, from your Start menu choose: Programs > Advanced Design System 2003A > ADS Tools > License Preference Tool. To launch the tool before launching ADS, modify the Advanced Design System shortcut located on the Start menu. Right-click the Advanced Design System icon, and choose Properties. Edit the shortcut command on the Target line to include the -p option as shown here: C:\ADS2003A\bin\ads.exe -p This runs the License Preference tool every time you start ADS. The License Preference window appears, enabling you to view the available bundles and their features, and select bundles. To see the features available in a bundle, click the expansion icon next to the bundle name under Available License Bundles. To select a bundle, choose one of the bundles listed under Available License Bundles, then click Add. The selected bundle appears under Selected License Bundles. Select your license preferences, and select OK, this will close the tool and launch ADS. The License Preference tool will set the environment variable AGILEESOFD_LICENSE_PREFERENCE in: UNIX: $HOME/.flexlmrc WINDOWS Registry: HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager For more information about selecting codeword bundles for use with ADS and RFDE, please refer to the Installation Guide, Chapter 4, "Using Advanced Design System". Common Problems --------------- If you are having trouble after following the procedure above, please check the following: o "hostid of this sysem does not match the hostid specified in the license file. Feature: ads_schematic 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 ADS 2003A Installation CD-ROM. You will find flexid.exe in the top-level directory of the CD-ROM. o "invalid host" error To fix this problem, load the new Sentinel drivers by running the flexid.exe executable on the ADS 2003A Installation CD-ROM. You will find flexid.exe in the top-level directory of the CD-ROM. o Does the hardware key number or ethernet address specified in the license.lic file match the hardware key or ethernet address on your PC? The ID that the licenses are nodelocked to is specified by the 'HOSTID=' field on the INCREMENT lines in your license.lic file. You can determine the ethernet address or hardware key ID for your PC using the aglmtool utility as follows: From the Start menu: Start > Programs > Advanced Design System 2003A > ADS Tools > License Information Tool Alternatively, you can use the following commands from a command prompt: cd /d c:\ads2003A\licenses\bin lmutil lmhostid -flexid (to read hardware key) lmutil lmhostid (to read ethernet address) o Is the license.lic file in the correct location and is it named correctly? By default, ADS expects to find a file named license.lic in the licenses folder of your ADS installation directory. Sometimes, the file is incorrectly renamed 'license.lic.txt' or 'license.lic.doc'. Using the Command Prompt, check that the name is correct, for example: C:\>cd \ads2003A\licenses C:\ads2003A\licenses>dir Volume in drive C is SysDisk Volume Serial Number is 3440-4D0A Directory of C:\ads2003A\licenses 02/25/2002 10:06 . 02/25/2002 10:06 .. 02/21/2002 15:15 bin 02/22/2002 14:17 994 license.lic 02/21/2002 15:15 vendors 1 File(s) 994 bytes 4 Dir(s) 6,232,678,400 bytes free C:\ads2003A\licenses> If the file is not named correctly, rename it: ren license.lic.txt license.lic Or recopy the file from your original email attachment. o Attempt to checkout the 'ads_schematic' license using the chksec utility supplied with ADS. From a command prompt: cd /d c:\ads2003A\licenses\bin chksec -d ads_schematic 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 ads_schematic > csout.txt and send csout.txt, along with your license.lic file, to Agilent EEsof EDA Technical Support: eesof_support@agilent.com More Help --------- ADS Installation Guide, Chapter 3 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.04282003