SUPRTOOL Version 4.0
                          Database Handyman for HP-UX
 
 
   Installation of 4.0
 
 
          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 take only 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 easily recognize a
          pre-release by its three-part version number  (e.g.,  4.2.52)  and
          the words "Pre-Release" next to the version number.
 
 
   Summary of Installation Steps
 
          Installing Suprtool involves the following steps:
 
          1. You must log in 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 in as Root
 
          There are two ways you can log in as root:
 
          a. Exit from HP-UX, and log in with root as the user name.
 
          b. If you are already logged in, 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
 
 
   Step 4:  Setup Path (optional)
 
          You can invoke Suprtool with the following command:
 
               /usr/robelle/bin/suprtool
 
          If you want to 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)
 
          All of the Suprtool documentation is now available in the  WinHelp
          format  of Microsoft Windows.  You can only use these files if you
          have MS Windows 3.1 or later.
 
 
   Make a Temporary Directory for the Setup Program
 
          From  DOS  or  the  File  Manager,  create  a  directory  for  the
          installation   files.    You   can  remove  this  directory  after
          installing the WinHelp files.
 
               mkdir \robtemp
 
 
   Download the 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.  Make sure that you use the binary
          transfer.
 
              receive c:\robtemp\suprhelp.exe
                      from suprhelp.exe binary
 
 
   Expand the Compressed File
 
          You need only the following commands to extract the files  because
          we   provide   the  Setup  program  and  the  Help  files  in  one
          self-extracting  Zip  file.   From  the  DOS  prompt,  type  these
          commands:
 
               cd \robtemp          {go to the new 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.  Follow 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 *.*              {delete all the files}
               cd ..
               rmdir robtemp        {remove the Robtemp directory}
 
          You  can  also  copy  the  files  in  Robtemp  to  a  diskette and
          distribute them to other Suprtool users.