ZDDDDDDDDDDDDDDDDDD? IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; ZDDDDDDDDDDDDDDDDDD?
  3   Founded By:    3 :  Network Information Access   : 3   Founded By:    3
  3 Guardian Of Time 3D:            05APR90            :D3 Guardian Of Time 3
  3   Judge Dredd    3 :       Guardian Of Time        : 3   Judge Dredd    3
  @DDDDDDDDBDDDDDDDDDY :            File 13            : @DDDDDDDDDBDDDDDDDDY
           3           HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM<           3
           3           IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM;            3
           @DDDDDDDDDDD:  VMS System Manager's Manual :DDDDDDDDDDDDY
                       :         Chapter 03.11        :
                       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM<



                         Chapter 3  INSTALLING SOFTWARE

Any software product that you use on your system must be installed.  When you
install software, the software is made available every time that the system
starts up.  You must use an installation procedure for software when it is
first acquired, and you must also use the installation procedure for any
subsequent upgrades to the software.

On the VMS operating system, you use the command procedure
SYS$UPDATE:VMSINSTAL.COM to install most software products and any upgrades.
Use VMSINTAL.COM to install the most recent version of the VMS operating system
and any subsequent maintenance updates, and to install many optional software
products.

This Chapter describes the following:

:  How to Prepare your system for running VMSINSTAL

:  How to start VMSINSTAL

:  How to select appropriate VMSINSTAL options

:  What to do if the system fails while running VMSINSTAL

This chapter does not describe VMSINSTAL procedures that are specific to any
upgrade, update, or product.  The examples used are for illustration only.  For
details of a particular product, refer to the VMSINSTAL procedure described in
the installation documentation for the specific product or update.

3.1 PREPARING YOUR SYSTEM FOR VMSINSTAL

Before you use VMSINSTAL, do the following:

1.  Back up your system disk.  Use the backup copy as a working copy for the
    installation.

    If you back up your system disk to magnetic tape, you must restore the tape
    to a Files-11 disk to get a working copy.  The working copy has more
    contiguous space than the original system disk because of the way BACKUP
    creates the copy.  You might need this additional contiguous space during
    the installation.

2.  Log in at the console terminal under the SYSTEM account ( If SYSGEN
    parameters MOUNTMSG or DISMOUMSG are set to 1, OPCOM displays a message
    each time a disk or tape is mounted or dismounted.  If these messages are
    not disabled, and you are installing from an operator's terminal, they
    appear within 30 seconds of each mount or dismount. )

3.  Be sure that all users are logged out and that all batch jobs are
    completed.

4.  Keep users off the system using the following command:
    $ SET LOGINS/INTERACTIVE=0

5.  If your system includes it, you should shut down DECnet-VAX if DECnet-VAX
    would be affected by the software product that you are installing.  To shut
    down DECnet-VAX, do the following:

    A.  Start the Network Control Program ( NCP ):
        $ RUN SYS$SYSTEM:NCP

    B.  At the NCP prompt ( NCP> ), enter the following command and press
        RETURN:
        NCP> SET EXECUTOR STATE SHUT
        Decnet-VAX performs an orderly shutdown.  The opcom facility notifies
        you when DECnet-VAX is shut down.

    C.  At the NCP prompt, enter EXIT and press RETURN.

6.  Make sure the limits in the SYSTEM account authorization record are equal
    to or greater than the follow:
    Buffered byte count quota ( BYTLM ) = 20480
    Enqueue quota ( ENQLM ) = 200
    Direct I/O limit ( DIOLM ) = 18
    Open file quota ( FILLM ) = 18
    AST limit ( ASTLM ) = 24

    a.  To check these limits, run the Authorize Utility ( AUTORIZE ).  To
        run AUTHORIZE, enter the following commands and press RETURN after
        each one:

        $ SET DEFAULT SYS$SYSTEM ( RETURN )
        $ RUN AUTHORIZE ( RETURN )

    b.  At the UAF ( UAF> ), enter the following command and press RETURN:

        UAF> SHOW SYSTEM ( RETURN )

    AUTHROIZE displays the current limits of the SYSTEM account's user
    authorization file.

7.  If you need to modify the current limits, enter the AUTHORIZE command
    MODIFY in the following format and press RETURN:

    UAF> MODIFY SYSTEM/limit=new_value

    For example, to increase the DIOLM limit to 18, enter the following
    command and press RETURN:

    UAF> MODIFY SYSTEM/DIOLM=18

