SUPRTOOL Version 3.8 Database Handyman for the HP 3000 Installation Instructions If you need to install this upgrade in an account other than the Robelle account, refer to the appendix at the end of this change notice before starting any installation steps. The following instructions apply to existing Suprtool users who are installing a new version. Please use these instructions instead of those in the user manual. The change notice always has the latest revision. The whole process should take about 30 minutes, assuming that no one is using Suprtool or its components. All of these steps are easily accomplished if you log on as Manager.Sys. To install this update of Suprtool, follow these steps: 1. Upgrade the structure of the Robelle account. 2. Restore the new files from tape. 3. Install the proper program files (NM or Classic). 4. Install Speed Demon in the System SL (Classic only). 5. Install the Suprtool2 interface in the System SL (Classic only). 6. Optionally limit Suprtool's runtime priority. 7. Install WinHelp documentation files (optional). 8. Install HowMessy (optional). 9. Configure Suprtool for Netbase (MPE/iX only). 10.Purge installation files (optional). Installation Assistance If you have any questions about the upgrade or run into any problems, please call us. Technical support is available on weekdays from 7 a.m. to 4 p.m. Pacific time. You can also receive emergency support outside of these hours by calling our regular phone number and asking the operator to page a support person for you. 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 tell a pre-release by its three-part version number (e.g., 3.7.03) and the words "Pre-Release" next to the version number. Important Note About Passwords None of the jobs we supply have passwords in them. Before streaming a job, you may have to add your system's passwords to the first line. Users of MPE XL 3.0 (and higher) do not have to do this because the operating system prompts for missing passwords. The same is true for some MPE V users who have security software that inserts passwords. Most MPE V users have to edit the jobs. For example, if the system manager logon password is Qwerty, you would do the following: :editor HP32201A.07.22 EDIT/3000 /text robelle.pub.sys FILE UNNUMBERED /modify 1 MODIFY 1 !job robelle,manager.sys,pub;hipri i/qwerty !job robelle,manager.sys/qwerty,pub;hipri /keep robtemp /exit END OF SUBSYSTEM :stream robtemp :purge robtemp STREAMX Users Users of STREAMX, a part of SECURITY/3000 from VESOFT Inc., must set a Job Control Word before streaming jobs. This prevents STREAMX from generating an error if the Robelle account does not yet exist. For example, :setjcw streamxtempnonest 1 :stream robelle.pub.sys Step 1: Upgrade or Build the Robelle Account Even if you already have the Robelle account, the first thing you must do is stream the Robelle job: :hello manager.sys :file suprtape;dev=tape :restore *suprtape;robelle.pub.sys {=reply on console} :stream robelle.pub.sys {supply passwords} This job stream launches a second job which sends you a message when it has completed. Stay logged on as Manager.Sys and put a password on the Robelle account. If the Robelle account already exists, use the old password. :altacct robelle;pass=hardpass {hard to guess} Please note that during installation, we add OP capability to the Robelle account. When the Suprtool installation is complete, you can optionally remove the OP capability. Step 2: Restore the Files Stay logged on as Manager.Sys and restore the Robelle files. :file suprtape;dev=tape :restore *suprtape;@.@.robelle The files on the tape require approximately 80,000 sectors. Most of these files replace files that already exist, so the new version does not take up much more space than the old version. The Suprtool program files are located in the Pub group of the Robelle account. At this point in the installation process, the files do not have their correct names. The next step assigns the proper names to the program files. Step 3: Install Suprtool into Production Our installation job installs Suprtool, STExport, Suprlink, Speed Demon, and the Suprtool2 interface. No one can use these programs when you do the installation. Warn people not to use these programs for a while, and then stream our installation job. :hello mgr.robelle :warn @;please exit from Suprtool and Suprlink NOW! :stream install.suprjob.robelle Check the installation job $STDLIST. If anyone is using Suprtool, STExport, Suprlink, or Speed Demon or attempting to back them up, the job will fail. Chase away any users, ensure that a backup is not in progress, then stream the installation job again. The installation job renames your current versions of Suprtool and its components to the PubOld group of the Robelle account. If you need to move these versions back into production, use the Previous.Suprjob job stream. You can now access Suprtool by entering, :run suprtool.pub.robelle Please note that the version of STExport included in this release is STExport 3.8.01. Important Note: If you also use Netbase on MPE/iX, the new Suprtool prefetch algorithms can interact with Netbase to cause system failures. We have a simple work-around that must be completed by Netbase users. See step 9 for details. Optional Installation Steps On MPE/iX, your installation should be complete. If you have copied Speed Demon or the Suprtool2 interface to your own XL files, you will have to copy the latest versions by using the instructions in the user manuals for Speed Demon and Calling Suprtool. On MPE V, you need to install Speed Demon and Suprtool2 in the System SL in order to use the new versions. MPE/iX users must also do this if they are calling Speed Demon or Suprtool2 from compatibility-mode programs. With so few changes to Speed Demon and Suprtool2, you can safely ignore them for this version of Suprtool. If you have a Windows PC, you can install all of the Suprtool documentation in the popular Microsoft Windows WinHelp format on your PC. Step 4: Speed Demon/V Installation (optional) To use the new features of Speed Demon/V, you must install the latest version in the System SL. You should follow the installation instructions in the Speed Demon user manual. These instructions assume that you have used the Install.Suprjob job stream to move Suprtool and its components into the Pub group of the Robelle account. :stream demon.suprjob.robelle Step 5: Suprtool2 Interface Installation (Classic only) The Suprtool2 interface has been revised. On MPE V, you must re-install the interface. If you do not install the latest Suprtool2 interface, any program that attempts to use totals returned by Suprtool2 will fail. You can install this version without recompiling any of your existing programs. System SL Installation To install the latest Suprtool2 interface in the System SL, use our standard installation job. :stream suprcall.suprjob.robelle User SL or XL Files If you have copied the Suprtool2 interface into your own SL or XL, you need to copy the latest version by using the instructions in the Calling Suprtool user manual. Step 6: Optionally Limiting Suprtool's Runtime Priority Some system managers like to restrict the amount of resources that Suprtool consumes. To force Suprtool to always run in the D Queue, you can use HP's Linkedit program. :linkedit >altprog suprtool;maxpri=ds >exit Because most users run in the C Queue, forcing Suprtool to always run in the lower queue means that Suprtool competes less with on-line users, even when Suprtool runs on-line. System managers should only restrict the priority of Suprtool if they are familiar with MPE process queues and the Tune command. Step 7: Install WinHelp Documentation Files (optional) All of the Suprtool documentation is now available in Microsoft Windows WinHelp format. To install and use these WinHelp files, your PC must have MS Windows 3.1 or higher. Make a Temporary Directory for the Setup Program From either DOS or File Manager, create a new directory for 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. Follow these instructions to download the file with Reflection. The file on the HP 3000 is called Suprhelp.Whelp .Robelle. You should be logged on as Mgr.Robelle. Press Alt-Y to go to the Reflection Command Line window. You must use binary transfer. receive c:\robtemp\suprhelp.exe from suprhelp.whelp.robelle 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 the following 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 as provided by the Setup program. You can now access all of the Suprtool documentation by selecting any of the icons in the "Robelle Help" Program Manager Group. Remove the Robtemp Directory Remove all of 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. Step 8: Install HowMessy (MPE/iX only) HowMessy has been included in this release of Suprtool. You can install HowMessy by streaming the install job. stream bonus.job.robelle Step 9: Netbase and Suprtool (MPE/iX only) Netbase is a product from Quest Software that allows you to access files and databases on remote machines, but they look like local files. There is a problem when using Netbase and Suprtool. 1. System failures can occur if the Netbase version is below 0.9.4. The solution to this problems is to insure that you have Netbase 0.9.4. If you do not have the correct version then you can workaround this problem by adding the following line to the Suprmgr.Pub.Sys file: set prefetch 0 {zero} Step 10: Purge Installation Files (optional) The easiest way to clean up after an installation is to stream the Cleanup.Purgejob.Robelle job. This job saves you disc space by purging the installation files. It does not purge any files needed to run the software.