Installing Floating Codewords on PC =================================== ================================================================== IMPORTANT NEWS/CHANGES IN ADS/RFDE LICENSING ================================================================== ADS/RFDE 2004A is the first release that offers License Backward Compatibility (LBC). We made changes to our licensing software that allow users to run both versions (2003 and 2004) with the same licenses, as long as the licenses are keyed to the newer version. For example, to be able to run ADS2003C and ADS2004A, you'd need to have codewords for ADS2004A available in your server. The example line below shows the changes made to the increment lines (version 2.34): INCREMENT ads_schematic agileesofd 2.34 01-jun-2005 2 \ VENDOR_STRING="5E700060A111 : JRDNMSO IWSPGBB ICHLEDL \ ICUNETS MCTENRX YGRTAKP SOG" SIGN="0129 3D82 9EED A56B \ 87AC 22D3 F27F CDC4 AF52 C4BD 2403 901E 17B2 75FC 00A2 \ 6033 79D0 5D3F F333 863F 4BD1" \ System Admininstrators will need to upgrade their licensing software to version 9.2 (we distribute this version with the ADS/RFDE installations under the licenses directory), this includes lmgrd, lmutil, lmtools and agileesofd. For the latest news in License backward compatibility and license management changes, read your release notes and/or the installation manual, Chapter 3. ! ! WARNING ! ! DON'T UPGRADE THE LMGRD AND UTILITIES TO VERSIONS FLEXnet 10.X , THESE VERSIONS HAVE A BUG THAT KEEPS agileesofd FROM RUNNING ================================================================== ================================================================== 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 (2002), you should be aware that license bundles have replaced PACKAGE codewords in ADS 2003C and 2004A. You must now select the bundle(s) you wish to use with the Agilent License Preference tool. See the section "Using the Preference Tool," below 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 ------------- 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 ADS installed on it. 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 versions of the FLEXID drivers are loaded. You can load them by running the 'flexid.exe' program included on the ADS 2004A Installation CD-ROM. Alternatively, you can download flexid.exe from our web site: http://edasupportweb.soco.agilent.com/portal/page?_pageid=34,38418&_dad=portal&_schema=PORTAL 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 to an existing file, you will want to simply append the INCREMENT lines from your new license file to your existing file. 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:\ads2004A\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 ADS is installed on the license server, you can place the license.lic in the licenses folder of the ADS installation. For example: c:\ads2004A\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-5E700360A111 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 Agilent License Manager Tool: Start > Program Files > Advanced Design System 2004A > ADS Tools > License Information Tool 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 FLEXID=8-5E700360A111 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:\ads2004A\licenses\bin\agileesofd 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:\ads2004A\licenses\bin lmgrd -app -c ..\license.lic -l ..\adsflexlog.txt In this example, the lmgrd supplied with ADS 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 You can also run a custom install of ADS and choose to only install the FLEXlm software. This is a good way to get all of the latest FLEXlm software for ADS. After starting lmgrd, wait about 10 to 15 seconds and then look at the contents of adsflexlog.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 3 of the ADS Installation Guide for a way to automate the startup of lmgrd. 5. You should now be ready to run ADS. Any machine that will run ADS (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 the following environment variable 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 specified by the environment variable LM_LICENSE_FILE for ADS/RFDE 2003A/C and 4A. 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. 6. You are now ready to run ADS. ------------------------------------------------------------------------------------------------------------ ***************** USING THE LICENSE PREFERENCE TOOL ************** ------------------------------------------------------------------------------------------------------------ ADS2004A 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 2004A > 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:\ADS2004A\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_LICPREF_ in the configuration file:: $HOME\hpeesof\config\hpeesof.cfg Where $HOME is the location where you keep your projects. For more information about selecting codeword bundles for use with ADS and RFDE, new features and customization options, 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 system does not match the hostid specified in the license file. Feature: ads_schematic Hostid: FLEXID=8-5E700360A111 FLEXIm error -9,57" To fix this problem, load the new Sentinel drivers by running the flexid.exe executable on the ADS 2004A 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 2004A Installation CD-ROM. You will find flexid.exe in the top-level directory of the CD-ROM. o Check the adsflexlog.txt file on the license server for errors. o Be sure you have set the AGILEESOFD_LICENSE_FILE environment variable correctly. 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 Macrovision Software http://www.macrovision.com/services/support/software_licensing.shtml Rev.11022004