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.
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
Section 3.4.6 explains how to complete an installation.
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 .)
) 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.
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.
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:
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:
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.