Installation Guide

Tecplot, Inc.

Bellevue, WA

2006

COPYRIGHT NOTICE Tecplot 360TM Installation Guide is for use with Tecplot 360TM 2006. Copyright 1988-2006 Tecplot, Inc. All rights reserved worldwide. Except for personal use, this manual may not be reproduced, transmitted, transcribed, stored in a retrieval system, or translated in any form, in whole or in part, without the express written permission of Tecplot, Inc., 3535 Factoria Blvd., Ste 550, Bellevue, Washington, 98006, U.S.A. The software discussed in this documentation and the documentation itself are furnished under license for utilization and duplication only according to the license terms. The copyright for the software is held by Tecplot, Inc. Documentation is provided for information only. It is subject to change without notice. It should not be interpreted as a commitment by Tecplot, Inc. Tecplot, Inc. assumes no liability or responsibility for documentation errors or inaccuracies. Tecplot, Inc. PO Box 52708 Bellevue, WA 98015-2708 U.S.A. Tel: 1.800.763.7005 (within the U.S. or Canada), 00 1 (425)653-1200 (internationally) email: [email protected], [email protected] Questions, comments or concerns regarding this documentation: [email protected] For more information, visit http://www.tecplot.com THIRD PARTY SOFTWARE COPYRIGHT NOTICES ENCSA Hierarchical Data Format (HDF) Software Library and Utilities 1988-1998 The Board of Trustees of the University of Illinois. All rights reserved. Contributors include National Center for Supercomputing Applications (NCSA) at the University of Illinois, Fortner Software (Windows and Mac), Unidata Program Center (netCDF), The Independent JPEG Group (JPEG), Jean-loup Gailly and Mark Adler (gzip). Bmptopnm, Netpbm 1992 David W. Sanderson. Dlcompat 2002 Jorge Acereda, additions and modifications by Peter OGorman. Ppmtopict 1990 Ken Yap. TRADEMARKS Tecplot, Tecplot 360TM, PreplotTM, Enjoy the ViewTM, and FramerTM are registered trademarks or trademarks of Tecplot, Inc. in the United States and other countries. Encapsulated PostScript, PostScript, Premier are registered trademarks or trademarks of Adobe Systems, Incorporated in the U.S. and/or other countries. Ghostscript is a registered trademark of Aladdin Enterprises in the U.S. and/or other countries. Linotronic, Helvetica, Times are registered trademarks or trademarks of Allied Corporation in the U.S. and other countries. AutoCAD, DXF are registered trademarks or trademarks of Autodesk, Incorporated in the U.S. and other countries. lan License Manager is a trademark of lan Computer Group, Incorporated in the U.S. and/or other countries. DEC, Digital, LaserJet, HP-GL, HP-GL/2, PaintJet are registered trademarks or trademarks of Hewlett-Packard Company in the U.S. and other countries. X-Designer is a registered trademark or trademark of Imperial Software Technology in the U.S. and/or other countries. Builder Xcessory is a registered trademark or trademark of Integrated Computer Solutions, Incorporated in the U.S. and other countries. IBM, RS6000, PC/DOS are registered trademarks or trademarks of International Business Machines Corporation in the U.S. and/or other countries. Bookman is a registered trademark or trademark of ITC Corporation in the U.S. and/or other countries. VIP is a registered trademark or trademark of Landmark Graphics Corporation in the U.S. and/or other countries. X Windows is a registered trademark or trademark of Massachusetts Institute of Technology in the U.S. and/or other countries. ActiveX, Excel, MS-DOS, Microsoft, Visual Basic, Visual C++, Visual J++, Visual Studio, Windows, Windows Metafile are registered trademarks or trademarks of Microsoft Corporation in the U.S. and/or other countries. HDF, NCSA are registered trademarks or trademarks of National Center for Supercomputing Applications in the U.S. and/or other countries. UNIX, Motif are registered trademarks or trademarks of Open Software Foundation, Incorporated in the U.S. and other countries. Gridgen is a registered trademark or trademark of Pointwise, Incorporated in the U.S. and/or other countries. Eclipse, FrontSim are registered trademarks or trademarks of Schlumberger, Limited in the U.S. and/or other countries. IRIS, IRIX, OpenGL are registered trademarks or trademarks of Silicon Graphics, Incorporated in the U.S. and/or other countries. Solaris, Sun, Sun Raster are registered trademarks or trademarks of Sun MicroSystems, Incorporated in the U.S. and/or other countries. All other product names mentioned herein are trademarks or registered trademarks of their respective owners. NOTICE TO U.S. GOVERNMENT END-USERS Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraphs (a) through (d) of the Commercial ComputerRestricted Rights clause at FAR 52.227-19 when applicable, or in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, and/or in similar or successor clauses in the DOD or NASA FAR Supplement. Contractor/manufacturer is Tecplot, Inc., Post Office Box 52708, Bellevue, WA 98015-2708. 06-360-03-1 Rev 03/2006

Contents
Chapter 1 Requirements ................................. 6
Technical Support ..............................................6 Requirements .....................................................6
System Requirements ................................................6 Platform Requirements .............................................7 Graphics Requirements ............................................7 Display Requirements ...............................................7 License Server Requirements....................................7

