===================================== INSTALLING FLOATING CODEWORDS ON UNIX ===================================== ================================================================================ IMPORTANT NEWS/CHANGES IN ADS/RFDE LICENSING ================================================================================ ADS/RFDE 2005A is the second release to offer License Backward Compatibility ("LBC"). For the latest news in License Backward Compatibility and license management changes, read the Release Notes and/or the Installation Manual, Chapter 3. Users can now run versions 2003A/C, 2004A and 2005A with the same licenses as long as the licenses are keyed to the newer version. For example, to run ADS 2003C and ADS 2005A, you need codewords for ADS 2005A on your machine. System Administrators must upgrade their licensing software to version 10.1.3 which is the version distributed with ADS/RFDE 2005a installations in the licenses directory. It may also be downloaded from the Agilent EEsof Knowledge Center http://www.agilent.com/find/eesof-knowledgecenter. This includes lmgrd, lmutil, lmtools and agileesofd. ! ! WARNING ! ! DO NOT USE THE LMGRD AND/OR UTILITIES FROM VERSIONS FLEXnet 10.0 or 10.1, THESE VERSIONS HAVE A BUG THAT KEEPS agileesofd FROM RUNNING ========================================================================= ========================================================================= The following instructions outline a quick procedure for installing your new ADS/RFDE 2005A Codewords: Read the "Prerequisites", follow the "Installation Procedures", and if you have questions, please read the "Common Problems" and "More Help" sections. If you would like more detailed instructions, please refer to Chapter 3 of the "Installation on UNIX Systems" guide for ADS 2005A and/or Chapter 3 of the "Installing RFDE" guide. The contents of an increment line must NOT be edited as this will corrupt the license file. However, deleting expired increment lines is recommended, and you may append new increment lines to an existing license file. Our Business Support Department often sends codewords with the SERVER name set to "unknown". In this case, you must change "unknown" to the correct SERVER name. If you would like to have future license files generated with the correct SERVER name, reply to the email message with which you received your codewords and advise your Business Support Representative of the correct name. You have floating licenses if your codewords do NOT include a "HOST ID=" statement in any increment line as in the below example: SERVER nogood 832XX987 VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.35 25-sep-2005 3 \ VENDOR_STRING="832XX987 : MC2HUOK EYWZH2Z FMYVNCA OGY2GPV \ ZUCO2Q2 ABGCREO DLKJZPC VOKJ" START=24-aug-2005 SIGN="0161 \ 1617 DC61 0EB9 1DB1 A7B9 6EB5 BAFA ACB5 26C9 F401 F9EC C008 \ C036 BDC8 DA3A E640 D411 2231 DBDD 4347" IMPORTANT: -------------------------------------------------------------------------------- If you have used codeword packages or Limited Term Packages (LTP) in previous versions, you should be aware that license bundles replaced PACKAGE codewords as of ADS/RFDE 2003A/C. Now, you must select the bundle(s) you wish to use with the Agilent License Preference Tool. See the section "Using the License Preference Tool," below for quick instructions. Or for more detailed information about selecting codeword bundles, please refer to the (ADS or RFDE) Installation Guide. -------------------------------------------------------------------------------- Prerequisites ------------- You can verify that you have ADS/RFDE 2005a codes by checking for the "2.35" version before the date in each increment line. A license server on a network can serve floating licenses. Any machine on that network can checkout a license, up to the total number of licenses. To determine the ID and/or name of your server, use the appropriate command for your platform: Linux: /sbin/ifconfig eth0 (returns ID and name) Linux Dongle: /sbin/ifconfig (returns name) $HPEESOF_DIR/licenses/bin> lmutil lmhostid -flexid (returns ID) HP-UX: uname -I (returns ID and name) SunOS: hostid (returns ID and name) The license server does not need a full installation of ADS/RFDE 2005A on it. RFDE 2005A works with Cadence DFII version 5.1.41(DBA) and ICOA5.1.41 (Open Access) on the following platforms: - HP-UX 11.0 and 11.i - Solaris 8, 9 and 10 - Linux RedHat(32 bit) 7.2, 7.3, 8, WS2.1 and WS3.X. RFDE requires the following Cadence Products: - Virtuoso Schematic Composer - Analog Design Environment - OASIS OASIS is included in the RFDE purchase price. Within 48 hours after receiving your RFDE codes, you will automatically receive RFDE_OASIS codes from Cadence tied to the same server ID as your RFDE license. If your Cadence license server is different from the server of your RFDE license, please contact your Business Support Representative, and advise them of the correct ID. A request for a new Oasis code will then be made to Cadence on your behalf. Contact your local Cadence Representative to obtain all other codewords and/or Cadence products installation and licensing information. If you are using Cadence versions older than 5.0.32, you must contact your local Cadence Representative to obtain the appropriate Oasis license as the Oasis license provided by the above process does not work with older Cadence software versions. ADS/RFDE 2005A LICENSE INSTALLATION PROCEDURES ---------------------------------------------- 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 /ads2005A/licenses/bin lmutil lmreread -c ../license.lic The following procedure assumes you are installing ADS/RFDE 2005A codewords for the first time. 1. Save the license.lic attachment to a file on your machine. If you received the files on a Windows PC, make sure that no hidden characters were added to the file by the windows application (see ADS 2005A Installation Manual's Appendix A for Troubleshooting Instructions or RFDE Installation Manual's Common Problems section). 2. Place the license.lic file on the license server: The license server's host ID is specified on the SERVER line in the 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/RFDE2005A is installed on the license server, you can place the license.lic in the licenses sub-directory of the ADS/RFDE 2005A installation directory. For example: /apps/ads2005A/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 80AA214X If you received a license.lic file with hostname set to 'unknown', you MUST change 'unknown' 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, FLEXnet 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, for example: VENDOR agileesofd /apps/eda/vendors/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 FLEXnet license manager on the license server machine. For example: cd /apps/ads2005A/licenses/bin ./lmgrd -c ../license.lic -l ../adsflex.log In this example, the lmgrd supplied with ADS 2005A 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/ads2005A/licenses/bin ./lmgrd -v ./agileesofd -v The latest version of lmgrd can be downloaded from the Macrovision Software website (see the URL in the More Help section below). A good way to get all of the latest FLEXnet software is to run a custom install of ADS/RFDE and choose to install only the FLEXnet software. 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 ADS/RFDE 2005A Installation Guide for a way to automate the startup of lmgrd. 5. Environment Variables: Any machine that will run ADS/RFDE2005A (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 for ADS/RFDE 2003A/C, 2004A and 2005A. 6. Before launching ADS or RFDE, you must set your license preferences using the License Preference Tool if you have license bundles. See the "Using the License Preference Tool" section below. You are now ready to run ADS/RFDE 2005A. -------------------------------------------------------------------------------- ***************** USING THE LICENSE PREFERENCE TOOL ***************** -------------------------------------------------------------------------------- When running ADS or RFDE bundles, the License Preference Tool allows you to select which license bundles to access. 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 or RFDE. 1. When starting ADS/RFDE, enter > ads -p or > rfde -p This runs the License Preference tool, and then runs ADS/RFDE after you choose the bundles you wish to use. 2. 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. If you started ADS/RFDE with the -p option, select your license preferences, then 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" (ADS) or Chapter 3 "Using RF Design Environment" (RFDE). ---------------------------------- COMMON PROBLEMS ---------------------------------- If you have 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 (RFDE only), CDS_LICENSE_FILE (RFDE only), CDS_INST_DIR (RFDE only) environment variables, as well as the paths to the ADS/RFDE 2005A and CADENCE installation directories (see the ADS and/or RFDE Installation Manual for more detailed instructions). ---------------------------------- MORE HELP ---------------------------------- ADS 2005A Installation Guide, Chapter 3 and 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 Edited 08312005