Installation Procedure for Windows

This chapter contains step-wise instructions for installing Telelogic Tau on either Windows NT 4.0 or Windows 95, including the software licenses.

For instructions on installing Telelogic Tau on UNIX systems, see Installation Procedure for UNIX.

In case you encounter problems, contact Telelogic Customer Support, see How to Contact Customer Support.

Table of Contents 

• Overview
• Before You Start
• Installation Options
• Installation Procedure
• Log On as Administrator (Windows NT)
• Mounting the CD-ROM
• Installing the Telelogic Tau Software
• FLEXlm Licenses and CopyControl Licenses in the Same Installation
• Installing a CopyControl License
• Installing a FLEXlm License
• Installing a C Compiler
• Starting Up the Telelogic Tau Tools
• Post Installation
• Updating Preferences Files
• Limiting On-Line Help Disk Space
• Adding Telelogic Tau Components to an Existing Installation

Overview

This chapter's installation procedure will help you install Telelogic Tau on your Windows NT 4.0 or Windows 95 system. You can do a full installation or customize it to meet your needs.

The process involves installing the actual Telelogic Tau software, as well as installing and activating your licenses.

Before You Start

Most likely, you have determined which licensing system you will use (FLEXlm® or CopyControl) before starting this installation, so that you already have received your license materials. If you do not yet know what kind of licensing system to use, read A Primer on Licensing before continuing.

Have the license materials at hand before starting the installation:

• For FLEXlm users, your Telelogic Tau delivery should contain a hardcopy of your FLEXlm license key.
• For CopyControl users, your Telelogic Tau delivery should contain one or two license software disk(s), one for ORCA¹ and SDT, and one for ITEX.

If you have not yet received a FLEXlm license key or the CopyControl software, see the box marked Important!.

Installation Options

When installing the Telelogic Tau software you can choose what components to include. You can always add components afterwards by running the installation procedure again (see Adding Telelogic Tau Components to an Existing Installation).

The Telelogic Tau components are:

• ORCA and SDT program files (binary executables).
• ITEX program files (binary executables).
• Example files. With these files, you will be able to follow the tutorials and other complete examples described in the documentation.
• Telelogic Tau on-line help files in HTML format (for ORCA, SDT and ITEX). These files have the same contents as the printed documentation, but they have a different layout and appearance. You need the HTML files to be able to perform a global text search in the on-line help documentation from within the Telelogic Tau tools. A simple HTML viewer is included in the Telelogic Tau installation.
• ORCA and SDT application files necessary to run the tools.
• ITEX application files necessary to run the tools.

Note:  Limiting disk space To limit local disk space usage in a multi-user environment, you may optionally put the on-line help files on a network server, if you are not performing a network installation of Telelogic Tau. See Configuring the Help Environment.

Note:  PostScript documentation The complete Telelogic Tau documentation is also available in PostScript format in the directory \PSCRIPT\<paper format> on the CD-ROM, but is not a component in the installation. The supported paper formats are A4, A5 and USLETTER. If you wish to "install" this, manually copy the needed files from the CD-ROM to a directory on a hard disk.

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 FLEXlm license key or the CopyControl software you will not be able to install Telelogic Tau. FLEXlm users: To obtain a license key youhave to provide Telelogic Customer Support with the hostname and hostID of the machine on which the license server will run. To obtain this information: Log in on the license server machine. Insert the Telelogic Tau CD-ROM. Change directory to the top level of the CD-ROM, and execute the batch file called lmhostid.bat. A utility called lmtools will start; press the hostid button.The second line in the text area will contain your hostname (example: "HOSTNAME=grail") and the sixth line (below the line starting with "INTERNET=") will contain the hostID as a 12 character (hex) code (example: "00abcde12345"). EMAIL or FAX this information to Telelogic Customer Support. CopyControl users: Contact Telelogic Customer Support for help. For contact information, see How to Contact Customer Support. When you have obtained either a FLEXlm license key or the CopyControl disk(s), you can complete the entire installation and run Telelogic Tau.

Caution!  At some points in the installation you must supply directory names where Telelogic Tau or license components will reside. Telelogic Tau does not support file or directory names that contain space characters, so do not to use such names. If you use a CopyControl license, names must also follow the old DOS 8+3 character limits and convention.

