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____________________________________ Keys are shown with boxes around them. 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__and_press_._ 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 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 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 . You will exit from the installation procedure. If you have backed up your system disk, enter Y or just press 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 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 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 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 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 . 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