Table of Contents 
Previous Chapter 3 Installation Procedure
This chapter contains stepwise instructions that will guide you throughout the installation procedure.
Before you start installing the software, you should spend a few minutes reading chapter 2, System Prerequisites.
Then, you can proceed with this chapter, taking care to follow the instructions exactly as they are given.
In case you run into problems, do not hesitate to contact Telelogic Customer Support. Phone and fax number can be found on page 1 of this manual.
The installation procedure will help you to install SDT and help you to customize your SDT installation.
If not already done, we recommend you to read chapter 1, SDT 3.02 Media and chapter 2, System Prerequisites before proceeding with the installation procedure.
During the installation you can choose what components to install. The default answer to most of the questions will be to install all components. If you choose to not install some of the components, you may always add them afterwards by running the installation procedure again (see "Adding SDT Components to an Existing Installation" on page 36).
The components that may be installed are:
- SDT applications, on the following platforms:
- SUN SPARCstation with SunOS 4.1.x/SunOS 5.4
- HP 9000/300 and 400, and HP 9000/700 and 800, with HP-UX
- DECstation with Ultrix
- IBM RS/6000 with AIX
- Examples and samples
- On-line help files in HTML format
- On-line help files in FrameMaker format
- SDT documentation in PostScript format
- SDT documentation in plain text format.
You will also obtain information of how you may configure the license control mechanism.
For a successful SDT installation the following steps must be carried out:
- Inserting the CD-ROM
- Mounting the CD-ROM
- Installing SDT (running an installation script)
- Installing the SDT Product License Key
- Starting the SDT License Server
- Setting Up Shared Libraries (HP and IBM only)
- Configuring the SDT Installation
- Add the SDT bin directory to your path.
Follow the instructions provided with your CD-ROM drive to install the drive on your system. Insert the disk into a CD-ROM caddy with the "SDT 3.02" text visible. Insert the caddy into the CD drive with the arrow on the caddy pointing into the drive.
Create a directory (if not already existing) to be the mount point for the CD. The examples below use the directory /cdrom.
mount -r -t hsfs /dev/sr0 /cdrom
mount -r -f hsfs /dev/sr0 /cdrom
/etc/mount /dev/dsk/c9d2s2 /cdrom -r -t cdfs
or
/etc/mount /dev/dsk/c201d2s0 /cdrom -r -t cdfs
/etc/mount /dev/dsk/1s0 /cdrom
- On DECstation running Ultrix:
mount -t cdfs -o noversion -r /dev/rz0c /cdrom
- On IBM RS/6000:
- Use the smit mount utility
Or,
- Use UNIX mount like this:
Find the available CD-ROM drive by typing:
/etc/lsdev -C -c cdrom -H
The first field in the resulting output shows the device name of the CD-ROM drive in /dev. The following string:
name status location description
cd0 Available 00-01-00-50 CD-ROM Drive
contains the device name: /dev/cd0
Verify that a CD-ROM drive is not already mounted by typing:
/etc/mount
and check that the device name /dev/cd0 does not exist in the list.
Mount the CD-ROM drive:
/etc/mount -vcdrfs -r /dev/cd0 /cdrom
The commands may slightly differ from system to system. If any of the device names are unknown on your system, consult your system manager.
Before starting the installation script, you should find a suitable location in your file system where to store the SDT 3.02 installation. This directory is called the installation root directory. It is to be used for all Telelogic products of the same release, such as SDT 3.02 and ITEX 3.02.
Therefore, if you already have ITEX 3.02 installed, you should use the same root directory when installing SDT 3.02. The installation procedure will create a subdirectory to this root directory, called sdt.
Within this installation procedure we will use /appl/telelogic as the root directory for the SDT installation.
----------------------------------------------------------------------
Note:
SDT 3.02 cannot be installed in the same root directory as SDT
3.0 or 3.01. If there already exists an SDT 3.0 or 3.01 installation,
please make a copy of the license.dat file, since it can be used
together with SDT 3.02. When it is time to update the license.dat
file in the new installation, the old license.dat file can be used.
----------------------------------------------------------------------
- Decide upon a suitable installation root directory, according to the above advice. Also, check the amount of available disk space and verify it against the required space (see "Installation Prerequisites" on page 17 in chapter 2, System Prerequisites).
- You will now start the installation script, which will guide you through the installation. The script will also print some information during the installation procedure. Please read all the printed information.
On the Sun platforms:
cd /cdrom
./SDTINST.CD
On the IBM platform:
cd /cdrom
./sdtinst.cd
On the HP platforms:
cd /cdrom
./SDTINST.CD\;1
On the DEC platform, do as follows:
- Change working directory to a temporary directory:
cd /home/tmp
- Copy the SDTINST.CD script from the CD-ROM to your temporary directory:
cp /cdrom/SDTINST.CD .
- Create a temporary BIN directory and copy the file
INSTALL.DEC to this directory:
mkdir BIN
cp /cdrom/BIN/INSTALL.DEC BIN/.
- Create a symbolic link to the directory TARFILES on the CD-ROM:
ln -s /cdrom/TARFILES .
- Confirm that the link works, by using an ls command:
ls TARFILES
You should get a list of 19 different files, with file suffix .TAR and .CR
./SDTINST.CD
- After the installation is completed, you can remove the temporary directory used above and all its contents:
cd ..
rm -r tmp
- Specify the installation root directory:
Specify the root-directory for your Telelogic products?
>> Enter path-name: [x]: /appl/telelogic
- Enter the SDT binary key for the workstation architecture you are installing. The binary key consists of the numbers printed on the sticker in the left margin on this page.
>> Please enter your SDT binary key? [x]: 12345678901234
- If you want to install binaries for more than one workstation architecture, you need to repeat the installation procedure as many times as required and specify the same root directory again.
- If you run this procedure and do not intend to install any binaries, you need to enter an SDT binary key anyway. See section "Adding SDT Components to an Existing Installation" on page 36.
- For each component you will be asked if you want to install it or not. The default answer is Yes to install it. See "Installation Options" on page 23 for more information.
- After you have answered all the questions, you will get a list of the currently selected components and the required amount of disk space.
>> The following components will be installed.
SUNOS4 SUNOS5 DEMO HTML FRAME PS TEXT
!! This installation will require: xxx MB
!! of disk space at file system: /appl/telelogic
>> Are you satisfied with the following setup? (y/n) [y]:
- If you are satisfied with the selection, answer y or just press <Return>.
- To change the selection, answer n and you will be prompted again to answer the questions.
- After you receive the message "No further questions will be asked", information is echoed to the console to inform you about the progress of the installation procedure.
- You finally get the message "Completed..." when the installation script is finished.
- Change your working directory to the root directory you specified during step 3. above, e.g.
cd /appl/telelogic
- "Source" the following file to set up a few environment variables:
- If you are running a csh-compatible shell:
source ./bin/telelogic.sou
- If you are running an sh-compatible shell:
. ./bin/telelogic.profile
The environment variable $telelogic now points to the installation root directory. We will refer to this variable throughout the rest of this manual.
The SDT licenses are controlled by a third party software, FLEXlm\xaa . FLEXlm is designed to serve multiple applications.
- Fill in the Product License Key application form with information about the license server's hostname and hostid (the name and id of the computer where you want the license server to run). The information is needed by Telelogic Customer Support in order to generate the software license keys. In response, you will receive a Product License Key, with information about how to edit the file
license.dat. You can send your request for the Product License Key via E-Mail if you find it convenient. In the root directory of your SDT 3.02 installation you can find the file licensekey.via_email. Please fill in the missing information and send it to Telelogic Customer Support at the following address: support@telelogic.se
- Edit the license.dat file according to the instructions provided in the document Product License Key.
---------------------------------------------------------------------
Note:
The Product License Keys that come with SDT 3.02 are not
compatible with license keys used in earlier versions of SDT.
This means that you cannot run earlier versions of SDT (i.e. 3.0 and
3.01) using the 3.02 FEATURES in the license.dat file in the
SDT 3.02 distribution.
If you want to be able to switch between earlier versions of SDT and
SDT 3.02, you must do as follows:
1. Save the existing (3.0 / 3.01) license.dat file before updating
it with the new FEATURES that come in the Product License
Key from Telelogic Customer Support.
2. Assign the environment variable LM_LICENSE_FILE a value
that designates the appropriate license.dat file before start
ing SDT.
---------------------------------------------------------------------
-----------------------------------------------------------------
Note:
All information in the file license.dat file is case significant.
-----------------------------------------------------------------
- If you make use of the license.dat file located at the root directory of the SDT installation, i.e. $telelogic/license.dat, carry on with the instructions below.
- If you have added your SDT licenses to an existing FLEXlm license.dat file, you should use the startup command you are used to. You may then not have to stop and restart the license server. You may use the FLEXlm lmreread utility to update a running license server with new information.
- Make sure you are logged in on the computer where the license server is to run.
-----------------------------------------------------------------
Note:
· On SunOS 5.X: The license server must be started with group-
id sys. To achieve this you have to do the following (as root):
chgrp sys $telelogic/flex/sunos5flex/telelogic
chmod g+s $telelogic/flex/sunos5flex/telelogic
· On HP 9000/300 and 400: The license server must be started as
user root.
-----------------------------------------------------------------
- Before you start the license server, make sure no license servers for SDT are currently running. Search for the license demons lmgrd and telelogic in the current process list. If you have any license demons running, terminate them using the kill command and the PID number.
- Change to the installation root directory:
cd $telelogic
(The $telelogic variable is set up when you "source" the file described in step 10. on page 28.)
- Start the license server:
./bin/startlicd
- You may check that the license server has been started correctly with the following command:
./bin/stat -a
- You should get a printout on the screen with the license server statistics. The list should contain the server, the vendor daemon telelogic and the features you have added to your license.dat file. A printout sample is provided below.
Example 2 : stat Output Sample
lmstat - Copyright (C) 1989, 1992 Highland Software, Inc.
Flexible License Manager status on Fri 2/3/95 8:52
License server status:
hostname: license server UP (MASTER)
Vendor daemon status (on hostname):
telelogic (v3.x): UP
Feature usage info:
Users of SDT-Base: (Total of 3 licenses available)
Users of SDT-MSCE: (Total of 3 licenses available)
Users of SDT-Cbasic: (Total of 3 licenses available)
Users of SDT-Cadvanced: (Total of 3 licenses available)
Users of SDT-Cmicro: (Total of 1 licenses available)
Users of SDT-Chill: (Total of 1 licenses available)
Users of SDT-Simulator: (Total of 2 licenses available)
Users of SDT-Validator: (Total of 1 licenses available)
Users of SDT-Performance: (Total of 1 licenses available)
Users of SDT-TTCN-Link: (Total of 2 licenses available)
- If the startup has failed, check the license.dat file and make sure that the information is correct according to the Product License Key.
- There is also a log file for the license server (license.log) in the root directory of your SDT installation, where all actions concerning the license server are logged.
----------------------------------------------------------------------
Note:
Each time you have changed any information in the license.dat
file, you have to update the license server with the new information.
How to update the license server is described in chapter 4, The Soft
ware License Server, in section "Updating the License File" on page
41.
----------------------------------------------------------------------
- In order to start up the SDT License Server automatically at boot time, a line like the following should be placed in /etc/rc
/appl/telelogic/bin/startlicd
where /appl/telelogic should be replaced by your installation root directory. (You cannot use the $telelogic variable in this case.)
------------------------------------------------------------------
Caution!
SDT will not operate properly on HP and IBM systems unless you
have set up the SDT shared libraries as described in this section.
------------------------------------------------------------------
The SDT applications are linked dynamically with a number of shared libraries X11R5libs and SDTlibs in the directory
$sdtrelease/sdtlib/hppasdtlib (on HP PA-RISC)
$sdtrelease/sdtlib/hpmcsdtlib (on HP Motorola)
$sdtrelease/sdtlib/ibmsdtlib (on IBM)
You have to create a symbolic link from /usr/local/SDT3.02/lib to the appropriate directory. The following examples illustrate how to do this. You probably need root privileges in order to perform the actions required.
-----------------------------------------------------------------------
Note:
The environment variable $sdtrelease is referring to the sub-
directory sdt in your installation root directory. The variable is set
up when you "source" the file described in step 10. on page 28.
-----------------------------------------------------------------------
- Create a subdirectory SDT3.02 and a soft link from there to the SDT installation, according to the following commands:
Example 3 (HP PA-RISC):
mkdir /usr/local/SDT3.02
ln -s $sdtrelease/sdtlib/hppasdtlib /usr/local/SDT3.02/lib
Example 4 (HP Motorola):
mkdir /usr/local/SDT3.02
ln -s $sdtrelease/sdtlib/hpmcsdtlib /usr/local/SDT3.02/lib
Example 5 (IBM AIX):
mkdir /usr/local/SDT3.02
ln -s $sdtrelease/sdtlib/ibmsdtlib /usr/local/SDT3.02/lib
The sdtconfig program configures your SDT installation according to the information in the license.dat file. The following optional SDT C Code Generator libraries will be installed when running the
sdtconfig program, if you have a valid license for these features:
- SDT-Performance
- SDT-Simulator
- SDT-Application
- SDT-Validator
- SDT-TTCN-Link(1)
- SDT-Cadvanced
The sdtconfig program will also check the contents of the file license.dat and will issue warnings if any inconsistencies are detected.
- Change to the installation root directory:
cd $telelogic
- Run the sdtconfig program with the command:
./bin/sdtconfig
---------------------------------------------------------------------
Note:
This program is also used when adding new features to an existing
installation. It has to be run each time a new binary component has
been added to an existing SDT Installation. You should run it logged
on to the machine for which you added the binaries.
---------------------------------------------------------------------
The startup of SDT 3.0/3.01/3.02 is slightly changed compare to previous versions of SDT. We recommend the SDT users to add the SDT 3.02 binary directory to their existing PATH variable.
------------------------------------------------------------------
Note:
The X Windows System and Motif Window Manger have to be
started before starting SDT!
In the case the computers on which you run the X Windows server
and the client (the SDT applications) coincide, make sure the envi
ronment variable DISPLAY is set to unix:0.0 before starting
SDT. Do not use the notation hostname:0.0
------------------------------------------------------------------
- Below the SDT 3.02 installation root directory, you will find a sub directory called bin. This directory should be added to the user's path, e.g.
set path = ( $path $telelogic/bin )
- After the path is updated, start SDT by the command:
sdt
- You can also start SDT with:
$telelogic/bin/sdt
After this installation we do recommend you to read chapter 5, System Setup. This chapter is useful both for the individual SDT user and the SDT system administrator. For the system administrator it might also be of interest to read through chapter 4, The Software License Server, where additional information regarding the software license control mechanism in SDT may be found.
If you already have an SDT 3.02 installation and want to add components to this installation, follow the instructions below. For more information on available components, see "Installation Options" on page 23.
- Insert the CD, as described in "Inserting the CD-ROM" on page 24.
- Mount the CD, as described in "Mounting the CD-ROM" on page 24.
- Follow all steps described in "Installing SDT" on page 25.
- Enter the same root directory as you did when you installed SDT.
- The SDT Binary Key must be entered.
- You will be asked the following question:
This directory already contains a sub-directory: sdt/
>> Do you like to update your existing SDT-3.02 installation?
[y]:
Answer y or press just press <Return>
- Answer "No" to questions for components you do not want to install. If you answer "Yes" to install a component that is already installed it will cause the existing component to be overwritten.
- If you added a component with binaries for HP or IBM, you have to set up the shared libraries as described in "Setting Up Shared Libraries (HP and IBM only)" on page 33.
- If you have received a new SDT Product License Key, you have to perform the actions described in "Installing the SDT Product License Key" on page 29. After that, you should also perform the actions described in "Configuring the SDT Installation" on page 34.
Footnotes
- (1)
- Available on SUN and HP 9000/700-800 only.
Table of Contents 
Next Chapter