Log On as Administrator (Windows NT)

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

• Log on as Administrator, or make sure you have administrative privileges. To grant administrative privileges, use the Windows NT User Manager feature (see Windows NT System Guide).

Mounting the CD-ROM

• Insert the Telelogic Tau 3.5 CD into the CD-ROM drive or mount it if it resides on a network drive.

In the rest of this chapter, we assume that the CD-ROM drive is mounted on drive D:\

Installing the Telelogic Tau Software

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

The Telelogic Tau files are compressed and require the installation utility to be run. You will only be able to install Telelogic Tau if you run SETUP.EXE.

Installation Steps

Perform all the 11 steps below:

1. Start your Windows environment. If you are using Windows NT, follow the directions in Log On as Administrator (Windows NT).
2. Exit all running Windows programs.
3. From the Windows Start menu, select Run.
4. In the dialog that appears, specify:

D:\WIN32\DISK1\SETUP.EXE

and press <Return>. A welcome screen is opened.

5. Click Next to continue the setup.
6. Select the installation directory. The default installation directory is:

C:\tau35

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.

7. Click on Next to select the Setup Type:
• Full installation will install all Telelogic Tau files.
• Compact installation will not install example files or on-line help files.
• Custom installation enables you to choose components to install.
If you want to add components to an existing Telelogic Tau 3.5 installation, use the Custom installation. See Adding Telelogic Tau Components to an Existing Installation.

8. 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).
9. Specify the program folder where the Telelogic Tau shortcuts are to be placed.
10. Click Next. Setup will now install the Telelogic Tau files, create shortcuts and update the registry.
11. Check the box if you want to read the README file and then click Finish.

FLEXlm Licenses and CopyControl Licenses in the Same Installation

If you intend to have some users' licenses served with the FLEXlm system and some with CopyControl, you must make two separate installations of Telelogic Tau: One for the CopyControl users (in which you should place the DLL files, see Installation Steps) and one for the FLEXlm users. Telelogic Tau checks for the presence of the DLL files to decide whether to use CopyControl or FLEXlm.

Installing a CopyControl License

The CopyControl node-locked license and accompanying software is delivered on one floppy disk for ORCA and SDT (labelled "SDT 3.5 for Windows License Key") and one for ITEX (labelled "ITEX 3.5 for Windows License Key"). The license is installed in an inactive state from the floppy disk(s) to your hard drive, and in the process, a unique serial number is produced and reported to you automatically. The license is then activated by a code produced by Telelogic Customer Support when you provide the unique serial number.

You must perform the installation procedure below once for each disk you have received.

If you have not yet received a CopyControl license floppy disk, contact Telelogic Customer Support (see How to Contact Customer Support).

When the Telelogic Tau software is installed on a network drive (i.e. remotely), a CopyControl license must still be installed locally on each computer on which you want to run Telelogic Tau.

Overview of the CopyControl Installation

1. Install an inactive copy of the license by running CCMOVE.
2. Send the product code, product serial number and version number of the inactive license copy to Telelogic Customer Support, and get an activation code in return.
3. Activate the inactive license with the activation code by running CCCHANGE.

Installation Steps

1. Start a Command Prompt.
2. Insert one of the CopyControl floppy disks into your system's floppy drive, assumed here as drive A:
3. Copy the license server's DLL files from the floppy to the subdirectory \bin\wini386 where Telelogic Tau is installed. Example:



C:> COPY A:\*.DLL C:\tau35\bin\wini386

4. Turn off any non-standard disk caching utility option. If necessary, restart the computer.
5. Decide where you want to install the CopyControl license. You must install the license on a local hard drive on each computer.

If Telelogic Tau is installed on	Install license
Local hard disk	In a subdirectory to the Telelogic Tau installation
Network drive	Create a dedicated local license directory, e.g.: C:> MKDIR C:\TAU35LIC

6. Set the default drive to the floppy drive:

C:> A:

7. Run CCMOVE with the "/M" option to transfer the License Key. The License Key cannot be copied from the floppy; you must move it by using the CCMOVE utility as described below.

If Telelogic Tau is installed on	Transfer license key to
Local hard disk	The subdirectory \bin\wini386 where Telelogic Tau is installed, e.g.: A:> CCMOVE A: C:\tau35\bin\wini386 /M
Network drive	The dedicated local license directory you created in step 5., e.g.: A:> CCMOVE A: C:\TAU35LIC /M