License Types ....................................................8

Single User License ..................................................8 Network License .......................................................8

License Keys .....................................................8 Changing License Servers or IP Addresses .......9 Running Network Versions of Tecplot 360 and Tecplot Focus .....................................................9

Chapter 2 Windows Installation ....................11

License Types .................................................. 11 Installation Instructions ...................................12 Additional Installation Instructions .................14
Evaluation License .................................................14 Single User with a Dongle ......................................14 Single User without a Dongle.................................15 Network License .....................................................15
3

Contents

Site License .............................................................16

Working with the Network License Manager ..16

Starting the License Manager ................................16 License Manager Settings ......................................17 Monitoring the License Manager ...........................18 Controlling the License Manager ...........................18 The Resource File ...................................................18 Modifying the Windows XP firewall .......................20

Chapter 3 Linux Installation ......................... 21

Linux Installation Procedure ............................21
Linux Installation Preparation ...............................21 TEC360HOME Environment Variable Setup .........21 Linux Help Configuration ......................................23 User Alias Selection ...............................................23 Linux Software Installation ....................................24

Network and Single User License Installation 26

License Server Selection .........................................26 License Key Installation .........................................27 License Manager Daemon Start-Up .......................28 TLMHOST Variable Setup ......................................29 License Manager Stopping .....................................30 Tecplot Installation on Other Linux Clients ...........30 Tecplot Installation on Windows Clients ................31

Site License Installation ...................................31

Tecplot Start-Up .....................................................31 Tecplot Running Remotely ......................................31 License Manager Setup ..........................................32 License Server Changing........................................33

Chapter 4 Macintosh Installation ................. 34

Installation Instructions ...................................34 License Manager Set-Up .................................36
License Server Changing ........................................37

Uninstalling Tecplot ........................................37 Notes ................................................................38

Chapter 1

Requirements

The installation instructions contained within this manual require a basic understanding of file editing, directory navigation, path names, environment variables and aliases. If you are unfamiliar with any of these, please ask your system administrator for assistance in installing Tecplot 360.

1 - 1 Technical Support
Tecplot, Inc. offers technical assistance through the following methods: Internet: www.tecplot.com/support E-mail: [email protected] Telephone: 425.653.9393 Please include your Tecplot license number whenever contacting Tecplot Technical Support.

1 - 2 Requirements
1- 2.1 System Requirements
Tecplot requires a minimum of 250 MB of disk space and 1 GB of RAM.

Requirements

1- 2.2 Platform Requirements

TABLE 1.

Supported 64-bit Platforms

CPU/Model Operating System Graphics

Platform

HP IBM Linux Linux SGI Sun

TABLE 2.

9K/7xx RS6000 Intel IA64 R5k, R8k, R10k Sparc

HPUX 11.0 or newer AIX 5.1 or newer Linux Kernel 2.4 or 2.6, glibc 2.3 newer Linux Kernel 2.4, glibc 2.3 newer IRIX 6.5.27 or newer Solaris 8 or newer

OpenGL or Mesa OpenGL or Mesa OpenGL or Mesa OpenGL or Mesa OpenGL or Mesa OpenGL or Mesa

Supported 32-bit Platforms

CPU/Model Operating System Graphics

Platform

Windows Linux

Intel Intel

Macintosh PPC

Windows XP, 2000 Linux Kernel 2.4 or 2.6, glibc 2.3 newer Mac OS X 10.3, 10.4

OpenGL OpenGL or Mesa OpenGL or Mesa

1- 2.3 Graphics Requirements

An OpenGL-accelerated card is required.

1- 2.4 Display Requirements

A minimum resolution of 1024 x 768 is required.

1- 2.5 License Server Requirements

If youre using a network license version, the following restrictions apply: 1. The server that runs the license manager must be running whenever users run Tecplot 360 on a networked computer. 2. The server must have a stable IP address.
7

1 - 3 License Types
There are two basic types of Tecplot 360 licenses for Linux and Windows. The installation procedure depends upon the type of license purchased. If you are not sure about what type of license you have, or would like to upgrade your license, please contact Tecplot or your distributor.

1- 3.1 Single User License

A Single User license allows one copy of Tecplot 360 to be installed, run and displayed on a single computer. For Linux Single User licenses, Tecplot 360 cannot be displayed remotely using the X-Window System and only one session of Tecplot 360 may run at a time.

1- 3.2 Network License

A Network license allows Tecplot 360 to be run anywhere within a local area network (LAN) for up to a specified number of users. This is a floating license, so Tecplot 360 may be installed on as many computers in your LAN as desired.

1 - 4 License Keys
Note (Windows Single User with a dongle): If you are installing Tecplot for the first time, you do not need to request a key to run Tecplot. The license key is printed on the dongle supplied with your software. Refer to 2- 3.2 Single User with a Dongle on page 14 for additional information.

The procedure for obtaining license keys for Tecplot is as follows: 1. Log on to your License Server and determine the server code. Windows: Run the LM Administration utility, located inside the Tecplot Program Group under the Start menu.
8

Changing License Servers or IP Addresses

