Home

TotalView

1. Configuring the License Server After placing a new or updated regular license in the license src file you can configure the license server to m Activate a regular license for the first time m Change a regular license in order to add users to your license use Total View on a new platform add or upgrade TotalView features or move the license to a new system The license configuration script creates the license dat license opt license client and license log files in the flexlm 6 1 directory It also places the toolworks init script in the flexlm 6 1 bin directory After using the su shell command to become the root user run the Configure_License script cd usr local toolworks flexim 6 1 bin Configure_License Accessing a Remote License Server When you start TotalView it must be able to find the license dat file in the flexim 6 1 directory If TotalView and the active license manager are all installed on the same host and you have already created the license dat file in the correct location you can skip to Starting the License Manager Man ually on page 12 If TotalView and the license server are installed on different machines you will need to have a license dat file for each TotalView installation You should copy the license client file from the license server to flexlm 6 1 license dat in each TotalView installation If you will be using an existing license server this is the only thing you need to do Ver
2. TotalView If you still get this _ bin tvdmain message report this installation problem to us See Reporting Problems on page 1 6 TotalView Installation Guide Version 5 0 Chapter 2 Installing or e Changing a Regular License e This chapter describes the procedure for installing or changing a regular license m To install TotalView software for the first time with a permanent license begin with the next section m To update an existing license see Ordering a Regular License on page 9 m To install TotalView software and will use an existing license see Access ing a Remote License Server on page 11 To shutdown and restart the license manager see Starting the License Manager Manually on page 12 Planning for a Regular License This section describes what you must do when your demo license expires or when you need to change your current regular license TotalView uses the FLEXIm license management software to grant or reject requests to use TotalView NOTE You do not need to install FLEX m if you are using a demo license Your regular TotalView license is associated with a FLEXIm license manager host the license server and is for a specific number of floating concurrent user licenses Etnus provides HTML documentation and tools for using FLEXIm Stand alone versions of the FLEXIm license manager are also available For more information see Choosing a Standalone FLEXIm Version
3. stop the license manager Before entering these commands use the su shell command to become the root user cd usr local toolworks flexim 6 1 bin toolworks_init stop 12 TotalView Installation Guide Version 5 0 Installing or Changing a Regular License Starting the License Manager when the System Boots Testing the License Manager To verify that you installed the license manager correctly you should man ually start the license manager and then run TotalView as non root After the license manager starts set the license file variable and test the license installation by typing installdir totalview version platform bin totalview TotalView should respond by displaying its Root window If you experience problems you may be able to determine the problem by looking at m The flexim 6 1 license log log file contains status and error messages from the Imgrd license server m The flexlm 6 1 platform bin Imstat command lists license manager activ ity For example to list the number of licenses that are currently checked out on a sun5 platform type cd usr local toolworks flexim 6 1 sun5 bin Imstat a c license dat Starting the License Manager when the System Boots Version 5 0 If you want the license manager to start automatically when the license server boots add the toolworks_init command see Starting the License Manager Manually on page 12 to the appropriate system start up file On most systems you also s
4. 12 jan 2000 16 CCD27662DKAB91FHC655 ISSUED 12 Jul 2001 ck 1 INCREMENT TV PPC AIX PGIHPF toolworks 5 000 12 jan 2000 16 DA26602D3A8A3FD4515D ISSUED 12 Jul 2001 ck 42 END LICENSE 4 Hostname FLEX m license version 0 FLEXIM host ID Expiration date an Concurrent users expiration date of 0000 Licensed platform indicates a permanent Processor maximum for each user license Figure 1 Regular License for TotalView f Creating a FLEX m User Account For best security run the FLEXIm license manager as a unique non privileged that is non root user Do this by creating a non privileged user account reserved for FLEXIm s use The steps for creating a new user account vary with operating systems and site configurations You may need to refer to your operating system s docu mentation or your site s operating procedures Here is an example of a passwd file record that supports the FLEXIm user flexIm 2000 250 FLEXIm License Manager nonexistent bin sh Note that this account must have the following properties m The password is set to because interactive access is not required m There is a unique user ID 10 TotalView Installation Guide Version 5 0 Installing or Changing a Regular License Configuring the License Server m There is a unique group ID m The login shell is bin sh NOTE The user name does not have to be flexlm Any unique name will do Also the values used here are also examples
5. 6 1 man User Guide An HTML version of the FLEXIm End User Manual is installed in flexlm 6 1 doc flexuser GLOBEtrotter Web Site FLEXIm is a product of GLOBEtrotter Software Incor porated Their Web site at www globetrotter com contains additional information about FLEXIm as well as utilities that can help you manager your license server TotalView Installation Guide 15 i 2 Installing or Changing a Regular License 2 Choosing a Standalone FLEXIm Version 16 TotalView Installation Guide Version 5 0
6. MS describes operating system patches that are required for some operating system versions Here is the procedure for installing TotalView 1 Optional Become the root user on the system where you will install TotalView su root We recommend that you become the root user when installing TotalView as this prevents users from modifying the software after you install it However you should not run TotalView as root 2 From the directory containing the unbundled files start the Install program Install NOTE For information on using this command type Install help If you use any of the options described in this displayed information TotalView is non interactively installed The Install program asks that you name an installation directory If the directory you specify does not exist the Install program creates it Install then creates two subdirectories totalview version platform flexIm 6 1 The first is where Install places TotalView and the second is for the license manager Type a period if you want Install to place TotalView in the cur rent directory If you do not enter a name the installation directory will either be usr toolworks or opt toolworks this is system dependent This manual refers to the installation directory s pathname as installdir 2 TotalView Installation Guide Version 5 0 Installing and Configuring TotalView Step 3 Installing a Demo License 3 You are then asked six questions
7. TOTALVIEW INSTALLATION GUIDE ETNUS AUGUST 2001 VERSION 5 0 ji Copyright 1999 2001 by Etnus LLC All rights reserved Copyright 1998 1999 by Etnus Inc All rights reserved Copyright 1996 1998 by Dolphin Interconnect Solutions Inc Copyright 1993 1996 by BBN Systems and Technologies a division of BBN Corporation o part of this publication may be reproduced stored in a retrieval system or transmit means electronic mechanical photocopying recording or otherwise without the prior LLC Etnus Rights in Technical Data and Computer Software clause at DFARS 252 227 7013 this manual is subject to change without notice and should not be construed as a com assumes no responsibility for any errors that appear in this document ed in any form or by any written permission of Etnus Use duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph c 1 ii of the Etnus has prepared this manual for the exclusive use of its customers personnel and licensees The information in mitment by Etnus Etnus TotalView and Etnus are registered trademarks of Etnus LLC TimeScan and Gist are trademarks of Etnus LLC All other brand names are the trademarks of their respective holders Version 5 0 Contents 1 Installing and Configuring TotalView Reporting Problems snene ee EE NEEE I Step 1 Unbundling Downloaded Files ennnnennn
8. asking which components you wish to install The first two relate to the TotalView executable the middle two relate to the license manager and the final two relate to the doc umentation If you have not yet installed Release 5 on your system you should answer yes to the first four While you do not have to install the documentation named by the last two questions you should install it If you are adding to an existing license you can skip portions of this installation to save space For example one TotalView component and one license manager component contain common components If you are reinstalling TotalView on an existing system you can ignore these com ponents For example if you have previously installed the documenta tion you do not have to reinstall it 4 The Install program asks if it should create a symbolic link named totalview to your installation directory NOTE If you are not the root user Install cannot create the link so you should answer n no If Install can not create the link you can ignore its complaints and continue installing TotalView by pressing Enter 5 After Install concludes become non root exit 6 Test the installation by starting TotalView installdir totalview version platform bin totalview TotalView prints information that includes a version number and a mes sage indicating that a license file was not installed If you see a diagnostic message instead of this informat
9. hould automatically stop the license manager when the system shuts down to single user mode You can edit your startup files by running the Configure Autostart shell script Configure_Autostart must be run as root For example if the license manager software is in the usr local toolworks directory run Configure_Autostart using the following commands Before entering these commands use the su shell command to become the root user cd usr local toolworks flexIm 6 1 bin Configure_ Autostart Configure_Autostart prompts you with some configuration questions and then makes its changes TotalView Installation Guide 13 2 Installing or Changing a Regular License o Managing Your Licenses Managing Your Licenses You should not combine Etnus licenses with those of other third party soft ware managed by FLEXIm If you must combine your working Etnus license manager with another see the FLEXIm documentation for information NOTE The TCP IP port number used for the Etnus license manager daemon must be unique and not in use elsewhere Find port numbers used by other FLEX m license managers in their license dat files Choosing a Standalone FLEX m Version Etnus supplies a stand alone version of the version 6 1 FLEXIm license man ager The following table indicates the supported platforms and the tar file associated with each TABLE 4 Stand Alone FLEX m License Manager Distribution Files Distribution Name File Size FLEX m
10. ion refer to Troubleshooting on page 6 Step 3 Installing a Demo License Version 5 0 Before you can use TotalView you must place the demo license into the flexim 6 1 directory This license file was attached to the email message confirming your download request and was named license demo 1 If you installed TotalView as the root user become the root user again 2 Copy the license file to the flexlm 6 1 directory cp license dat installdir flexlm 6 1 TotalView Installation Guide 3 i 1 Installing and Configuring TotalView I Step 4 Configuring Your Environment 3 To test that TotalView can use the license file type installdir totalview version platform bin totalview TotalView responds by displaying its Root window NOTE After you purchase TotalView we will send you a permanent license that you will copy into this same directory The filename of the permanent license file is license dat Setting the License File Variable The totalview startup script sets the LM_LICENSE_FILE environment vari able to installdir flexlm 6 1 license demo If you do not want to install the license demo file in this directory you must set the LM_LICENSE_FILE environment variable to the full pathname of the directory containing the license demo file For example setenv LM LICENSE FILE nonstandard dir license demo NOTE Ifyou change this directory you will have to change the name license demo to license dat af
11. license manager for flexlm 6 1 alpha tar Z 1 0 MB Compaq Tru64 UNIX 4 0B flexlm 6 1 hp800 tar Z 0 8 MB HP UX flexlm 6 1 mips64 irix6 tarZ 0 9 MB IRIX 6 2 flexlm 6 1 rs6000 tar Z 0 7 MB RS 6000 AIX 4 2 1 flexlm 6 1 sun5 tar Z 0 9 MB SPARC SunOS 5 5 1 flexlm 6 l 1386 linux tarz 0 7 MB RedHat Linux 5 2 flexlm 6 1 alpha linux tarz 0 9 MB Compaq Alpha Linux Unpacking FLEX m Unpack the FLEXIm tar files using the uncompress and tar commands For best security you should unpack the archive as super user root By default the tar command creates a toolworks directory and copies the FLEXIm files into it For example use the following commands install the FLEXIm files for the SPARC SunOS 5 into the usr local toolworks directory Before entering these commands the su shell command to become the root user 14 TotalView Installation Guide Version 5 0 Version 5 0 Installing or Changing a Regular License Choosing a Standalone FLEXIm Version cd usr local uncompress lt home bob flexIm 6 1 sun5 tarZ tar xpf These commands create the usr local toolworks directory and copy the SunOS 5 FLEXIm license manager files into the flexlm 6 1 subdirectory The files are identical to those supplied with TotalView These instructions provide only basic information on installing the FLEXIm license manager For more information see man Pages The man pages for the FLEXIm license manager and its support utilities are installed in flexlm
12. nnnnnnznna l Step 2 Running the Install Program 2 Step 3 Installing a Demo License cceccccetseecesseeeneteesseeees 3 Setting the License File Variable nn 4 Step 4 Configuring Your Environment 4 Setting Environment Variables a n 4 Mounting the proc Directory iii b Troubleshootins ii in i illa 6 Installing or Changing a Regular License Planning for a Regular License ennennnnnznnnennnnnzzn ena n net 7 Choosing a License Server oonan 8 Supporting Redundancy eeennennnzznnzznnnzzznnznzznnnnzznnnzrnanrznnznnna 8 Ordering a Regular License LL nenennnnnnannnn nanna rna 9 Finding a License Server Host ID LL enennnnnenennznnnannnznena nn nn nn zi 9 Installing a Regular License cece cece ceceseceeceeeeeseeesssteenseesenseeens 9 Creating a FLEXIm User Account 10 Configuring the License Server 1 Accessing a Remote License Server 11 Starting the License Manager Manually LL eennnnnzzennenzznneni 12 Stopping the License Manager nn na 12 Testing the License Manager oseese 13 Starting the License Manager when the System Boots 13 Managins YOUrLICENses iaia ia ipa loin 14 Choosing a Standalone FLEXIm Version s 14 Unpacking FLEXIM nennennnnnnnnnnn nn nanna nanna r nn 14 TotalView Installation Guide iv TotalView Installation Guide Version 5 0 Chapter 1 In
13. on page 14 Version 5 0 TotalView Installation Guide 7 2 Installing or Changing a Regular License Planning for a Regular License Choosing a License Server You do not need to install the FLEX m license server until you install a regular license or change a current regular license In most cases the license man ager and TotalView reside on the same system However you can install them on different systems If you order a single user license consider placing the license server on one machine and TotalView on another This lets you change the system upon which you run TotalView without having to make major changes to the license server The license manager should reside on a machine that is reliable always run ning and a permanent part of your local network NOTE If you already have a FLEX m license manager in your network we recommend that you do not include your TotalView software with the other software managed by that license manager Instead use the steps outlined in this chapter to configure a dedicated FLEX m license manager for TotalView Supporting Redundancy The FLEX m license manager supports two configurations that increase server availability You can have up to three license servers serving a redun dant server license If one server goes down users can obtain TotalView licenses from another If you support several sites interconnected on a TCP IP network each site can have its own server and license file U
14. script as follows installdir flexlm 6 1 bin toolworks hostid NOTE Donotuse the UNIX hostid command This script writes the host name and the FLEXIm host ID value to standard output for example The host name for this machine is fast server The host ID for this machine is 08122b2cf32d After sending this information to us we will respond bv sending vou a per manent license file Installing a Regular License For best securitv vou should become super user root on the license server before installing the license Begin installing vour permanent license bv using an ASCII text editor to copv the license file received from Etnus into the installdir flexlm 6 1 license src file You may copy the entire message or Version 5 0 TotalView Installation Guide 9 2 Installing or Changing a Regular License o Creating a FLEXIm User Account only the portion beginning with BEGIN LICENSE and ending with END LICENSE BEGIN LICENSE SERVER happy sp2 1386310 lt port number gt DAEMON toolworks lt daemon path gt lt options file gt INCREMENT TV Base toolworks 5 000 12 jan 2000 16 ACE2E64242992DE2EC36 ISSUED 12 Jul 2001 ck 189 INCREMENT TV PPC AIX toolworks 5 000 12 jan 2000 16 BC6206D2ABA83DF53D15 ISSUED 12 Jul 2001 ck 84 INCREMENT TV PPC AIX MP 32 toolworks 5 000 12 jan 2000 16 OCA2B6B2AP0494749892 ISSUED 12 Jul 2001 ck 236 INCREMENT TV PPC AIX PE toolworks 5 000
15. sers can configure their LM_LICENSE_FILE environment variable to include license files that refer to servers at the other sites so that a license service is always available If you will have redundant servers you must set up each server as described in Installing a Regular License on page 9 In addition when you order a regular license you must include the output from the toolworks_hostid script for each server 8 TotalView Installation Guide Version 5 0 Installing or Changing a Regular License Installing a Regular License Ordering a Regular License To set up or change a regular installation contact Etnus at 1 800 856 3766 in the United States or 1 508 875 3030 worldwide or you can email us at info etnus com Please be ready to provide the following information m The platforms and operating systems upon which you will run TotalView m For each platform the maximum number of processors that will poten tially run target processes of a single TotalView debugging session m The maximum number of concurrent users m The toolworks_hostid output from your FLEXIm license server See Finding a License Server Host ID for an example FLEXIm uses a host ID to identify the computer running the license server Finding a License Server Host ID When you install TotalView the files for the FLEXIm license manager are automatically installed in installdir flexIm 6 1 To obtain host information run the toolworks_hostid
16. sion 5 0 TotalView Installation Guide 11 2 Installing or Changing a Regular License UD Starting the License Manager Manuallv The format for this type of license dat file the license client file is SERVER host name host id port number USE SERVER For example SERVER fast server 08122b2cf32d 7127 USE SERVER FLEXIm ignores all lines after USE SERVER Starting the License Manager Manually You can start or stop the license manager by using the toolworks init script If the license manager software is installed in usr local toolworks the fol lowing commands start the license manager Before entering these com mands use the su shell command to become the root user cd usr local toolworks flexim 6 1 bin toolworks_init start NOTE Before running this program make sure that you have write permission to this directory Although the start up script should be run as super user root the license manager is started using the FLEXIm user ID If the license manager starts successfully the UNIX ps command shows that Imgrd the primary license manager daemon is running Depending on how many shared licenses are currently in use the ps command may show one or more instances of the toolworks license daemon Stopping the License Manager The procedure for manually stopping the license manager is similar to the process for starting it If the license manager software is installed in usr local toolworks the following commands
17. stalling and Configuring TotalView This document provides information about installing the TotalView multipro cess debugger See the TotalView Release Notes for complete information about supported oper ating systems Reporting Problems Please contact us if you have problems installing TotalView questions that are not answered in the product documentation or on our Web site or sug gestions for new features or improvements support etnus com 1 800 856 3766 in the United States 1 508 875 3030 worldwide The TOTALVIEW RELEASE NOTES has instructions on how to report problems Step 1 Unbundling Downloaded Files Use the uncompress and tar commands to extract the TotalView files that you downloaded from our web site For example tar xvf totalview version platform tar tar xvf totalview version doc pdf tar Version 5 0 TotalView Installation Guide 1 1 Installing and Configuring TotalView o Step 2 Running the Install Program Step 2 Running the Install Program NOTE Before you can run TotalView you will need to obtain a demo licence You can obtain one by filling in the form located at www etnus com This section describes how you install a new version of TotalView Before starting you should read the TOTALVIEW RELEASE NOTES and the README TXT file that came with the software that you downloaded These files contain information that you may need to use for your version of TotalView In addi tion TOTALVIEW PLATFOR
18. ter you purchase TotalView If the LM_LICENSE_FILE environment variable is already set add the path name for license demo to the list The LM_LICENSE_FILE variable contains a colon separated list of license file pathnames For example setenv LM_LICENSE FILE nonstandard dir license demo LM LICENSE FILE Step 4 Configuring Vour Environment Before vou can begin using TotalView vou must add directories to vour svs tem s environment variables On some systems you will also need to mount the proc directory Setting Environment Variables The pathnames listed in the following table assume that 4 TotalView Installation Guide Version 5 0 Installing and Configuring TotalView Mounting the proc Directory m Youinstalled the software as the root user m opt toolworks is the default installation directory m The Install program created the a symbolic link to this directory refer to Step 2 Running the Install Program on page 2 for details You will need to include the following path names in environment variables TABLE 1 TotalView Environment Variable Settings for Root Installation PATH opt totalview bin MANPATH opt totalview man LD_LIBRARY_PATH opt totalview lib not on IBM RS 6000 LM_LICENSE_FILE nonstandard dir license demo If you did not install TotalView as the root user or if the Install program did not create the opt totalview or usr totalview links you must add the fol lowing pathnames to yo
19. ur environment variables In these variables direc tories are separated by colon characters TABLE 2 TotalView Environment Variable Settings for User Installations PATH installdir totalview version platform bin MANPATH installdir totalview version platform man LD_LIBRARY_PATH installdir totalview version platform lib not on IBM RS 6000 LM_LICENSE FILE nonstandard dir license dat Mounting the proc Directory Version 5 0 On some systems you must mount the proc directory if it is not currently mounted If you use any of the following systems determine if the proc directory is mounted m Compaq UNIX m SunOS 5 x m IRIX TotalView Installation Guide 5 1 Installing and Configuring TotalView You can check if this directory is mounted by typing Is proc If it is mounted the Is command prints a list of numbers If you see an error message or no message at all the proc directory is probably not mounted Your system administrator can mount the proc directory Troubleshooting If TotalView prints a diagnostic message instead of its banner you should perform one of the actions listed in the following table Table 3 Start up Diagnostic Messages Unable to find installation Edit the totalview script Set TVROOT to directory installdir totalview version platform Platform is not supported Log in to a system that is running on a supported platform before running totalview A message that includes Reinstall

TotalView

Contents

Download Pdf Manuals

Related Search

Related Contents