The /M option will report something like:



   Transferring protection from a CCC master disk
   Serial number of the installed product is NNNNN

"CCC" is the Telelogic Tau product code, and "NNNNN" is the unique five-digit CopyControl product serial number.

You now have an installed inactive License Key.

8. Make a note of the reported product code, product serial number, and version number (the version number is printed on the CopyControl floppy disk label).
9. Send these data to Telelogic Customer Support, and you will receive an activation code in return (see How to Contact Customer Support).
10. After receiving your activation code, run CCCHANGE to activate your license:

If Telelogic Tau is installed on	Run CCCHANGE with the parameter
Local hard disk	The subdirectory \bin\wini386 to the Telelogic Tau installation directory, e.g.: A:> CCCHANGE C:\tau35\bin\wini386
Network drive	The dedicated local license directory, e.g.: A:> CCCHANGE C:\TAU35LIC

11. Enter the activation code. See Example of a CopyControl Installation Session for a complete example of a CopyControl license installation and activation session.

The license is now activated.

12. If you have installed Telelogic Tau on a network drive, and thus have a dedicated local license directory, or if the license key is in a directory different from where Telelogic Tau is installed, you have to set the environment variable CC_PATH_<product code> to point to that directory so that Telelogic Tau can find the license files.

The label <product code> refers to the code you received when you installed the inactive license in step 7. above. So, for example, your environment variable might be called CC_PATH_TAU.

If you run	Set the environment variable
Windows NT	Click Start button, Settings > Control Panel and then System > Environment. Set User Variables toCC_PATH_<product code>and Value to the directory where you have installed the licenses, e.g. C:\TAU35LIC Set the System Variables if you have administrator rights.
Windows 95	Insert a command in the file AUTOEXEC.BAT, e.g. SET CC_PATH_<product code>=C:\TAU35LIC Restart your computer.

End of Installation

If you have received two license floppy disks, you must now repeat all of the steps above with the second floppy disk.

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

Example of a CopyControl Installation Session

This example assumes that Telelogic Tau is installed in the default location, C:\TAU35. The product code "TAU" is used as an example.

C:> COPY A:\*.DLL C:\TAU35\bin\Wini386
A:\SCADVANC.DLL
A:\SCBASIC.DLL
A:\SCMICRO.DLL
A:\SCMICROB.DLL
A:\SCMICROT.DLL
A:\SOME.DLL
A:\SPERFLIB.DLL
A:\SSIMULAT.DLL
A:\STELELOG.DLL
A:\SVALIDAT.DLL
A:\SDLACCESS.DLL
       11 file(s) copied.

C:> A:
A:> CCMOVE A: C:\TAU35\bin\Wini386 /M

Transferring protection from a TAU master disk (A:)
Serial number of the installed product is 51590
Protection successfully transferred.

Contact with Telelogic Customer Support gives the activation code:

A:> CCCHANGE C:\TAU35\bin\Wini386

Copy protection parameter changing.
Version: 1.71, Product code: TAU, Serial no.: 51590, Update number 1.
Enter code given to you by your supplier:
60 34 45 f1 0c
Confirmation Code : 0/47196
Update number 1 completed successfully.

Installing a FLEXlm License

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

If you have not yet received a FLEXlm license key, contact Telelogic 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 Telelogic Tau tools.

You have two options in installing your FLEXlm license:

• In a shared license file, which is shared with other FLEXlm licensed software, see Using a Shared License File. You may consider this option if you have other software products that make use of FLEXlm licensing.
• As a Telelogic specific license, which only handles licenses for Telelogic Tau, see Using a Telelogic Specific License File. This is the default option if you only will use FLEXlm for the Telelogic Tau licenses.

Using a Shared License File

If you have other products that make use of FLEXlm you may wish to install your Telelogic Tau license features into the existing FLEXlm license.dat file. To install the license key:

1. Copy the following lines from the license key you received from Telelogic Customer Support into the existing license.dat file:
• the DAEMON line; make sure to change the path to the \flex subdirectory in your Telelogic Tau installation directory
• 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 FLEXlm Licensing Pitfalls to Avoid).