8.  When you have changed the limits, at the UAF prompt ( UAF> ) enter EXIT
    and press RETURN.  This returns you to the dollar-sign prompt ( $ ).  Your
    changes will not take effect until you log out and log in again.  ( See the
    Reference section for a description of the commands in the Authorize
    Utility. )

9.  Physically mount the first distribution medium that contains the software
    product.

3.1.1  STARTING VMSINSTAL

This section tells you how to start VMSINSTAL and describes options that you
can use.

When you start VMSINSTAL, it displays several prompts and messages that direct
and explain the installation.  These prompts and messages differ, depending on
the software product that you are installing.  Before you begin, make sure that
you read and understand the installation procedures for the specific product or
update.  If you need assistanced  during an installation, entering a question
mark ( ? ) at a prompt gives you an explanation of acceptable responses.

When you start VMSINSTAL, it asks if you are statisfied with the backup of your
system disk.  Make sure that the backup copy is fairly recent before you
continue.

If you have not statisfied all conditions required to start VMSINSTAL, it
desplays a warning message explaining the problem and a prompt asking if you
want to continue.  DIGITAL strongly recommends that you correct these
conditions before you try to start VMSINSTAL again.

NOTE:  If you continue without making the requrired corrections, DIGITAL might
NOT support the resulting installation.

To start VMSINSTAL, enter a command in the following format and press RETURN:

$ @SYS$UPDATE:VMSINSTAL product-list source:  [OPTIONS option-list] -
_$ [destination] [qualifiers]

The following sections describe the parameters and the keyword that you must
supply in this command.

3.1.1.1 SELECTING A PRODUCT-LIST

This parameter lists the products that you want to install.  If you use a
wildcard character ( * ), all versions and updates of all products from the
distribution media will be installed in alphabetical order.

If you want to specify more than one item in the product list parameter, you
must separate the items using commas and no intervening spaces.  Specify the
product list in the following format:

facvvu

fac     The product name code ( 1 to 36 alphanumeric characters )
vv      The major version number ( 2 digits )
u       The update number ( 1 digit )

For example, if you upgrade your operating system to VMS Version 5.2, the
product name ( fac ) is VMS, the major version ( vv ) is 05, and the update
number ( u ) is 2.  Therefore the porduct-list parameter is VMS052.

Using this format, you can install a specific version and update of a product
form distribtuion media containing several versions and updates.  If you do not
include a version or update number, all versions and updates from the source
are installed in alphabetical order.

If you omit the product-list parameter, VMSINSTAL asks you for it.

If you are installing from a distribution kit, the list of products on your
distribution media is included with the bill of materials for the distribution
kit.  If the list is not available, enter a DIRECTORY command so that the
distribution media will find the products that are included.  To obtain the
product list, enter commands int he following format and press RETURN after
each one:

$ MLUNT/OV=ID ddcu:
$ DIRECTORY ddcu: [0,0]

Where ddcu is the drive that holds the distribution media.  If you are
installing from a disk directory, obtain the product list by entering a
DIRECTORY command, sepcifying the disk directory in the following format and
pressing RETURN.

$ DIRECOTY node::drive:[directory]

If you are accessing a remote node, you must have READ and EXECUTE (R,E) access
to the directory.

3.1.1.2 SELECTING THE SOURCE

This parameter identifies the source of the optional software product as one of
the following:

:  A drive tha holds the distribution media; for example, the RX50 drive
   disignated CSA2: ona  VAX 8200.

:  A disk directory to which the product save set has been transferred from the
   distribution media for later installation.

   You specify a disk directory as the source when you select the GET SAVE SET
   option.  For more information about this option see Section 3.1.3.

:  A disk directory on another node.

You also can use a logical name to specify the source.  If you do not specify
the source VMSINSTAL asks you for it.

3.1.1.3  SELECTING OPTIONS.

This keyword is optional.  It precedes the list of options to be installed.  If
you enter an option list without the OPTIONS keyword, VMSINSTAL displays an
informational error message and the installation ends.

The options-list parameter lists the options requested.  The VMSINSTAL command
procedure permits the use of five options.  You specify each option by entering
the appropriate option letter after the keyword OPTIONS in the command that
starts VMSINSTAL.

If you specify more than one option, do not separate the letters with spaces or
commas.  For more information on choosing VMSINSTAL options see Section 3.1.3.

3.1.1.4 SELECTING THE DESTINATION

This parameter is optional.  By default, VMSINSTAL assumes that the product is
to be installed in the system-specific directory root on the system disk.

There are two instances in which you must use this parameter:

:  If you want to install the product in an alternate root.  The product is
   installed on a system root other than that on which the target system is
   running.  Specify the alternate system root in the following format:

   ddcu:[SYSn.]

   ddcu    --    The device on which the alternate root resides.
   SYSn.   --    The top-level directory of the alternate system root.

   You also may specify a previously defined logical name for the alternate
   root.

:  If you specify the GET SAVE SET option to copy the product kit save sets
   into a storage directory for later installation.  For more information on
   the GET SAVE SET optionj, see Section 3.1.3.

   Specify the destination directory in the following format:

   [node::]ddcu:[directory]

   node    --    a node remote from the target system ( DECnet software must be
                 installed on your system to use this option.)  If you do not
                 specify a node, VMSINSTAL assumes that the product save sets
                 are to be stored on the local node.
   ddcu    --    The destination disk device.
   directory --  Usually, a directory dedicated to product save sets on the
                 specified disk.

3.1.1.5  QUALIFYING THE BACKUP COMMAND

You can specify this parameter along with the GET SAVE SET option to qualify the
BACKUP command further.  The BACKUP command copies the save sets to the
destination directory.

The following example includes the GET SAVE SET option and BACKUP qualifiers:

$  @SYS$UPDATE:VMSINSTAL  TEST042 DUA0: [KITS] OPTIONS G DUB0: [KITS] -
_$ "/VERFIFY/LOG/CONFIRM"

3.1.2  WHEN THE INSTALLATION IS COMPLETE

When the installation is complete, VMSINSTAL does one of the following,
depending on the requirements of the product you have installed:

:  Performs an automatic shutdown of the system and instructs you to reboot
   manually

:  Returns you to the dollar-sign prompt ( $ )

When the product is installed, back up the updated system disk.

3.1.3  CHOOSING VMSINTAL OPTIONS

The VMSINSTAL command procedure permits the use of five options:

:  Auto-answer option    ( A )
:  Get save set option   ( G )
:  File log option       ( L )
:  Release notes option  ( N )
:  Alternate root option ( R )

To specify each option, do the following:

:  Enter the appropriate option letter after the keyword OPTIONS in the command
   line that starts VMSINSTAL.

:  Press RETURN.

If you specify more than one option, do NOT separate the letters with commas or
spaces.  For example:

$  @VMSINSTAL product source:  OPTIONS AN

3.1.3.1  AUTO-ANSWER ( A )

The AUTO0ANSWER option makes it easier to reinstall a product by providing
responses to VMSINSTAL questions and prompts during the reinstallation.  You
use the AUTO0ANSWER option most often to reinstall products after an upgrade.

If you specify the AUTO-ANSWER option when you install a product, an aswer file
is created in the form product.ANS in the SYS$UPDATE directory, where product
is the product-list parameter that you provide when you start VMSINSTAL.

The file type of an answer file is .ANS.  The answer file contains a record of
your responses to questions and prompts from VMSINSTAL.  For example, if you
install the product, NEWAID, with the AUTO-ANSWER option, VMSINSTAL creates an
answer file designated NEWAID.ANS.

When you reinstall the product and specify the AUTO-ANSWER option ( typically
after upgrading your operating system ), VMSINSTAL reads the answer file
instead of asking you questions.

If you want to create a new answer file when you reinstall a product, you must
delete the existing answer file first.

3.1.3.2  GET SAVE SET ( G )

Installing products either from a distribution tape or from console media
directly onto your system disk is time-consuming.  The GET SAVE SET option
saves you time by allowing you to store product save sets temorarily on a
magnetic tape or in a disk directory.

You might consider dedicating a user disk on a node that other licensed system
users can access.  You can store product save sets on this dedicated user disk
to give other licensed system users fast access to the product save-set
directory.

To store a product save set on a disk directory using the GET SAVE SET option,
enter a command in the following format and press RETURN:

$  @SYS$UPDATE: VMSINSTAL product-list soruce: -
$ _OPTIONS G device:[DIRECTORY]

NOTE:  The directory that you specify must exist, and the device must be
mounted; VMSINSTAL does NOT perform any CREATE/DIRECTORY or MOUNT operations.

You specify the disk immediately after the OPTIONS G parameter.  For example,
if you are storing save sets for a product named NEWAID from the console drive
into disk directory USER1:[PRODUCTS], enter the following command and press
RETURN:

$ @SYS$UPDATE: VMSINSTALL NEWAID CSA1:  OPTIONS G -
$_USER1: [PRODUCTS]

VMSINSTAL creates one or more files to store the product save set in the disk
directory.  The save set file name has the following format:

facvvu.x

