INSTALLING NODELOCKED CODEWORDS ON UNIX ======================================== ================================================================== 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="5E600060B111 : 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 ADS2004A/RFDE Codewords. If you would like more detailed instructions, please refer to Chapter 3 of the "Installation on Unix Systems" guide for ADS2004A and/or Chapter 3 of the “Installing RFDE” guide. Read the Prerequisites, follow the Procedures, and if you have questions, please read the “Common Problems and More Help” sections in this document or contact Agilent Technical Support http://eesof.tm.agilent.com/assist/contact.html. 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/RFDE 2003A/C and 4A. You must now select the bundle(s) you wish 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 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: Linux: /sbin/ifconfig eth0 HP-UX: uname -i SunOS: hostID The license server doesn't have to have a full installation of ADS2004A or RFDE on it (see step 4 for more information). RFDE works with Cadence versions 4.4.6 and 5.0.33 and is available on HP-UX, Sun and Linux platforms: HP-UX 11.0x Solaris 2.6, 2.7 and 2.8 Linux RedHat 7.3,8. RFDE also requires the following Cadence Products: Virtuoso Schematic Composer. Analog Design Environment. OASIS. OASIS is included in the RFDE purchase price; contact your local Cadence representative to obtain codewords and/or Cadence products installation and licensing information. ADS2004A AND RFDE LICENSE INSTALLATION PROCEDURES -------------------------------------------------- Nodelocked licenses come in two formats: nodelocked to the machine they are installed in (no server needed), and nodelocked licenses that need to be loaded into a license server. You have the first type (nodelocked/no server needed) if your codewords look like these: INCREMENT ads_datadisplay agileesofd 2.34 01-jun-2005 0 \ VENDOR_STRING="80AA214X : JRDNMSO IWSPGBB ICHLEDL JIWDLWB \ ICUNETS MCTENRX YGRTAKP SOG" HOSTID=80AA214X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" INCREMENT ads_datadisplay agileesofd 2.34 01-jun-2005 uncounted \ VENDOR_STRING="80AA214X : JRDNMSO IWSPGBB ICHLEDL JIWDLWB \ ICUNETS MCTENRX YGRTAKP SOG" HOSTID=80AA214X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" In these examples, the Vendor String and HOSTID are a clear example of a nodelocked license. Since the license doesn't have a license SERVER or VENDOR lines and the quantity is 0 or uncounted, a server is not needed to run ADS. Simply save the license.lic file we e-mailed you, as ADS2004A/licenses/license.lic or RFDE2004A/licenses/license.lic and launch ADS/RFDE. If ADS/RFDE returns an error message, see the sections COMMON PROBLEMS and MORE HELP for debug hints. You have the second type (nodelocked, needs a server), if your license file looks like this: SERVER serv-1 80AA214X VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.34 01-jun-2005 1 \ VENDOR_STRING="80AA214X : JRDNMSO IWSPGBB ICHLEDL JIWDLWB \ ICUNETS MCTENRX YGRTAKP SOG" HOSTID=60A26XXX SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" This licenses have to be loaded into server 80AA214X for users to be able to login to Workstation 60A26XXX and run ADS/RFDE. If you have this kind of licenses, follow the installation instructions below: ---------------------------------------------------------------------------- If you wish to install RFDE codewords only, skip to the “RFDE LICENSE INSTALLATION PROCEDURES” section. The following procedure assumes you are installing ADS2004A codewords for the first time. 1. Save the license.lic attachment to a file on your machine. If you received the files in a Windows PC, make sure that no hidden characters were added to the file by the windows application (see ADS2004A installation manual’s Appendix A for troubleshooting instructions) 2. Place the license.lic file on the license server, and edit the SERVER and VENDOR lines: 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: SERVER unknown 80AA214X VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.34 01-jan-2005 1 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" If ADS2004A is installed on the license server, you can place the license.lic in the $HPEESOF_DIR/licenses directory. For example: /apps/ads2004A/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: SERVER unknown 80AA214X VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.34 01-jan-2005 1 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" 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 80AA214X 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 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 80AA214X 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/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 /apps/ads2004A/licenses/bin ./lmgrd -c ../license.lic -l ../adsflex.log In this example, the lmgrd supplied with ADS2004A 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: cd /apps/ads2004A/licenses/bin ./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 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 adsflex.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. Please see Chapter 3 of the ADS2004A Installation Guide for a way to automate the startup of lmgrd. 5. You should now be ready to run ADS2004A 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] AGILEESOFD_LICENSE_FILE=@joshua export AGILEESOFD_LICENSE_FILE [C Shell] setenv AGILEESOFD_LICENSE_FILE @joshua If a TCP port was specified on the SERVER line, set the environment variable as follows: [Korn/Bourne Shell] AGILEESOFD_LICENSE_FILE=27005@joshua export AGILEESOFD_LICENSE_FILE [C Shell] setenv AGILEESOFD_LICENSE_FILE 27005@joshua You will want to use the actual TCP port number you specified on your SERVER line. Note: AGILEESOFD_LICENSE_FILE will override any settings specified by the environment variable LM_LICENSE_FILEfor ADS/RFDE 2003A/C and 4A only. 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 ADS2004A. ------------------------------------------------------------ INSTALLATION OF RFDE CODEWORDS ------------------------------------------------------------ If you are adding RFDE Codewords to your ADS2004A license.lic file, you will want to simply append one of the RFDE INCREMENT lines: INCREMENT rfde_premier agileesofd 2.34 31-dec-2004 2 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" INCREMENT rfde_wireless agileesofd 2.34 31-dec-2004 2 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" INCREMENT rfde_wireline agileesofd 2.34 31-dec-2004 2 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" from your RFDE license file to your existing RFDE2004A license.lic file. 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 Remember to read the “Installing RFDE” manual for more detailed installation instructions. RFDE LICENSE INSTALLATION PROCEDURES 1. Save the license.lic attachment to a file on your machine. If you received the files in a Windows PC, make sure that no hidden characters were added to the file by the windows application (see RFDE2004A installation manual’s Appendix A for troubleshooting instructions) 2. Place the license.lic file on the license server, and edit the SERVER and VENDOR lines: 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: SERVER unknown 80AA214X VENDOR agileesofd INCREMENT rfde_premier agileesofd 2.34 31-dec-2004 1 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" If RFDE is installed on the license server, you can place the license.lic in the $HPEESOF_DIR/licenses directory. For example: /apps/RFDE/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: SERVER unknown 80AA214X VENDOR agileesofd INCREMENT rfde_premier agileesofd 2.34 31-dec-2004 1 \ VENDOR_STRING=80AA214X HOSTID=00009995603X SIGN="008C 0B3B \ B6CE F5FD A202 41E9 4976 A13E 8FD7 74EC B500 077B 6A8B 43D7 \ 6ACC 2844 FC22 ED6F B9C5 0702 BD2C" 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 80AA214X 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 TCP port for the license server to listen to for 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 80AA214X 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. If you have placed the agileesofd daemon executable in a different location, then enter the full path as follows: VENDOR agileesofd /apps/RFDE/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 /apps/RFDE/licenses/bin ./lmgrd -c ../license.lic -l ../adsflex.log In this example, the lmgrd supplied with RFDE 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: cd /apps/RFDE/licenses/bin ./lmgrd -v ./agileesofd -v After starting lmgrd, wait about 10 to 15 seconds and then look at the contents of adsflex.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. Please see Chapter 3 of the RFDE Installation Guide for a way to automate the startup of lmgrd. 5. Before you run RFDE. Any machine that will run RFDE (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: [Korn/Bourne Shell] AGILEESOFD_LICENSE_FILE=@joshua export AGILEESOFD_LICENSE_FILE [C Shell] setenv AGILEESOFD_LICENSE_FILE @joshua If a TCP port was specified on the SERVER line, set the environment variable as follows: [Korn/Bourne Shell] AGILEESOFD_LICENSE_FILE=27005@joshua export AGILEESOFD_LICENSE_FILE [C Shell] setenv AGILEESOFD_LICENSE_FILE 27005@joshua You will want to use the actual TCP port number you specified on your SERVER line. Note: AGILEESOFD_LICENSE_FILE will override any settings specified by the environment variable LM_LICENSE_FILE. --------------------------------------------------------------------- Note When setting the shell environment variable from the command line, be sure to set it in the same terminal window in which you will run RFDE, and set it prior to starting RFDE. FOR MORE INFORMATION REFER TO THE “INSTALLING RFDE” MANUAL --------------------------------------------------------------------- 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 RFDE. ------------------------------------------------------------------------------------------------------------ ***************** USING THE LICENSE PREFERENCE TOOL ************** ------------------------------------------------------------------------------------------------------------ ADS/RFDE2004A 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/RFDE, enter > ads -p or >rfde -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. 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/RFDE. 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 (ADS) or libraries (RFDE) 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 Check the adsflex.log file on the license server for errors. o Be sure you have set correctly the HPEESOF_DIR, AGILEESOFD_LICENSE_FILE, CLS_CDSD_COMPATIBILITY_LOCKING ,CDS_LICENSE_FILE, CDS_INST_DIR environment variables, as well as the paths to the ADS2004A and CADENCE installation directories (see the ADS2004A and RFDE installation manual for more detailed instructions) MORE HELP --------- ADS2004A Installation Guide, Chapter 4 http://eesof.tm.agilent.com/docs/ RFDE 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