[next] [previous] [contents]

  3.4 Running VMSINSTAL.COM
  Before you run VMSINSTAL.COM, note the following:

  .
        Read the installation instructions for the specific product
        or update. If you need assistance during an installation,
        enter a question mark ( ? ) for an explanation of possible
        responses.
  .
        When you first start VMSINSTAL.COM, the procedure
        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.
  .
        When the procedure asks if you are satisfied with the
        backup of your system disk, back up your system disk be-
        fore continuing with the installation if you do not have a
        recent backup of your system disk.
  .
        If you do not satisfy all conditions required to start
        VMSINSTAL.COM, the procedure displays a warn-
        ing message explaining the problem and asks you if
        you want to continue. Digital strongly recommends
        that you satisfy these conditions before you try to start
        VMSINSTAL.COM again.



                                          Caution

        If you continue the procedure without making the re-
        quired corrections, Digital cannot guarantee that the
        installation will be supported.

  How to Perform This Task
  To run VMSINSTAL.COM, enter a command in the follow-
  ing format:
  @SYS$UPDATE:VMSINSTAL product-list source: [OPTIONS option-list]
  [destination] [qualifiers]

  Example
  $ @SYS$UPDATE:VMSINSTAL CALENDAR020 MUA0:
  The command in this example installs the product CALENDAR,
  from save sets named CALENDAR020, on a magnetic tape
  on the MUA0: drive. (This command shows the simplest
  case, in which you use no options or qualifiers.)

  The following sections explain required and optional parame-
  ters in the VMSINSTAL.COM command line:


  Parameter Section



  Product list
Section 3.4.1
  Source Section 3.4.2
  Options Section 3.4.3
  Destination Section 3.4.4
  Backup qualifiers Section 3.4.5 and Section 3.6.3.3

  Section 3.4.6 explains how to complete an installation.

  3.4.1 Selecting a Product List

  Products are stored in a save set , which is a specially for-
  matted file that contains a group of files. Installation and
  upgrade procedures move the files from the save set to your
  system disk.

  The product-list parameter lists the products that you want
  to install. You can use this parameter when you install lay-
  ered products or update the operating system. (When you
  perform an upgrade procedure, you can list only one product,
  VMSvvu
.)



                                            Note

        Do not use the wildcard character (
                                                            *

                                                              ) if you are
        installing layered products and updating the oper-
        ating system at the same time. In this case, update
        the system first. If you use the wildcard character,
        VMSINSTAL sorts the product list in alphabetical
        order; the operating system would probably not be
        installed first.



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

  Table 3-3 explains the format of facvvu . Using this format,
  you can install a specific version and update of a product
  from distribution media containing several versions and up-
  dates. If you do not include a version and update number, all
  versions and updates to the specified product from the source
  are installed in alphabetical order.

  If you are installing from a distribution kit, the list of prod-
  ucts on your distribution media is included with the bill of
  materials for the distribution kit. If the list is not available,
  you can obtain one by using the DIRECTORY command; the
  distribution media then finds and displays the products that
  are included.

  How to Perform This Task
  To obtain the product list, enter commands in the following
  format:
  MOUNT/OVERRIDE=ID device:
  DIRECTORY device:[0,0]

  Device is the drive that holds the distribution media.
