SUPRTOOL Version 3.8 Database Handyman for HP-UX Installation Instructions The following general notes describe the installation of a new Suprtool release. The new version overwrites an existing version of Suprtool on your HP-UX system. Who Should Use These Instructions? The system manager should use the following instructions to install Suprtool/UX. No one can be using Suprtool/UX during the installation, which should only take a few minutes. Replace Any Pre-Release If you are currently running a pre-release version of Suprtool, you should replace it with this new official release. Pre-release versions expire within two years of their creation date, whereas this new release has no expiry date. You can recognize a pre-release by its three-part version number (e.g., 3.7.03) and the words "Pre-Release" next to the version number. Summary of Installation Steps Installing Suprtool involves the following steps: 1. You must log on as root. 2. You must create the correct directory structure. 3. You must restore Suprtool/UX and its associated files from the distribution tape. 4. You can set up a PATH for Suprtool/UX, or copy it to an existing directory in your PATH. (optional) 5. You can install WinHelp documentation files. (optional) Step 1: Log on as Root There are two ways you can log on as root: a. Exit from HP-UX, and log on with root as the user name. b. If you are already logged on, you can execute this command: su - In either case, you have to know and supply the user password for root. Step 2: Create Robelle Directory Suprtool/UX is installed in /usr/robelle. Before restoring the files, you must first create /usr/robelle. mkdir /usr/robelle Step 3: Restore Files Use the following command to restore the Suprtool/UX files from the distribution tape. tar xv /usr/robelle After successfully restoring the files, you can run the new version of Suprtool/UX. /usr/robelle/bin/suprtool Please note that the version of STExport/UX included in this release is STExport 3.8.01. Step 4: Setup Path (optional) You can invoke Suprtool with the following command. /usr/robelle/bin/suprtool If you just type suprtool to invoke Suprtool/UX, you must either add /usr/robelle/bin to your PATH or copy /usr/robelle/bin/suprtool to a directory that is currently on your PATH. Similarly, the man pages for Suprtool are in /usr/robelle/man/man1/suprtool.1. To make the man pages available to everyone, you can either add /usr/robelle/man to your MANPATH or copy the man pages to a directory that is currently on your MANPATH. If you adjust your PATH and MANPATH environment variables, you can also invoke Suprlink/UX with suprlink Step 5: Install WinHelp Documentation Files (optional) The documentation for Suprtool HP-UX is now available in a WinHelp format for Microsoft Windows. Your PC must have MS Windows 3.1 or higher to install our WinHelp files. To install the WinHelp files, follow these instructions. Make a Temporary Directory for the Setup Program From DOS or File Manager, make a directory to copy the installation files (you can remove this directory after installing the WinHelp files). mkdir \robtemp Download Compressed File In the next step, download the self-extracting Zip file to your PC. If you are using Reflection to download the Zip file, follow these instructions. The file on the HP 9000 is called /usr/robelle/winhelp/suprhelp.exe From the /usr/robelle/winhelp directory, press Alt-Y to go to the Reflection command line window. You must use a binary transfer. receive c:\robtemp\suprhelp.exe from suprhelp.exe binary Expand the Compressed Files Since we provide both the Setup program and the Help files in one self-extracting Zip file, you only need the following commands to extract the files. From the DOS prompt, type these commands: cd \robtemp {go to the "robtemp" directory} suprhelp.exe {extract the Help files} Run the Setup Program From the Program Manager, run the Setup program by choosing Run from the File menu. Then enter c:\robtemp\setup in the Command Line box. Continue following the instructions in the Setup program. Now you can access all the Suprtool documentation by selecting any of the icons in the "Robelle Help" Program Manager group. Remove the Robtemp Directory You can now remove all the files from the Robtemp directory either from the File Manager or by using the following DOS commands: cd \robtemp del *.* cd .. rmdir robtemp You can also copy the files in Robtemp to a diskette and distribute them to other Suprtool users.