Linux: switch to the Tecplot home directory and type: .setuplic Select Install Purchased License Key. 1. Request a license key using one of these methods: Internet: www.tecplot.com/support. On the Support page and choose Request a License Key. E-mail: [email protected] Telephone: 425.653.9393 Be sure to specify your license number and server code whenever you request a new key.

1 - 5 Changing License Servers or IP Addresses

Windows Network License and Linux License keys are unique to a single computer hardware ID and IP address. If you need to move your Tecplot license to a new machine, or change the IP address of your license server, please contact Tecplot or your local distributor to request a new key. (See Section 1 - 4, License Keys. ).

1 - 6 Running Network Versions of Tecplot 360 and Tecplot Focus

If you have a network license of both Tecplot 360 and Tecplot Focus, you need to perform the following additional steps (on the server computer ONLY). 1. Install Tecplot 360 first (including the Network License Manager). 2. Install Tecplot Focus (without the Network License Manager). 3. Run the License Manager, a. Enter your Tecplot 360 key
9

b. Enter your Tecplot Focus key

10

Chapter 2

Windows Installation

2 - 1 License Types
There are five license types for Tecplot 360: Evaluation License Single User License (with a dongle) Single User License (without a dongle) Network License Site License The installation instructions are essentially the same for each license type and are provided in 2 - 2, Installation Instructions. Additional instructions for dongle users are provided in 2- 3.2, Single User with a Dongle. Additional information on Network License management can be found in 2 - 4, Working with the Network License Manager.

2 - 2 Installation Instructions
The auto-install should begin the installation process once the CD is loaded. If not, use Explorer to open the CD directory and double-click on setup.exe.

11

1. License Agreement - Please read and accept the license agreement in order to continue with the installation. Acceptance is indicated by selecting the I Accept radio button, and clicking Next. 2. License Type - Select the appropriate license type and press the Next button. [Evaluation users ONLY] - Enter the Eval Key provided with your CD or contact your Tecplot salesperson for a key. If you dont have your evaluation key, you can skip this step and enter it when you first launch Tecplot. [Network License users ONLY] Enter the name or IP address of the machine on which the License Manager software has been or will be installed.

NOTE - Network License Manager software must be

installed on one computer with a stable IP address. That computer must be part of the network where Tecplot is installed, and it must be running during those times when Tecplot is in use. Refer to 2- 3.4 Network License on page 15 for instructions on installing the license manager and 2 - 4 Working with the Network License Manager on page 16 for information on working with the license manager.

3. User Information - Please fill out the information for Name, Organization and License Number. If you will be the only user, select that radio button and click Next. If others will be using this software, you must have administrator rights on your computer to install the necessary settings. If you have those rights, select the Anyone Who Uses This Computer radio button, and click Next.

4. Destination Folder -A default Destination Folder is selected for installation. Browse for a new folder if you would like to install Tecplot elsewhere. Select the Next button to continue.

12

Additional Installation Instructions

5. Working Folder - A default Working Folder is selected for installation. Alternatively, you may browse to a new folder. Select the Next button to continue. 6. Select Installation Type - Specify whether to perform a custom or default installation type. The default installation installs all components of Tecplot. The custom installation allows you to select whether or not to install the Add-on Developers Kit (ADK) directory, the Documentation folder (Docs) or the Demo folder. Select an option and click Next. 7. Ready To Install - You may click Back to change your selection, or click Install to continue. 8. Once the installation process is complete, click Finish. 9. The remaining installation steps are dependent upon the type of license that you have. Please proceed to the section corresponding to your license type: 2- 3.1 Evaluation License on page 14 2- 3.2 Single User with a Dongle on page 14 2- 3.3 Single User without a Dongle on page 15 2- 3.4 Network License on page 15 2- 3.5 Site License on page 16

2 - 3 Additional Installation Instructions

2- 3.1 Evaluation License
If you did not enter your Eval Key in Step 2, enter it when you first launch Tecplot.

13

2- 3.2 Single User with a Dongle

Your Tecplot Single User license is protected by the Sentinel SuperPro dongle and a license key that is associated with your dongle. The dongle is distributed along with your Tecplot installation key. If you are updating from an earlier version of Tecplot, you can install a new license key and your current dongle will still work. Send your license number and the server code generated by the dongle, and a new key will be sent to you. Once you have completed Steps 1 - 8 from 2 - 2, Installation Instructions, please perform the following steps: 1. Restart Your System - In order for the installation to take effect, you must restart your system. This screen gives you the option to restart your system now or later. 2. Attach the Sentinel SuperPro dongle to your computers parallel port. If a printer or other device is using the port, attach the dongle first, then connect your device to the dongle. 3. Run Tecplot. 4. The Single-Computer License Key dialog will launch, prompting you to enter your license key. 5. Contact your local distributor with your dongle ID (displayed in the dialog) and a new key will be sent to you. 6. Upon receipt, enter your license key in Tecplot.

2- 3.3 Single User without a Dongle

Once you have completed Steps 1 - 8 from 2 - 2, Installation Instructions, please perform the following steps: 1. Run Tecplot.

14

Additional Installation Instructions

2. The Personal License Key dialog will launch, prompting you to enter your license key. Go to our website to get a key, www.tecplot.com. Contact your salesperson or technical support if you have a problem.

