 






          From: AMERCA::DERIENZE "Bruce DeRienze 264-4879" 10-
          AUG-1990 10:11:26.86 To: SSPENG::HUSTON CC: Subj:
          DECslide V1.4 Inst. Guide .SDML File










          VAX DECslide
          Installation Guide


          Order Number: AA-V915C-TE

          Software Version:             DECslide Version 1.4

          Operating System:             VAX/VMS Version 5.0 or
                                        higher


          August 1990



          This manual describes the steps required for system
          managers to install VAX DECslide V1.4.

 





          ________________________
          August 1990

          __________
          The information in this document is subject to change
          without notice and should not be construed as a
          commitment by Digital Equipment Corporation. Digital
          Equipment Corporation assumes no responsibility for
          any errors that may appear in this document.

          The software described in this document is furnished
          under a license and may be used or copied only in
          accordance with the terms of such license.

          No responsibility is assumed for the use or
          reliability of software on equipment that is not
          supplied by Digital Equipment Corporation or its
          affiliated companies.

          Restricted Rights: Use, duplication, or disclosure
          by the U.S. Government is subject to restrictions as
          set forth in subparagraph (c)(1)(ii)  of the Rights in
          Technical Data and Computer Software clause at DFARS
          252.227-7013.

          __________
          Copyright 1990 by Digital Equipment Corporation

          All Rights Reserved.
          Printed in U.S.A.

          __________
          The postpaid READER'S COMMENTS form on the
          last page of this document requests the user's
          critical evaluation to assist in preparing future
          documentation.

          The following are trademarks of Digital Equipment
          Corporation:

          DEC             DECUS         RSX
          DEC/CMS         DECwriter     UNIBUS
          DEC/MMS         DIBOL         VAX
          DECalc          EduSystem     VAX Xway
          DECalc-Plus     FMS-11        VAXcluster
          DECgraph        IAS           VMS
          DECnet          MASSBUS       VT
          DECslide        PDP
          DECsystem-10    PDT
          DECsystem-20    RSTS          DIGITAL

          This document was prepared using VAX DOCUMENT, Version
          1.2

 






          _______________________________________________________

          Contents

                _________________________________________________
                PREFACE                                         v

          _______________________________________________________
          CHAPTER 1  PREINSTALLATION                          1-1

                _________________________________________________
                1.1   THE DISTRIBUTION KIT                    1-1

                _________________________________________________
                1.2   PREREQUISITE SOFTWARE                   1-1

                _________________________________________________
                1.3   INSTALLATION PROCEDURE REQUIREMENTS     1-2

                1.3.1     Checking the System
                          Parameters  ____________________    1-2

                1.3.2     Special Requirements  __________    1-4

          _______________________________________________________
          CHAPTER 2  INSTALLATION                             2-1

                _________________________________________________
                2.1   INSTALLING DECSLIDE                     2-1

                _________________________________________________
                2.2   INSTALLATION PROCEDURE                  2-2

                _________________________________________________
                2.3   POST INSTALLATION                       2-8

                _________________________________________________
                2.4   INSTALLATION ERROR MESSAGES             2-8




                                                              iii

 


          Contents



          _______________________________________________________
          CHAPTER 3  RUNNING THE INSTALLATION
                     VERIFICATION PROCEDURE                   3-1


          _______________________________________________________
          APPENDIX A  SAMPLE INSTALLATION                     A-1


          _______________________________________________________
          TABLES

                1-1       Directories and Files for
                          DECslide Installation  _________    1-5



























          iv

 





          _______________________________________________________

          Preface


          This installation guide describes how to install
          VAX DECslide on the VAX/VMS operating system. It is
          intended for system managers.

          Keep this installation guide with your distribution
          kit. You will need to refer to it again if you receive
          any maintenance updates or need to reinstall DECslide.

          The installation procedure is described step by step.
          The dialog is interactive. The installation procedure
          prompts you to answer questions.

          This installation guide does not contain release
          notes. Release notes are on-line. You can display and
          print them from within the installation procedure.

          To read the release notes after installation, type or
          print the file SYS$HELP:SLIDE014.RELEASE_NOTES.

          __________________________________________________________________

          Conventions

          This manual uses the following conventions:

          _______________________________________________________
          Convention__Meaning____________________________________

          <RETURN>    Keys are shown with boxes around them.

          <CTRL/X>    Two keys separated by a forward slash
                      means you should hold down the first key
                      and press the second. In the example here,
          ____________you_should_hold_down_<CTRL>_and_press_<X>._



                                                                v

 






          _______________________________________________________

   1      Preinstallation




          This chapter describes how to prepare for installing
          VAX DECslide V1.4 software on your VAX/VMS system.

          __________________________________________________________________

   1.1    The Distribution Kit

          You can receive DECslide V1.4 on two types of media:
          magnetic tape (16MT9) or TK50.

          The installation procedure will prompt you to mount
          the volumes. To mount the distribution medium, see
          the Guide to VAX/VMS Software Installation for your
          system. The guide also details several options to the
          installation procedure. Be sure to read it.

          Each distribution kit includes all files needed to
          install and execute DECslide V1.4. Release notes about
          installing and operating DECslide are available on-
          line. You can display them and print them from within
          the installation procedure (see Section 2.2, step 6).

          The DECslide kit contains two savesets: SLIDE014.A and
          SLIDE014.B

          __________________________________________________________________

   1.2    Prerequisite Software

          To run DECslide V1.4 you must have VMS V5.0 or later
          on your system.



                                                              1-1

 


          Preinstallation


          __________________________________________________________________

   1.3    Installation Procedure Requirements

          Before you can install DECslide, you must have the
          following:

          o  A DECslide distribution kit

          o  Access to a privileged system manager's account

          o  A minimum of 3,500 free blocks on the system disk
             for use during installation (1,000 blocks are
             allocated to DECslide after installation.)

          o  A minimum of 450 unused global pages and a minimum
             of 5 global sections

          o  A DECslide license installed and loaded

          ___________________________

   1.3.1  Checking the System Parameters

          Before you install DECslide you must compare the
          required number of global pages and global sections
          with the values on your system. The installation
          procedure also checks these system parameters. If a
          parameter does not meet the minimum value, VMSINSTAL
          terminates the installation so you can modify the
          parameters. Refer to the Guide to Setting Up a VMS
          System in the VAX/VMS documentation for information
          about modifying GBLPAGES and/or GBLSECTIONS values.

          To determine the number of global pages and sections
          on your system, do the following:

          1  Invoke the INSTALL utility by entering:

                $ INSTALL

          2  Determine the number of available global pages by
             entering:

                INSTALL> LIST/GLOBAL/SUMMARY

          1-2

 


                                                  Preinstallation



             This command determines whether your system has
             enough available global pages to install DECslide.
             It displays a summary of the number of global
             sections used, the number of global pages used,
             and the number of global pages unused.

             DECslide requires 450 global pages. If there are
             fewer than 450 unused pages, you can delete an
             existing known image (with the INSTALL utility).
             You also can increase the GBLPAGES system parameter
             with the SYSTEM GENERATION utility by using
             AUTOGEN.COM. For more information about using
             AUTOGEN, refer to the Guide to Setting Up a VMS
             System in the VAX/VMS documentation.

             Note the number of global sections used because you
             will need the information when checking the global
             sections.

          3  Exit from the INSTALL utility by entering:

                INSTALL> EXIT

          4  Determine the number of available global sections
             by using the SYSGEN utility. Enter the following:

                $ RUN SYS$SYSTEM:SYSGEN
                SYSGEN> USE CURRENT
                SYSGEN> SHOW GBLSECTIONS

             These commands determine whether your system
             has enough available global sections to install
             DECslide. The first number displayed is the maximum
             number of global sections. Compare this number to
             the number of global sections in use displayed by
             the INSTALL utility.

             DECslide requires five global sections. Therefore,
             if the amount displayed plus five exceeds the
             system maximum, you must increase the number of
             available global sections before you can install
             DECslide.

                                                              1-3

 


          Preinstallation



             To increase the amount, you must increase the
             GBLSECTIONS parameter with the SYSTEM GENERATION
             utility by using AUTOGEN.COM. For more information
             about AUTOGEN, refer to the Guide to Setting Up a
             VMS System in the VAX/VMS documentation.

             If the amount displayed plus five is less than the
             system maximum, you can install DECslide.

          ___________________________

   1.3.2  Special Requirements

          DECslide operation requires permanent disk space in
          the following directories:

          o  SYS$SYSTEM

          o  SYS$SHARE

          o  SYS$HELP

          o  SYS$TEST

          o  SYS$MANAGER

          o  SYS$SYSROOT:[SYSTEST.SLIDE014]

          Table 1-1 shows the files in the directories.












          1-4

 


                                                  Preinstallation



          Table 1-1  Directories and Files for DECslide
          ___________Installation________________________________

          Directory________File__________________________________

          SYS$HELP         SLIDE014.RELEASE_NOTES
                           SLIDEHELP.HLB

          SYS$MANAGER      SLIDE$START.COM

          SYS$SHARE        SLIDESHR.EXE

          SYS$SYSTEM       DECSLIDE.EXE

          SYS$TEST         SLIDE$IVP.COM

          [SYSTEST.SLIDE014SLIDEVFY.SLD__________________________

          You need at least 3,500 free blocks before attempting
          this installation.

          Use the following command to determine if you have
          enough free blocks on your system disk (or target disk
          system) to install DECslide:

             $ SHOW DEVICE SYS$SYSDEVICE















                                                              1-5

 






          _______________________________________________________

   2      Installation




          This chapter explains how to install DECslide and
          describes error messages you might receive during the
          installation.

          __________________________________________________________________

   2.1    Installing DECslide

          This section contains the steps you follow to install
          DECslide. You will have to log on to the system
          manager's account and make a backup of the system
          disk, checking all parameters. You should install
          DECslide in stand-alone mode. You will have to make
          sure that all users have logged off the system, and
          all batch jobs are complete. Then you will shut down
          the DECnet network and invoke VMSINSTAL to install
          DECslide.

          The installation procedure prompts you to enter
          information. Most queries require a simple YES or NO
          answer. Respond with Y or N, as appropriate, or press
          <Return> to choose the default.

          Enhancements to VMSINSTAL in future releases of VMS
          might result in additional prompts appearing during
          the course of the installation. Although such prompts
          might not be documented in this installation guide,
          the installation will proceed normally.

          The DECslide installation procedure takes between
          2 and 30 minutes to complete, depending on your
          particular VAX configuration.


                                                              2-1

 


          Installation


          __________________________________________________________________

   2.2    Installation Procedure

          1  Make a backup of the system disk and check the
             system parameters.

          2  Log on to the system manager's account. Set the
             default directory to SYS$UPDATE by entering:

                $ SET DEFAULT SYS$UPDATE

          3  Start the installation by entering:

                $ @VMSINSTAL SLIDE014 device OPTIONS N

             device is the name of the device on which you will
             mount the DECslide distribution media. VMSINSTAL
             displays information similar to the following:

                       VAX/VMS Software Product Installation Procedure V5.3

                  It is 22-APR-1990 at 08:08.
                  Enter a question mark (?) at any time for help.

             VMSINSTAL checks to see if users are logged on
             to the system. If someone is, VMSINSTAL displays
             a warning message. You can stop the installation
             procedure by pressing <Return> when prompted
             to continue the installation procedure. If you
             continue, VMSINSTAL asks you if you are satisfied
             with the backup of your system disk:

                  Are you satisfied with the backup of your system disk [YES]?

             If you have not made a backup of your system disk,
             type N and press <Return>. You will exit from the
             installation procedure.

             If you have backed up your system disk, enter Y or
             just press <Return> to continue the installation
             procedure.

          2-2

 


                                                     Installation



          4  Mount the first installation kit volume when
             VMSINSTAL displays a message similar to the
             following:

                  Please mount the first volume of the set on [device].
                  Are you ready?

          5  After mounting the first volume, type Y and press
             <Return> to continue the installation procedure.
             VMSINSTAL displays the following messages:

                  %MOUNT-I-MOUNTED, SLIDE mounted on [device]:

                  The following products will be processed:

                          SLIDE V1.4

                               Beginning installation of SLIDE V1.4 at 08:10

                  %VMSINSTAL-I-RESTORE, Restoring product save set A ...

                  Release notes included with this kit are always copied to SYS$HELP.

                  Additional Release Note Options:

                       1. Display release notes
                       2. Print release notes
                       3. Both 1 and 2
                       4. None of the above

                  * Select option [2]:

          6  Select a release notes option. If you select Option
             1, VMSINSTAL displays the release notes immediately
             on your screen. If you select Option 2 or 3,
             VMSINSTAL prompts you for a queue name:

                  * Queue name  [SYS$PRINT]:

             Enter a queue name or press <Return> to indicate
             the default output print device SYS$PRINT.

             If you select Option 4, VMSINSTAL does not display
             or print the release notes.

                                                              2-3

 


          Installation



             VMSINSTAL asks if you want to continue with the
             installation:

                  Do you want to continue the installation [NO]?

          7  Type N or press <Return> to stop the installation.
             Enter Y to continue.

             If you enter Y to continue the installation,
             VMSINSTAL displays the following message:

                  ********************************************************
                  *                   VAX DECslide V1.4                  *
                  *              Business Presentation Package           *
                  *                                                      *
                  *               Installation Procedure                 *
                  *                                                      *
                  * Copyright 1990 , Digital Equipment Corporation       *
                  *                                                      *
                  ********************************************************

                  %SLIDE-I-VMSOK, Your VMS Version is O.K. Confirming license...

                          Product:       DECslide
                          Producer:      DEC
                          Version:       1.4
                          Release Date:  13-AUG-1990

                  * Does this product have an authorization key registered and loaded?

             If your license is loaded, enter Y at the prompt.
             If you enter Y and you do not have a license
             loaded, your Installation Verification Procedure
             (IVP) will fail. The installation proceeds as
             normal, but you will not be able to use DECslide
             until you load a valid license on the system.
             See the VMS License Management Utility Manual for
             instructions on how to install and load licenses.

             If you enter N at the prompt, then VMSINSTAL lets
             you exit the installation to load the license on to
             the system with the following prompt:

          2-4

 


                                                     Installation



                  You do not have the DECslide license currently loaded on your system.
                  You may continue with this installation, or you may stop to load the
                  license at this time. If you do continue, you will not be able to use
                  the DECslide product until the license is loaded.

                  *Do you wish to continue with the DECslide installation? [N]?

             If you enter N, the installation will stop. If you
             enter Y, VMSINSTAL verifies that you have enough
             disk space, and displays the following messages:

                  %SLIDE-I-LICOK, License O.K. Checking disk space...
                  %SLIDE-I-DISKOK, Your disk space is O.K.

          8  VMSINSTAL asks if you want to purge the files the
             current installation replaces:

                  * Do you want to purge the files replaced by this installation [YES]?

             Press <Return> or enter Y to purge the old version
             of DECslide from your system. Enter N to keep the
             old version of DECslide.

             VMSINSTAL then creates a test directory to put the
             test slide used for the Installation Verification
             Procedure (IVP):

                  %VMSINSTAL-I-SYSDIR, This product creates system directory
                  [SYSTEST.SLIDE014].

                      If you intend to execute this layered product on the other nodes
                      in your VAXcluster, and you have the appropriate software license,
                      you must prepare the system-specific roots on the other nodes by
                      issuing the following command on each node (using a suitable
                      privileged account):

                         $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSTEST.SLIDE014]

          9  VMSINSTAL now gives you the option of running the
             Installation Verification Procedure (IVP). The
             IVP confirms that the installation was successful.
             The IVP takes from 2 to 20 minutes to complete,
             depending on your configuration.

                                                              2-5

 


          Installation



             However, you cannot run the IVP if your DECslide
             license is not loaded. If it is not loaded,
             VMSINSTAL displays the following message:

                  You do not have a license installed on your system. Since the
                  Installation Verification requires the license be loaded, it will
                  not be run. Once this installation has finished and the license is
                  loaded, it is highly recommended to run the IVP by hand. To do
                  this, type:

                  @SYS$TEST:SLIDE$IVP.COM

             If your license is loaded, VMSINSTAL displays the
             following prompt:

                  * Do you want to run the IVP after the installation [YES]?

          10 To run the Installation Verification Procedure,
             press <Return>.

                  All questions necessary for the installation of DECslide have been
                  answered.

                  This installation will continue from 2 to 30 minutes depending
                  on your particular configuration ...

          11 VMSINSTAL copies files from the distribution kit
             and performs the installation. It displays the
             following message:

                  %VMSINSTAL-I-RESTORE, Restoring product save set B ...
                  %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
                                          directories...

          12 If you chose to run the Installation Verification
             Procedure, you will see the following messages:





          2-6

 


                                                     Installation



                   Beginning IVP of SLIDE V1.4 ...

                     ************************************************************
                     *                                                          *
                     *                    VAX DECslide V1.4                     *
                     *              Business Presentation Package               *
                     *                                                          *
                     *          Installation Verification Procedure             *
                     *                                                          *
                     *       Copyright 1990, Digital Equipment Corporation      *
                     *                                                          *
                     ************************************************************

                  Please wait for the Installation Verification Procedure to complete.
                  The IVP takes from 2 to 20 minutes to complete depending on your
                  configuration.

                  The VAX DECslide V1.4 Installation Verification completed successfully.

             If the installation did not pass the verification
             test, you will see a failure message.

          13 When the installation procedure finishes, VMSINSTAL
             displays the following message:

                     Installation of SLIDE V1.4 completed at 08:20

                     VMSINSTAL procedure done at 08:20

             The DECslide installation is complete.

          14 If you installed DECslide from the console drive,
             you must dismount the DECslide media and remount
             your console media.







                                                              2-7

 


          Installation


          __________________________________________________________________

   2.3    Post Installation

          After installation, you must edit the file
          SYSTARTUP_V5.COM so that DECslide will be properly
          started when your system is booted.

          If you are installing DECslide for the first time,
          add the following line to SYSTARTUP_V5.COM in the
          directory SYS$STARTUP:

               @SYS$STARTUP:SLIDE$START.COM

          If DECslide was previously installed on your
          system, and you are updating to V1.4, edit the file
          SYSTARTUP_V5.COM in directory SYS$STARTUP. Find the
          following lines:

               $ RUN SYS$SYSTEM:INSTALL
               DECSLIDE/PRIVILEGE=TMPMBX/SHARE/OPEN/HEADER_RESIDENT
               SYS$SHARE:SLIDESHR/SHARE/OPEN/HEADER_RESIDENT
               /EXIT

          Delete these lines, and add the following line in
          their place:

               @SYS$STARTUP:SLIDE$START.COM

          __________________________________________________________________

   2.4    Installation Error Messages

          This section describes error messages you might
          receive during installation.

             Operating System Failure

                If the power goes off during the installation
                procedure or the operating system fails for any
                other reason, you must restart the system and
                the installation procedure.

          2-8

 


                                                     Installation



          The following errors can occur during the installation
          procedure:

             %SLIDE-E-BADPAGE, DECslide V1.4 requires 450 free
             GBLPAGES to install.

                Facility: VAX DECslide
                Severity: Error
                Explanation: DECslide requires 450 global pages.
                Make sure that at least 450 global pages are
                available on your system and repeat the VAX
                DECslide V1.4 installation.

             %SLIDE-E-BADSECT, DECslide V1.4 requires 5 free
             GBLSECTIONS to install.

                Facility: VAX DECslide
                Severity: Error
                Explanation: DECslide requires five global
                sections. Make sure that at least 5 global
                sections are available on your system and repeat
                the VAX DECslide V1.4 installation.

             %SLIDE-E-BADVMS, SLIDE V1.4 requires VMS Version
             5.0 or later to install.

                Facility: VAX DECslide
                Severity: Error
                Explanation: Your VAX system must be running
                VMS V5.0 or later to install VAX DECslide
                V1.4. The installation procedure detected that
                an earlier version of VMS is running on your
                system. Upgrade to VMS V5.0 and then repeat the
                VAX DECslide V1.4 installation.

             %SLIDE-E-NOSPACE, SLIDE V1.4 requires 3,500 free
             blocks to install.

                Facility: VAX DECslide
                Severity: Error

                                                              2-9

 


          Installation



                Explanation: The system disk on your system
                must have at least 3,500 free blocks in order
                to install VAX DECslide V1.4. The installation
                procedure found fewer than 3,500 blocks and
                terminated. Make sure that at least 3,500 blocks
                are available on your system disk and repeat the
                VAX DECslide V1.4 installation.


































          2-10

 






          _______________________________________________________

   3      Running the Installation Verification Procedure




          You can execute the DECslide Installation Verification
          Procedure (IVP) from a privileged or non-privileged
          account any time after DECslide has been installed on
          your system.

          To execute the IVP, enter the following:

               $ @SYS$TEST:SLIDE$IVP

          The IVP displays the following message:

                Beginning IVP of SLIDE V1.4 ...

                  *********************************************************
                  *                                                       *
                  *                 VAX DECslide V1.4                     *
                  *              Business Presentation Package            *
                  *                                                       *
                  *           Installation Verification Procedure         *
                  *                                                       *
                  *      Copyright 1990, Digital Equipment Corporation    *
                  *                                                       *
                  *********************************************************

               Please wait for the Installation Verification Procedure to
               complete.  The IVP takes from 2 to 20 minutes to complete
               depending on your configuration.

          If the IVP completes successfully, it displays the
          following message:

               The VAX DECslide V1.4 Installation Verification completed successfully.

          If the IVP fails, it displays the following message:

               The VAX DECslide V1.4 Installation Verification has failed.

                                                              3-1

 






          _______________________________________________________

   A      Sample Installation





                VAX/VMS Software Product Installation Procedure V5.3

               It is 28-MAY-1990 at 11:39.

               Enter a question mark (?) at any time for help.

               * Are you satisfied with the backup of your system disk [YES]?

               The following products will be processed:
                 SLIDE V1.4

                Beginning installation of SLIDE V1.4 at 11:40

               %VMSINSTAL-I-RESTORE, Restoring product save set A ...

               Release notes included with this kit are always copied to SYS$HELP.
               Additional Release Note Options:

                1.  Display release notes
                2.  Print release notes
                3.  Both 1 and 2
                4.  None of the above

               * Select option [2]: 4
               * Do you want to continue the installation[NO]? YES

               ***************************************************************
               *                                                             *
               *                   VAX DECslide V1.4                         *
               *               Business Presentation Package                 *
               *                                                             *
               *                 Installation Procedure                      *
               *                                                             *
               *       Copyright 1990, Digital Equipment Corporation         *
               *                                                             *
               ***************************************************************

                                                              A-1

 


          Sample Installation



               %SLIDE-I-VMSOK, Your VMS Version is O.K. Confirming license...

                       Product:      DECslide
                       Producer:     DEC
                       Version:      1.4
                       Release Date: 13-AUG-1990

               * Does this product have an authorization key registered and loaded? YES

               %SLIDE-I-LICOK, License O.K. Checking disk space...
               %SLIDE-I-DISKOK, Your disk space is O.K. Setting safety margin...

               * Do you want to purge files replaced by this installation [YES]?

               %VMSINSTAL-I-SYSDIR, This product creates system directory
               [SYSTEST.SLIDE014].

                   If you intend to execute this layered product on other nodes in your
                   VAXcluster, and you have the appropriate software license, you must
                   prepare the system-specific roots on the other nodes by issuing the
                   following command on each node (using a suitably privileged account):

                $ CREATE /DIRECTORY SYS$SPECIFIC:[SYSTEST.SLIDE014]

               * Do you want to run the IVP after the installation [YES]?

               All questions necessary for the installation of DECgraph have been
               answered.

               This installation will continue from 2 to 30 minutes depending on
               your particular configuration ...

               %VMSINSTAL-I-RESTORE, Restoring product save set B ...
               %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
               directories...

                Beginning IVP of SLIDE V1.4 ...




          A-2

 


                                              Sample Installation



                  ************************************************************
                  *                                                          *
                  *                    VAX DECslide V1.4                     *
                  *              Business Presentation Package               *
                  *                                                          *
                  *          Installation Verification Procedure             *
                  *                                                          *
                  *       Copyright 1990, Digital Equipment Corporation      *
                  *                                                          *
                  ************************************************************

               Please wait for the Installation Verification Procedure to complete.
               The IVP takes from 2 to 20 minutes to complete depending on your
               configuration.

               The VAX DECslide V1.4 Installation Verification completed successfully.

                Installation of SLIDE V1.4 completed at 11:55

                VMSINSTAL procedure done at 11:55





















                                                              A-3
