how to install tecplot
TRANSCRIPT
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. Con-tributors 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 O’Gorman. 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. Ghost-script 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 coun-tries. É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, Incor-porated 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 coun-tries. 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 Computer-Restricted 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
3
Contents
Chapter 1 Requirements ................................. 6Technical Support ..............................................6Requirements .....................................................6
System Requirements ................................................6Platform Requirements .............................................7Graphics Requirements ............................................7Display Requirements ...............................................7License Server Requirements....................................7
License Types ....................................................8Single User License ..................................................8Network License .......................................................8
License Keys .....................................................8Changing License Servers or IP Addresses .......9Running Network Versions of Tecplot 360 and Tecplot Focus.....................................................9
Chapter 2 Windows Installation ....................11License Types .................................................. 11Installation Instructions ...................................12Additional Installation Instructions .................14
Evaluation License .................................................14Single User with a Dongle......................................14Single User without a Dongle.................................15Network License .....................................................15
Contents
4
Site License.............................................................16Working with the Network License Manager ..16
Starting the License Manager ................................16License Manager Settings ......................................17Monitoring the License Manager ...........................18Controlling the License Manager...........................18The Resource File ...................................................18Modifying the Windows XP firewall .......................20
Chapter 3 Linux Installation ......................... 21Linux Installation Procedure............................21
Linux Installation Preparation ...............................21TEC360HOME Environment Variable Setup .........21Linux Help Configuration ......................................23User Alias Selection ...............................................23Linux Software Installation ....................................24
Network and Single User License Installation 26License Server Selection.........................................26License Key Installation .........................................27License Manager Daemon Start-Up.......................28TLMHOST Variable Setup......................................29License Manager Stopping .....................................30Tecplot Installation on Other Linux Clients ...........30Tecplot Installation on Windows Clients ................31
Site License Installation ...................................31Tecplot Start-Up .....................................................31Tecplot Running Remotely ......................................31License Manager Setup ..........................................32License Server Changing........................................33
5
Chapter 4 Macintosh Installation ................. 34Installation Instructions ...................................34License Manager Set-Up .................................36
License Server Changing........................................37Uninstalling Tecplot ........................................37Notes ................................................................38
6
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 SupportTecplot, 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 RequirementsTecplot requires a minimum of 250 MB of disk space and 1 GB of RAM.
7
Requirements
1- 2.2 Platform Requirements
HP 9K/7xx HPUX 11.0 or newer OpenGL or MesaIBM RS6000 AIX 5.1 or newer OpenGL or MesaLinux Intel Linux Kernel 2.4 or 2.6, glibc 2.3
newerOpenGL or Mesa
Linux IA64 Linux Kernel 2.4, glibc 2.3 newer OpenGL or MesaSGI R5k, R8k,
R10kIRIX 6.5.27 or newer OpenGL or Mesa
Sun Sparc Solaris 8 or newer OpenGL or Mesa
Windows Intel Windows XP, 2000 OpenGLLinux Intel Linux Kernel 2.4 or 2.6, glibc 2.3
newerOpenGL or Mesa
Macintosh PPC Mac OS X 10.3, 10.4 OpenGL or Mesa
1- 2.3 Graphics RequirementsAn OpenGL-accelerated card is required.
1- 2.4 Display RequirementsA minimum resolution of 1024 x 768 is required.
1- 2.5 License Server RequirementsIf you’re 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.
TABLE 1. Supported 64-bit PlatformsPlatform CPU/Model Operating System Graphics
TABLE 2. Supported 32-bit PlatformsPlatform CPU/Model Operating System Graphics
8
1 - 3 License TypesThere 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 LicenseA 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 LicenseA 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
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.
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 soft-ware. Refer to 2- 3.2 “Single User with a Dongle” on page 14 for additional information.
9
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 com-puter 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 FocusIf 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
10
b.Enter your Tecplot Focus key
11
Chapter 2 Windows Installation
2 - 1 License TypesThere 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 InstructionsThe 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.
12
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 don’t 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.
3. User Information - Please fill out the information for Name, Organi-zation 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 Computerradio 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 Tec-plot elsewhere. Select the Next button to continue.
NOTE - Network License Manager software must be installed on one computer with a stable IP address. That com-puter 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 Net-work License Manager” on page 16 for information on working with the license manager.
13
Additional Installation Instructions
5. Working Folder - A default Working Folder is selected for installa-tion. 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 compo-nents of Tecplot. The custom installation allows you to select whether or not to install the Add-on Developer’s Kit (ADK) directory, the Doc-umentation 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 LicenseIf you did not enter your Eval Key in Step 2, enter it when you first launch Tec-plot.
14
2- 3.2 Single User with a DongleYour 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 computer’s 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 DongleOnce you have completed Steps 1 - 8 from 2 - 2, “Installation Instructions,” please perform the following steps:
1. Run Tecplot.
15
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 LicenseThe 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 windowsdirectory 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 automati-cally 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.
Refer to 2 - 4 “Working with the Network License Manager” on page 16 for addition information on the Network License Manager.
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 Tec-
plot will be run.
16
2- 3.5 Site LicenseIf 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 ManagerIn 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 ManagerTo 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 manu-ally (via the Tecplot License Manager) whenever your computer is restarted.
• Automatic - Select this option to launch the license manager auto-matically 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.
17
Working with the Network License Manager
•Launch/Stop - Select the Launch or Stop button to change the activity status of the License Manager.
2- 4.2 License Manager SettingsSelect 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 ManagerUse 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 have a Network license, you must have Win-dows License Server software installed on one machine, with a stable IP address, that is on the net-
work where Tecplot will be run.
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 Ver-
sions of Tecplot 360 and Tecplot Focus” on page 9.
18
2- 4.4 Controlling the License ManagerUse 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 informa-tion to the log file.
•Bury Client - Use the Bury Client button to revoke the license for a run-ning client (i.e. log-off the user and make the license available for another user).
2- 4.5 The Resource FileThe 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 man-ager.
RESTRICTING USERSBy 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
19
Working with the Network License Manager
where the e may be any one (or a comma separated list) of: an integer, an inte-ger range, a wildcard (*), or the word “THIS”. The word “THIS” is used to represent the corresponding IP address for the machine where the license man-ager 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 LICENSESLicenses 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 fol-lowing 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 com-puters. If a hostname is entered, precede the hostname with the “@” symbol. NUMKEYS is the number of licenses reserved for the GROUP. HOLDPERIODis the number of seconds to hold a license recently made available by a mem-ber of the GROUP before making it available to other users.
To restrict specific users, use the word EXCLUDE in lieu of NUMKEYS.
20
2- 4.6 Modifying the Windows XP firewallThe license manager for network licenses may not work on Windows XP plat-forms 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 recom-mended.
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.
21
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 Tec-plot 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 exe-cuted.
The following procedure assumes you know what type of shell you are using. If you do not know, type the following command:
echo $SHELL
22
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 follow-ing (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/binIf 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
23
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 com-ments 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:
24
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 set-uptec script, named according to one of the following formats:SETUPTEC.;1setuptec.
25
Linux Installation Procedure
setuptec
7. Start the setuptec script by issuing the command from the follow-ing 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 Tec-plot 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, “TLM-HOST 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 out-lined 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).
26
11.Enter the key provided by Technical Support at the prompt.
3 - 2 Network and Single User License Installa-tion
Linux Network and Single User licenses both run under the control of the Tec-plot 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 alloca-tion 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 ses-sions 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.
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.
Note: We no longer support redundant License Manag-ers for those who have used redundant license servers for Tecplot Version 7.0 or older. If you have any ques-
tions or comments regarding this, please contact Tecplot Technical Support, or your local Tecplot distributor.
27
Network and Single User License Installation
•The license server must be up and running when users are running Tec-plot 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 run-ning 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 server’s IP address. If your IP address, operating system or ethernet card should change, or you wish to move the License Manager to a different
28
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 dae-mon 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 automati-cally unless one of the system startup shell scripts contains the following com-mand:
<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.
29
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..
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 TLM-HOST 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. TLMHOSTmust 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 user’s .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
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.
30
where remotehostname is the name of the host where the License Manager daemon (tlmd) is running. Be sure to include the @ symbol in your TLMHOSTvariable, as shown above.
As always, changes made to your .profile or .cshrc file must be acti-vated.
•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.” )
31
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 cli-ent, without displaying remotely from a Linux machine. To install Tecplot on a Windows client, follow the instructions in Section 2 - 2, “Installation Instruc-tions.”
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 Tec-plot 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 pro-vided by our support staff.
3- 3.1 Tecplot Start-Up
To run Tecplot, type: tecplot
A complete description of Tecplot’s command line options can be found in the Tecplot User’s 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.
32
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 Tecplot’s home direc-tory, or the TecplotLM utility in Tecplot’s 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 Tec-plot installer. Otherwise, double-click on the TecplotLM icon in Tecplot’s TLM directory.
2. Your machine’s server code is displayed. Send a license key request, including the server code, to Tecplot or your local distributor. For
33
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 auto-matically 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. Pro-ceed 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.
34
Chapter 4 Macintosh Installation
4 - 1 Installation InstructionsTo install Tecplot 360 on your computer, perform the following steps:
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 Apple’s 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.
You may also use the Linux installation procedure in a termi-nal window (the CD is mounted in /Volumes). See 3 - 1 “Linux Installation Procedure” on page 21. You must
have administrative privileges in this case.
35
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.
10.Click Close after the files are installed.
11.The License Setup dialog will now be displayed. If you have pur-chased Tecplot, enter your license number. Also choose the appropri-ate 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 Tecplot’s 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 Tecplot’s License Manager is already installed on any machine on your network, choose Use an Existing Network License.
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 Apple’s Installer, clicking Upgrade changes the owner-ship of the directory into which you install Tec-plot. 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.
36
• If you purchased a Tecplot license, choose Install a Single-Com-puter 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.
4 - 2 License Manager Set-UpThe 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 Tecplot’s home directory, or the TecplotLM utility in Tecplot’s 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 Tec-plot installer. Otherwise, double-click on the TecplotLM icon in Tecplot’s TLM directory.
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 Apple’s website at http://www.apple.com/downloads/macosx/apple/x11formacosx.html.
Mac OS 10.4 Users - install X11 using your Tiger DVD installer disk.
37
Uninstalling Tecplot
2.TecplotLM will display your machine’s 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 auto-matically 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. Pro-ceed with the Auto-Start installation.
6. Click Quit.
4- 2.1 License Server ChangingLicense 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 TecplotApple’s package installer creates a directory of the same name as the installed package in /Library/Receipts/. For example, when you install Tecplot by dou-ble-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
38
drag everything to the trash because the file permissions are too restrictive, users with Administrator privileges can delete the directories with the sudocommand in a shell as follows:sudo /bin/rm -rf /Applications/Tec360sudo /bin/rm -rf /Library/Receipts/Tecplot360.pkgsudo /bin/rm -rf /Library/Receipts/AutoStart.pkgsudo /bin/rm -rf /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 User’s Manual section on resetting preferences.
4 - 4 NotesApple'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.