2- 3.4 Network License

The Network version of Tecplot runs under the control of a license manager. The License Manager is installed on only one computer on your network, even if you are licensed for multiple copies of Tecplot. You should choose a computer with a stable IP address that will be on and available any time someone wants to run the Tecplot software. Tecplot can be loaded on any computer on the same network as the License Manager. Installation of the License Manager software requires Administrator privileges (unlike the Tecplot installation). Tecplot License Manager Setup will guide you through the installation process. Start the installation by double-clicking on TecplotLM.msi (located in the licensemgr subdirectory of the windows directory on your installation CD). You must contact Tecplot Support by e-mail or telephone to obtain a key that will activate your Tecplot licenses. A program named Install Key will automatically be launched at the end of the License Manager installation, or you can click Start > Programs > Tecplot License Manager >Install Key. When the Install Key widget appears, the dialog will display the Key Directory, the Host Name and the Server Code. Copy the Server Code, and with that information, call or e-mail Tecplot where a support representative will provide you with a Key code that should be entered in the Key field of the dialog.
If you have a Network license, you must have Tecplot License Server software installed on one machine, with a stable IP address, that is on the network where Tecplot will be run.

Refer to 2 - 4 Working with the Network License Manager on page 16 for addition information on the Network License Manager.
15

2- 3.5 Site License

If you choose the Site license, you need to copy an additional installation file, tecplot.ste into your Tecplot installation directory. Please contact your site license manager for the file.

2 - 4 Working with the Network License Manager

In addition to the Install Key program, please familiarize yourself with the other two applications in the License Manager: Server Runtime Control and Query Server. Server Runtime Control allows you access to information relating to Tecplot logs, while Query Server allows you to list current servers, clients and information on the environment in which your host operates.

2- 4.1 Starting the License Manager

To launch the Tecplot license manager, select TecplotLM from the control panel. The Tecplot Network License Manager dialog has the following options: Startup - Select one of the following settings for launching the license manager Manual - Select this option to launch the license manager manually (via the Tecplot License Manager) whenever your computer is restarted. Automatic - Select this option to launch the license manager automatically with each restart. Disabled - Select this option to disable the license manager. Settings - Use the Settings button to adjust the startup parameters of the Tecplot license manager.

16

Working with the Network License Manager

Launch/Stop - Select the Launch or Stop button to change the activity status of the License Manager.
If you have a Network license, you must have Windows License Server software installed on one machine, with a stable IP address, that is on the network where Tecplot will be run.

2- 4.2 License Manager Settings

Select the Settings button from the License Manager and verify the following parameter values: Key Directory = TLM subdirectory below the Tecplot home directory (e.g. C:\Tecplot\TLM) Log File Name = TLM.log (located in the Key directory) Log File Size Limit > 0 (40k is a reasonable limit)

2- 4.3 Monitoring the License Manager

Use the Query Server utility to monitor the status of your license keys. Enter 02 in the Feature field and press the Client button. After a brief wait, a list of your license key(s) and their status will be displayed. If you are also running instances of the Tecplot Focus via the license manager, enter 01 in the Feature field to monitor your Tecplot Focus keys. See also: 1 - 6 Running Network Versions of Tecplot 360 and Tecplot Focus on page 9.

17

2- 4.4 Controlling the License Manager

Use the Server Runtime Control utility to control the log file. The Server Runtime Control dialog has the following options: Zero Log - select the Zero Log button to empty the license manager log file. Find Log - select the Find Log button to identify the path for TLM.log Dump Log - select the Dump Log button to write the server information to the log file. Bury Client - Use the Bury Client button to revoke the license for a running client (i.e. log-off the user and make the license available for another user).

2- 4.5 The Resource File

The resource file contains user login names or host names for which licenses are to be reserved. If redundant License Manager servers are being used, the resource file should also contain the names of the hosts on which the License Manager may be running. The resource file must be named tlm.res, and it must reside in the TLM subdirectory of the Tecplot home directory. Any changes to the resource file must be installed by stopping and restarting the license manager.

RESTRICTING USERS
By default, the Tecplot License Manager accepts requests from any IP address within your local network. To restrict this add the %IPACCEPT command to the resource file. The %IPACCEPT command has the following format: %IPACCEPT e.e.e.e

18

Working with the Network License Manager

where the e may be any one (or a comma separated list) of: an integer, an integer range, a wildcard (*), or the word THIS. The word THIS is used to represent the corresponding IP address for the machine where the license manager is running. For example: %IPACCEPT 192.37.123.* - allows Tecplot to be run on machines with an IP address beginning with 192.37.123 %IPACCEPT THIS.THIS.THIS.200-210 - allows Tecplot to be run on machines within the subnet as the license manager and whose IP address end in 200-210.

RESERVED, EXCLUDED AND HELD LICENSES

Licenses may be reserved for individual users or client machines using the resource file. Individual users can also be excluded from using licenses. Reserved and excluded licenses are indicated in the resource file using the following command:
NNN:GROUP:CLIENT1, CLIENT2, ...CLIENTn:NUMKEYS:HOLDPERIOD

