======================================== INSTALLING NODELOCKED 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. You, or your System Administrator, must upgrade your 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 nodelocked licenses if your codewords include a "HOST ID=" statement in an increment line as in either of the two below examples. The example below is of a nodelocked license where the nodelock machine and the license server are NOT the same machine: SERVER joshua 80AA214X VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.35 01-aug-2005 1 \ VENDOR_STRING="80AA214X : BFXSMUR PGNMW2Y NBH2AGI OGIHEUJ \ CULRIBR NZWUIBU FNCUIWQ UFP" HOSTID=60A26XXX START=26-jun-2005 \ SIGN="017A F887 0FAA 3E9B 5987 C313 E332 3D63 CAE8 1B11 D101 \ AF23 FC64 CD15 0480 09E5 D82B 8654 A261 923E 5BC5" The above license must be loaded onto server 80AA214X for users to be able to run ADS/RFDE from workstation 60A26XXX. The example below is of a nodelocked license where the nodelock machine and the license server ARE the same machine: SERVER joshua 80AA214X VENDOR agileesofd INCREMENT ads_datadisplay agileesofd 2.35 01-aug-2005 1 \ VENDOR_STRING="80AA214X : BFXSMUR PGNMW2Y NBH2AGI OGIHEUJ \ CULRIBR NZWUIBU FNCUIWQ UFP" HOSTID=80AA214X START=26-jun-2005 \ SIGN="017A F887 0FAA 3E9B 5987 C313 E332 3D63 CAE8 1B11 D101 \ AF23 FC64 CD15 0480 09E5 D82B 8654 A261 923E 5BC5" The above license must be loaded onto server/workstation 80AA214X for users to be able to run ADS/RFDE from workstation 80AA214X. 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. Agilent EEsof EDA software can be nodelocked to your Unix workstation's unique host ID. The license server and the machine the license is nodelocked to can be two different machines. To determine the ID and/or name of your server or Unix workstation, 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: hosted (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 ---------------------------------------------- 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 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.35 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 ADS/RFDE 2005A is installed on the license server, you may place the license.lic in the $HPEESOF_DIR/licenses directory. 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 from which lmgrd is started, this is sufficient. If your server has a different directory structure than ADS/RFDE, you must specify the exact location of the agileesofd daemon executable, 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: 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_FILE for ADS/RFDE 2003A/C and 4A only. 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 from the machine(s) whose host ID matches the host ID the licenses are locked to. -------------------------------------------------------------------------------- ***************** 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. There are two ways to start the License Preference tool. In a terminal window: 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