 

















                     ______________________________________________
                     Bookreader for OpenVMS
                     Installation Guide

                     Order Number: AA-PT19A-TE


                     March 1993
                     March 1993
                     March 1993

                     This guide describes how to install Bookreader on
                     an OpenVMS system.






                                                  OpenVMS Version 5.4
                     Operating System:
                     Operating System:
                     Operating System:
                                                  or higher

                                                  Bookreader Version
                     Software Version:
                     Software Version:
                     Software Version:
                                                  4.1









                     Digital Equipment Corporation
                     Digital Equipment Corporation
                     Digital Equipment Corporation
                     Maynard, Massachusetts
                     Maynard, Massachusetts
                     Maynard, Massachusetts

 






              __________________________________________________________
              March 1993
              March 1993
              March 1993

              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.

              The postpaid Reader's Comments forms at the end of this
              document request your critical evaluation to assist in
              preparing future documentation.

              The following are trademarks of Digital Equipment
              Corporation: Alpha AXP, AXP, Bookreader, CDA, DATATRIEVE,
              DDIF, DECalc, DECdecision, DECnet, DECpage, DECpresent,
              DECquery, DECwindows, DECwrite, Digital, DTIF, DX,
              LinkWorks, LiveLink, OpenVMS, PATHWORKS, PrintServer,
              RdbAccess, Rdb/VMS, TEAMDATA, ULTRIX, VAX, VAXcluster,
              VAXserver, VAXstation, VIDA, VMS, WPS-PLUS, XUI, and the
              DIGITAL logo.

              The following are third-party trademarks:

              Motif and OSF/Motif are trademarks of Open Software
              Foundation, Inc.

              PostScript is a registered trademark of Adobe Systems,
              Inc.

              UNIX is a registered trademark of UNIX Systems Laboratories,
              Inc.

                                                                  ZK6072

 













     ________________________________________________________________

                                                             Contents
                                                             Contents
                                                             Contents


     Preface
     Preface
     Preface
            ..................................................      v


     1  Preparing for Installation
     1  Preparing for Installation
     1  Preparing for Installation

         1.1  Checking the Distribution Kit...................    1-2
         1.2  Prerequisite Hardware...........................    1-2
         1.3  Prerequisite Software...........................    1-2
         1.4  Required Operating System Components............    1-2
         1.5  VAXcluster Considerations.......................    1-2
         1.6  Preparing Your System...........................    1-3
         1.6.1  Checking Privileges of the Installing
                Account.......................................    1-3
         1.6.2  System Disk Space Requirements ...............    1-3
         1.6.3  System Parameter Values ......................    1-4
         1.6.3.1   Calculating GBLPAGES and GBLSECTIONS
                   Parameter Values...........................    1-4
         1.6.3.2   Changing Parameter Values with AUTOGEN.....    1-5
         1.7  Backing Up Your System Disk.....................    1-5
         1.8  Determining and Reporting Problems..............    1-6
         1.9  Pre-Installation Check List.....................    1-6

     2  Installing Bookreader
     2  Installing Bookreader
     2  Installing Bookreader

         2.1  Running the VMSINSTAL Command Procedure.........    2-1









                                                                  iii

 






        3  Post-Installation Procedures
        3  Post-Installation Procedures
        3  Post-Installation Procedures

           3.1  Additional VAXcluster Tasks  ....................    3-1
           3.2  Editing the LIBRARY.DECW$BOOKSHELF File.........     3-1
           3.3  Running Bookreader..............................     3-2

        A  Sample Bookreader Installation
        A  Sample Bookreader Installation
        A  Sample Bookreader Installation


        B  Bookreader Files
        B  Bookreader Files
        B  Bookreader Files

        Index
        Index
        Index


        Tables
        Tables
        Tables

           1-1     Required Minimum System Parameter Values .....    1-4

           1-2     Pre-Installation Check List ..................    1-6


























        iv

 











        ________________________________________________________________

                                                                 Preface
                                                                 Preface
                                                                 Preface



              Bookreader lets you read online documentation in a Motif
              environment.

        Purpose of This Guide
        Purpose of This Guide
        Purpose of This Guide

              This guide describes how to install and maintain
              Bookreader on the OpenVMS operating system. You should
              review the entire guide before you start the installation.

        Who Should Use This Guide
        Who Should Use This Guide
        Who Should Use This Guide

              This guide is for OpenVMS system managers or others
              responsible for installing system software. To install
              the Bookreader software, you must have access to a
              privileged account such as the SYSTEM account, and you
              must be familiar with the OpenVMS installation procedure,
              VMSINSTAL.COM.

        For More Information
        For More Information
        For More Information

              Refer to the following documents for more information
              about Bookreader:

              o  Online Help-choose items from the Bookreader Help menu

              o  Online documentation that ships on the ConOLD discs:

                 -
                    _____ __________
                    Using Bookreader

                 -
                    ________ __________ _________ ___ _____
                    Managing Bookreader Libraries and Books

                 -
                    ______ __________ __ ____ ___________
                    Adding Bookreader to Your Environment


                                                                       v

 






              For more information about the VMSINSTAL command
              procedure, see one of the following manuals:

              o                             , in the OpenVMS base
                 ___ ______ _________ ______
                 VMS System Manager's Manual
                 documentation set

              o                                  , in the OpenVMS system
                 _____ __ _______ __ _ ___ ______
                 Guide to Setting Up a VMS System
                 management kit

        Conventions
        Conventions
        Conventions

              The following conventions are used in this guide:

              <Return>        In procedures, key names are shown
                              enclosed to indicate that you press a
                              key on the keyboard.

              <Ctrl/x>        A sequence such as <Ctrl/x> indicates that
                              you must hold down the key labeled Ctrl
                              while you press another key or a pointing
                              device button.

              ()              In format descriptions, parentheses
                              indicate that, if you choose more than
                              one option, you must enclose the choices
                              in parentheses.

              []              In format descriptions, brackets indicate
                              that whatever is enclosed is optional;
                              you can select none, one, or all of the
                              choices.

                              Italic text represents information that
              ______ ____
              italic text
                              can vary in system messages (for example,
                              Internal error       ).
                                             ______
                                             number

              UPPERCASE TEXT  Uppercase letters indicate that you must
                              enter a command. Uppercase letters also
                              indicate the name of a routine, the name
                              of a file, the name of a file protection
                              code, or the abbreviation of a system
                              privilege.

              Bookreader      The term Bookreader refers to the
                              Bookreader[TM] software.

              VMS systems     Refers to OpenVMS VAX systems unless
                              otherwise specified.

        vi

 









                                                                       1
                                                                       1
                                                                       1
        ________________________________________________________________

                                              Preparing for Installation
                                              Preparing for Installation
                                              Preparing for Installation



              This chapter describes tasks that you must complete before
              installing Bookreader. Installing Bookreader is similar to
              installing other OpenVMS layered products. You must do the
              following:

              o  Take an inventory of the software distribution kit.

              o  Make sure that your system has the prerequisite
                 hardware and enough disk space to install and run
                 Bookreader.

              o  Make sure that your system has the required OpenVMS
                 operating system components and the prerequisite
                 software.

              o  If you are installing on a VAXcluster, decide how best
                 to install Bookreader, depending on your configuration.

              o  Check your global pages and global sections OpenVMS
                 system parameters.

              o  Back up your system disk.

              o  Advise your users when the installation will take
                 place and how long it will take. The full installation
                 takes approximately 10 minutes on a VAXstation 3100
                 system. Your time may vary depending on your system
                 configuration.

              Once you have prepared your system, you can then perform
              the installation procedure as described in Chapter 2, and
              any necessary post-installation procedures as described in
              Chapter 3.


                                          Preparing for Installation
                                                                     1-1
                                                                     1-1
                                                                     1-1

 



        Preparing for Installation
        Preparing for Installation
        Preparing for Installation
        1.1 Checking the Distribution Kit
        1.1 Checking the Distribution Kit
        1.1 Checking the Distribution Kit

        1.1 Checking the Distribution Kit
        1.1 Checking the Distribution Kit
        1.1 Checking the Distribution Kit

              Each Bookreader distribution kit contains:

              o  The distribution medium for the Bookreader software

              o  The
                     __________ ___ _______ ____________ _____
                     Bookreader for OpenVMS Installation Guide

              If your kit is damaged or parts of it are missing, contact
              your Digital representative.

        1.2 Prerequisite Hardware
        1.2 Prerequisite Hardware
        1.2 Prerequisite Hardware

              Bookreader runs on all hardware configurations supported
              by OpenVMS DECwindows Motif V1.0 or higher.

        1.3 Prerequisite Software
        1.3 Prerequisite Software
        1.3 Prerequisite Software

              To install and run Bookreader, you must have the
              following:

              o  A valid OpenVMS operating system configuration running
                 OpenVMS Version 5.4 or higher and OpenVMS DECwindows
                 Motif Version 1.0 or higher.

        1.4 Required Operating System Components
        1.4 Required Operating System Components
        1.4 Required Operating System Components

              Bookreader requires the following OpenVMS Version 5.4
              components:

              o  VMS required files (BASE)

              o  Network support (NETWORK)

              If your system does not meet these requirements, the
              installation will fail. You must install the required
              software using VMSTAILOR before performing the Bookreader
              installation.

        1.5 VAXcluster Considerations
        1.5 VAXcluster Considerations
        1.5 VAXcluster Considerations

              You can install Bookreader on a VAXcluster.

              In a common-environment VAXcluster, you can install
              Bookreader on the VAXcluster boot node. This allows
              more than one VAX processor to share the same Bookreader
              software.

            Preparing for Installation
        1-2
        1-2
        1-2

 



                                              Preparing for Installation
                                              Preparing for Installation
                                              Preparing for Installation
                                           1.5 VAXcluster Considerations
                                           1.5 VAXcluster Considerations
                                           1.5 VAXcluster Considerations

              In a multiple-system VAXcluster, you can install
              Bookreader on each system disk in the cluster.

              You must make sure that each node where you plan to
              install or run Bookreader meets the minimum system
              parameter value requirements. See Section 1.6.3 for a
              list of required system parameter values.

        1.6 Preparing Your System
        1.6 Preparing Your System
        1.6 Preparing Your System

              This section tells you which characteristics of your
              system you need to check before you install Bookreader.
              These characteristics include:

              o  Account privileges

              o  Disk space requirements

              o  System parameters

              You must adjust those characteristics that do not match
              the minimum values required for installing and running
              Bookreader.

        1.6.1 Checking Privileges of the Installing Account
        1.6.1 Checking Privileges of the Installing Account
        1.6.1 Checking Privileges of the Installing Account

              The account you use to install Bookreader must have the
              user privilege SETPRV. As one of the first actions, the
              VMSINSTAL command procedure grants all privileges (except
              BYPASS) to the process that invokes it. This command
              succeeds only if the account has SETPRV.

              On most systems, the SYSTEM account has SETPRV and is
              used to install software. The procedures described in this
              installation guide refer to the SYSTEM account, but they
              are the same for any account with SETPRV.

        1.6.2 System Disk Space Requirements
        1.6.2 System Disk Space Requirements
        1.6.2 System Disk Space Requirements

              Your system must have at least 5000 free disk blocks to
              accommodate the installation.

              Use the DCL command SHOW DEVICE to determine the number
              of free blocks that are available on the system disk, as
              follows:

              $ SHOW DEVICE SYS$SYSDEVICE

                                          Preparing for Installation
                                                                     1-3
                                                                     1-3
                                                                     1-3

 



        Preparing for Installation
        Preparing for Installation
        Preparing for Installation
        1.6 Preparing Your System
        1.6 Preparing Your System
        1.6 Preparing Your System

              If the disk does not have enough free blocks, delete
              unnecessary files to provide the space required.

        1.6.3 System Parameter Values
        1.6.3 System Parameter Values
        1.6.3 System Parameter Values

              Table 1-1 lists the minimum system parameter values
              required for Bookreader installation and use.

              On a VAXcluster, you must adjust not only the system
              parameters of nodes on which you install Bookreader, but
              also the nodes on which you intend to run Bookreader.

              __________________________________________________________
              Table 1-1 Required Minimum System Parameter Values
              Table 1-1 Required Minimum System Parameter Values
              Table 1-1 Required Minimum System Parameter Values

              System
              System
              System
              __________________________________________________________
              Parameter        Minimum Value
              Parameter        Minimum Value
              Parameter        Minimum Value

              GBLPAGES         1055 unused global pages

              __________________________________________________________
              GBLSECTIONS      1 unused global section

        1.6.3.1 Calculating GBLPAGES and GBLSECTIONS Parameter Values
        1.6.3.1 Calculating GBLPAGES and GBLSECTIONS Parameter Values
        1.6.3.1 Calculating GBLPAGES and GBLSECTIONS Parameter Values

              The values for GBLPAGES and GBLSECTIONS in Table 1-1
              indicate that you must have at least 1055 unused global
              pages and 1 unused global section available for the
              installation.

              To calculate the number of unused global pages and global
              sections on your system, perform these steps:

              1. Use the DCL F$GETSYI lexical function to determine the
                 number of free global pages and global sections:

                 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")
                 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")

              2. If the number of unused global pages or global sections
                 is less than the number specified in Table 1-1, you
                 must increase the value using the AUTOGEN command
                 procedure, as shown in Section 1.6.3.2.




            Preparing for Installation
        1-4
        1-4
        1-4

 



                                              Preparing for Installation
                                              Preparing for Installation
                                              Preparing for Installation
                                               1.6 Preparing Your System
                                               1.6 Preparing Your System
                                               1.6 Preparing Your System

        1.6.3.2 Changing Parameter Values with AUTOGEN
        1.6.3.2 Changing Parameter Values with AUTOGEN
        1.6.3.2 Changing Parameter Values with AUTOGEN

              Use the AUTOGEN command procedure to change system
              parameters. To change system parameters with AUTOGEN:

              1. Edit the following file:

                 SYS$SYSTEM:MODPARAMS.DAT

                 For example, to increase the setting for the GBLPAGES
                 system parameter by 1055, add this line to the file:

                 ADD_GBLPAGES = 1055

              2. Run the AUTOGEN procedure to recalculate your system
                 parameters and reboot the system. Enter the following
                 command at the DCL prompt:

                 $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT

                 When you specify REBOOT, AUTOGEN performs an automatic
                 system shutdown and reboot. Any users logged on to
                 the system are immediately disconnected during the
                 shutdown. The automatic reboot puts the new parameter
                 values into effect.

                 AUTOGEN automatically adjusts some of the SYSGEN
                 parameters based on the consumption of resources since
                 the last reboot. If you do not want to take advantage
                 of this automatic adjustment, include the NOFEEDBACK
                 parameter on the AUTOGEN command line as well. For
                 example:

                 $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT NOFEEDBACK

              For more information about using AUTOGEN, see the
              instructions on modifying system parameters in the
                                                                 _____
                                                                 Guide
                                        .
              __ _______ __ _ ___ ______
              to Setting Up a VMS System

        1.7 Backing Up Your System Disk
        1.7 Backing Up Your System Disk
        1.7 Backing Up Your System Disk

              At the beginning of the installation, VMSINSTAL asks if
              you have backed up your system disk. Digital recommends
              that you do a system disk backup before installing any
              software. If a system failure occurs at a critical point
              during the installation, some of the files could be
              corrupted. Therefore, you should back up your system disk
              before attempting any software installation.

                                          Preparing for Installation
                                                                     1-5
                                                                     1-5
                                                                     1-5

 



        Preparing for Installation
        Preparing for Installation
        Preparing for Installation
        1.7 Backing Up Your System Disk
        1.7 Backing Up Your System Disk
        1.7 Backing Up Your System Disk

              For more information on backing up your system disk,
              see the section on the Backup Utility in the
                                                           _____ __
                                                           Guide to
                                      .
              ___________ _ ___ ______
              Maintaining a VMS System

        1.8 Determining and Reporting Problems
        1.8 Determining and Reporting Problems
        1.8 Determining and Reporting Problems

              If you encounter a problem while using Bookreader, report
              it to Digital. Depending on the nature of the problem
              and the type of support you have, you can take one of the
              following actions:

              o  Call Digital if your software contract or warranty
                 agreement entitles you to telephone support.

              o  Submit a Software Performance Report (SPR).

              o  Fill out and submit a Reader's Comments form if the
                 problem has to do with the Bookreader documentation.
                 There are Reader's Comments forms at the back of each
                 manual. Use the form from the manual in which you found
                 the error. Include the section number and page number.

              Review the Software Product Description (SPD) and Warranty
              Addendum for an explanation of your warranty. If you
              encounter a problem during the warranty period, report
              the problem as indicated above.

        1.9 Pre-Installation Check List
        1.9 Pre-Installation Check List
        1.9 Pre-Installation Check List

              Table 1-2 summarizes the tasks you must perform before
              installing Bookreader. Check to make sure that you have
              performed all these tasks before proceeding with the
              installation.

              __________________________________________________________
              Table 1-2 Pre-Installation Check List
              Table 1-2 Pre-Installation Check List
              Table 1-2 Pre-Installation Check List

              __________________________________________________________
              Task                            For More Information
              Task                            For More Information
              Task                            For More Information

              Check that you have the         See Section 1.2 and
              prerequisite hardware and       Section 1.3
              software

              Check that you have enough      See Section 1.6.2
              disk space

              Check system parameters         See Section 1.6.3

              __________________________________________________________
              Back up your system disk        See Section 1.7

            Preparing for Installation
        1-6
        1-6
        1-6

 









                                                                       2
                                                                       2
                                                                       2
        ________________________________________________________________

                                                   Installing Bookreader
                                                   Installing Bookreader
                                                   Installing Bookreader



              This chapter describes the procedure for installing
              Bookreader.

              Before you begin installing Bookreader, make sure that
              your system meets the requirements outlined in Chapter 1.

              The full installation takes approximately 10 minutes on a
              VAXstation 3100 system. Your time may vary depending on
              the configuration of your system.

        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure

              Use the VMSINSTAL command procedure to install Bookreader.
              For more information about VMSINSTAL, refer to the books
              listed in the Preface.

              If VMSINSTAL detects a problem during the installation
              procedure, it notifies you and asks if you want to
              continue. To stop the installation and correct the
              problem, enter NO or press RETURN. After you have made
              the correction, you can restart the installation.

              To stop the installation procedure at any time, press
              Ctrl/Y. The installation procedure deletes all the files
              it has created up to that point and exits. You can then
              restart the installation.

              Follow these steps to install Bookreader:

              1.
                 Log in to the SYSTEM account.
                 Log in to the SYSTEM account.
                 Log in to the SYSTEM account.

                 Log in at the operator's console terminal under the
                 system manager's account, SYSTEM.

              2.
                 Notify the users.
                 Notify the users.
                 Notify the users.

                                               Installing Bookreader
                                                                     2-1
                                                                     2-1
                                                                     2-1

 



        Installing Bookreader
        Installing Bookreader
        Installing Bookreader
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure

                 Send a message requesting that all users log out. Use
                 the DCL REPLY command to inform users of the schedule
                 for the installation. Use the SET LOGINS command to
                 prevent others from logging in:

                 $ REPLY/USER "Installation starting in 5 minutes. Please log out."
                 $ SET LOGINS/INTERACTIVE=0

              3.
                 Invoke VMSINSTAL.
                 Invoke VMSINSTAL.
                 Invoke VMSINSTAL.

                 Enter the following command line to run VMSINSTAL.COM:

                 $ @SYS$UPDATE:VMSINSTAL BKR041 ddcu: OPTIONS N

                 where:

                 o                        invokes VMSINSTAL
                    _____________________
                    @SYS$UPDATE:VMSINSTAL

                 o         is the save set name for the Bookreader
                    ______
                    BKR041
                    software

                 o        is the device specification for the distribu-
                    _____
                    ddcu:
                    tion medium, for example, MUA0:.

                 o            is an optional parameter indicating that
                    _______ _
                    OPTIONS N
                    you want to see the Release Notes question. If you
                    do not include the OPTIONS N parameter, VMSINSTAL
                    does not ask you about the Release Notes. Digital
                    recommends that you review the Release Notes before
                    proceeding with the installation.

                 After you invoke VMSINSTAL, you see the following
                 message:

                         VAX/VMS Software Product Installation Procedure V5.4

                 It is 06-Mar-1993 at 08:05

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

              4.
                 Answer the backup question.
                 Answer the backup question.
                 Answer the backup question.

                 The installation procedure asks if you have backed up
                 your system disk:

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

            Installing Bookreader
        2-2
        2-2
        2-2

 



                                                   Installing Bookreader
                                                   Installing Bookreader
                                                   Installing Bookreader
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure

                 If you have not backed up your system disk, you should
                 not continue with the installation until you do so.
                 If you need to back up the system disk, enter NO.
                 VMSINSTAL exits and returns you to the DCL prompt.
                 Back up your system disk, and then start VMSINSTAL
                 again.

                 If you have already backed up the system disk, press
                 RETURN to continue.

              5.
                 Mount the media.
                 Mount the media.
                 Mount the media.

                 You receive instructions to mount the distribution
                 medium on the device you specified when you invoked
                 VMSINSTAL (MUA0: in this example):

                 Please mount the first volume of the set on MUA0:.
                 * Are you ready?

                 Mount the distribution medium and enter YES to indicate
                 that you are ready to continue.

                 The following messages appear on your terminal:

                 %MOUNT-I-MOUNTED,  BKR mounted on _MUA0:

                 The following products will be processed:

                   BKR V4.1

                         Beginning installation of BKR V4.1 at 08:05

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

              6.
                 Print and read the Release Notes.
                 Print and read the Release Notes.
                 Print and read the Release Notes.

                 If you specified OPTIONS N when you invoked VMSINSTAL,
                 you are now asked to choose one of the four options for
                 reviewing the Release Notes:

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

                 Additional Release Notes Options:

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

                 * Select option [2]:

                                               Installing Bookreader
                                                                     2-3
                                                                     2-3
                                                                     2-3

 



        Installing Bookreader
        Installing Bookreader
        Installing Bookreader
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure

                 Review the Release Notes in case they contain any
                 information about changes in the installation
                 procedures. Selecting option 2 prints a copy of the
                 Release Notes.

                 You are prompted for a print queue:

                 * Queue name [SYS$PRINT]:

                 Press RETURN to print the Release Notes on SYS$PRINT,
                 or type a different queue name and press RETURN. You
                 receive a message similar to the following:

                 Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT

                 If you selected options 1 or 3, the Release Notes are
                 displayed.

              7.
                 Decide whether or not to continue.
                 Decide whether or not to continue.
                 Decide whether or not to continue.

                 The installation procedure asks if you want to
                 continue:

                  * Do you want to continue the installation? [NO]?

                 %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

                 Enter YES to continue. Otherwise, press RETURN. In
                 either case, the Release Notes are moved to the
                 SYS$HELP directory. The Release Notes are contained
                 in the following file, which you may read or print
                 later:

                 SYS$HELP:BKR041.RELEASE_NOTES.

              8.
                 Decide whether or not to purge files.
                 Decide whether or not to purge files.
                 Decide whether or not to purge files.

                 The installation procedure asks if you want to purge
                 (delete) old versions of files replaced by this
                 installation:

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

                 Purging is recommended. Press RETURN to purge the old
                 files. However, if you need to keep files from the
                 previous version, enter NO.

              9.
                 Install the Bookreader Library File.
                 Install the Bookreader Library File.
                 Install the Bookreader Library File.

                 The installation procedure asks how you want to install
                 the Bookreader library file. This file contains a
                 bookshelf with the Bookreader online documentation.

            Installing Bookreader
        2-4
        2-4
        2-4

 



                                                   Installing Bookreader
                                                   Installing Bookreader
                                                   Installing Bookreader
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure

                 If your system does not currently have a
                 [DECW$BOOK]LIBRARY.DECW$BOOKSHELF file, the instal-
                 lation procedure installs one.

                 If your system already has a [DECW$BOOK]LIBRARY.DECW$BOOKSHELF
                 file, you see the following message:

                 A Bookreader Library file already exists on your system
                         ([DECW$BOOK]LIBRARY.DECW$BOOKSHELF)
                 This installation provides a new LIBRARY.DECW$BOOKSHELF.
                 Please enter one of the following:
                         1. Replace the existing LIBRARY.DECW$BOOKSHELF, or
                                 (saving a copy of the existing file)
                         2. Merge the two LIBRARY.DECW$BOOKSHELF files

                 * Select an option [1]:

                 Select Option 1 to replace the old LIBRARY.DECW$BOOKSHELF
                 with a new one. Use this option if you have not altered
                 the default LIBRARY.DECW$BOOKSHELF file. You then see
                 the following message:

                 Your existing LIBRARY.DECW$BOOKSHELF will be saved as
                 [DECW$BOOK]SAVED_LIBRARY.DECW$BOOKSHELF.

                 You should edit the new version of
                         [DECW$BOOK]LIBRARY.DECW$BOOKSHELF
                 to incorporate into it any books described in
                         [DECW$BOOK]SAVED_LIBRARY.DECW$BOOKSHELF

                 Select Option 2 to add the new library file to your
                 current
                 LIBRARY.DECW$BOOKSHELF. Use this option if you have
                 made edits to your default LIBRARY.DECW$BOOKSHELF file.
                 You then see the following message:

                 The two versions of LIBRARY.DECW$BOOKSHELF will be merged
                 by appending your existing file to the new file supplied
                 by this installation.

                 If your system already has a LIBRARY.DECW$BOOKSHELF
                 file, but it is not in the default [DECW$BOOK]
                 directory, you see the following message:


                                               Installing Bookreader
                                                                     2-5
                                                                     2-5
                                                                     2-5

 



        Installing Bookreader
        Installing Bookreader
        Installing Bookreader
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure
        2.1 Running the VMSINSTAL Command Procedure

                 Your system has a Bookreader library file LIBRARY.DECW$BOOKSHELF
                 in a location other than [DECW$BOOK].

                 This installation will place a new Bookreader library
                 file at [DECW$BOOK]LIBRARY.DECW$BOOKSHELF.

                 You should modify your current Bookreader library to
                 incorporate the contents of that file at the beginning
                 of your library.

              10.
                 Check informational messages.
                 Check informational messages.
                 Check informational messages.

                 The installation procedure displays a series of
                 messages as it performs the following installation
                 tasks:

                 o  Restores files

                 o  Notifies you about post-installation procedures

                 o  Transfers files to their directories

                   No further questions will be asked during this installation.

                   This installation will add the following files:

                         [SYSEXE]DECW$BOOKREADER.EXE
                         [SYSHLP]BKR041.RELEASE_NOTES
                         [SYSHLP]DECW$BOOKREADER.DECW$BOOK
                         [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER.UID
                         [DECW$DEFAULTS.SYSTEM]LWK_REG_BOOKREADER.UID
                         [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER.DAT
                         [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER_PROLOG.PS
                         [DECW$BOOK]BOOKREADER_USING.DECW$BOOK
                         [DECW$BOOK]BOOKREADER_MANAGING.DECW$BOOK
                         [DECW$BOOK]BOOKREADER_ADDING.DECW$BOOK
                         [DECW$BOOK]BOOKREADER_RELEASE_NOTES.DECW$BOOK
                         [DECW$BOOK]LIBRARY.DECW$BOOKSHELF

                 %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

              11.
                 End the installation procedure.
                 End the installation procedure.
                 End the installation procedure.

                 The installation procedure ends automatically with the
                 following messages:

                         Installation of BKR V4.1 completed at 08:15

                         VMSINSTAL procedure done at 08:15

            Installing Bookreader
        2-6
        2-6
        2-6

 



                                                   Installing Bookreader
                                                   Installing Bookreader
                                                   Installing Bookreader
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure
                             2.1 Running the VMSINSTAL Command Procedure

              12.
                 Make the system available to users.
                 Make the system available to users.
                 Make the system available to users.

                 After the installation completes successfully, you
                 should reset system logins to your system default (64
                 in this example). Then send a message to all users
                 stating that the system is again available. Use the
                 following DCL commands:

                 $ SET LOGINS/INTERACTIVE=64
                 $ REPLY/USER "Installation complete. System is ready for use."



































                                               Installing Bookreader
                                                                     2-7
                                                                     2-7
                                                                     2-7

 









                                                                       3
                                                                       3
                                                                       3
        ________________________________________________________________

                                            Post-Installation Procedures
                                            Post-Installation Procedures
                                            Post-Installation Procedures



              This chapter describes tasks that you must complete after
              Bookreader is installed.

        3.1 Additional VAXcluster Tasks
        3.1 Additional VAXcluster Tasks
        3.1 Additional VAXcluster Tasks

              To complete the installation of Bookreader on any type
              of VAXcluster, you must first install Bookreader on each
              system disk that is shared. Then you must perform the
              following procedure to replace the DCL tables.

              $ RUN SYS$SYSTEM:SYSMAN
              SYSMAN> SET ENVIRONMENT/CLUSTER/USER=SYSTEM
              Remote Password: supply SYSTEM password here
              SYSMAN> DO INSTALL REPLACE SYS$LIBRARY:DCLTABLES.EXE
              SYSMAN> EXIT

        3.2 Editing the LIBRARY.DECW$BOOKSHELF File
        3.2 Editing the LIBRARY.DECW$BOOKSHELF File
        3.2 Editing the LIBRARY.DECW$BOOKSHELF File

              The installation procedure installs a new LIBRARY.DECW$BOOKSHELF
              into your [DECW$BOOK] directory. This file contains a
              bookshelf with the Bookreader online documentation. If
              your system already had an existing LIBRARY.DECW$BOOKSHELF
              file, one of the following actions was taken:

              o  The new library file was merged with your old library
                 file.

              o  The new library file replaced your old library
                 file, renaming the old library file to SAVED_
                 LIBRARY.DECW$BOOKSHELF.

              o  The installation found a LIBRARY.DECW$BOOKSHELF file in
                 a location other than [DECW$BOOK] and installed a new
                 LIBRARY.DECW$BOOKSHELF file at [DECW$BOOK].

                                        Post-Installation Procedures
                                                                     3-1
                                                                     3-1
                                                                     3-1

 



        Post-Installation Procedures
        Post-Installation Procedures
        Post-Installation Procedures
        3.2 Editing the LIBRARY.DECW$BOOKSHELF File
        3.2 Editing the LIBRARY.DECW$BOOKSHELF File
        3.2 Editing the LIBRARY.DECW$BOOKSHELF File

              After the installation, you may need to edit the
              LIBRARY.DECW$BOOKSHELF file to obtain the proper listing
              of libraries and bookshelves in your Bookreader Library
              window. Use a text editor to make any changes.

        3.3 Running Bookreader
        3.3 Running Bookreader
        3.3 Running Bookreader

              Users may start Bookreader by selecting the Bookreader
              menu option in the Session Manager's Application menu.

              Users may also enter a command at the DCL prompt to use
              Bookreader. The following command invokes the Bookreader
              Motif interface:

              $ BOOKREADER

              For a full list of the Bookreader DCL commands, enter the
              following DCL command:

              $ HELP BOOKREADER

























            Post-Installation Procedures
        3-2
        3-2
        3-2

 









                                                                       A
                                                                       A
                                                                       A
        ________________________________________________________________

                                          Sample Bookreader Installation
                                          Sample Bookreader Installation
                                          Sample Bookreader Installation



              This appendix shows a typical installation of Bookreader
              on an OpenVMS Version 5.4 system.

              Table 1-2 summarizes the tasks you must perform before
              installing Bookreader. Check to make sure that you have
              completed all these tasks before proceeding with the
              installation.

                      Welcome to node MYNODE

              Username: SYSTEM <Return>
              Password:        <Return>

                      Welcome to VAX/VMS Version 5.4 on node MYNODE

                  Last interactive login on Monday,  06-JAN-1993 07:59
                  Last non-interactive login on Monday, 06-JAN-1993 01:00

              $ REPLY/USER "Installation starting in 5 minutes. Please log out." <Return>
              $ SET LOGINS/INTERACTIVE=0 <Return>
              $ @SYS$UPDATE:VMSINSTAL BKR041 MUA0: OPTIONS N <Return>

                      VAX/VMS Software Product Installation Procedure V5.4

              It is 06-Mar-1993 at 08:05.

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

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

              Please mount the first volume of the set on MUA0:.
              * Are you ready? YES <Return>

              %MOUNT-I-MOUNTED, BKR mounted on _MUA0:

              The following products will be processed:
                BKR V4.1

                      Beginning installation of BKR V4.1 at 08:05

                                      Sample Bookreader Installation
                                                                     A-1
                                                                     A-1
                                                                     A-1

 



        Sample Bookreader Installation
        Sample Bookreader Installation
        Sample Bookreader Installation


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

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

              Additional Release Notes Options:

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

              * Select option [2]: 2 <Return>

              * Queue name [SYS$PRINT]: <Return>
              Job 810 (queue SYS$PRINT, entry 1295) started on SYS$PRINT

              * Do you want to continue the installation [NO]? YES <Return>

              %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP.

              * Do you want to purge files replaced by this installation [YES]? <Return>
              A Bookreader Library file already exists on your system
                      ([DECW$BOOK]LIBRARY.DECW$BOOKSHELF)
              This installation provides a new LIBRARY.DECW$BOOKSHELF.
              Please enter one of the following:
                      1. Replace the existing LIBRARY.DECW$BOOKSHELF, or
                              (saving a copy of the existing file)
                      2. Merge the two LIBRARY.DECW$BOOKSHELF files

              * Select an option [1]: <Return>

                No further questions will be asked during this installation.

                This installation will add the following files:

                      [SYSEXE]DECW$BOOKREADER.EXE
                      [SYSHLP]BKR041.RELEASE_NOTES
                      [SYSHLP]DECW$BOOKREADER.DECW$BOOK
                      [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER.UID
                      [DECW$DEFAULTS.SYSTEM]LWK_REG_BOOKREADER.UID
                      [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER.DAT
                      [DECW$DEFAULTS.SYSTEM]DECW$BOOKREADER_PROLOG.PS
                      [DECW$BOOK]BOOKREADER_USING.DECW$BOOK
                      [DECW$BOOK]BOOKREADER_MANAGING.DECW$BOOK
                      [DECW$BOOK]BOOKREADER_ADDING.DECW$BOOK
                      [DECW$BOOK]BOOKREADER_RELEASE_NOTES.DECW$BOOK
                      [DECW$BOOK]LIBRARY.DECW$BOOKSHELF

            Sample Bookreader Installation
        A-2
        A-2
        A-2

 



                                          Sample Bookreader Installation
                                          Sample Bookreader Installation
                                          Sample Bookreader Installation


              %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...


                      Installation of BKR V4.1 completed at 08:15

                      VMSINSTAL procedure done at 08:15

              $ SET LOGINS/INTERACTIVE=64
              $ REPLY/USER "Installation complete. System is ready for use."




































                                      Sample Bookreader Installation
                                                                     A-3
                                                                     A-3
                                                                     A-3

 









                                                                       B
                                                                       B
                                                                       B
        ________________________________________________________________

                                                        Bookreader Files
                                                        Bookreader Files
                                                        Bookreader Files



              This appendix lists all the files that are transferred
              to your system during a Bookreader installation. The
              files are organized by directory. Note that references
              to SYS$COMMON are valid only if the kit was installed in
              the system common root (SYS$COMMON).

              In SYS$COMMON:[SYSEXE]

              DECW$BOOKREADER.EXE

              In SYS$COMMON:[DECW$BOOK]

              BOOKREADER_USING.DECW$BOOK
              BOOKREADER_MANAGING.DECW$BOOK
              BOOKREADER_ADDING.DECW$BOOK
              BOOKREADER_RELEASE_NOTES.DECW$BOOK
              LIBRARY.DECW$BOOKSHELF

              In SYS$HELP:

              BKR041.RELEASE_NOTES
              DECW$BOOKREADER.DECW$BOOK

              In DECW$SYSTEM_DEFAULTS:

              DECW$BOOKREADER.UID
              LWK_REG_BOOKREADER.UID
              DECW$BOOKREADER.DAT
              DECW$BOOKREADER_PROLOG.PS






                                                    Bookreader Files
                                                                     B-1
                                                                     B-1
                                                                     B-1

 













     ________________________________________________________________

                                                                Index
                                                                Index
                                                                Index


     B
     B
     B
                                          Disk blocks
     ___________________________
                                           displaying number of
     Backing up system disk,                  unused,  1-3
        1-5, 2-2                           required,  1-3
     Bookreader                           Distribution kit
       DCL commands for running,           contents of,  1-2
                                           list of files on,  B-1
         3-2
       files, B-1
                                          ___________________________
                                          F
                                          F
                                          F
       post-install tasks on
         VAXcluster,  3-1                 Files
       running, 3-2                        Bookreader,  B-1

                                           purging old versions,  2-4
     ___________________________
     C
     C
     C

                                          ___________________________
                                          G
                                          G
                                          G
     Checking the distribution

        kit, 1-2                          Global pages
     Cluster                               checking,  1-4
       installing on, 1-2                  required values,  1-4
       post-install tasks, 3-1            Global sections
     Components required                   checking,  1-4
       OpenVMS, 1-2                        required values,  1-4
       VMS, 1-2

                                          ___________________________
                                          H
                                          H
                                          H
     ___________________________
     D
     D
     D
                                          Hardware

     DCL commands                          prerequisite,  1-2
       for checking disk space,
                                          ___________________________
                                          I
                                          I
                                          I
         1-3
       for running Bookreader,            Installation
         3-2                               example,  A-1 to A-3
       for running VMSINSTAL,              files installed,  B-1
         2-1                               kit,  1-2

                                           preparing for,  1-1

                                                              Index-1
                                                              Index-1
                                                              Index-1

 






        Installation (cont'd)
                                            ___________________________
                                            R
                                            R
                                            R
         starting,  2-1

         stopping,  2-1                     Release notes,  2-3
         time needed,  2-1                  Reporting problems,  1-6
        Installing account                  Required disk space,  1-3
          requirements,  1-3                Required hardware,  1-2
         privileges,  1-3                   Required operating system

                                               components, 1-2
        ___________________________
        L
        L
        L
                                            Required privileges,  1-3
                                            Required software,  1-2
        Library file
                                            Running Bookreader,  3-2
         editing,  3-1

         installing,  2-4
                                            ___________________________
                                            S
                                            S
                                            S
        LIBRARY.DECW$BOOKSHELF file

         editing,  3-1                      Sample installation,  A-1

                                               to A-3
        ___________________________
        M
        M
        M
                                            Software

                                              prerequisite,  1-2
        Media
                                            Starting the installation,
         mounting,  2-3
                                               2-1
        ___________________________
        O
        O
        O
                                            Stopping the installation,
                                               2-1
        OpenVMS components required
                                            SYSGEN
          ,  1-2
                                              changing parameters,  1-5
        Operating system
                                              minimum values,  1-4
         required components,  1-2
                                            System disk
                                              backing up,  1-5, 2-2
        ___________________________
        P
        P
        P
                                            System parameters

                                              changing,  1-5
        Parameters
                                              minimum values,  1-4
         changing,  1-5
                                              on VAXclusters,  1-3
         system,  1-4

        Preparing for installation,
                                            ___________________________
                                            T
                                            T
                                            T
          1-1

         check list,  1-6                   Time needed to install,
        Prerequisite hardware, 1-2             2-1
        Prerequisite software, 1-2
                                            V
                                            V
                                            V
        Privileges
                                            ___________________________
         required for installing,
                                            VAXcluster
            1-3
                                              Bookreader post-install
        Problems
                                                 tasks, 3-1
         reporting,  1-6
                                              installing on,  1-2

        Index-2
        Index-2
        Index-2

 






        VMS components required,              starting the installation
          1-2                                    , 2-1
        VMSINSTAL procedure, 2-2              stopping the installation
          to 2-7                                 , 2-1
         command line,  2-2                   time needed to install,
         problem detection,  2-1                 2-1







































                                                                 Index-3
                                                                 Index-3
                                                                 Index-