Each line starts with an integer value NNN, where NNN is 02 for Tecplot 360. GROUP can be anything you want and is not related to the Linux group. CLIENT1, CLIENT2,...CLIENTn are either login names or hostnames of computers. If a hostname is entered, precede the hostname with the @ symbol. NUMKEYS is the number of licenses reserved for the GROUP. HOLDPERIOD is the number of seconds to hold a license recently made available by a member of the GROUP before making it available to other users. To restrict specific users, use the word EXCLUDE in lieu of NUMKEYS.

19

2- 4.6 Modifying the Windows XP firewall

The license manager for network licenses may not work on Windows XP platforms until you change the following settings. 1. Launch the Control Panel. 2. Select the Windows Firewall control. 3. In the Windows Firewall dialog, select the Exceptions tab. 4. Select the Add Port button. 5. Set the Name= TecplotLM. 6. Set Port=5291. 7. Choose the UDP radio button. 8. (Optional) Select the Change Scope and modify the computers that can use this port. My Network (Subnet) Only would be recommended. 9. Press the OK button to apply the changes and close the dialog. 10.You are now ready to use your Tecplot Network license on Windows XP. Contact Technical Support at [email protected], if you have additional questions.

20

Linux Installation Procedure

Chapter 3

Linux Installation

3 - 1 Linux Installation Procedure

We suggest that you log in as root to install Tecplot. This allows you to install Tecplot in system directories such as /usr or /usr/local, which typically have write permission only if you are logged in as root.

3- 1.1 Linux Installation Preparation

The Tecplot home directory is where the Tecplot program and associated files are stored. In order for Tecplot to run properly, you must tell it where the Tecplot home directory is located. There are two ways that you can do this: By assigning the path for the Tecplot home directory to the environment variable TEC360HOME. By setting aliases that use the -h flag on the command line.

3- 1.2 TEC360HOME Environment Variable Setup

If you use the TEC360HOME environment variable, you must also include the bin sub-directory of the Tecplot home directory in your PATH environment variable so the Tecplot program and other utilities in this directory can be executed. The following procedure assumes you know what type of shell you are using. If you do not know, type the following command:
echo $SHELL

21

A response of /bin/csh means you are using the C shell, a response of / bin/ksh means the Korn shell, a response of /bin/sh means the Bourne shell, and a response of /bin/bash means the BASH shell. For example, if your Tecplot home directory is /usr/tec360, do the following (choosing the commands appropriate to your shell): For users running the Bourne, Korn, or Bash shell, add the following to your .profile file (Bourne or Korn) or .bash_profile (for Bash) in your login home directory:
TEC360HOME=/usr/tec360 export TEC360HOME ...{pre-existing code}... PATH=..paths already assigned..:$TEC360HOME/bin

If you have the path to an earlier version of Tecplot included in your PATH environment variable, replace that path with the Tecplot 360 path information. For users running the C shell, add the following to your .cshrc file in your login home directory:
setenv TEC360HOME /usr/tec360 ...{pre-existing code}... set path = (... paths already assigned ... $TEC360HOME/bin) ...

If you have the path to an earlier version of Tecplot included in your PATH environment variable, replace that path with the Tecplot Version 360 path information. All changes made to your .profile or .cshrc file must be activated. For the Korn or Bourne shells, run the following command:
. ./.profile
22

Linux Installation Procedure

For C shell, run the following command:

source . ./.cshrc

For bash shell, run the following command:

. ./.bash_profile

3- 1.3 Linux Help Configuration

Help in Tecplot now uses any browser capable of displaying an HTML file. Tecplot may be configured to use any browser with only slight modifications to the example LaunchBrowser file located in the bin directory. The comments in the file should provide sufficient information for you to customize your settings. If you are having trouble viewing the help files, please contact your System Administrator.

3- 1.4 User Alias Selection

If your Tecplot home directory is /usr/tec360, set up the following aliases: For users running the Bourne or Korn shell, add to the .profile file in your login home directory:
alias -x tecplot="/usr/tec360/bin/tecplot -h /usr/tec360" alias -x preplot="/usr/tec360/bin/preplot" alias -x cnvtec="/usr/tec360/bin/cnvtec"

For users running the C shell, add to the .cshrc file in your login home directory:
alias tecplot "/usr/tec360/bin/tecplot -h /usr/tec360" alias preplot "/usr/tec360/bin/preplot" alias cnvtec "/usr/tec360/bin/cnvtec"

For users running the bash shell, add to the .bash_profile file in your login home directory:
23

alias tecplot = "/usr/tec360/bin/tecplot -h /usr/tec360" alias -x preplot="/usr/tec360/bin/preplot" alias -x cnvtec="/usr/tec360/bin/cnvtec"

All changes made to your .profile or .cshrc file must be activated. For the Korn or Bourne shells, run the following command: . ./.profile For C shell, run the following command: source .cshrc

3- 1.5 Linux Software Installation