2. Set the environment variable 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. 7598@server.

If you run	Set the environment variable
Windows NT	Click Start button, Settings > Control Panel and then System > Environment. Set User Variables toLM_LICENSE_FILEand Value to the complete path to the license.dat file, e.g. N:\flexlm\license.dat, or to a port number and server, e.g. 7598@server. Set the System Variables if you have administrator rights.
Windows 95	Insert a command in the file AUTOEXEC.BAT, e.g. SET LM_LICENSE_FILE=7598@server or SET LM_LICENSE_FILE=N:\flexlm\license.dat Restart your computer.

3. 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 FLEXlm utility in:



<Tau installation directory>\flex\lmtools.exe

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 FLEXlm for Telelogic Tau licenses, or wish to run a separate FLEXlm license server for Telelogic Tau, do the following:

1. Save or copy the FLEXlm license key you received from Telelogic Customer Support into a text file called license.dat and store the file, for instance in the directory where Telelogic Tau is installed.
2. Set the environment variable LM_LICENSE_FILE to point to the location of your 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. 7598@server.

If you run	Set the environment variable
Windows NT	Click Start button, Settings>Control Panel and then System>Environment. Set User Variables toLM_LICENSE_FILEand Value to the complete path to the license.dat file, e.g. C:\tau35\license.dat, or to a port number and server, e.g. 7598@server. Set the System Variables if you have administrator rights.
Windows 95	In AUTOEXEC.BAT, e.g. SET LM_LICENSE_FILE=7598@server or SET LM_LICENSE_FILE=C:\tau35\license.dat Restart your computer.

Starting the License Server

You will now start the FLEXlm 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. Log in on the computer where the license server is to run.
2. Make sure no license servers for the Telelogic Tau tools are currently running. Search for the license daemons lmgrd.exe and telelogic.exe in the Processes list in the Windows Task Manager (see Automatic Server Startup (Windows)).
3. Start a Command Prompt.
4. Change to the FLEXlm directory in the Telelogic Tau installation, e.g.:



cd c:\tau35\flex

5. Start the license server:



c:\tau35\flex> lmgrd -app

6. Check that the license server has been started correctly. Execute c:\tau35\flex> lmtools.exe and select Status.

The license server statistics is displayed containing the server, the vendor daemon telelogic and the features available in your license.dat file.

7. If the startup has failed, check the license.dat file for errors and omissions; see FLEXlm Licensing Pitfalls to Avoid. Double-check your file with the original sent from Telelogic Customer Support. Especially check the "company name" information in the quote-field of the first FEATURE line in the file.

As an additional debugging help, the log for the license server will be displayed from where the license server was started. Unfortunately, when the server is started manually this way, there is no way to "close" this console window. It can be "minimized" at best.

8. For Windows NT users, we suggest installing the license server as a service; Windows 95 users should use the Startup folder. See Automatic Server Startup (Windows) for more information.

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 Telelogic Tau 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 ORCA and SDT Compiler Environment and ITEX Compiler Environment.

Starting Up the Telelogic Tau Tools

Telelogic Tau can be started from an icon in Start menu > Programs. An alternative way is to double-click an .sdt file.

Post Installation

Updating Preferences Files

Note:  This subsection is only applicable if you are upgrading from a previous version of Telelogic Tau.

Telelogic Tau 3.5 has some new preference parameters. Update these parameters by using the Preference Manager. See Managing Preferences.

Limiting On-Line Help Disk Space

If you have installed Telelogic Tau locally on several PC's, you may wish to limit the disk space usage in a multi-user environment. Instead of storing the Telelogic Tau on-line help files locally on every PC where you have installed Telelogic Tau, you may put a single copy of the on-line help files on a network server. This is further described in Configuring the Help Environment.

Adding Telelogic Tau Components to an Existing Installation

If you want to add components to your installation, follow the instructions below. For more information on available components, see Installation Options.

1. Mount the CD, as described in Mounting the CD-ROM.
2. Follow all steps described in Installing the Telelogic Tau Software.
• In the Destination Location dialog, enter the same installation directory as you did when you installed Telelogic Tau the first time.
• Choose Custom installation in the Setup Type dialog.
• Deselect the components you do not want to install in the Select Components dialog. If you install a component that is already installed, the existing component will be overwritten.