fac    --    The product name code ( 1 to 36 alphanumeric characters).
vv     --    The major version number ( 2 digits ).
u      --    The update number ( 1 digit ).
x      --    A literal extension that is used to identify save set files, where
             A is the first save set, B the second, and so forth.

NOTE:  Valid extensions for save set files include the literal range A through
Z and the numberic range VMI_0027 throught VMI_9999.

For example, suppose you are storing update 1 to Version 2.0 of the product,
NEWAID, and this process requires four save sets.  VMSINTAL creates the
following four files:

         NEWAID021.A
         NEWAID021.B
         NEWAID021.C
         NEWAID021.D

When you want to install the product on your system, enter a command in the
following format and press RETURN:

$ @SYS$UPDATE:VMSINTAL product-list device:[Directory]

For the product NEWAID, enter this command and press RETURN:

$ @SYS$UPDATE:VMSINSTAL NEWAID USER1:[PRODUCTS]

VMSINSTAL installs the NEWAID product on your system disk.

3.1.3.3 FILE LOG ( L )

The FILE LOG option logs all file activity to the terminal during installation.
File activity is defined as any action that alters the disposition of a file,
such as creating a new file, updating a library, or deleting a file.

3.1.4 RELEASE NOTES ( N )

Use the RELEASE NOTES option to display or print the online release notes file
supplied by the layered product.

NOTE:  Not all layered products provide online release notes.

The person who builds the product kit names the release notes file.  The
release notes file is given the file name facvvu.release_notes, where facvvu
represents the product name code, version, and update numbers.

If release notes are available and you specify option N, VMSINSTAL asks you the
following questions.  ( The default answeres are indicated in brackets ).

Release Notes OPtions:

    1.  Display release notes
    2.  Print release notes
    3.  Both 1 and 2
    4.  Copy release notes to SYS$HELP
    5.  Do NOT display, print, or copy release notes

*Select option [2]:
*Queue name [SYS$PRINT]:
*Do you want to continue the installation [N]:

:  The first prompt ( *SELECT OPTION ) allows you to choose options 1 - 5.
:  The second prompt ( *QUEUE NAME ) Is displayed only if you select option 2
   or option 3.  If you enter the name of a print queue, the system displays a
   message saying that the release notes have been queued successfully to the
   printer.  if you do not specify a print queue, the release notes are sent to
   SYS$PRINT by default.
:  The third prompt ( *DO YOU WANT TO CONTINUE THE INSTALLATION) allows you
   either to continue or to end the installation.  The default is to end the
   installation.

If release notes are not supplied with the product, VMSINSTAL displays two error
messages.  It also asks whether you want to continue or to end the
installation, as follows:

%VMSINSTAL-W-NOFILE, New File facvvu.RELEASE_NOTES does not exist.
%VMSINSTAL-W-NORELNOTE, unable to locate release notes.

*Do you want to continue the installation [N]:

To continue the installation ( Whether or not release notes are available ),
type Y ( for YES ) and press RETURN.

3.1.4.1 ALTERNATE ROOT ( R )

The ALTERNATE ROOT option lets you install the product to a system root other
than that of the running system.  The VMS operating system in the alternate
root must be complete and the same version/update level as the running system.
All files and software products that the product installation refers to must be
present in the alternate root.

NOTE:  Not all optional software products allow a product to be installed to an
alternate system root.

Consult the documentation of the specific product to determine whether the
product can be installed to an alternate system root.

If you specify option R, the product is installed on the alternate root.
However, you cannot create accounts or request a system reboot.

3.1.5 RECOVERING FROM A SYSTEM FAILURE

If the system fails during installation of an update or optional software
product, VMSINSTAL attempts to continue the installation upon rebooting.
Depending on when the system failed, one of three conditions exists:

:  The system disk was not altered before the system failure.  In this case,
   VMSINSTAL instructs you to restart the installation.

:  The system disk or library used by the installation was corrupted.  In this
   case, VMSINSTAL instructs you to retore either the system disk or the
   corrupted library from the backup copy and to restart the installation.

:  VMSINSTAL continues the installation.  In this case, VMSINSTAL performs most
of the installation.  Also, it may tell you that you must perform some tasks
manually to complete the installation.  If VMSINSTAL instructs you to do so, do
the following:
    A:  Reboot the system
    B:  Log in as system manager
    C:  Purge all system files that have been replaced, even if you requested
        an automatic purge.
        $  PURGE/LOG SYS$SYSROOT:[*...]*.*


                                [ END OF 03.11 ]

[OTHER WORLD BBS]