To install Tecplot from your CD drive: 1. Log on to your computer (preferably as root.) 2. If you are upgrading from an older version of Tecplot, first kill the License Manager daemon tlmd. Go to your current Tecplot home directory and type: tlm/tlmadmin -k 3. It is best to delete the previous License Manager installation directory. 4. Insert the Tecplot CD in the CD drive (exact CD mounting procedures may vary between platforms). 5. Switch to the unix (or UNIX) sub-directory under the root directory of the CD. This directory is generally named /cdrom or /CDROM. 6. Issue the ls command and check the results. You should see the setuptec script, named according to one of the following formats:
SETUPTEC.;1 setuptec.
24

Linux Installation Procedure

setuptec

7. Start the setuptec script by issuing the command from the following list that best matches the result from the previous step, including the double quotes and all other punctuation marks.
"./SETUPTEC.;1" ./setuptec. ./setuptec

8. The setuptec script prompts you for information and completes the installation process. When setuptec asks for the directory where the distribution files should be written, enter the full path to the Tecplot home directory (See 3- 1.1 Linux Installation Preparation on page 21). 9. The setuptec script now asks you if you wish to continue with the installation of the license key to run Tecplot. At this point, continue on to one of the following sections: If the machine where you are installing Tecplot is not the one that will be running the License Manager, select Skip license key installation on this machine, then go to Section 3- 2.4, TLMHOST Variable Setup. If you are installing a Site License, select Skip license key installation on this machine, then move on to Section 3 - 3, Site License Installation. If you are installing Tecplot on the machine running the License Manager, but do not yet have a key, select Get server code now and install key later. Then at a later time, follow the steps outlined in Section 3- 2.2, License Key Installation. If you already have your license key for Tecplot 360, select Obtain server code now and install the key now, and continue with the steps below.

10.The setuptec script displays a server code for the current machine. Send this information to Tecplot or your local Tecplot distributor (See 3- 2.2 License Key Installation on page 27).
25

11.Enter the key provided by Technical Support at the prompt.

3 - 2 Network and Single User License Installation

Linux Network and Single User licenses both run under the control of the Tecplot License Manager. The Tecplot License Manager limits the number of users who can access Tecplot simultaneously. The Tecplot License Manager consists of a daemon application which runs on a single computer called the license server. This daemon manages the allocation of keys to Tecplot users. When a user runs Tecplot on any machine in the network, Tecplot contacts the license server via TCP/IP and checks out a key from the License Manager. When the user quits Tecplot, the License Manager checks in the key. The License Manager limits the number of Tecplot sessions currently active to the number of users allowed by the license. If you have a Single User License, you will only be able to run and display Tecplot on the licensed computer.
Note: We no longer support redundant License Managers for those who have used redundant license servers for Tecplot Version 7.0 or older. If you have any questions or comments regarding this, please contact Tecplot Technical Support, or your local Tecplot distributor.

3- 2.1 License Server Selection

The machine you designate as your license server must have the following characteristics: The license server must be of a machine type and operating system that Tecplot Version 360 supports.
26

Network and Single User License Installation

The license server must be up and running when users are running Tecplot on any machine in your network. For network licenses, the license server must be set up so that it can communicate via TCP/IP with all machines on which you will be running Tecplot. That is, you should be able to contact the license server via telnet or ping. The license server must have a stable IP address. Any change to the operating system or the IP address will require a new key.

3- 2.2 License Key Installation

In order to run Tecplot, a license key must be installed on the machine that runs the License Manager daemon. To install the key, use the following steps: 1. Go to the Tecplot home directory and enter the following command:
./setuplic

2. The setup program will display a list of options. Choose the option labeled Install purchased license key. 3. Obtain a license key (See Section 1 - 4, License Keys. for details). 4. At the prompt, enter your license key. After successful installation of your license key, the setup will create a key file, $TEC360HOME/tlm/02.lic. Do not edit or move this file after installing. The key is linked to your server code, which may be based in part on the license servers IP address. If your IP address, operating system or ethernet card should change, or you wish to move the License Manager to a different
27

server, send a request for a new key to Tecplot Technical Support, or your local distributor. Be sure to include your license number and your new server code in your request.

3- 2.3 License Manager Daemon Start-Up

The License Manager daemon must be running in order for any user to run Tecplot. The License Manager may be started manually or automatically.

Manual Start-Up. If you did not already launch the License Manager daemon during the installation process or if the License Manager was stopped for some reason, start the License Manager by going to the Tecplot home directory and entering the following command:
./setuplic

Setup will display a list of options. Choose the option labeled Restart the license manager.

Automatic Start-Up. If the computer where the License Manager is located

has stopped, and then started, the License Manager will not restart automatically unless one of the system startup shell scripts contains the following command:
<tecplothomedirectory>/setuplic <tecplothomedirectory> restart

where <tecplothomedirectory> is the full path to the Tecplot home directory. The system startup script to which you add this command will vary depending on your operating system. Consult with your system administrator if you are unsure which system startup script is appropriate.

28

Network and Single User License Installation

For example, on Linux you might place the command in /etc/rc.d/ rc.local. On SGI/Solaris, you may place the command in /etc/rc2.d/ S9x..
Note: If you are updating from a previous version of Tecplot, be sure to edit the system startup shell scripts and make any modifications necessary to start up the Tecplot Version 360 License Manager instead of the old License Manager.

3- 2.4 TLMHOST Variable Setup

