skip book previous and next navigation links
go up to top of book: HP OpenVMS System Manager's Manual, Volume 1:... HP OpenVMS System Manager's Manual, Volume 1:...
go to beginning of chapter: Installing, Upgrading, and Updating Software Installing, Upgrading, and Updating Software
go to previous page: Preparing Your System to Run VMSINSTAL.COM Preparing Your System to Run VMSINSTAL.COM
go to next page: Recovering from a System FailureRecovering from a System Failure
end of book navigation links

Running VMSINSTAL.COM  



Before you run VMSINSTAL.COM, note the following points:

How to Perform This Task

To run VMSINSTAL.COM, enter a command in the following 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 parameters in the VMSINSTAL.COM command line:

Parameter Section
Product list
Selecting a Product List
Source
Selecting the Source
Options
Selecting Options
Destination
Selecting the Destination
Backup qualifiers
Verifying, Logging, and Confirming the Operation and Specifying Backup Qualifiers

Completing the Installation explains how to complete an installation.

Selecting a Product List  

Products are stored in a save set, which is a specially formatted 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 layered products or update the operating system. (When you perform an upgrade procedure, you can list only one product, VMSvvu.)


NoteDo not use the wildcard character (*) if you are installing layered products and updating the operating 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

Format of facvvu Save-Set File Name 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 updates. 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.

Table 1   Format of facvvu Save-Set File Name
fac
The product name code (1 to 36 alphanumeric characters)
vv
The major version number (2 digits)
u
The minor version number (1 digit), also known as update number

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, 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]

where device is the drive that holds the distribution media.

If you are installing from a disk directory, obtain the product list by entering DIRECTORY and specifying the disk directory in the following format: DIRECTORY node::device:[directory]

Examples

  1. $ MOUNT/OVERRIDE=ID MUA0:
    %MOUNT-I-MOUNTED, VMS071       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        DECW071.C;1
    DECW071.D;1         DECW071.E;1         DECW071.F;1         INDEXF.SYS;1
    ISL_SCRIPT.ESS;1    SECURITY.SYS;1      SYS0.DIR;1          VMS071.A;1
    VMS071.B;1          VMS071.C;1          VMS071.D;1          VMS071.E;1          
    VMS071.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.

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

Selecting the Source  

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

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:

Selecting Options  

The VMSINSTAL.COM command procedure permits the use of six options. VMSINSTAL.COM Options briefly describes each option. Selecting VMSINSTAL.COM Options in Detail contains a detailed description of each option.

Table 2   VMSINSTAL.COM Options
Letter Choice Option Description
A
Autoanswer
Makes it easier to reinstall a product after an upgrade by providing responses to the questions and prompts during the reinstallation. (Specify this option only when installing layered products.)
AWD=
Alternate Working Device
Lets you specify an alternate working device for the temporary working directory. (You can specify this option when installing layered products or applying updates.)
G
Get Save Set
Saves you time by allowing you to store product save sets temporarily on a magnetic tape or in a disk directory. (Specify this option only when installing layered products.)
L
File Log
Logs all file activity to the terminal during installation.
N
Release Notes
Displays or prints the online release notes file supplied by the layered product.
R
Alternate Root
Lets you install the product on a system disk other than that of the running system.

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 optional. 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 informational 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 appropriate 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

Selecting the Destination  

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

Verifying, Logging, and Confirming the Operation  

The VMSINSTAL.COM command procedure includes a BACKUP command that copies the save sets to the destination directory. You can verify, log, and confirm the copy operation by specifying BACKUP qualifiers with the VMSINSTAL.COM Get Save Set option. See Using the Get Save Set Option (G) (Layered Products Only) for more information.

Completing the Installation  

When the installation is complete, VMSINSTAL.COM performs one of the following actions, depending on the requirements of the product you have installed:

When the product is installed, back up the updated system disk. For instructions, see Backing Up and Restoring the System Disk.


go to previous page: Preparing Your System to Run VMSINSTAL.COM Preparing Your System to Run VMSINSTAL.COM
go to next page: Recovering from a System FailureRecovering from a System Failure