If you are installing from a disk directory, obtain the product
  list by entering the DIRECTORY command, specifying the
  disk directory in the following format:
  DIRECTORY node::device:[directory]

  Examples
  1.

        $ MOUNT/OVERRIDE=ID MUA0:
        %MOUNT-I-MOUNTED, VMS060 mounted on _MUA0:
        $ DIRECTORY MUA0:[0,0]
        The DIRECTORY command in this example directs the
        distribution media to find the products included on the
        MUA0: drive; for example:
        Directory MUA0:[000,000]
        000000.DIR;1 BACKUP.SYS;1 BADBLK.SYS;1 BADLOG.SYS;1
        BITMAP.SYS;1 CONTIN.SYS;1 CORIMG.SYS;1 DECW060.C;1
        DECW060.D;1 DECW060.E;1 DECW060.F;1 INDEXF.SYS;1
        ISL_SCRIPT.ESS;1 SECURITY.SYS;1 SYS0.DIR;1 VMS060.A;1
        VMS060.B;1 VMS060.C;1 VMS060.D;1 VMS060.E;1
        VMS060.F;1 VOLSET.SYS;1
        Total of 22 files.
  2.

        $ DIRECTORY BRAVO::DUA1:[0,0]
        The DIRECTORY command in this example directs
        the distribution media to find the products on the node
        BRAVO, which is on the DUA1: device.



                                            Note

        If you want to access a remote node, you must have
        read and execute access (R,E) to the directory.

  3.4.2 Selecting the Source
  The source parameter identifies the source of the optional
  software product as one of the following:

  .
        A drive that holds the distribution media; for example, a
        TK50 drive designated as the MUA0: drive.
  .
        A disk directory to which the product save set has been
        transferred from the distribution media for later installa-
        tion.

        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.6.3.
  .
        A disk directory on another node.

  You can also use a logical name to specify the source. If you
  do not specify the source, VMSINSTAL.COM asks you for it,
  as follows:
  * Where will the distribution volumes be mounted:

  3.4.3 Selecting Options
  The VMSINSTAL.COM command procedure permits the
  use of six options.
Table 3-4 briefly describes each option.
  Section 3.6 contains a detailed description of each option.

  You specify each option by entering the appropriate option
  letter after the keyword OPTIONS in the command that
  starts VMSINSTAL.COM. The OPTIONS keyword is op-
  tional. However, if you have an option list, you must enter
  OPTIONS before it. If you enter an option list without the
  OPTIONS keyword, VMSINSTAL.COM displays an in-
  formational error message and the installation ends. (The
  option-list
parameter lists the options requested.)

  How to Perform This Task
  To specify each option:

  1. Invoke the VMSINSTAL.COM procedure, entering ap-
        propriate option letters after the keyword OPTIONS.
  2. Press Return.

  If you specify more than one option, separate the options with
  commas. Do not separate the options with spaces.

  Example
  $ @VMSINSTAL.COM NEWAID021 MTA0: OPTIONS A,N

  3.4.4 Selecting the Destination
  The destination parameter is optional. By default,
  VMSINSTAL.COM assumes that the product is to be in-
  stalled in the system common directory SYS$COMMON on
  the system disk. However, you must use this parameter in
  the following two instances:

  .
        To install the product in an alternate root. The product is
        installed on a system disk other than that on which the
        target system is running. Specify the alternate system
        root in the following format:
        device:[SYSn.]

        where:

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

        You can also specify a previously defined logical name for
        the alternate root.
  .
        To copy the product kit save sets into a storage directory
        for later installation. For more information on the Get
        Save Set option, see
Section 3.6.3.

        Specify the destination directory in the following format:
        device:[directory]

        where:

        device
The destination disk device
        directory
Usually a directory dedicated to product save sets on
                        the specified disk

  3.4.5 Verifying, Logging, and Confirming the Operation
  The VMSINSTAL.COM command procedure includes a
  BACKUP command that copies the save sets to the des-
  tination directory. You can verify, log, and confirm the
  copy operation by specifying BACKUP qualifiers with the
  VMSINSTAL.COM Get Save Set option. See
Section 3.6.3 for
  more information.

  3.4.6 Completing the Installation
  When the installation is complete, VMSINSTAL.COM does
  one of the following, depending on the requirements of the
  product you have installed:

  .
        Performs an automatic shutdown of the system; you
        might be instructed to reboot manually.
  .
        Returns you to the system prompt.

  When the product is installed, back up the updated system
  disk. For instructions, see
Section 10.17.