In order for Tecplot to contact the License Manager daemon, it needs to know which machine is running the License Manager. Tecplot looks to the TLMHOST environment variable for this information. For users to access Tecplot, they must set TLMHOST equal to @hostname where hostname is the name or IP address of the host where the License Manager daemon is running. TLMHOST must be set for all users of Tecplot, on any machine where the software will be executed. We suggest that you set this environment variable in each users .cshrc,.profile or .bash_profile file by using one of the following commands. For users running the Bourne, Korn or Bash shell, enter the following line into your .profile file (Bourne or Korn) or .bash_profile file (Bash):
TLMHOST=@remotehostname ; export TLMHOST

For users running the C shell, enter the following line into your .cshrc file:
setenv TLMHOST @remotehostname

29

where remotehostname is the name of the host where the License Manager daemon (tlmd) is running. Be sure to include the @ symbol in your TLMHOST variable, as shown above. As always, changes made to your .profile or .cshrc file must be activated. For the Korn or Bourne shells, run the following command:
. .profile

For C shell, run the following command:

source .cshrc

3- 2.5 License Manager Stopping

To terminate the License Manager daemon at any time, switch to the Tecplot home directory and type:
./setuplic

In setuplic, choose option 5, Kill the License Manager. Depending on your system permission settings, you may need to log in as root to kill the License Manager.

3- 2.6 Tecplot Installation on Other Linux Clients

To install Tecplot on other Linux machines in your network, follow steps 1 through 9 as listed in Section 3- 1.5, Linux Software Installation. When the setup is complete, choose the skip license installation option. Be sure to set TLMHOST to the name of your license server. (See Section 3- 2.4, TLMHOST Variable Setup. )

30

Site License Installation

3- 2.7 Tecplot Installation on Windows Clients

With a Linux Network License, it is possible to run Tecplot on a Windows client, without displaying remotely from a Linux machine. To install Tecplot on a Windows client, follow the instructions in Section 2 - 2, Installation Instructions.

3 - 3 Site License Installation

After completing the steps in Section 3- 1.5, Linux Software Installation, choose the skip license installation option. Send a license key request to Tecplot Technical Support, and provide the following information: Your license number. The network IP address(es) at your site. A license key, along with instructions on how to install the key, will be provided by our support staff.

3- 3.1 Tecplot Start-Up

To run Tecplot, type: tecplot A complete description of Tecplots command line options can be found in the Tecplot Users Manual.

3- 3.2 Tecplot Running Remotely

If you purchased a Network or Site License, you may run Tecplot remotely using the X Window System.

31

X Window System programs send their output to the display identified by the DISPLAY environment variable. Set your DISPLAY environment variable by entering one of the following commands: If your login shell is the Bourne or Korn shell, type:
DISPLAY=hostnameofservermachine:0; export DISPLAY

If your login shell is the C shell, type:

setenv DISPLAY hostnameofservermachine:0

Another option is to use the -d flag on the command line, for example:
tecplot -d computername:0

If you purchased a Single User License, Tecplot must run and display on the same computer.

3- 3.3 License Manager Setup

The license-managed version of Tecplot requires the Tecplot License Manager to run on a network-accessible machine. If the License Manager is running on a Macintosh, you may use the setuplic shell script in Tecplots home directory, or the TecplotLM utility in Tecplots TLM directory to setup the License Manager. (Refer to Section 3 - 1, Linux Installation Procedure, for more information on the setuplic shell script.) To use the TecplotLM utility: 1. If TecplotLM was launched by the Tecplot installer, close the Tecplot installer. Otherwise, double-click on the TecplotLM icon in Tecplots TLM directory. 2. Your machines server code is displayed. Send a license key request, including the server code, to Tecplot or your local distributor. For

32

Site License Installation

information on how to request a license key, see Section 1 - 4, License Keys. 3. Fill the supplied key in the License Key text field and click Add. A message appears stating the key has been added. 4. Click Start Manager. If it is enabled, the License Manager starts. (It is disabled if the License Manager is already running; you can still install license keys when the License Manager is running.) 5. (Optional) Click Auto-Start to configure the operating system to automatically start the License Manager whenever the system is re-booted. This launches another installation package. If TecplotLM was launched by the Tecplot installer and you did not close the installer prior to clicking Auto-Start, the installer comes to the front and does nothing. Close the installer window and click Auto-Start again. Proceed with the Auto-Start installation. 6. Click Quit. See also: 1 - 6 Running Network Versions of Tecplot 360 and Tecplot Focus on page 9.

3- 3.4 License Server Changing

License keys are unique to a single computer hardware ID. If you need to move your Tecplot License Manager to a new machine, please contact Tecplot or your local distributor to request a new key. Be sure to specify your license number and server code whenever you request a new key.

33

Chapter 4

Macintosh Installation

4 - 1 Installation Instructions
To install Tecplot 360 on your computer, perform the following steps:
You may also use the Linux installation procedure in a terminal window (the CD is mounted in /Volumes). See 3 - 1 Linux Installation Procedure on page 21. You must have administrative privileges in this case.

