This scl_INSTALL_README.txt document contains installation instructions for the Synopsys Common Licensing (SCL) version 10.9.3 tool in the following sections: * General Information * Download & Installation Procedure * Obtaining and Verifying the License File * Starting the SCL Server & Setting up the User Environment ----------------------------------------------------------------- General Information ----------------------------------------------------------------- This document contains quick-start installation assistance for SCL product files downloaded from Synopsys by Electronic Software Transfer (EST). To obtain information on hardware platforms and OS versions supported by SCL 10.9.3, see the supported OS table at http://www.synopsys.com/support/keys/supported_os.html To obtain your latest Synopsys license key file, go to the SmartKeys Web page at http://www.synopsys.com/smartkeys For start-up and troubleshooting information, see the Synopsys Licensing QuickStart Guide at http://www.synopsys.com/keys ----------------------------------------------------------------- Download & Installation Procedure ----------------------------------------------------------------- This section contains the following information: - Installation Prerequisites - Installing by Electronic Software Transfer (EST) Installation Prerequisites ===================================================================== To install SCL, you must have write and execute permissions in the installation directory. Installing by Electronic Software Transfer (EST) ===================================================================== Below you will find a sample SCL download session. A Solvnet user name and password are required. The download instructions are for ftp. Alternatively, you may download SCL via HTTPS by browsing to the Synopsys Download Center at https://solvnet.synopsys.com/DownloadCenter. In the Download Center, choose "Synopsys Common Licensing" as the product. This section contains installation information for the following platforms: - UNIX - Windows UNIX -------- 1. Create a destination directory for SCL. Download any SCL files to the destination directory. For SCL 10.9.3, you will need to download * An OS platform file, which is specific to the operating system and hardware platform you will be using * A "common file" Note: SCL 10.9.3 requires the Synopsys Installer version 2.0 or later. Download example: # Get the product file(s) % cd /temp/usr % ftp ftp.synopsys.com 220 Synopsys FTP server ready Name: Password: 230 User logged in. ftp> binary ftp> cd /rev ftp> cd scl_v10.9.3 ftp> get scl_INSTALL_README.txt ftp> get scl_v10.9.3_.tar ftp> get scl_v10.9.3_common.tar where is one or more of linux, sparc64, and so on. 2. Untar the common file and the platform files. Example: % tar xvf scl_v10.9.3_common.tar % tar xvf scl_v10.9.3_sparc64.tar SCL will be found in the //bin directory. For example, /usr/scl10.9.3/sparc64/bin 3. Add the installer directory to your UNIX path. % set path=(/usr/usr/installer $path) 4. To install the software, enter one of the following installer commands: % installer #To use a text script % installer -gui (or setup.sh) #To use a GUI 5. Answer the installer prompts. When you are prompted to choose a location for installing the software, do not select the temporary directory. You must specify a new location. Note: SCL must be installed into a local directory. Do not install it into an NFS directory or there may be perfomance problems. If you encounter any installer problems, please see SolvNet article 023312, Synopsys Installer 2.0 Troubleshooting, at https://solvnet.synopsys.com/retrieve/023312.html/. 6. Obtain and verify the latest license key file. See the next section, "Obtaining and Verifying the License File." 7. Start SCL. See the section, "Starting the SCL License Server", below. 8. Modify the user environment to point to the license server. See the "Post-Installation Steps" section, below. Windows -------------- Windows 2000 and higher are supported. (64-bit versions of Windows are not supported at this time.) 1. Copy the single .exe file to a temporary directory. 2. Double-click this file to extract to a destination folder using Winzip or a similar tool. Be sure to choose the option to extract all files. 3. Use use lmtools to start SCL. For detailed information on using lmtools, see http://www.synopsys.com/support/keys/keys.html#start_win 4. To enable the users to access the license server, the user environment must be modified to set a licensing variable. For more information, see the "Post-Installation Steps" section, below. ----------------------------------------------------------------- Obtaining and Verifying the License File ----------------------------------------------------------------- This sections contains the following information: - Obtaining & Customizing the Latest License File - Verifying the license file with sssverify Obtaining & Customizing the Latest License File =================================================================== Before starting SCL 10.9.3, you must first obtain and customize the license file. To obtain your site's latest license ("key") file, go to Smartkeys at http://www.synopsys.com/smartkeys Click "Key Retrieval". A Synopsys username and password are required. Under "Key Retrieval", make sure that the correct Site ID is specified. Click "Continue". You license file(s) will be emailed to your SolvNet-registered email address. To customize the license file, perform the following steps: 1. Modify the SERVER line so that the "hostname1" field contains the correct system host name. For example, SERVER my_server 87654321 27000 2. Modify the VENDOR (or DAEMON) line so that it contains the full path to snpslmd. For example, VENDOR snpslmd /usr/scl10.9.3/sparc64/bin/snpslmd 27000 Note: SCL 10.9.3 requires only the snpslmd vendor daemon. Remove any "DAEMON" lines that refer to avantd, tmald, CADABRA, Innologd, ISE_TCAD, numeritechd, nassd, TE_CATS, or any other Synopsys vendor daemons incorporated into (supported by) SCL 10.9.3. 3. Make sure all lines wrap properly. Comment lines must start with # and not wrap. Every line must start with either # or one of the following keywords: SERVER, VENDOR, INCREMENT, or PACKAGE. Lines may only wrap after a continuation character (" /"). 4. Do not add any keys (except temp keys) to your production keys. Such an action will void your license file. For details, see the next section, "Verifying the License File with sssverify". 5. Save any changes in ASCII (.txt) format only. Verifying the License File with sssverify =================================================================== With SCL 10.x, Synopsys has introduced a new security technology, Synopsy Secure Server. To avoid "SSS"-related license checkout denials, it is important that you verify the license file with the sssverify tool included with SCL. 1. It is important that no keys (INCREMENTs) be added to the license file, or the license file will be invalidated. The only exception is for unexpired temporary keys with an issued date later than the issued date of the Smartkeys "production" or "release" keys. For example: If I retrieve productions keys from Smartkeys with an issued date of 25-jun-2007 ("ISSUED=25-jun-2007"). For the given hostid, I may add unexpired temp keys to this license file only if the temp keys have an issued date of 25-oct-2006 or prior. 2. Verify the integrity of the license file with sssverify. For example: % cd /usr/scl10.9.3/sparc64/bin % sssverify /usr/scl10.9.3/admin/license/usr.lic The result should be: Integrity check report for license file "synopsys.lic". Report generated on Checking the integrity of the license file... Valid SSS feature found. License file integrity check passed. Note: Do not run sssverify on license files that have only short-term temp keys (temp keys cut for a duration of 60 days or less). ------------------------------------------------------------------------------------- Starting the SCL Server & Setting up the User Environment ------------------------------------------------------------------------------------- This sections contains the following information: - Starting the SCL License Server - Setting up the User Environment Starting the SCL License Server =================================================================== Unix ------- 1. For the SCL 10.9.3 license server, use lmdown to bring down all Synopsys daemons (incorporated into SCL 10.9.3), avantd, snpslmd, tmald, CADABRA, Innologd, ISE_TCAD, nassd, sandwork, TE_CATS, etc. (If these daemons are running, SCL 10.9.3 will not start.) lmdown -c /path/to/license.dat 2. Start SCL 10.9.3 with the following command: scl_root//bin/lmgrd -c scl_root/admin/license/synopsys.lic \ -l scl_root/admin/logs/synopsys.log -reusaddr Note: * All components of SCL should be locally mounted, including SCL binaries, license file, and logfiles. This avoids possible NFS performance problems. * A UNIX boot script is recommended. For a sample SCL 10.9.3 boot script, see https://solvnet.synopsys.com/retrieve/020757.html 3. Verify that lmgrd started correctly by viewing the debug.log. It should show that lmgrd and snpslmd started, followed by a list of available features. If SCL did not start properly, there will be an appropriate error message. Use this to debug the problem, or send the license file and debug.log information to your local Synopsys Suppport Center. To open a case on the Web, browse to http://www.synopsys.com/support and choose "Enter a Call to Support." Windows ------- 1. Use lmtools to bring down all Synopsys daemons (incorporated into SCL 10.9.3) such as avantd, snpslmd, nassd, sandwork, etc. (If these daemons are running, SCL 10.9.3 will not start.) 2. Use lmtools 10.8 or later to start SCL. lmtools is included with SCL. For detailed information on using lmtools, see http://www.synopsys.com/support/keys/keys.html#start_win Note: If your system has a dongle, first verify that the dongle hostid is recognized. For more information on this, see http://www.synopsys.com/support/keys/dongle.html 3. Verify that lmgrd started correctly by viewing the debug.log. It should show that lmgrd and snpslmd started, followed by a list of available features. If SCL did not start properly, there will be an appropriate error message. Use this to debug the problem, or send the license file and debug.log information to your local Synopsys Suppport Center. To open a case on the Web, browse to http://www.synopsys.com/support and choose "Enter a Call to Support." Setting Up the User Environment ======================================================== - UNIX - Windows UNIX ---- To set up your users, you must create a Synopsys source file, or modify each user's $HOME setup files (typically .cshrc, .profile, .kshrc, or .bashrc), as follows. 1. Set SNPSLMD_LICENSE_FILE, LM_LICENSE_FILE or a tool-specific licensing variable. This variable specifies the path to the Synopsys FLEXlm license server. Note: To reduce tool start-up time, it is recommended that you set a daemon- or tool-specific licensing variable. SNPSLMD_LICENSE_FILE is supported by most but not all Synopsys tools. LM_LICENSE_FILE is supported by all Synopsys tools. If unsure of which variable to set, set both variables. In the following example, it is assumed that the Synopsys license server is using TCP port 27000, the default port. (However, you can specify another port by modifying the SERVER line of your site's keyfile--for example, "SERVER myserver 8308a297 26585.") Example: * Add to .cshrc setenv SNPSLMD_LICENSE_FILE 27000@my_server or setenv LM_LICENSE_FILE 27000@my_server * Add to .profile, .kshrc, or .bashrc SNPSLMD_LICENSE_FILE=27000@my_server; export SNPSLMD_LICENSE_FILE or LM_LICENSE_FILE=27000@my_server; export LM_LICENSE_FILE Note: Path syntax (/path/to/usr.lic) is not supported unless a USE_SERVER line is present at the top of the license file, before any feature (INCREMENT) lines. 2. Add the lmutilities (lmutil, lmstat, etc.) executable files to the user path. Example: * Add to .cshrc: set path=(/usr/scl//bin $path) * Add to .profile, .kshrc, or .bashrc: PATH=/usr/scl//bin:$PATH export PATH Windows ------- 1. Set SNPSLMD_LICENSE_FILE, LM_LICENSE_FILE or a tool-specific licensing variable. This variable specifies the path to the Synopsys FLEXlm license server. Set this variable in Control Panel: Control Panel > System > Advanced > Environment Variables Example: * Add to the System Variables section: Variable: SNPSLMD_LICENSE_FILE Value: 27000@my_server or Variable: LM_LICENSE_FILE Value: 27000@my_server