IBM
Contents Index Previous Next



Installation Procedure


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

Figure 2 : Flowchart for installation

Important!

If you have not received a FLEXnet license key you will not be able to start SDL Suite and TTCN Suite after the installation is performed. Please see below for information on how to obtain the license key.

How to obtain a license key

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:

  1. Log in on the license server machine.
  2. Insert the SDL Suite and TTCN Suite CD-ROM.
  3. Change directory to the flex directory on the CD-ROM, and execute the batch file called lmhostid.bat. One of the Ethernet addresses should be used as hostid.
  4. Alternatively start the FLEXnet utility called lmtools.exe; select the System Settings tab.
    • If you want the license to be locked to your network card, note the 12-character hex code in the Ethernet Address field.
      (example: "00abcde12345").
    • Use the 14-character code in the FLEXID field of lmtools (example: "8-5E700060F63D"). Lmtools is also included on the CD-ROM. The FLEXID can also be read on the dongle.
      For information on how to install the dongle, see Installing the FLEXID dongle and drivers.

  1. EMAIL or FAX this information to IBM Rational Customer Support.

For contact information, see How to Contact Customer Support.

When you have obtained a FLEXnet license key, you can complete the entire installation and run SDL Suite and TTCN Suite.

Log On as Administrator

To install on Windows 2000/XP, you do not need to be logged on as the Administrator, but your login ID must be a member of the local or domain Administrators group.

Mounting the CD-ROM

Installing SDL Suite and TTCN Suite

An installation utility, SETUP.EXE, is enclosed in the distribution.

The installation files for SDL Suite and TTCN Suite are compressed and require the installation utility to be run. You will only be able to run the installation using SETUP.EXE.

Installation Steps

Perform all the steps below:

  1. Start your Windows environment. Be sure you have Administrators privileges.
  2. Exit all running Windows programs.

Note: Starting the installation script

The instructions below describe how to start the installation script from the Windows Start menu. The script can also be started from the installation CD HTML interface. In that case, click the Install on Windows link on the Installation page and proceed with step 5 below.

  1. From the Windows Start menu, select Run.
  2. In the dialog that appears, specify:
    D:\sdl_ttcn\setup.exe
    and press <Return>. A welcome screen is opened.
  3. Click Next to continue the setup.
  4. Click Yes to accept the software license agreement.
  5. Select the installation directory. The default installation directory is:
    C:\IBM\Rational\SDL_TTCN_Suite6.3
    where `C' is the local hard drive on which Windows is installed. You may also change to a network drive to perform a single network installation for all users on your network.
  6. Click on Next to select the Setup Type:
    • Typical installation will install all SDL Suite and TTCN Suite files, including the Help files.
    • Compact installation will install SDL Suite and TTCN Suite files, excluding example files and on-line help files.
    • Custom installation enables you to choose components to install.
      If you want to add components to your installation, use the Custom installation. See Adding Components to an Existing Installation.
  7. Select an option and click Next. The disk space requirements and which files to install before proceeding are determined. If you have chosen the Custom installation, select which components to install (see Installation Options for more information).
  8. Specify the program folder where the program shortcuts are to be placed.
  9. Click Next. Setup will now install the selected files, create shortcuts and update the registry.
  10. If not already defined, you will be asked for the license server and port number used. This information is found on the first line of the FLEXnet license key.
    If you have not received the license key, you can later add the license server and the port number to the file license.dat in the installation directory.
  11. Click Finish.

The installation of the SDL Suite and the TTCN Suite is now completed.

If you are using a host ID to identify your license, continue with Installing a FLEXnet License.

Installing the FLEXID dongle and drivers

If you are using a dongle continue with the following steps.

  1. Turn off the computer.
  2. Find the parallel port or the USB port on the back of the computer and plug in the dongle.
  3. Turn on the computer.
  4. To install the drivers run FLEXidInstaller.exe located in in the flexid directory on the CD-ROM.

Installing a 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, see How to obtain a license key.

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 SDL Suite and TTCN Suite.

You have two options in installing your FLEXnet license:

Using a Shared License File

Install the Telelogic License Server by running setup.exe in the flex directory on the CD-ROM. Avoid starting the license server as a service as you are assumed to already have a server running. Make sure the global installation is FLEXnet 11.5 or higher.

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. 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. Change the path to the license server installation directory (e.g. "C:\Program Files\IBM\Rational\Tools\Licensing_11\Server\telelogic.exe").
    • 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. 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, start the FLEXnet utility by selecting IBM Rational > IBM Rational License Server > LMTOOLS from the Programs menu and select Reread.

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 daemon, do the following:

  1. Save or copy the FLEXnet license key you received from IBM Rational Customer Support into a text file called license.dat.
  2. Store the file, for instance in the directory where IBM Rational products are installed.
Starting the License Server

Install and start the Telelogic License Server by running setup.exe in the flex directory on the CD-ROM. For mroe info see Setting up Your License Server.

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, 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