1. Insert the Tecplot CD into your CD drive. Double-click on the Tecplot 360 disk icon on your desktop, then double-click on the Mac folder to open it. 2. Double-click on the Tecplot 360 Install icon. This should be named Tecplot 360 or Tecplot360.pkg. This launches Apples package installer to install Tecplot. 3. Choose Continue. 4. After reading the Read me notes, click Continue. 5. After reading the Software License Agreement, click Continue. 6. A pop-up window appears. If you agree to the terms of the Software License Agreement, click Agree. 7. Select a disk for the destination. A new folder, Tec360, is created with Tecplot installed in it. 8. Click Continue.
34

Installation Instructions

9. On the Easy Install window, click the button labeled Install or Upgrade. If prompted, enter the name and password for an account with administrator privileges. Contact your system administrator if you do not have this information.

If you have installed to anywhere other than the default location, do not click Upgrade. Uninstall Tecplot and reinstall using the Installer. Make sure the button reads Install. Due to an apparent bug in Apples Installer, clicking Upgrade changes the ownership of the directory into which you install Tecplot. If you click Upgrade inadvertently, please call Tecplot Technical Support for instructions. Refer to 4 - 3 Uninstalling Tecplot on page 37 for instructions on uninstalling Tecplot.
10.Click Close after the files are installed. 11.The License Setup dialog will now be displayed. If you have purchased Tecplot, enter your license number. Also choose the appropriate option: If you do not have a license key and want to quickly run Tecplot without the key, choose Use Restricted Demo Mode. You will not be able to load your own data sets or save created data sets. You are able to load data sets from Tecplots Demo directory. If you want to load your data sets, choose a different option. If you have an evaluation license from Tecplot Technical Support, choose Install an Evaluation License Key. You are prompted for your key when you click Continue. If Tecplots License Manager is already installed on any machine on your network, choose Use an Existing Network License.

35

If you purchased a Tecplot license, choose Install a Single-Computer or Network License on this Machine. This launches the TecplotLM License Manager utility, allowing you to enter your license key and set-up the License Manager to run on your machine. TecplotLM is discussed below.

12.Click Continue to complete your Tecplot installation.

If you did not install X11 when you installed your operating system, you will need to install it in order to run Tecplot: Mac OS 10.3 Users - download X11 from Apples website at http://www.apple.com/downloads/ macosx/apple/x11formacosx.html. Mac OS 10.4 Users - install X11 using your Tiger DVD installer disk.

4 - 2 License Manager Set-Up

The license-managed version of Tecplot requires the Tecplot License Manager to run on a network-accessible machine. If the License Manager is running on the Macintosh, you may use the setuplic shell script in Tecplots home directory, or the TecplotLM utility in Tecplots TLM directory to set-up the License Manager. (Refer to Section 3 - 1, Linux Installation Procedure, for more information on the setuplic shell script.) To use the TecplotLM utility: 1. If TecplotLM was launched by the Tecplot installer, close the Tecplot installer. Otherwise, double-click on the TecplotLM icon in Tecplots TLM directory.

36

Uninstalling Tecplot

2. TecplotLM will display your machines server code. Go to www.tecplot.com/support to submit a request for a license key. 3. Fill the supplied key in the License Key text field and click Add. A message appears stating the key has been added. 4. Click Start Manager. If it is enabled, the License Manager starts. (It is disabled if the License Manager is already running; you can still install license keys when the License Manager is running.) 5. (Optional) Click Auto-Start to configure the operating system to automatically start the License Manager whenever the system is re-booted. This launches another installation package. If TecplotLM was launched by the Tecplot installer and you did not close the installer prior to clicking Auto-Start, the installer comes to the front and does nothing. Close the installer window and click Auto-Start again. Proceed with the Auto-Start installation. 6. Click Quit.

4- 2.1 License Server Changing

License keys are unique to a single computer hardware ID. If you need to move your Tecplot License Manager to a new machine, please contact Tecplot or your local distributor to request a new key. Be sure to specify your license number, you previous server code and your new server code whenever you request a new key.

4 - 3 Uninstalling Tecplot
Apples package installer creates a directory of the same name as the installed package in /Library/Receipts/. For example, when you install Tecplot by double-clicking on Tecplot360.pkg, a directory /Library/Receipts/Tecplot360.pkg/ is created. To completely remove an installation, all Tecplot-related Receipts directories must be removed, along with all files installed by the package. If you cannot
37

drag everything to the trash because the file permissions are too restrictive, users with Administrator privileges can delete the directories with the sudo command in a shell as follows:
sudo sudo sudo sudo /bin/rm /bin/rm /bin/rm /bin/rm -rf -rf -rf -rf /Applications/Tec360 /Library/Receipts/Tecplot360.pkg /Library/Receipts/AutoStart.pkg /Library/StartupItems/TecplotLM

You may be prompted for your password (not the root password). You should also remove your Tecplot preferences file. This procedure is described in the Tecplot Users Manual section on resetting preferences.

4 - 4 Notes
Apple's X11 X server doesn't treat the Command or Option key as an Alt key. A workaround on this is to add a line to the/etc/X11/xinit/xinitrc file: xmodmap -e "keycode 66 = Alt_L" Which will occur when the X server is restarted. You should also be able to type the xmodmap command in at a terminal window.

38