IBM
Contents Index Previous Next



Installation Procedure


The flowchart below shows the basic steps of the installation procedure.

Figure 1 : Flowchart for installation

Important!

If you have not received a FLEXnet license key, you will not be able to use SDL Suite and TTCN Suite.

To obtain a license key you have to provide IBM Rational Customer Support with the hostname and hostID of the machine on which the license server will run. To obtain this information please refer to the IBM Rational Lifecycle Solutions Licensing Guide on the IBM Rational Support web.

Installing the Software

Before starting the installation script, you should find a location in your file system where to store the installation. This directory is called the installation directory.

/appl/telelogic will be used as an example installation directory for this installation.

Note:

SDL Suite and TTCN Suite cannot be installed in the same directory as an older version of SDL Suite and TTCN Suite.

When you receive the license.dat file, this license file can be used to run both the current version and any prior version (from the 3.02 version).

Installation Steps

Perform all the steps below:

  1. Decide upon an installation directory. Also, check the amount of available disk space and verify it against the required space (see UNIX Installation Prerequisites).
  2. Start the installation script tauinst.cd, which will guide you through the installation. The script will also print some information during the installation procedure.
  3. Specify the installation directory:
          Specify the root-directory for your IBM Rational 
    products?
    
    
    
    >>    Enter path-name: [x]: /appl/telelogic
    
    
    
  4. Confirm that you want to install SDL and TTCN suite:
    >>     Install IBM Rational SDL Suite and TTCN Suite for 
    <platform>? (y/n)          [
    
    • Enter y or press <Return> if the selection is correct.
  5. Now you will be prompted with information about what you will install and how much disk space it will require and where the installation will be placed. Confirm this by entering y or press <Return> if the selection is correct.
  6. Now you will be asked which license server to use.
    >>      Enter license server name: [servername]: 
    
    • [Enter the name of the license server and press <Return> to continue the installation procedure.
  7. After specifying the license server, the port should be specified.
    >>      Enter license server port number: [19353]: 
    
    • [Enter the port nuber and press <Return> to continue the installation procedure. Default port numer is 19353.
  8. After the message "No further questions will be asked", information is displayed regarding the progress of the installation procedure.
  9. The message "Completed..." is displayed when the installation script has finished executing.
  10. To check that the installation was successful, do a ls /appl/telelogic (where /appl/telelogic is your installation directory). You should at least see:
    bin/ bitmaps/ examples/ fontinfo/ include/ itex/ 
    lib/ license.dat sdt/ X11/
    
    
    

There can be other files and directories visible, depending on the platform.

Installing the FLEXnet License

Follow the directions below to install your textual FLEXnet license file. The license file contains the license key you have received from IBM Rational Customer Support.

If you have not yet received a FLEXnet license key, contact IBM Rational Customer Support (see How to Contact Customer Support).

Caution!

All information in the license.dat file is case significant, so be careful not to accidentally invalidate any of the encryption codes. Otherwise you will not be able to start the SDL Suite and TTCN Suite tools.

You have two options in installing your FLEXnet license:

Using a Shared License File

If you have other products that make use of FLEXnet you may wish to install your IBM Rational license features into the existing FLEXnet license.dat file. Make sure the global installation is FLEXnet 11.5 or higher. To install the license key:

  1. Copy the following lines from the license key you received from IBM Rational Customer Support into the existing license.dat file:
    • the VENDOR line; make sure to change the path to the /flex/{arch} subdirectory in your installation directory (where {arch} is the architecture of your server, i.e. "solaris")
    • the FEATURE line(s)
      You must do this since your existing license server's "lmgrd" daemon is not in the same directory as the "telelogic" daemon (for information, see Common problems).
  2. Set the environment variable TELELOGIC_LICENSE_FILE or LM_LICENSE_FILE to point to the location of the existing license.dat file.
    It can also be a <port>@<hostname> setting, where <port> and <hostname> are the port number and hostname from the SERVER line in the license file, e.g. 19353@server.

If you run Type

C shell-compatible shell (e.g. csh or tcsh)

setenv LM_LICENSE_FILE /your/directory/license.dat

or

setenv LM_LICENSE_FILE <port>@<hostname>

Bourne shell-compatible shell (e.g. sh, ksh, zsh or bash)

LM_LICENSE_FILE=/your/directory/license.dat

export LM_LICENSE_FILE

or

LM_LICENSE_FILE=<port>@<hostname>

export LM_LICENSE_FILE

  1. There must not be a license.dat file in the top level of the installation directory. If there is, remove or rename the file $telelogic/license.dat
  2. When you have changed any information in the license.dat file, you must update the license server to let it know about the changes. To do this, run the following script:
    $telelogic/bin/updatelicd
    
    
    

The license installation is finished. Continue with Installing a C Compiler.

Using a telelogic Specific License File

If you will only use FLEXnet for licenses using the vendor telelogic, or wish to run a separate FLEXnet license server for products using the telelogic vendor, do the following:

  1. Log in on the computer where the license server is to run.
  2. Save or copy the FLEXnet license key you received from IBM Rational Customer Support into a text file called license.dat, and store the file in the default location, which is the installation directory ($telelogic/license.dat).
  3. If you wish to place this file in another location, you must set the environment variable LM_LICENSE_FILE to point to this location.
    It can also be a <port>@<hostname> setting, where <port> and <hostname> are the port number and hostname from the SERVER line in the license file, e.g. 19353@server.

If you run Type

C shell-compatible shell (e.g. csh or tcsh)

setenv LM_LICENSE_FILE /your/directory/license.dat

or

setenv LM_LICENSE_FILE <port>@<hostname>

Bourne shell-compatible shell (e.g. sh, ksh, zsh or bash)

LM_LICENSE_FILE=/your/directory/license.dat

export LM_LICENSE_FILE

or

LM_LICENSE_FILE=<port>@<hostname>

export LM_LICENSE_FILE

After the file has been placed in the new directory, make sure to remove or rename the file $telelogic/license.dat.
  1. Make sure that the information in the license.dat file is correct according to your server and installation:
    • The SERVER line must have the correct hostname and hostID.
    • The VENDOR line must have the correct path to the "telelogic" daemon. This daemon is located in the /flex/{arch} subdirectory in your installation directory (where {arch} is the architecture of your server, i.e. "solaris")
Starting the License Server

You will now start the FLEXnet license server:

Note:

If you are using an evaluation license, or if the word "DEMO" ends each FEATURE line in your license.dat file, you do not need to start the license server.

  1. Make sure no license servers for the IBM Rational tools are currently running. Search for the license daemons lmgrd and telelogic in the current process list, for instance by using the command
    ps -ae | egrep '(lmgrd|telelog)'
    . If you have any license daemons running, terminate them using the kill command and the PID number(s).
  2. Change to your installation directory:
    cd $telelogic
    
  3. Start the license server:
    ./bin/startlicd
    
  4. Check that the license server has been started correctly with the following command:
    ./bin/stat -a
    
    
    
    The license server statistics is displayed containing the server, the vendor daemon telelogic and the features available in your license.dat file.
  5. If the startup has failed, check the license.dat file for errors and omissions; see Common problems. Double-check your file with the original sent from IBM Rational Customer Support. Especially check the "company name" information in the quote-field of the first FEATURE line in the file.
    There is also a license.log file in the installation directory, where all actions concerning the license server are logged. The events to be logged includes:
    • Startup and shutdown of the license server
    • Checking licenses in and out
    • Denying licenses
      Each event involving a license also specifies:
    • The telelogic FEATURE name (license controlled tools only)
    • The user
    • The node
    • The date and time
    • The usage time (for check-in log entries)

Note:

The log file will grow as users run SDL Suite and TTCN Suite. You may consider deleting the head of the file from time to time to save disk space.

  1. The license server has to be restarted every time the server computer is rebooted.

The license installation is now finished.

Installing a C Compiler

You must also install a C compiler to be able to use certain features of the SDL Suite and TTCN Suite tools, such as Simulation and code generation. How to install a C compiler is described in the compiler documentation.

For information on which C compiler you need, see The SDL Suite Compiler Environment and The TTCN Suite Compiler Environment.


http://www.ibm.com/rational
Contents Index Previous Next