1 Getting Started

This chapter defines key terms and describes preliminary procedures you must perform before an installation or upgrade to version 7.3–1 of the OpenVMS Alpha operating system.

1.1 Key Terms

The following are a few key terms you need to know before you install or upgrade the system:

Table 1–1 Definitions of Terms

Term	Definition
Operating system CD–ROM	The CD–ROM containing the OpenVMS Alpha operating system.
HSx device	A self-contained, intelligent, mass storage subsystem that lets computers in an OpenVMS Cluster environment share disks. The disk on which you install or upgrade the operating system can be connected to one of these systems (for example, an HSC or HSD).
InfoServer	A general-purpose disk storage server that allows you to use the operating system CD–ROM to install the operating system on remote client systems connected to the same local area network (LAN).
Local drive	A drive, such as an RRD42 CD–ROM drive, that is connected directly to an Alpha computer. If you have a standalone Alpha computer, it is likely that all drives connected to the system are local drives.
Source drive	The drive that holds the operating system CD–ROM during the upgrade or installation.
System disk	The disk that contains (or will contain) the OpenVMS Alpha operating system. The installation or upgrade procedure transfers the OpenVMS Alpha operating system from the operating system CD–ROM on the source drive to the system disk.
Target drive	The drive that holds the system disk during the upgrade or installation.

1.2 Examining Software and Hardware Components

Before beginning an installation or upgrade, be sure you have all the required hardware and software components, as described in the following sections.

1.2.1 Hardware Components

Before you begin an installation or upgrade, do the following:

• Be sure the hardware has been installed and checked for proper operation. For detailed information, see the hardware manuals you received with your Alpha computer.

• Be sure you know how to turn on and operate the components of your system, including the system unit, console, monitor, drives, terminals, and printers. If necessary, read the hardware manuals that came with these components.

• Set up your system to record the installation procedure on either a hardcopy terminal or a printer attached to the console terminal. (See your hardware manuals for more details about connecting those components to your system.) If you do not do this, the screen messages will be lost. You will need a transcript in case there is a problem during the installation.

1.2.2 Software Components

Before you begin an installation or upgrade, do the following:

• Be sure you have all the items listed on the bill of materials in the distribution kit. If your distribution kit is incomplete, notify your Compaq support representative and request priority shipment of any missing items.

• Before installing the OpenVMS Alpha operating system software, review all cover letters and release notes.

1.2.3 Operating System CD–ROM

Included in your kit is the OpenVMS Alpha operating system CD–ROM, which you use to install or upgrade the operating system, or to perform operations such as backing up the system disk. The CD–ROM is labeled similar to the following:

CD–ROM Label:	OpenVMS Alpha V7.3–1 Operating System
Volume Label:	ALPHA0731

$Q:\adept8\entities\note.eps$ Note

The volume label is the machine-readable name that the OpenVMS Alpha operating system and InfoServer systems use to access the CD–ROM.

1.2.4 Firmware Revision Checking

OpenVMS Alpha Version 7.3–1 provides enhanced firmware checking for systems during a boot operation. When you boot the OpenVMS Alpha operating system CD-ROM, the system automatically checks the version of console firmware, which includes PALcode, that is running on your computer. The system also provides more explicit information about how to upgrade the firmware. Previously, only the PALcode version was checked and the informational messages were less specific.

If you do not have the required version of console firmware, the system displays a message similar to the following:

%SYSBOOT-F-FIRMREV, Firmware rev. nnn is below the absolute minimum of nnn.
Please update your firmware to the recommended revision nnn, which can be found on the firmware CD labeled:
Alpha Systems Firmware Update Vn.n.

If you do not have the recommended version of console firmware, the system displays a message similar to the following:

%SYSBOOT-W-FIRMREV, Firmware rev.nnn is below the recommended minimum of nn.
                    Please update your firmware to the recommended revision,
                    which can be found on the firmware CD labeled:
                    Alpha Systems Firmware Update Vn.n.

The latest console firmware CD-ROM is included with your kit.

$Q:\adept8\entities\note.eps$ Note

Once you install this version of the OpenVMS Alpha operating system, the firmware check (similar to the previous PALcode check) will occur each time you reboot the system.

1.2.5 Device Naming Conventions

When you perform specific operations, you are asked to specify device names for the source drive and target drive. When specifying those device names, note the following naming conventions:

• When the source drive is a local CD–ROM drive, the device name is similar to the following:

DKA400

• When the source drive is a CD–ROM drive connected to the InfoServer, the device name is always the following:

DAD1

• When the target drive is a local disk, the device name is similar to the following:

DKA0:

Note the following conventions:

– DK is the device code of the boot device.

– A is the boot device controller designation.

– 0 is the unit number of the boot device.

• On Alpha systems configured in certain OpenVMS Cluster or HSx environments, the device naming convention is similar to the following:

DUA20.14.0.2.0

The values you specify identify components such as the boot device, controller, unit number of the boot device, HSx controller node number, and channel numbers. Because these values vary depending on your specific hardware configuration, refer to the owner, operator, and technical service manuals that came with your computer for detailed information.

1.3 Using the Operating System CD–ROM

The following sections describe how you use the operating system CD–ROM to install, upgrade, and modify your system disk.

1.3.1 Using the Menu

The OpenVMS Alpha operating system CD–ROM includes a menu system that allows you to easily upgrade or install the operating system and to perform related operations such as backing up the system disk, installing layered products, and removing or reconfiguring products. This command procedure starts automatically when you boot the OpenVMS Alpha operating system CD–ROM, displaying a menu from which you choose options to perform the following tasks:

• Install or upgrade the operating system from the CD–ROM.

• Display a list of products that can be installed from the CD–ROM.

• Install or upgrade layered products from the CD–ROM.

• Show which products are installed on your system.

• Reconfigure layered products installed on your system.

• Remove products.

• Enter a DCL environment from which you can perform preinstallation or maintenance tasks such as mounting or showing devices and backing up or restoring files on the system disk.

• Shut down the system.

Review the following sections to understand how the menu works. You will then be prepared to choose appropriate menu options when you are asked to do so before, during, and after an installation or upgrade.

1.3.2 Sample Menu Display

The following is a sample display of the menu:

    OpenVMS (TM) Alpha Operating System, Version 7.3-1

    Copyright (c) 2002 -- All rights reserved.

    Compaq Information Technologies, L.P.

    Installing required known files...

    Configuring devices... 

    ***************************************************************
    You can install or upgrade the OpenVMS Alpha operating system
    or you can install or upgrade layered products that are included
    on the OpenVMS Alpha operating system CD-ROM. 

    You can also execute DCL commands and procedures to perform
    "standalone" tasks, such as backing up the system disk. 

    Please choose one of the following:

        1)  Upgrade, install or reconfigure OpenVMS Alpha Version 7.3-1
        2)  Display products and patches that this procedure can install
        3)  Install or upgrade layered products and patches
        4)  Show installed products         
        5)  Reconfigure installed products
        6)  Remove installed products
        7)  Execute DCL commands and procedures
        8)  Shut down this system            
        
Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?)

1.3.3 How the Install or Upgrade Option Works

The OpenVMS installation and upgrade options implement a POLYCENTER Software Installation (PCSI) utility concept called a platform. The OpenVMS Alpha platform contains the OpenVMS Alpha operating system, plus options for certain other products, including DECwindows Motif, DECnet-Plus, DECnet Phase IV, TCP/IP Services for OpenVMS, and Common Data Security Architecture (CDSA). Including these products in the OpenVMS Alpha platform allows you to install or upgrade these products along with the OpenVMS Alpha operating system.

You can look at the platform Product Definition File (PDF) itself. This file is located in [VMS$COMMON] on the OpenVMS operating system CD-ROM. The file has a name similar to DEC-AXPVMS-OVMS-Vnnnn-n.PCSI$DESCRIPTION, where the variables indicate the version number.

Once you select which of the optional products you want to install, information is retained in the database maintained by the PCSI utility. This information allows future OpenVMS upgrades to select the correct default choices for these optional products.

When you choose the install or upgrade option (1) from the menu, the system asks whether you want to preserve or initialize the system disk. The display is similar to the following:

   There are two choices for Installation/Upgrade:

   INITIALIZE - Removes all software and data files that were         
       previously on the target disk and installs OpenVMS Alpha.      

   PRESERVE -- Installs or upgrades OpenVMS Alpha on the target disk 
       and retains all other contents of the target disk.

   * Note: You cannot use PRESERVE to install OpenVMS Alpha on a disk on
        which OpenVMS VAX or any other operating system is installed.

Do you want to INITIALIZE or to PRESERVE? [PRESERVE]

1.3.3.1 Specifying the INITIALIZE Option

When you specify the INITIALIZE option, the following operations take place:

• All software and data files that were previously on the target disk are removed.

• The operating system is installed.

Specify the INITIALIZE option and perform a full installation under the following conditions:

• If your Alpha computer is new (it has never had any version of the operating system running on it, including factory-installed software).

• If your Alpha computer is running a version of the OpenVMS Alpha operating system and you want to overwrite the entire contents of the system disk (the operating system, application software, and user files).

• If you want to create a new system disk but keep the old one (if you want to alternate between the two).

• If you are running the OpenVMS Alpha operating system but cannot upgrade. For example, if you changed the names of system directories on the system disk, the upgrade procedure will not work correctly. Therefore, unless you chose to restore the system disk to its original directory structure, you would have to reinstall the operating system.

1.3.3.2 Specifying the PRESERVE Option

When you specify the PRESERVE option, the following operations take place:

IF ...	THEN ...
the OpenVMS Alpha operating system is not already installed on the target disk,	the following operations take place: • The operating system is installed. • All other contents of the target disk are retained.
the OpenVMS Alpha operating system is installed on the target disk,	the operating system is upgraded, as follows: • Old operating system files and new files are merged or replaced. • All other contents of the target disk are retained.

$Q:\adept8\entities\note.eps$ Note

If you intend to choose the PRESERVE option (because there are certain files on the disk that you want to retain), Compaq recommends that you first make a backup copy of your system disk. If there is any problem during the installation or upgrade that might affect the integrity of the disk, you will have the backup copy as a safeguard.

If you choose the PRESERVE option and choose a target disk that already contains the OpenVMS Alpha Version 7.3–1 software, you are provided with the option to either reconfigure or reinstall the OpenVMS Alpha operating system. Reconfigure the operating system if you want to change the options you chose to include when the operating system was installed. Reinstall the operating system if you think that your system files may have become corrupted.

See Section 8.9 for additional configuration information.

1.3.4 How the Layered Products Options Work

After you have installed or upgraded the operating system, you can use the menu to show, install, reconfigure (change previously selected options for a layered product), or remove products as well.

$Q:\adept8\entities\note.eps$ Note

When you boot the OpenVMS Alpha operating system CD–ROM and select the option to install layered products, that installation procedure does not run the Installation Verification Procedure (IVP) for layered products. Because the operating system is booted from the CD–ROM and the layered products are installed on a different device (the target drive), the IVPs cannot execute correctly. However, you can run the IVP for each layered product after you boot the target system (see the layered product installation documents for information on running the IVP).

1.3.5 How the DCL Option Works

When you choose the DCL option (7) from the menu, you can use a subset of DCL commands (such as SHOW DEVICE, MOUNT, and BACKUP) to perform specific preinstallation and maintenance operations. Note, however, that this is a restricted DCL environment in that certain DCL commands (such as PRODUCT) and certain utilities (such as VMSINSTAL) will not function as expected because you are booting from read-only or write-locked media and because the full system startup is not performed.

A triple dollar sign system prompt ($$$) indicates that you are in this restricted DCL environment, as shown in the following example:

$$$ SHOW DEVICE

To exit from the DCL environment and return to the main menu, enter the LOGOUT command.

1.3.6 How the Shutdown Option Works

When you choose the shutdown option (8) from the menu, your system shuts down and you are returned to the console prompt (>>>). The system displays a message similar to the following:

    Shutting down the system

        SYSTEM SHUTDOWN COMPLETE

1.4 Making the Install/Upgrade/Backup Selection

Now that you have reviewed key terms, examined hardware and software requirements, and learned how to use the menu system included on the OpenVMS Alpha operating system CD–ROM, you can do the following:

IF ...	THEN ...
you want to install the operating system in an OpenVMS Cluster environment,	go to Chapter 2, Preparing to Install in an OpenVMS Cluster Environment.
you want to install the operating system in a nonclustered environment,	go to Chapter 3, Installing the OpenVMS Alpha Operating System.
you want to upgrade the operating system in any environment,	go to Chapter 5, Before Upgrading the OpenVMS Alpha Operating System.
you want only to back up or restore your system disk,	go to Appendix B.

2 Preparing to Install in an OpenVMS Cluster Environment

This chapter contains information that you should review before performing an installation in an OpenVMS Cluster environment.

Before installing the operating system in an OpenVMS Cluster environment, be sure you review any relevant OpenVMS Cluster information contained in the following documents:

• The cover letters and the software product descriptions included with your distribution kit

• OpenVMS Alpha Version 7.3–1 New Features and Documentation Overview

• OpenVMS Alpha Version 7.3–1 Release Notes

Be sure the following sources of information are available as well:

• OpenVMS Cluster Systems manual

• Guidelines for OpenVMS Cluster Configurations

• Your network or system manager

2.1 Mixed-Version Support

OpenVMS Alpha Version 7.3–1 and OpenVMS VAX Version 7.3 provide two levels of support for mixed-version and mixed-architecture OpenVMS Cluster systems. These two support types are warranted and migration.

Warranted support means that Compaq has fully qualified the two versions coexisting in an OpenVMS Cluster and will answer all problems identified by customers using these configurations.

Migration support is a superset of the Rolling Upgrade support provided in earlier releases of OpenVMS and is available for mixes that are not warranted. Migration support means that Compaq has qualified the versions for use together in configurations that are migrating in a staged fashion to a newer version of OpenVMS VAX or OpenVMS Alpha systems. Problem reports submitted against these configurations will be answered by Compaq. However, in exceptional cases, Compaq may request that you move to a warranted configuration as part of the solution.

Compaq supports only two versions of OpenVMS running in a cluster at the same time, regardless of architecture. Migration support helps customers move to warranted OpenVMS Cluster pairs. Table 2 –1 shows the level of support provided for all possible version pairings.

Table 2–1 OpenVMS Cluster Warranted and Migration Support

	Alpha V7.3x and VAX V7.3	Alpha V7.2-x^{1 (SEE NOTE)} and VAX V7.2
Alpha V7.3x and VAX V7.3	WARRANTED	Migration
Alpha V7.2-x¹ and VAX V7.2	Migration	WARRANTED

In a mixed-version cluster, you might need to install remedial kits on earlier versions of OpenVMS. For a complete list of required remedial kits, see the OpenVMS Alpha Version 7.3–1 Release Notes.

2.2 OpenVMS Cluster Information You Will Need

If during the installation you answer YES to the system prompt asking whether your system will be a member of an OpenVMS Cluster, you will need to provide the following information after you boot the system disk:

Required Information	Explanation
Type of configuration	Configuration types (CI, DSSI, SCSI, local area, or mixed-interconnect) are distinguished by the interconnect device that the VAX and Alpha computers in the OpenVMS Cluster use to communicate with one another.
DECnet node name and node address	See the network or system manager to obtain the DECnet node name and node address for the computer on which you are installing the OpenVMS Alpha operating system. If you install DECnet-Plus for OpenVMS (Phase V) software and do not plan to use DECnet Phase IV for OpenVMS addresses, then you do not need to provide this information.
Allocation class value	During the installation procedure, you will be asked for the allocation class value (ALLOCLASS) of the Alpha computer on which you are installing the OpenVMS Alpha operating system. For example: Enter a value for this_node ALLOCLASS parameter: Refer to OpenVMS Cluster Systems for the rules on specifying allocation class values. Note that in a mixed-interconnect OpenVMS Cluster environment, the allocation class value cannot be zero if the nodes serve DSSI or CI disks. It must be a value from 1 to 255. This is also true for any Alpha computer that is connected to a dual-pathed disk. After you enter the allocation class value, the installation procedure uses it to automatically set the value of the ALLOCLASS system parameter.
Whether you want a quorum disk	Refer to OpenVMS Cluster Systems to help you determine whether you want a quorum disk in the cluster.
Location of the page and swap files	On a nonclustered system, the page and swap files are on one or more local disks but on a clustered system, the files are on one or more local or clustered disks. See OpenVMS Cluster Systems to help you determine where the page and swap files will be located for the system on which you are installing the OpenVMS Alpha operating system software.
Systems that will be MOP^{2 (SEE NOTE)} servers, disk servers, and tape servers	If you are going to set up either a local area or a mixed-interconnect cluster, you will need to make these determinations.
Cluster group number and cluster password	If you are going to set up a local area cluster or a mixed-interconnect cluster that is LAN-based, use the following rules to determine the cluster group number and password: • Cluster group number — A number in the range from 1 to 4095 or 61440 to 65535 • Cluster password — Must be from 1 to 31 alphanumeric characters in length and can include dollar signs ($) and underscores(_)

2.3 Beginning the Installation

After you have completed all the tasks in this chapter, go to Chapter 3, Installing the OpenVMS Alpha Operating System to begin the installation.

3 Installing the OpenVMS Alpha Operating System

This chapter describes the following installation tasks:

• Preparing to respond to prompts during the installation

• Installing from the operating system CD–ROM

• Creating the system disk

• Registering licenses

• Selecting operating system components

• Installing layered products

• Booting the new system disk

• Joining an OpenVMS Cluster (optional)

• Running AUTOGEN

• Logging in to the SYSTEM account

$Q:\adept8\entities\note.eps$ Note

Before you install the operating system, the correct version of console firmware should be running on your computer, as described in Section 1.2.4.

3.1 Preparing to Respond to Prompts During the Installation

At different points during the installation, you must respond to prompts asking you to supply specific information. This manual and the Help text available during the installation procedure tell you how to obtain most of this information and how to make decisions when responding to specific prompts.

However, Compaq recommends that you review the following summary before you begin the installation so that you have an understanding beforehand of the types of information you will need to provide.

During the installation, the system will prompt you for the following information:

• The names of the source drive, target drive, and local area network device (if you are booting from an InfoServer system).

• Whether you want to select the INITIALIZE or PRESERVE option (as described in Chapter 1, Getting Started).

• A volume label for the target disk (if you choose not to use the default volume label).

• A password for the SYSTEM account. You will be prompted to enter a password of at least 8 characters (but not exceeding 31 characters).

• Whether you want to join an OpenVMS Cluster system and, if so, what kind (as described in Chapter 2, Preparing to Install in an OpenVMS Cluster Environment ).

• DECnet node name and address (or values for the system parameters, SCSNODE and SCSSYSTEMID).

$Q:\adept8\entities\note.eps$ Note

If you install the DECnet-Plus for OpenVMS software but want to use addresses compatible with DECnet Phase IV software, you still need to provide this information. These settings identify your system by name and number in a DECnet or cluster environment. Note that if you supply a DECnet address, the system will automatically calculate the SCSSYSTEMID value. If necessary, see the network or system manager to obtain this information.

• Information listed on Product Authorization Keys (PAKs) for your OpenVMS licenses. To register your licenses, you will need to enter the information listed on the PAK for each license.

• Operating system components that you want to install (including DECwindows and OpenVMS Management Station files). You can install all components by default, or you can select each component individually.

When you install the OpenVMS Alpha operating system, you can install along with it any or all of the following products:

– DECwindows Motif for OpenVMS

If you install this product, you must also include the Support for DECwindows components.

– TCP/IP Services for OpenVMS

– Either DECnet-Plus for OpenVMS or DECnet Phase IV for OpenVMS (but not both)

If you install either DECnet implementation, you must also include the Support for DECnet components.

$Q:\adept8\entities\note.eps$ Note

You must include the DECwindows and DECnet support components now even if you do not plan to install these products until later.

If you need to create a kit to install the PC component of the OpenVMS Management Station software, then you must include the OpenVMS Management Station Software -- PC files component.

See Section 3.5.3 for a complete list of components included with the OpenVMS Alpha operating system.

3.2 Booting the Operating System CD–ROM

The OpenVMS Alpha Version 7.3–1 operating system includes procedures that allow you to easily install the operating system using the POLYCENTER Software Installation utility. To get started, boot the OpenVMS Alpha operating system CD–ROM either from your local CD–ROM drive or from a CD–ROM drive connected to the InfoServer, as described in the following sections.

3.2.1 Booting from the Local Drive

To boot the operating system CD–ROM from the local CD–ROM drive, follow these steps:

1. Insert the operating system CD–ROM into the local CD–ROM drive.

2. At the console prompt (>>>), enter the SHOW DEVICE command so you can identify the name of the CD–ROM drive (for example, DKA400:).

3. Enter the boot command in the following format:

BOOT -FLAGS 0,0 source-drive

Substitute the device name of the CD–ROM drive (as listed in the SHOW DEVICE display) for source-drive.

For example, if the SHOW DEVICE display lists the device name of your CD–ROM drive as DKA400, enter the following command and press the Return key:

>>> BOOT -FLAGS 0,0 DKA400

3.2.2 Booting from the InfoServer

To boot the operating system CD–ROM using the InfoServer, follow these steps:

1. At the console prompt (>>>), enter the SHOW DEVICE command and scan the devices listed in the output to determine the name of the CD–ROM drive. Look for a device listed with its hardware address; for example, see the last line in the following example:

>>>SHOW DEVICE

dva0.0.0.1000.0    DVA0                     RX23
dka200.2.0.5.0     DKA200                   RZ28M  1004
dka300.3.0.5.0     DKA300                   RZ29B  0016
dka400.4.0.5.0     DKA400                   RZ26L  442E
ewa0.0.0.3.0       00-00-F8-1F-70-3D        Twisted-Pair

For additional information, refer to the Compaq OpenVMS Operating System for Alpha and VAX Software Product Description and the hardware manuals that you received with your Alpha computer.

2. At the console prompt, enter the following command:

>>> BOOT -FLAGS 0,0 -FILE APB_1073 lan-device-name

Note the following conventions:

• The APB file name is the unique file name that was assigned to the APB.EXE file when it was copied from the operating system CD-ROM to the InfoServer. This file is the name of the APB program used for the initial system load (ISL) boot program.

• lan-device-name is the name of the local area network (LAN) device identified with your computer, as determined by using the SHOW DEVICE command in the previous step.

$Q:\adept8\entities\note.eps$ Note

If you are using a DEC 3000 or 4000 series system, note the following:

• On DEC 3000 series systems, you can boot through the InfoServer using an alternate TURBOchannel device, such as a PMAD (Ethernet) or DEFTA (FDDI), by specifying the device name as “n/ESA0”. The value for n is the TURBOchannel slot number, which you can obtain by entering the SHOW CONFIGURATION command at the console prompt (>>>) and examining the display. For more information, see Section A.1.8 in Appendix A.

• On DEC 4000 series systems, you must specify the ISL file name in uppercase (APB_1073).

3. The InfoServer ISL program then displays the following menu:

   
Network Initial System Load Function
Version 1.2


  FUNCTION         FUNCTION
    ID
    1     -        Display Menu
    2     -        Help
    3     -        Choose Service
    4     -        Select Options
    5     -        Stop

Enter a function ID value:

4. Respond to the prompts as follows, pressing the Return key after each entry:

a. Enter 3 for the function ID.

b. Enter 2 for the option ID.

c. Enter the service name (ALPHA0731).

A sample display follows:

Enter a function ID value: 3  [Return]

OPTION          OPTION
   ID
   1     -       Find Services
   2     -       Enter known Service Name

Enter an Option ID value: 2  [Return]
Enter a Known Service Name: ALPHA0731  [Return]

$Q:\adept8\entities\note.eps$ Note

If you boot the OpenVMS Alpha operating system CD–ROM from an InfoServer but lose your connection during the installation procedure (the system is unresponsive and pressing Ctrl/Y does not return you to the menu), do the following:

IF ...

THEN ...

you previously chose the INITIALIZE option,

do the following:

1. Reboot the OpenVMS Alpha operating system CD–ROM.

2. Choose the install option from the menu and perform the installation again, as described in this chapter.

you previously chose the PRESERVE option,

do the following:

1. Reboot the OpenVMS Alpha operating system CD–ROM.

2. Enter the DCL environment by choosing option 7 from the menu.

3. Mount the device containing your backup copy of the target disk and the device that is your target disk.

4. Restore the backup copy of your target disk by entering the appropriate BACKUP commands. (See Appendix B for complete information using MOUNT and BACKUP commands to restore a system disk.)

5. Log out from the DCL environment.

6. Choose the install option from the menu and perform the installation again, as described in this chapter.

3.3 Creating the System Disk

The following sections describe how to create the system disk from the operating system CD–ROM.

3.3.1 Installing from the CD–ROM

After you boot the operating system CD–ROM, choose the install option (1) from the menu displayed on the screen. For example:

    OpenVMS (TM) Alpha Operating System, Version 7.3-1

    Copyright (c) 2002 -- All rights reserved.

    Compaq Information Technologies Group, L.P.

    Installing required known files...

    Configuring devices...

    ****************************************************************

    You can install or upgrade the OpenVMS Alpha operating system
    or you can install or upgrade layered products that are included
    on the OpenVMS Alpha operating system CD-ROM.
    
    You can also execute DCL commands and procedures to perform
    "standalone" tasks, such as backing up the system disk.
    
    Please choose one of the following:

        1)  Upgrade, install or reconfigure OpenVMS Alpha Version 7.3-1
        2)  Display products and patches that this procedure can install
        3)  Install or upgrade layered products and patches
        4)  Show installed products
        5)  Reconfigure installed products
        6)  Remove installed products
        7)  Execute DCL commands and procedures
        8)  Shut down this system

    Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 1

The OpenVMS Alpha operating system CD–ROM may contain patch kits. If it does, information similar to the following is displayed:

    The following PATCH kits are present on the OpenVMS Alpha
    distribution media.

    ----------------------------------- ----------- ----------
    PRODUCT                             KIT TYPE    KIT FORMAT
    ----------------------------------- ----------- ----------
    DEC AXPVMS DNVOSIECO01 V7.3         Patch       Sequential
    DEC AXPVMS TCPIP_ECO V5.1-153       Patch       Sequential
    DEC AXPVMS TCPIP_ECO V5.1-152       Patch       Sequential
    DEC AXPVMS TCPIP_ECO V5.1-151       Patch       Sequential
    DEC VAXVMS TCPIP_ECO V5.1-153       Patch       Sequential
    DEC VAXVMS TCPIP_ECO V5.1-152       Patch       Sequential
    DEC VAXVMS TCPIP_ECO V5.1-151       Patch       Sequential
    ----------------------------------- ----------- ----------

    7 items found

    Please consult the OpenVMS Alpha Upgrade and Installation Manual,
    the Release Notes, and the Cover Letter to determine if any or
    all of these patches may be required for your system.

If you have not already done so, check to determine if you need to install any patches.

3.3.2 Choosing INITIALIZE or PRESERVE

After you choose the install option, the system displays the following information and prompts:

***********************************************************

    The installation procedure will ask a series of questions.

          () - encloses acceptable answers
          [] - encloses default answers

    Type your response and press the <Return>key.  Type:

          ? - to repeat an explanation
          ^ - to change prior input (not always possible)
          Ctrl/Y - to exit the installation procedure

    There are two choices for Installation/Upgrade:

    INITIALIZE - Removes all software and data files that were
        previously on the target disk and installs OpenVMS Alpha.

    PRESERVE -- Installs or upgrades OpenVMS Alpha on the target disk
        and retains all other contents of the target disk.

   * NOTE: You cannot use preserve to install OpenVMS Alpha on a disk on
         which OpenVMS VAX or any other operating system is installed.

Do you want to INITIALIZE or to PRESERVE? [PRESERVE]

Respond to the INITIALIZE or PRESERVE prompt as follows:

IF ...	THEN ...
your system disk is new,	do the following: 1. Enter INITIALIZE. 2. Press the Return key.
you want to remove all files from an existing system disk,	do the following: 1. Enter INITIALIZE. 2. Press the Return key.
you want to retain certain files on an existing disk,	press the Return key to accept the default (PRESERVE).

3.3.3 Specifying the Target Disk

The procedure next asks you for the name of the target disk. If you enter a question mark (?), the system displays a list of devices on your system. Select the appropriate disk and respond to the prompt. For example:

You must enter the device name for the target disk on which
OpenVMS Alpha will be installed.

Enter device name for target disk: (? for choices) DKB400

If you select a device that is not available or that cannot be used for some other reason, the system displays information indicating why the device cannot be used. For example, if you enter MKA500, a tape device, a message similar to the following is displayed:

MKA500 is not a disk device

3.3.4 Specifying the Volume Label

The system then prompts you for the volume label and asks if the information is correct. You can keep the label already assigned to the disk, accept the default label assigned by the system (ALPHASYS), or specify a different volume label (with a limit of 12 characters that can include the letters A to Z, numbers 0 through 9, and the dollar sign($), hyphen (-), and underscore (_) characters).

$Q:\adept8\entities\note.eps$ Note

Compaq strongly recommends that the volume labels for all disks on your system or OpenVMS Cluster have unique labels. If a disk having the same label as the system disk is mounted, various OpenVMS components will not function as intended.

3.3.5 Specifying the On-Disk Structure Level

After you enter the volume label for the target system disk, you will be asked if you want to initialize the target system disk with On-Disk Structure Level 2 (ODS-2) or Level 5 (ODS-5).

    Enter volume label for target system disk: [ALPHASYS] 

       The target system disk can be initialized with On-Disk Structure
       Level 2 (ODS-2) or Level 5 (ODS-5). (? for more information)

   Do you want to initialize with ODS-2 or ODS-5? (2/5/?)

For details about ODS-2 and ODS-5 file systems, refer to the OpenVMS System Manager’s Manual. A brief summary follows:

• ODS-2

ODS-2 allows for full compatibility with all OpenVMS VAX systems and with OpenVMS Alpha systems prior to Version 7.2.

• ODS-5

– ODS-5 supports file names that are longer and have a wider range of legal characters. This feature permits use of file names similar to those in a Windows or UNIX environment.

– ODS-5 supports hard links to files, access dates, and files whose names differ only by case.

– ODS-5 volumes cannot be mounted on any version of OpenVMS prior to Version 7.2.

– Systems running OpenVMS VAX Version 7.2 and later can mount ODS-5 volumes, but cannot create or access files having extended names. (Lowercase file name characters are seen in uppercase on OpenVMS VAX systems.)

Select ODS-2 or ODS-5 by entering 2 or 5 at the prompt. If you select ODS-5, you are asked whether you want to enable hard links. For more information about hard links, refer to the OpenVMS Alpha Version 7.3–1 New Features and Documentation Overview.

        Hard links can be enabled on ODS-5 disks. (? for more information)
        (***Enabling hard links can take up to 5-10 minutes or more.***)

    Do you want to enable hard links? (Yes/No)

Enter Yes or No to indicate your choice. Your target system disk choices are displayed, and you are asked to confirm that they are correct.

       You have chosen to install OpenVMS Alpha on a new disk.

       The target system disk, DKB400:, will be initialized
       with structure level 5 (ODS-5).
       Hard links will NOT be enabled.
       It will be labeled ALPHASYS.
       Any data currently on the target system disk will be lost.

   Is this OK? (Yes/No) Y

         Initializing and mounting target....

       Creating page and swap files....

3.3.6 Setting the SYSTEM Account Password

Before you respond to the system prompt asking you to enter a password for the SYSTEM account, note the following:

• Passwords must be at least eight characters in length; they do not appear on the display.

• Press the Return key after you enter the password.

• After you enter the password, the procedure checks to make sure it meets the requirements for a valid password.

• Reenter the password for verification.

The following is a sample display:

    You must enter a password for the SYSTEM account.

    The password must be a minimum of 8 characters in length,
    and may not exceed 31 characters.
    It will be checked and verified.
    The system will not accept passwords that can be guessed easily.

    The password will not be displayed as you enter it.

Password for SYSTEM account: 

Reenter SYSTEM password for verification:

If you reenter the password incorrectly or if the system determines that the password is too easy for another user to guess, the system displays an error message and gives you the opportunity to specify a valid password.

3.3.7 Becoming a Cluster Member

The procedure now asks if your system will be part of a cluster. The display is similar to the following:

Will this system be a member of an OpenVMS Cluster? (Yes/No) Yes

You should answer Yes if the system will be an OpenVMS Galaxy instance or a member of an OpenVMS cluster. Answering Yes to this question causes SYS$MANAGER:CLUSTER_CONFIG.COM to run automatically when your newly installed system is first booted. The CLUSTER_CONFIG procedure will ask a series of questions about the cluster. Refer to the Guidelines for OpenVMS Cluster Configurations for more information.

If you answer No to the cluster question, the system can still be a member of an OpenVMS Cluster. However, in this case you will have to explicitly configure the cluster when your newly installed system is first booted. You can do this by executing a command similar to the following:

$ @SYS$MANAGER:CLUSTER_CONFIG

For detailed information about cluster configuration, refer to the OpenVMS Cluster Systems manual.

3.3.8 Becoming an OpenVMS Galaxy Instance

The procedure next asks if your system will be an instance in an OpenVMS Galaxy. The display is similar to the following:

Will this system be an instance in an OpenVMS Galaxy? (Yes/No) Yes

If you answer Yes to this question, and you also answered Yes to the OpenVMS Cluster question, information about required remedial kits is displayed.

3.3.9 Installing Windowing and Networking Products

The procedure next asks if you want to install the following Compaq windowing and networking software:

• DECwindows Motif for OpenVMS

• DECnet-Plus for OpenVMS or DECnet Phase IV for OpenVMS (but not both)

• TCP/IP Services for OpenVMS

This software is included with the OpenVMS Alpha operating system. You can change the default values for these products later in the installation procedure.

$Q:\adept8\entities\note.eps$ Note

The OpenVMS Alpha installation menu offers the choice to install either DECnet-Plus for OpenVMS or DECnet Phase IV for OpenVMS networking software. However, you cannot have both installed on your system at the same time. Install one or the other.

Once you have DECnet and TCP/IP installed on your system, you can run DECnet applications over your TCP/IP network. Please see the DECnet-Plus for OpenVMS Management Guide for more information on DECnet over TCP/IP.

The display is similar to the following:

You can install the following products along with the OpenVMS operating 
system:
 
        o DECwindows Motif for OpenVMS Alpha
        o DECnet-Plus for OpenVMS Alpha
        o DECnet Phase IV for OpenVMS Alpha
        o Compaq TCP/IP Services for OpenVMS

    If you want to change your selections, you can do so later in the
    installation by answering "NO" to the following question:
                                
        "Do you want the defaults for all product options?"    

    Do you want to install DECwindows Motif for OpenVMS Alpha V1.2-6?
(Yes/No) [YES] y


    Beginning with OpenVMS V7.1, the DECnet-Plus kit is provided with the
    OpenVMS operating system kit.  Compaq recommends that DECnet
    users install DECnet-Plus.  DECnet Phase IV applications are
    supported by DECnet-Plus.

    DECnet Phase IV is also provided as an option.  Support for
    DECnet Phase IV is available through a Prior Version Support
    Contract available through Compaq’s Services.

    If you install DECnet-Plus and TCP/IP  you can run DECnet 
    applications over a TCP/IP network.  Please see the OpenVMS 
    Management Guide for information on running DECnet over TCP/IP.    

    Do you want to install DECnet-Plus for OpenVMS Alpha V7.3-1?
(Yes/No) [YES] y


    Do you want to install Compaq TCP/IP Services for OpenVMS V5.1?
(Yes/No) [YES] n

Note that if you answer No to the prompt to install DECnet-Plus for OpenVMS, you will be prompted to install DECnet Phase IV for OpenVMS.

3.3.10 Setting System Parameters

The procedure now asks you to set values for the parameters SCSNODE and SCSSYSTEMID. SCSNODE is a name that can be from 1 to 6 letters or numbers; it must include at least one letter. If this system is part of an OpenVMS Cluster, SCSNODE must be unique within the cluster. If you are using DECnet Phase IV for OpenVMS or DECnet-Plus for OpenVMS with DECnet Phase IV addresses, then SCSNODE must be the same as your DECnet node name.

SCSSYSTEMID must also be unique within an OpenVMS Cluster. In addition, if you are using DECnet Phase IV for OpenVMS or DECnet-Plus for OpenVMS with DECnet Phase IV addresses, SCSSYSTEMID depends on the DECnet Phase IV address that your system is using.

The following is an example of the display and valid responses:

    For your system to operate properly, you must set two parameters:
    SCSNODE and SCSSYSTEMID.
      
    SCSNODE can be from 1 to 6 letters or numbers.  It must contain at
    least one letter.

    If you plan to use DECnet, SCSNODE must be the DECnet Phase IV
    node name, or the DECnet-Plus node synonym.

    If you have multiple OpenVMS systems, the SCSNODE on each system 
    must be unique.

Enter SCSNODE: alpcsi

    If you plan to use DECnet, SCSSYSTEMID must be set based on the
    DECnet Phase IV address.

    DECnet Phase IV addresses are in the format

        DECnet_area_number.DECnet_node_number

    DECnet_area_number is a number between 1 and 63.
    DECnet_node_number is a number between 1 and 1023.

    If you plan to use DECnet WITHOUT Phase IV compatible addresses, 
    enter 0.0.


Enter DECnet (Phase IV) Address [1.1]: 63.180

    SCSSYSTEMID will be set to 64692.

        This was calculated as follows:

        (DECnet_area_number * 1024) + DECnet_node_number

If you are not using DECnet, or if you enter 0.0 as the DECnet Phase IV address, you are prompted to enter a SCSSSYSTEMID in the range of 1 to 65535. If this is a standalone system, the default 65534 is acceptable. However, if this system is part of an OpenVMS Cluster, you must enter a unique SCSSYSTEMID. The following is a sample display:

   Please choose a SCSSYSTEMID between 1 and 65535.  If you have multiple
   OpenVMS systems, the SCSSYSTEMID on each system must be unique.

Enter SCSYSTEMID [65535]: 12345

3.3.11 Setting Time Zone Information

At this point in the installation, the procedure asks you for information that is used for providing local time zone support. Time zone information is always set on new installations. It may be set on upgrades. (See Section 7.2.10.)

For local time zone support to work correctly, the installation procedure must set the time zone that accurately describes the location you want to be considered as your default time zone. Usually, this is the time zone in which your system is running. In addition, your system must be correctly configured to use a valid OpenVMS time differential factor (TDF).

The procedure displays a series of time zone menus and prompts you to make selections from each. Begin by selecting the desired time zone from the main time zone menu.

If you choose a time zone that has subcomponents, the system displays an additional menu. For example, if you choose the United States (US) time zone from the main menu, a second menu displays the specific time zones within the United States. You then select the menu item that best represents the desired time zone.

The procedure then prompts you for the TDF. The TDF is the difference between your system time and Coordinated Universal Time (UTC), which is an international standard (similar to Greenwich Mean Time) for measuring time of day. The procedure supplies a default for TDF, which is generally the correct response.

The following is a sample display:

  Configuring the Local Time Zone


  TIME ZONE SPECIFICATION -- MAIN Time Zone Menu

      1) AFRICA               16) GREENWICH            31) POLAND
      2) AMERICA              17) HONGKONG             32) PRC
      3) ANTARCTICA           18) ICELAND              33) ROC
      4) ASIA                 19) INDIAN               34) ROK
      5) ATLANTIC             20) IRAN                 35) SINGAPORE
      6) AUSTRALIA            21) ISRAEL               36) SYSTEMV
      7) BRAZIL               22) JAMAICA              37) TURKEY
      8) CANADA               23) JAPAN                38) UCT
      9) CET                  24) LIBYA                39) UNIVERSAL
     10) CHILE                25) MET                  40) US
     11) CUBA                 26) MEXICO               41) UTC
     12) EET                  27) NAVAJO               42) W-SU
     13) EGYPT                28) NZ-CHAT              43) WET
     14) FACTORY              29) NZ                   44) ZULU
     15) GB-EIRE              30) PACIFIC

      0) GMT

Select the number above that best represents the desired time zone: 40

  US Time Zone Menu

      1) ALASKA                5) EAST-INDIANA          9) MICHIGAN
      2) ALEUTIAN              6) EASTERN              10) MOUNTAIN
      3) ARIZONA               7) HAWAII               11) PACIFIC
      4) CENTRAL               8) INDIANA-STARKE       12) SAMOA

      0) return to Main Time Zone Menu

Select the number above that best represents the desired time zone: 6

You selected EASTERN / US as your time zone.
Is this correct? (Yes/No) [YES]:

    Configuring the Time Differential Factor (TDF)


    Default Time Differential Factor for standard time is -5:00.
    Default Time Differential Factor for daylight saving time is -4:00.


    The Time Differential Factor (TDF) is the difference between your
    system time and Coordinated Universal Time (UTC).  UTC is similar
    in most respects to Greenwich Mean Time (GMT).

    The TDF is expressed as hours and minutes, and should be entered
    in the hh:mm format.  TDFs for the Americas will be negative
    (-3:00, -4:00, etc.); TDFs for Europe, Africa, Asia and Australia
    will be positive (1:00, 2:00, etc.).

This time zone supports daylight saving time.
Is this time zone currently on daylight saving time? (Yes/No): n

Enter the Time Differential Factor [-5:00]:

    NEW SYSTEM TIME DIFFERENTIAL FACTOR = -5:00

Is this correct? [Y]:

For more information about TDF and local time zone support, see the OpenVMS System Manager’s Manual.

3.4 Registering Licenses

Before you can use the OpenVMS Alpha operating system and its components, you must register all licenses in one of two ways:

• During the installation (which Compaq recommends), by responding to the prompts displayed by the SYS$UPDATE:VMSLICENSE.COM procedure. This procedure is executed if you answer Yes (the default) to the following question:

	     Do you want to register any Product Authorization Keys?

• After the installation, by using the LICENSE REGISTER command or by invoking SYS$UPDATE:VMSLICENSE.COM.

In addition to reviewing the license information provided in this chapter, you can also refer to the following:

• Appendix C, which contains notes and supplemental information about licenses and licensing procedures

• The OpenVMS License Management Utility Manual, which contains complete, detailed information about the licensing procedure

3.4.1 Types of OpenVMS Alpha Licenses

The operating system uses one or more of the following types of licenses, depending on your hardware and software configuration.

$Q:\adept8\entities\note.eps$ Note

All OpenVMS Alpha Base and SMP licenses include the NO_SHARE attribute and remain with the initial host computer.

Table 3–3 Types of OpenVMS Alpha Licenses

Type of License	Description
Operating System Base License	Grants the right to noninteractive use of the remote batch, print, application, and computing services of the operating system on a single processor and authorizes one direct login (for system management purposes only). This license is a prerequisite for OpenVMS Alpha Interactive User Licenses.
Interactive User Licenses	Grant the right to interactive use of the OpenVMS Alpha operating system, provided you have previously installed the appropriate OpenVMS Alpha Operating System Base License on your Alpha computer. These licenses, which are concurrent, are available in any quantity desired or as an unlimited user license. You can add interactive users to the computer at any time by specifying the same node name on the additional Interactive User License PAK and by following the license combination procedure described in the OpenVMS License Management Utility Manual.
Symmetric Multiprocessing (SMP) Extension to the Operating System Base License	Upgrades the Operating System Base License and all Interactive User licenses (including Unlimited) to the matching multiprocessing level of your Alpha SMP system. Because the Symmetric Multiprocessing (SMP) Extension grants all the rights the existing Base and User licenses provided at the uniprocessing level, you do not need to reinstall those licenses when you upgrade to a multiprocessing system. Each time you upgrade your system to a new multiprocessing level (for example, from a DEC 7000 Model 620 Alpha system to a DEC 7000 Model 630 Alpha system), you add an SMP Extension to your existing licenses.

3.4.2 How to Register Licenses

After you install the OpenVMS Alpha operating system, the system displays the following message:

    If you have Product Authorization Keys (PAKs) to register,
    you can register them now.

Do you want to register any Product Authorization Keys? (Yes/No) [Yes]

Respond to the prompt as follows:

IF ...	THEN ...
you choose to register your licenses at this time (which Compaq recommends),	do the following: 1. Be sure you review Appendix C and have the OpenVMS License Management Utility Manual available. 2. Be sure you have a copy of the Product Authorization Key (PAK) for each license that you will register. 3. Type Y and press the Return key. 4. Register your licenses, as described in the next section.
you choose not to register your licenses at this time,	do the following: 1. Type N and press the Return key. 2. Skip the next section about registering licenses and follow the directions in Section 3.5. 3. After completing the installation, register your licenses using the LICENSE REGISTER command or by invoking SYS$UPDATE:VMSLICENSE.COM before performing any other postinstallation tasks.

3.4.3 Using the Licensing Procedure

Entering Y (Yes) to register your licenses during the installation invokes the SYS$UPDATE:VMSLICENSE.COM procedure, which displays the following message:

VMS License Management Utility Options:
     
    1. REGISTER a Product Authorization Key
    2. AMEND an existing Product Authorization Key
    3. CANCEL an existing Product Authorization Key
    4. LIST Product Authorization Keys
    5. MODIFY an existing Product Authorization Key
    6. DISABLE an existing Product Authorization Key
    7. DELETE an existing Product Authorization Key
    8. COPY an existing Product Authorization Key
    9. MOVE an existing Product Authorization Key
   10. ENABLE an existing Product Authorization Key
   11. SHOW the licenses loaded on this node
   12. SHOW the unit requirements for this node
            
   99. Exit this procedure

   Type ’?’ at any prompt for a description of the information 
   requested. Press Ctrl/Z at any prompt to return to this menu.
     
Enter one of the above choices [1]

1. Select the appropriate options (beginning with 1, as indicated in the display) until you have successfully registered all required PAKs.

2. After you register all your licenses, exit from the License Management procedure by entering option 99.

3.5 Completing the Installation

The following sections describe the remaining steps that you need to perform to complete the installation.

3.5.1 Choosing Descriptive Help Text

Next, the system prompts you as follows:

The installation can provide brief or detailed descriptions.
In either case, you can request the detailed descriptions by typing "?".

Do you always want detailed descriptions? (Yes/No) [No]

If you answer Yes, the system will display additional explanatory text with each prompt.

3.5.2 Selecting Components

The system next displays the following message, indicating that the procedure is ready to install the operating system:

The following product has been selected:
    DEC AXPVMS OPENVMS V7.3-1                    Platform (product suite)
 

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for 
any products that may be installed to satisfy software dependency requirements.
 
DEC AXPVMS OPENVMS V7.3-1: OpenVMS and related products Platform
 
    COPYRIGHT (c) 27-MAY-2002 -- All rights reserved
 
    Compaq Information Technologies Group, L.P.

After the system displays a series of additional messages, the procedure prompts you to choose the default values for all the options and suboptions for each component included in the operating system. The display is similar to the following:

    Do you want the defaults for all options? [YES]

When selecting components, note the following:

• If you want all the default values, press the Return key.

If you want to select components individually, answer NO. The system will then prompt you for each option and suboption.

• You should review the list of options and compare them with the requirements for your system. If you are selecting components individually, be sure that you include all components necessary to support the needs of your users. Note also that certain components are dependent upon the installation of other components.

• If you are not sure whether you want certain options, request help by entering a question mark (?) at the prompt for that option.

• After you select all the options you want, you will have an opportunity to view your selections and make changes (if necessary).

• OpenVMS Management Station software is automatically installed on your OpenVMS system disk when you accept all the default values. If you do not accept the default values, you must select the OpenVMS Management Station component (server and client files) if you plan to use that product. After the installation is complete, you can then prepare your OpenVMS Alpha system and your PC to run OpenVMS Management Station by following the procedures described in Appendix D.

• If you decide after the installation to change which OpenVMS Alpha operating system options you want installed on your system, you must reconfigure the installation as described in Section 1.3.3.2 and Section 4.10.

• After you boot the new system disk and log in, you can obtain information about individual system files by entering HELP SYSTEM_FILES at the dollar sign prompt ($).

$Q:\adept8\entities\note.eps$ Note

Unless you have specific reasons to do otherwise, Compaq recommends that you accept the defaults and install all OpenVMS options. OpenVMS and layered products have various dependencies on many of these options. Even if you think you do not need certain options, some OpenVMS or layered product operations may not work correctly if other OpenVMS options are not installed.

3.5.3 List of Components

The following components are included with the OpenVMS Alpha Version 7.3–1 operating system:

    Accounting Log Report Generator Utility
    Access Control List Utilities 
    Print and Batch Queue Utilities
    DECdtm Distributed Transaction Manager
    LDAP (Lightweight Directory Access Protocol) files
    Support for DECnet-Plus or DECnet for OpenVMS
        DECnet Incoming Remote File Access
        DECnet Incoming Remote Terminal
        DECnet Network Test
        DECnet Remote Task Loading
    Programming Support
        Debugger Utility
        Image Dump Utility
        RMS Analyze and FDL Editor Utilities
        Message Utility
        System Shareable Image and Object Module Libraries
        Macro libraries
        Macro-32 Migration Compiler
        TLB intermediary form of STARLET
        Fortran Require Files
        C Object Libraries
        C Header Files
        VMS text libraries of Ada declarations
    RMS Journaling Recovery Utility
    System Programming Support
        Support for ISO 9660 and High Sierra CDrom Formats
        MONITOR
        Analyze Object File Utility
        Delta Debugger
        System Dump Analyzer Utility
        Miscellaneous Symbol Table Files
    OpenVMS Management Station Software -- PC files
    Utilities
        OpenVMS Mail Utility
        Dump Utility
        DIGITAL Standard Runoff (DSR) Text Formatter
        Phone Utility
        Help Library
        Foreign Terminal Support
        LAT-11 Terminal Server (via Ethernet)
        Error Log Generator Utility
        Terminal Fallback Facility
        TECO Interactive Text Editor
        National Character Set Utility (NCS)
        DIAGNOSE Utility
        XPG4 Internationalization Utilities
        World Wide PostScript Printing Subsystem
    Bliss Require Files
    Example Files
    Message Facility Files (HELP/MESSAGE)
    Translated Image Support
    UETP Files
    Support for DECwindows
        DECwindows workstation files
        Video fonts
            100 dots-per-inch video fonts
    Delete any obsolete OpenVMS files
    Delete files archived by OpenVMS remedial kits

3.5.4 Completing the Procedure

When you have answered all the prompts and selected the components you want installed, the system allows you to review your selections (and make changes if necessary), then installs the product, provides informational messages, and returns you to the menu. The following is a sample display:

$Q:\adept8\entities\note.eps$ Note

If you perform two installations at the same time to systems connected by MEMORY CHANNEL, you may see a message similar to the following every 5 seconds:

             
%PMA0 CPU00: 30-MAY-2002 14:58:40 Remote System Conflicts with 
Known System - REMOTE NODE
%PMA0 CPU00: 30-MAY-2002 14:58:45 Remote System Conflicts with 
Known System - REMOTE NODE

Disregard the message. The installation or upgrade will proceed normally and the messages will not be present when the system reboots with its actual node name.

    Do you want to review the options? [NO] 

Execution phase starting ...

The following products will be installed to destinations:
    CPQ AXPVMS CDSA V1.0                  DISK$ALPHASYS:[VMS$COMMON.]
    DEC AXPVMS DECNET_OSI V7.3-1          DISK$ALPHASYS:[VMS$COMMON.]
    DEC AXPVMS DWMOTIF V1.2-6             DISK$ALPHASYS:[VMS$COMMON.]
    DEC AXPVMS OPENVMS V7.3-1             DISK$ALPHASYS:[VMS$COMMON.]
    DEC AXPVMS TCPIP V5.1                 DISK$ALPHASYS:[VMS$COMMON.]
    DEC AXPVMS VMS V7.3-1                 DISK$ALPHASYS:[VMS$COMMON.]

Portion done: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100%

The following products have been installed:
    CPQ AXPVMS CDSA V1.0                   Layered Product
    DEC AXPVMS DECNET_OSI V7.3-1           Layered Product
    DEC AXPVMS DWMOTIF V1.2-6              Layered Product
    DEC AXPVMS OPENVMS V7.3-1              Platform (product suite)
    DEC AXPVMS TCPIP V5.1                  Layered Product
    DEC AXPVMS VMS V7.3-1                  Operating System

    The installation is now complete.

    When the newly installed system is first booted, a special
    startup procedure will be run.  This procedure will:

    o  Configure the system for standalone or OpenVMS Cluster operation.
    o  Run AUTOGEN to set system parameters.
    o  Reboot the system with the newly set parameters.


    You may shut down now or continue with other operations.


  Process AXPVMS_INSTALL logged out at 27-MAY-2002 14:45:49.54

Press Return to continue...

    ****************************************************************

    You can install or upgrade the OpenVMS Alpha operating system
    or you can install or upgrade layered products that are included
    on the OpenVMS Alpha operating system CD-ROM.
    
    You can also execute DCL commands and procedures to perform
    "standalone" tasks, such as backing up the system disk.
    
    Please choose one of the following:

        1)  Install or upgrade OpenVMS Alpha Version 7.3-1
        2)  Display products and patches that this procedure can install
        3)  Install or upgrade layered products and patches
        4)  Show installed products
        5)  Reconfigure installed products
        6)  Remove installed products
        7)  Execute DCL commands and procedures
        8)  Shut down this system

    Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?)

If you want to install layered products, go to Section 3.6.

If you do not want to install layered products or perform any other operations prior to booting the new system disk, choose option 8 from the menu to shut down the system. The system display is similar to the following:

Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 8

Shutting down the system

SYSTEM SHUTDOWN COMPLETE

After you complete the installation and shut down the system, go to Section 3.7.

3.6 Installing Layered Products

You can use the menu system included on the operating system CD–ROM to install certain layered products with the POLYCENTER Software Installation utility. You can view a list of the layered products that can be installed in this way by choosing option 2 from the menu. (To install layered products that are not listed, see Chapter 4, After Installing the OpenVMS Alpha Operating System and the installation documentation for each layered product.)

You may see the following product name while installing layered products:

        DEC AXPVMS UCX V4.2-PLACEHOLDER

Do not attempt to install this kit. This is a "dummy" that is needed to facilitate upgrading from the prior UCX implementation of TCP/IP Services for OpenVMS to the new implementation.

If you do attempt to install this kit, the following message will be displayed:

          The UCX implementation of TCP/IP Services is obsolete and is not
          supported on OpenVMS V7.2 and higher versions.

          Starting with OpenVMS V7.2, the UCX implementation of TCP/IP
          services is replaced by the new TCPIP product.

          This is a placeholder kit to satisfy OpenVMS upgrade requirements
          so that UCX can be automatically upgraded to TCPIP.

          You cannot use this kit to install UCX.

The installation will then terminate.

You can install (or upgrade to) the new implementation of TCP/IP Services for OpenVMS, Version 5.1, as part of the OpenVMS upgrade. If you want to install Version 5.1 separately, choose the product:

        DEC AXPVMS TCPIP V5.1

To install layered products using the POLYCENTER Software Installation utility, choose option 2 to view the list and then option 3 to perform the installation. For example:

Please choose one of the following:

        1) Upgrade, install or reconfigure OpenVMS Alpha Version 7.3-1
        2) Display products and patches that this procedure can install
        3) Install or upgrade layered products and patches
        4) Show installed products
        5) Reconfigure installed products
        6) Remove installed products
        7) Execute DCL commands and procedures
        8) Shut down this system

        Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 2

            The following versions of the OpenVMS operating system, the
            DECwindows graphical user interface and network products.
            are available on the OpenVMS Distribution compact disk.
            They can be installed by selecting choice 1:

        DEC AXPVMS VMS version V7.3-1
        DEC AXPVMS DWMOTIF version V1.2-6
        DEC AXPVMS DECNET_OSI version V7.3-1
        DEC AXPVMS DECNET_PHASE_IV version V7.3-1
        DEC AXPVMS TCPIP version V5.1

            The following Layered Product kits are available on the OpenVMS
            Distribution Compact Disk.  They can be installed by selecting
            choice 3.  If already installed, they can be reconfigured by
            selecting choice 5, or removed by selecting choice 6.
        ----------------------------------- ----------- ----------
        PRODUCT                             KIT TYPE    KIT FORMAT
        ----------------------------------- ----------- ----------
        DEC AXPVMS DECNET_OSI V7.3-1        Full LP     Sequential
        DEC AXPVMS DECNET_PHASE_IV V7.3-1   Full LP     Sequential
        DEC AXPVMS DWMOTIF V1.2-6           Full LP     Sequential
        DEC AXPVMS TCPIP V5.1               Full LP     Sequential
        DEC AXPVMS UCX V4.2-99PLACEHOLDER   Full LP     Sequential
        ----------------------------------- ----------- ----------

        5 items found

        Press Return to continue...

            ****************************************************************

            You can install or upgrade the OpenVMS Alpha operating system
            or you can install or upgrade layered products that are included
            on the OpenVMS Alpha operating system CD-ROM.

            You can also execute DCL commands and procedures to perform
            "standalone" tasks, such as backing up the system disk.

            Please choose one of the following:

        1) Upgrade, install or reconfigure OpenVMS Alpha Version 7.3-1
        2) Display products and patches that this procedure can install
        3) Install or upgrade layered products and patches
        4) Show installed products
        5) Reconfigure installed products
        6) Remove installed products
        7) Execute DCL commands and procedures
        8) Shut down this system

        Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 3
            ***********************************************************

            If you choose to install or upgrade DECwindows Motif,
            please note the following:

              o If you did not select the OpenVMS DECwindows base support
                and workstation files options, DECwindows Motif will not run.
                You must add these options to use DECwindows Motif.

              o If you are upgrading DECwindows Motif from version V1.1 and
                want to save the OSF/Motif Release 1.1.3 programming files,
                DO NOT upgrade now.  Instead, see the DECwindows Motif
                installation manual and follow the instructions for running
                PCSI_INSTALLATION.COM.

            If you choose to install or upgrade DECnet-Plus or DECnet Phase IV,
            please note the following:

        o If you did not select the OpenVMS DECNET option, neither version
          of DECnet will run.  You must add this option to use DECnet.

        Press Return to continue...
           ***********************************************************

            The installation procedure will ask a series of questions.

                  () - encloses acceptable answers
                  [] - encloses default answers

            Type your response and press the Return key.  Type:

                  ? - to repeat an explanation
                  ^ - to change prior input (not always possible)
                  Ctrl-Y - to exit the installation procedure

            You must enter the device name for the target disk on which
            the layered product(s) installation will be performed.

        Enter device name for target disk: [DKB400:] (? for choices)

            DKB400: is labeled V73_TCPIPV51.

            The install operation can provide brief or detailed descriptions.
            In either case, you can request the detailed descriptions by typing
            "?".

        Do you always want detailed descriptions? (Yes/No) [No]
           1 - DEC AXPVMS DECNET_OSI V7.3-1        Layered Product
           2 - DEC AXPVMS DECNET_PHASE_IV V7.3-1   Layered Product
           3 - DEC AXPVMS DWMOTIF V1.2-6           Layered Product
           4 - DEC AXPVMS TCPIP V5.1               Layered Product
           5 - DEC AXPVMS UCX V4.2-99PLACEHOLDER   Layered Product
           6 - All products listed above
           7 - Exit

        Choose one or more items from the menu separated by commas:

Note that the UCX V4.2-99PLACEHOLDER kit is not a valid UCX (TCP/IP) kit. It is present only to support upgrading UCX to the new TCPIP implementation of TCP/IP Services for OpenVMS. Any attempt to install this PLACEHOLDER kit will terminate with an error.

If you do not want to perform any other operations after you install the layered products, enter option 8 to shut down the system. The system display is similar to the following:

Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 8

Shutting down the system

SYSTEM SHUTDOWN COMPLETE

After you complete the installation and shut down the system, go to the next section to boot the new system disk.

3.7 Booting the New System Disk

After you have successfully installed the operating system, boot the new system disk, as described in the following sections.

3.7.1 Preparing to Boot the New System Disk

Before you boot the new system disk, you must do the following:

1. Halt the system by entering Ctrl/P or by pressing the Halt button.^{1 (SEE NOTE)}

2. At the console prompt (>>>), enter the SET BOOTDEF_DEV command in the following format:

SET BOOTDEF_DEV target-drive

Substitute the device name of the system disk for target-drive. The SET BOOTDEF_DEV command tells the system which disk to boot from. For example, if the system disk has the device name DKA400, enter the following command and press the Return key:

>>> SET BOOTDEF_DEV DKA400

If the system disk is connected to a hierarchical storage device (HSx), the format for specifying that drive is different. For example, on a DEC 7000 series system connected to an HSC device, the command is similar to the following:

>>> SET BOOTDEF_DEV DUA20.14.0.2.0

For more information about setting and showing the default boot device, see Appendix A.

3.7.2 How to Boot the New System Disk

To boot the system disk, enter the following command and press the Return key:

>>> BOOT -FLAGS 0,0

When the system finishes booting, it displays informational messages that begin as follows:

    OpenVMS (TM) Alpha Operating System, Version 7.3-1

%DECnet-I-LOADED, network base image loaded, version = 05.0D.00

$!  Copyright (c) 2002 Compaq Information Technologies Group, L.P.  
$!  All rights reserved.

    Installing required known files...

    Configuring devices...
.
.
.

3.8 Joining an OpenVMS Cluster

If during the installation, you previously answered Yes to the question about joining an OpenVMS Cluster, the system now asks a series of questions about your configuration (CI, DSSI, SCSI, local area, or mixed-interconnect).

You might need to refer to OpenVMS Cluster Systems or Guidelines for OpenVMS Cluster Configurations to answer these questions.

3.8.1 OpenVMS Cluster Prompts

Table 3 –5 lists the OpenVMS Cluster prompts and suggested responses. Note that, depending on your responses and particular cluster configuration, some prompts will not be displayed.

Table 3–5 Prompts for OpenVMS Cluster Configurations

Question	How to Respond
Will this node be a cluster member (Y/N)?	Enter Y.
What is the node’s DECnet node name?	Enter the DECnet node name (for example, MYNODE). The DECnet node name may be from one to six alphanumeric characters in length and cannot include dollar signs or underscores.
What is the node’s DECnet node address?	Enter the DECnet node address --- for example, 2.2.
Will the Ethernet be used for cluster communications (Y/N)?	Enter N for a CI only or DSSI-only OpenVMS Cluster. Otherwise, answer Y. ^{2 (SEE NOTE)}
Enter this cluster’s group number:	Enter a number in the range from 1 to 4095 or 61440 to 65535.
Enter this cluster’s password:	Enter the cluster password. The password must be from 1 to 31 alphanumeric characters in length and may include dollar signs and underscores.^{3 (SEE NOTE)}
Reenter this cluster’s password for verification:	Reenter the password.
Will MYNODE be a disk server (Y/N)?	Enter Y if you want local disks to be served to the cluster (mandatory for local area and mixed-interconnect configurations). Refer to OpenVMS Cluster Systems for information about served cluster disks.
Will MYNODE serve RFxx disks (Y)?	Enter a response appropriate for your DSSI configuration, if such disks are available to your system.
Enter a value for MYNODE’s ALLOCLASS parameter:	In a CI only system (connected to a dual-ported disk), a DSSI-only system, or a local area or mixed-interconnect configuration where nodes serve DSSI or CI disks, enter the appropriate allocation class value (1 to 255). Otherwise, enter 0. For information about selecting the ALLOCLASS parameter, see OpenVMS Cluster Systems.
Does this cluster contain a quorum disk (Y/N)?	For CI only, SCSI, local area, and mixed-interconnect configurations, enter Y or N, depending on your configuration. For most DSSI systems, enter Y. However, if you are adding a two-system DSSI configuration to an existing cluster (in which case you might not need a quorum disk), you can answer N. If you enter Y, the system asks for the name of the quorum disk. Enter the device name of the quorum disk. Refer to OpenVMS Cluster Systems for information about quorum disks.

3.9 Running AUTOGEN

The system next runs AUTOGEN to evaluate your hardware configuration and estimate typical work loads. AUTOGEN then sets system parameters, the sizes of page, swap, and dump files, and the contents of VMSIMAGES.DAT. When AUTOGEN finishes and you reboot your system, the installation procedure is complete.

The installation procedure displays messages similar to the following:

    AUTOGEN will now be run to compute the new SYSGEN parameters. The system
    will then shut down and reboot, and the installation or upgrade will be
    complete.

    After rebooting you can continue with such system management tasks as:

            Decompressing the System Libraries
            Configuring DECnet
            Using SYS$MANAGER:CLUSTER_CONFIG.COM to create an OpenVMS Cluster
            Creating FIELD, SYSTEST, and SYSTEST_CLIG accounts if needed

%AUTOGEN-I-BEGIN, GETDATA phase is beginning.
%AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:PARAMS.DAT has been created.
        You may wish to purge this file.
%AUTOGEN-I-END, GETDATA phase has successfully completed.
%AUTOGEN-I-BEGIN, GENPARAMS phase is beginning.
%AUTOGEN-I-NEWFILE, A new version of SYS$MANAGER:VMSIMAGES.DAT has been created.
         You may wish to purge this file.
%AUTOGEN-I-NEWFILE, A new version of SYS$SYSTEM:SETPARAMS.DAT has been created.
        You may wish to purge this file.
%AUTOGEN-I-END, GENPARAMS phase has successfully completed.
%AUTOGEN-I-BEGIN, GENFILES phase is beginning.
%SYSGEN-I-EXTENDED, SYS$SYSROOT:[SYSEXE]PAGEFILE.SYS;1 extended
%SYSGEN-I-EXTENDED, SYS$SYSROOT:[SYSEXE]SWAPFILE.SYS;1 extended
%SYSGEN-I-CREATED, SYS$SYSROOT:[SYSEXE]SYSDUMP.DMP;1 created

%AUTOGEN-I-REPORT, AUTOGEN has produced some informational messages that
        have been stored in the file SYS$SYSTEM:AGEN$PARAMS.REPORT. You may
        wish to review the information in that file.

%AUTOGEN-I-END, GENFILES phase has successfully completed.
%AUTOGEN-I-BEGIN, SETPARAMS phase is beginning.
.
.
.

3.9.1 Automatic Reboot after Autogen

After AUTOGEN finishes, the system shuts down, displaying messages similar to the following:

The system is shutting down to allow the system to boot with the
generated site-specific parameters and installed images.

The system will automatically reboot after the shutdown and the
installation will be complete.



        SHUTDOWN -- Perform an Orderly System Shutdown
                    on node ALPCSI

%SHUTDOWN-I-BOOTCHECK, performing reboot consistency check...
%SHUTDOWN-I-CHECKOK, basic reboot consistency check completed
.
.
.

3.9.2 Manual Reboot after Autogen

If the system does not reboot automatically, reboot the system manually.

For example, if the system disk is on an RZ25 disk drive with a unit number of 1, enter the following command and press the Return key:

>>> BOOT DKA1

After the system reboots, a message similar to the following is displayed:

     OpenVMS (TM) Alpha Operating System, Version 7.3-1

    Copyright (c) 2002 -- All rights reserved.

    Compaq Information Technologies Group, L.P.
    
%STDRV-I-STARTUP, OpenVMS startup begun at 27-MAY-2002 14:50:18.35
.
.
.

The system next displays informational messages and accounting information indicating that your OpenVMS Alpha operating system is running. For example:

%SET-I-INTSET, login interactive limit = 64, current interactive value = 0
  SYSTEM       job terminated at  27-MAY-2002 14:51:23.47

  Accounting information:
  Buffered I/O count:            2177         Peak working set size:   6848
  Direct I/O count:              1358         Peak page file size:   179552
  Page faults:                   1805         Mounted volumes:            0
  Charged CPU time:     0 00:00:13.37         Elapsed time:   0 00:01:06.20

At this time, you can log in to the SYSTEM account (so you can perform postinstallation tasks), as described in the following sections.

3.10 Logging in to the SYSTEM Account from a Character Cell Terminal

Log in to a character cell terminal by entering the user name SYSTEM followed by the password. The display is similar to the following:

OpenVMS (TM) Alpha Operating System, Version 7.3-1

Username: SYSTEM
Password:
.
.
.
      OpenVMS (TM) Alpha Operating System, Version 7.3-1

If you forget your password, follow the instructions in Appendix A to perform an emergency startup.

3.11 Logging in to the SYSTEM Account from a Workstation

If you installed the DECwindows Motif for OpenVMS software on your workstation, do the following after the login window displays on your screen:

1. Enter the user name SYSTEM followed by the password.

2. Click on the OK button.

3.12 Postinstallation Tasks

After you have successfully installed the OpenVMS Alpha operating system and logged in to the SYSTEM account, you must perform certain postinstallation tasks before you can use the system. For complete information, go to Chapter 4, After Installing the OpenVMS Alpha Operating System.

4 After Installing the OpenVMS Alpha Operating System

After you have installed the OpenVMS Alpha operating system, you must perform several important tasks to prepare the system for operation. This chapter describes the following postinstallation tasks in the order in which you perform them:

• Registering licenses

• Creating accounts

• Backing up the system disk

• Customizing the system

• Initializing CDSA

• Configuring and starting networking software

• Testing the system with UETP

• Expanding the system libraries

• Adding and removing files

• Preparing your OpenVMS Alpha system and your PC to run OpenVMS Management Station

• Installing layered products

• Installing OpenVMS Debugger clients on a PC

• Backing up the customized system disk

• Configuring a multihead system

• Running AUTOGEN

• Using the postinstallation checklist

4.1 Registering Your Licenses

The installation procedure gave you the opportunity to register any software product licenses. If you did not register your OpenVMS Alpha licenses at that time, you must do so before you can use the OpenVMS Alpha operating system. You must also register the licenses for OpenVMS Alpha layered products.

You can invoke the OpenVMS License utility by entering the following command:

$ @SYS$UPDATE:VMSLICENSE

(You can also use the LICENSE REGISTER command.)

For information about registering licenses, see the following:

• Section 3.4

• Appendix C

• The OpenVMS License Management Utility Manual

4.2 Creating Accounts

During the installation, DEFAULT and SYSTEM accounts are created for you automatically. However, if you plan to have Compaq service representatives test your system or if you plan to run testing software such as UETP, you must create accounts for each representative and a SYSTEST (standalone system) or SYSTEST_CLIG (OpenVMS Cluster system) account to run UETP.

For complete information about creating accounts for Compaq service representatives and UETP, see the OpenVMS System Manager’s Manual.

4.3 Backing Up Your System Disk

After you install the operating system, protect your work by making a backup copy of the system disk in case you have any problems while customizing it.

To back up the system disk:

1. Shut down the system (described in Appendix A ).

2. Boot the operating system CD–ROM (locally or from the InfoServer).

3. Use the menu system to enter the DCL environment (option 7).

4. Mount the system disk and the target device on which you will make the backup copy.

5. Enter backup commands to back up the system disk to supported media.

6. Log out from the DCL environment.

7. Shut down the system by selecting option 8 from the menu.

8. Boot from the system disk.

In addition to backing up the system disk now before you customize it, you should back up your system disk again after you successfully complete your customization tasks and install layered products.

For complete information about backup operations, including a description of an alternate method that does not require booting from the operating system CD–ROM and that allows you to back up a shadowed disk without disabling the shadow set, see Appendix B.

4.4 Customizing the System

You can customize the system to meet your site-specific needs. In addition, if your Alpha computer is part of an OpenVMS Cluster environment, you must prepare the cluster environment and configure the cluster.

For instructions on customizing the system, review the following documentation:

• OpenVMS Cluster Systems (if the computer is part of an OpenVMS Cluster environment)

• The release notes, for notes and restrictions that might be relevant to your customization plans

• The OpenVMS System Manager’s Manual, for instructions on customizing and using your system. You will find information about the following tasks:

– Editing the template files SYCONFIG.COM, SYLOGICALS.COM, SYLOGIN.COM, and SYSTARTUP_VMS.COM

– Starting the queue manager and creating a queue database

– Setting up user accounts

– Adjusting system parameters

– Setting up your system to run DECdtm services

• Section 4.7, for information about configuring and starting networking software

$Q:\adept8\entities\note.eps$ Note

If you have installed the DECwindows Motif for OpenVMS layered product (see Section 4.12 ), you can customize your DECwindows environment.

4.5 Initializing CDSA

The Common Data Security Architecture (CDSA) is automatically installed with the operating system. However, before you can use CDSA, you must perform the following one-time, manual setup and initialization procedure. You must have SYSPRV privileges to do this.

1. Increase your FILLM process quota by 100 before you initialize CDSA.

2. Execute the following command:

$ @SYS$STARTUP:CDSA$INITIALIZE

If you attempt to run this procedure when it has been run previously, you will get an error message.

$Q:\adept8\entities\note.eps$ Note

Do not attempt to remove CDSA from your system. The PRODUCT REMOVE command is not supported for CDSA even though there appears to be an option to remove CDSA. CDSA is installed with the operating system and is tightly bound with it. Any attempt to remove it will not work cleanly, and could create other undesirable side effects. An attempt to remove it results in the following message:

%PCSI-E-HRDREF, product CPQ AXPVMS CDSA Vn.n is referenced
by DEC AXPVMS OPENVMS V7.3-1
-PCSI-E-HRDRF1, the two products are tightly bound by this
software dependency

For more information about CDSA, refer to Open Source Security for OpenVMS Alpha, Volume 1: Common Data Security Architecture.

4.6 Configuring Kerberos

Kerberos Version 1.0 for OpenVMS Security Client, based on MIT Kerberos V5 Release 1.0.5, is now integrated into the OpenVMS Alpha Version 7.3-1 operating system. Previously, Kerberos was shipped as a layered product.

To configure Kerberos, perform the following steps from a privileged OpenVMS username (for example, SYSTEM).

1. Insert the following line into SYS$MANAGER:SYSTARTUP_VMS.COM. This line must be entered after the startup command for Compaq TCP/IP Services for OpenVMS. (If you start Compaq TCP/IP Services for OpenVMS as a batch job, be sure that TCP/IP has started before you start Kerberos.)

$ @SYS$STARTUP:KRB$STARTUP.COM

2. Add the following line to your SYLOGIN command procedure, or into the LOGIN.COM of each user who will use Kerberos.

$ @SYS$MANAGER:KRB$SYMBOLS

3. Run the following command procedure to configure the Kerberos clients and servers.

$ @SYS$STARTUP:KRB$CONFIGURE.COM

Refer to the Kerberos for OpenVMS Security Client Installation Guide and Release Notes for additional setup and configuration information. This document contains links to the MIT Kerberos documentation, and is available from the OpenVMS Alpha Version 7.3-1 documentation CD-ROM.

4.7 Configuring and Starting Networking Software

The following sections describe how to configure and start your networking software.

4.7.1 DECnet-Plus for OpenVMS

If you installed DECnet-Plus for OpenVMS software, refer to the DECnet-Plus for OpenVMS Release Notes and DECnet-Plus for OpenVMS Installation and Basic Configuration for postinstallation instructions.

4.7.2 DECnet Phase IV for OpenVMS

$Q:\adept8\entities\note.eps$ Note

Support for DECnet Phase IV is available only under Compaq’s Prior Version Support Program. Contact your local Compaq support representative for additional information.

If you plan to run DECnet Phase IV for OpenVMS software, note the following:

• After you have registered the license for the DECnet Phase IV for OpenVMS software, execute the interactive command procedure SYS$MANAGER:NETCONFIG.COM to automatically configure your system for networking. See the DECnet for OpenVMS Guide to Networking for instructions on using NETCONFIG.COM.

• After you start the queue manager (see the OpenVMS System Manager’s Manual), edit the commands in SYS$COMMON:[SYSMGR]SYSTARTUP_VMS.COM that pertain to networking so that the DECnet Phase IV for OpenVMS software starts automatically when your system is booted. Edit the file as follows:

– If you have batch queues set up on your system, choose the following command by removing the comment delimiter (!) from the command line. Enabling this command allows the system to start up more quickly and decreases the amount of time you must wait to log in.

!$ SUBMIT SYS$MANAGER:STARTNET.COM

– If you do not have batch queues set up on your system, remove the comment delimiter (!) from the following lines:

$! DECNET_VERSION = F$INTEGER(F$EXTRACT(2,2,F$GETSYI("DECNET_VERSION") ) )
$! IF DECNET_VERSION .GE. 5
$!     THEN 
$!         START/NETWORK "DECNET/OSI"$!     ELSE 
$!         START/NETWORK DECNET
$! ENDIF

• If you plan to run both DECnet Phase IV for OpenVMS and DECwindows software, you must also edit SYS$COMMON:[SYSMGR]SYSTARTUP_VMS.COM to add a comment delimiter (!) immediately following the dollar sign ($) in the following command:

$ DEFINE DECW$IGNORE_DECNET TRUE

If you are not going to start the DECnet Phase IV for OpenVMS software or have not yet started it, this command tells the DECwindows software not to wait for the DECnet Phase IV for OpenVMS software.

4.7.3 Compaq TCP/IP Services for OpenVMS

If you installed TCP/IP Services for OpenVMS software, refer to the Compaq TCP/IP Services for OpenVMS Installation and Configuration manual for information about how to configure this software using the TCPIP$CONFIG.COM procedure.

4.8 Testing the System with UETP

The User Environment Test Package (UETP) is a software package designed to test whether the OpenVMS Alpha operating system is installed correctly. As part of the postinstallation procedure, Compaq recommends that you run UETP to verify the installation.

For complete information about using UETP, see the OpenVMS System Manager’s Manual.

4.9 Expanding the System Libraries

Some of the larger system libraries ship with the OpenVMS operating system in a data-reduced (compressed) format. Expanding (that is, decompressing) these libraries gives the system faster access to them, but also consumes more disk space. Table 4 –1 lists the libraries that ship in data-reduced format on OpenVMS Alpha Version 7.3–1 and shows the approximate sizes of the libraries in both data-reduced and expanded format.

Table 4–1 Reduced and Expanded Library Sizes

Library Name	Reduced Size (as shipped)	Expanded Size	Description
[SYSHLP] directory; Help library files (.HLB)

ACLEDT.HLB	70	102	Access Control List Editor help
BKM$HELP.HLB	156	248	Backup Manager help
DBG$HELP.HLB	1234	2133	OpenVMS Debugger help
DBG$UIHELP.HLB	269	438	OpenVMS Debugger help
EDTHELP.HLB	154	229	EDT Editor help
EVE$HELP.HLB	676	1197	EVE Editor help
EVE$KEYHELP.HLB	99	145	EVE Keypad help
EXCHNGHLP.HLB	83	118	Exchange Utility help
HELPLIB.HLB	9179	16662	DCL help
LANCP$HELP.HLB	119	174	LAN Control Program help
LATCP$HELP.HLB	157	243	LAT Control Program help
MAILHELP.HLB	211	316	Mail Utility help
NCPHELP.HLB	261	412	Network Control Program help
SDA.HLB	308	457	System Dump Analyzer help
SHWCLHELP.HLB	103	151	Show Cluster utility help
SYSGEN.HLB	337	526	System Generation utility help
SYSMANHELP.HLB	492	786	System Management utility help
TPUHELP.HLB	575	1036	Text Processing Utility help
UAFHELP.HLB	241	377	Authorize Utility help

[SYSLIB] directory; Macro library files (.MLB)

LANIDEF.MLB	181	241	LAN internal driver macros
LIB.MLB	2715	4679	Operating system macros
STARLET.MLB	2335	3467	Operating system macros

[SYSLIB] directory; Object library files (.OLB)

STARLET.OLB	27461	44256	System object library and run-time library
VAXCRTL.OLB	1163	1557	Compaq C RTL routine name entry points; VAX G_floating double-precision, floating-point entry points
VAXCRTLD.OLB	1587	2542	Limited support of VAX D_floating double-precision, floating-point entry points
VAXCRTLDX.OLB	1506	2391	VAX D_floating support; support for /L_DOUBLE_SIZE=128 compiler qualifier
VAXCRTLT.OLB	1434	2234	IEEE T_floating double-precision, floating-point entry points
VAXCRTLTX.OLB	1449	2244	IEEE T_floating support; support for /L_DOUBLE_SIZE=128 compiler qualifier
VAXCRTLX.OLB	1285	1811	G_floating support; support for /L_DOUBLE_SIZE=128 compiler qualifier
VMS$VOLATILE_ PRIVATE_INTERFACES.OLB	445	635	OpenVMS bugcheck processing codes

[SYSLIB] directory; Text library files (.TLB)

ERFLIB.TLB	64	85	ANALYZE/ERROR device descriptions
LIB_ADA_SUBSET.TLB	1839	3385	Ada programmers toolkit of operating system definitions
NTA.TLB	34	42	Files to build against NTA facility
STARLET_RECENT_ ADA_SUBSET.TLB	1100	1942	Ada programmers toolkit of operating system definitions
STARLETSD.TLB	3940	7208	STARLET definitions used during layered product installations
SYS$LIB_C.TLB	9442	20214	Header files for C language; derived from LIB
SYS$STARLET_C.TLB	5864	12752	Public header files for Compaq C

TOTALS:

78568

137435

$Q:\adept8\entities\note.eps$ Note

File sizes are subject to change. For the most accurate information, run the Library Decompression utility (LIBDECOMP.COM) on your own system and review the output from the list function.

To expand all the libraries, you would need approximately 60,000 free disk blocks. However, you can choose to expand only selected libraries. For complete details about expanding and reducing system library files and using LIBDECOMP.COM, refer to the OpenVMS System Manager’s Manual.

4.10 Adding and Removing Operating System Files

If you decide after the installation to change which OpenVMS Alpha operating system files you want installed on your system, you can use the menu system contained on the OpenVMS Alpha operating system CD–ROM to add or remove files.

$Q:\adept8\entities\note.eps$ Note

You can obtain information about individual system files by entering HELP SYSTEM_FILES at the dollar sign prompt ($).

To add or remove operating system files:

1. Mount and boot the OpenVMS Alpha operating system CD–ROM.

2. Choose option 1 from the menu.

3. Choose the PRESERVE option.

4. Enter the name of the device that contains the system disk and answer the questions.

5. After you answer the question “Do you want detailed descriptions?,” information regarding reconfiguring or reinstalling is displayed. Read the instructions, then choose the desired entry from the menu of options.

The following is a sample display:

    Please choose one of the following:

        1)  Upgrade, install or reconfigure OpenVMS Alpha Version 7.3-1
        2)  Display products and patches that this procedure can install
        3)  Install or upgrade layered products and patches
        4)  Show installed products
        5)  Reconfigure installed products
        6)  Remove installed products
        7)  Execute DCL commands and procedures
        8)  Shut down this system

Enter CHOICE or ? for help: (1/2/3/4/5/6/7/8/?) 1
    ***********************************************************

.
.
.

Do you want to INITIALIZE or to PRESERVE? [PRESERVE] 

.
.
.
    Version 7.3-1 of the OpenVMS operating system is already installed
    on the target disk.  You may choose one of the following actions:

    o Reconfigure the OpenVMS platform.

      This action will allow you to change your selections of which
      of the windowing and network products you included with your
      OpenVMS operating system installation.

    o Reconfigure the OpenVMS operating system.

      This action will allow you to change your choices about which
      options you included for the OpenVMS operating system.

    o Reinstall the OpenVMS operating system.

      This action will cause ALL operating system  files to be replaced.
      You can also change your choices about which options you included
      for the OpenVMS operating system.

      Reinstall will take longer than Reconfigure.  Reinstall may be
      appropriate if you suspect that files in the operating system,
      or in the windowing and network products have become corrupted.

    If you want to reinstall any of the windowing and network products,
    choose "Install or upgrade layered products and patches" (option 3)
    from the main menu.

    If you want to change your choices about which options you included
    for any of the windowing and network products, choose "Reconfigure
    installed products" (option 5) from the main menu.

    Please choose one of the following:

        1)  Reconfigure the OpenVMS platform.
        2)  Reconfigure the OpenVMS operating system.
        3)  Reinstall the OpenVMS operating system.
        4)  Return to the Main Menu (abort the upgrade/installation).


Enter choice or ? for help: (1/2/3/4/?) 2
The following product has been selected:
    DEC AXPVMS VMS V7.3-1              Operating System


Configuration phase starting ...

You will be asked to choose options, if any, for each selected product 
and for any products that may be installed to satisfy software dependency
requirements.

DEC AXPVMS VMS V7.3-1: OpenVMS Operating System

    COPYRIGHT (c) 12-MAY-2002 -- All rights reserved
   
    Compaq Information Technologies Group, L.P.  

Do you want the defaults for all options? [YES]

Answer No to this question, and select the options you want as described in Section 3.5.2. A list of components is provided in Section 3.5.3. After you respond to the prompts, the display continues and the installation procedure completes as described in Section 3.5.4. The following is a continuation of the sample display:

    Do you want to review the options? [NO] 
 
Execution phase starting ...
The following product will be reconfigured:
    DEC AXPVMS VMS V7.3-1
Portion done: 0%...10%...20%...30%...40%...50%...60%...80%...90%...100%
The following product has been reconfigured:
    DEC AXPVMS VMS V7.3-1
.
.
.

For detailed instructions on how to remove the OpenVMS Alpha operating system from your disk, see Appendix E.

4.11 Preparing to Use OpenVMS Management Station

If you installed the OpenVMS Management Station software on your system (either by accepting all default values or by selecting the component manually during the installation procedure), you must perform several tasks on your OpenVMS Alpha system and your PC before you can use OpenVMS Management Station. These tasks include the following:

• Editing system files

• Starting OpenVMS Management Station on other nodes

• Verifying that you have the proper memory, disk space, media, and the required software to install and run OpenVMS Management Station on your PC

• Installing the client software on your PC

• Defining DECnet nodes

For complete information about preparing your OpenVMS system and your PC to run the OpenVMS Management Station server and client software, see Appendix D.

$Q:\adept8\entities\note.eps$ Note

After you complete the tasks described in Appendix D, you can then remove those files from your system to save disk space. Do not use the DELETE command to remove the files. Instead, reconfigure the OpenVMS Alpha operating system as described in Section 4.10.

4.12 Installing Layered Products

You can use the menu system included on the operating system CD–ROM to install certain layered products with the POLYCENTER Software Installation utility. If you did not install those layered products previously during the installation procedure, you can do so using the following procedure. To install layered products that require VMSINSTAL, see Section 4.12.1.

$Q:\adept8\entities\note.eps$ Note

To use this procedure, the target system must have the exact same version of the OpenVMS Alpha operating system as the CD–ROM. If you need to install layered products on a target system that has a different version of the operating system, use the alternate procedure described in the next section.

1. Shut down the system (described in Appendix A ).

2. Boot the operating system CD–ROM (locally or from the InfoServer).

3. Choose option 2 from the menu to view which layered products can be installed using the POLYCENTER Software Installation utility.

4. Choose option 3 from the menu to install the layered products.

5. Shut down the system by selecting option 8 from the menu.

6. Boot from the system disk.

If the layered product that you want to install is not listed in the display, see the documentation you received with that layered product for installation information.

For additional information about installing layered products, see the OpenVMS System Manager’s Manual.

Be sure you back up the system disk after you install all your layered products.

4.12.1 Alternate Procedure

Following is another method for installing layered products from the OpenVMS Alpha operating system CD–ROM:

1. From your running OpenVMS system (the target system disk), mount the OpenVMS Alpha operating system CD–ROM.

2. Locate the directories and files containing the available layered products by entering the following command (where, in the example, DKA400: is the device name of the CD–ROM):

$ DIRECTORY /NOHEAD/NOTRAIL DKA400:[*.KIT]

You can use the PRODUCT FIND command to locate kits that are installed using the POLYCENTER Software Installation utility. For example:

$ PRODUCT FIND * /SOURCE=DKA400:[*.KIT]

3. To install layered products that require VMSINSTAL (indicated in the directories by save-set file names with file types of .A, .B, and so on), enter the @SYS$UPDATE:VMSINSTAL command and then specify the CD–ROM device and directory. For example:

$ @SYS$UPDATE:VMSINSTAL
* Where will the distribution volumes be mounted: DKB400:[UCX032.KIT]

4. To install layered products that require the POLYCENTER Software Installation utility (indicated in the directories by file names with file types of .PCSI or .PCSI$DESCRIPTION), use the PRODUCT INSTALL command to specify the CD–ROM device name and directory. Following is an example of the PRODUCT INSTALL command:

$ PRODUCT INSTALL POSIX /SOURCE=DKB400:[POSIX020.KIT]

4.13 Installing OpenVMS Debugger Clients on a PC

OpenVMS Debugger includes a client/server interface. The debug server runs on OpenVMS; debug clients run on OpenVMS and on Microsoft Windows 95 and Windows NT. There is no special installation procedure for the components that run on OpenVMS. This section describes the procedure for installing the debug client on a PC.

The following table shows which client kit to use for each PC configuration:

CPU	Operating System	Client Kit
Alpha	Windows NT	40COMAXP.EXE
Intel	Windows NT	40COMUPD.EXE
Alpha	Windows NT	DEBUGALPHA011.EXE
Intel	Windows 95, 98, Me, NT, 2000, XP	DEBUGX86011.EXE

These client kits are self-extracting .EXE files. To make these clients available to PC users, copy these files from the distribution media to a suitable PATHWORKS or Advanced Server for OpenVMS share, FTP server, or other device available to the PC. (Refer to the Guide to OpenVMS Alpha Version 7.3–1 CD–ROMs for the directory where these kits ship on the media.)

Once the appropriate executable file has been transferred to the PC, the user can run the file to install the debug client on the PC. The InstallShield installation procedure guides the user through the installation.

By default, the debug client is installed in the \Programs\OpenVMS Debugger directory. Click Browse to select an alternate directory.

Choose one of the following options:

Install Option	Details
Typical	Debug client and OpenVMS Debugger Manual in HTML format
Compact	Debug client only
Custom	Choice of Debug Client and/or OpenVMS Debugger Manual in HTML format

The installation procedure creates an OpenVMS Debugger program folder that contains the following items:

• Debug client

• Debug client help file

• OpenVMS Debugger Manual in HTML format

• Readme file

• Uninstall procedure

4.14 Backing Up the Customized System Disk

After you have customized the OpenVMS Alpha operating system to your satisfaction and installed your layered products, protect your work by making a standalone backup copy of the system disk.

For complete information about backup operations, including a description of an alternate method that does not require booting from the operating system CD–ROM, see Appendix B.

To back up the system disk:

1. Shut down the system (described in Appendix A ).

2. Boot the operating system CD–ROM (locally or from the InfoServer).

3. Use the menu system to enter the DCL environment (option 7).

4. Mount the system disk and the target device on which you will make the backup copy.

5. Enter backup commands to back up the system disk to the target device.

6. Log out from the DCL environment.

7. Shut down the system by selecting option 8 from the menu.

8. Boot from the system disk.

4.15 Configuring a Multihead System

A multihead configuration consists of a single system (such as a Compaq AlphaServer ES40) that supports multiple graphics options. A graphics option consists of a graphics controller and a graphics display interface (monitor).

Your system can be automatically configured for multihead use if you rename the private server setup file from a template file type to a command procedure file type. The DECwindows Motif server loads this command procedure on startup or restart.

To set up your system for multihead support:

1. After installing the DECwindows Motif software on your system, log in to your system.

2. Copy the private server setup template file to a new .COM file by entering the following command:

$ COPY SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.TEMPLATE
_To: SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM

3. Restart the DECwindows server by entering the following command:

$ @SYS$STARTUP:DECW$STARTUP RESTART

See the most recent version of the DECwindows Motif for OpenVMS Installation Guide and Managing DECwindows Motif for OpenVMS Systems for more information about customizing your DECwindows environment using the SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM file.

4.16 Running AUTOGEN

When you installed the OpenVMS Alpha operating system, the system executed the AUTOGEN.COM procedure to set the values of system parameters and the sizes of the page, swap, and dump files according to the system configuration. As a postinstallation procedure, you should run the AUTOGEN.COM procedure again to properly tune the system.

Run AUTOGEN as follows:

1. After 24 hours of operation, run AUTOGEN in feedback mode and reboot the system.

2. Run AUTOGEN again in feedback mode two workdays later, and then reboot the system. (For information about the importance of having a current AGEN$FEEDBACK.DAT file, see Section 5.5.)

3. Compaq recommends that you run AUTOGEN from SAVPARAMS through TESTFILES on a weekly basis thereafter, and examine AGEN$PARAMS.REPORT to determine the need for additional changes.

4.17 Modifying Parameters

Based on your examination of AGEN$PARAMS.REPORT, you might need to modify parameter values in MODPARAMS.DAT. If so, note the following:

• Hardcoded values in MODPARAMS.DAT should not hinder AUTOGEN’s ability to calculate feedback parameters. AUTOGEN generally does not reduce the value of parameters that allocate resources; it considers current parameter values to be minimum values, which means that you do not have to add MIN_* symbols to MODPARAMS.DAT.

• AUTOGEN does increase parameter values according to its calculations unless you have specified explicit or maximum values (by adding MAX_* symbols) in MODPARAMS.DAT.

For more information about the MODPARAMS.DAT file and about using AUTOGEN in general, see the OpenVMS System Manager’s Manual.

4.18 Tuning BAP System Parameters

OpenVMS Alpha Version 7.1 and later contains system parameters that control the operation of bus-addressable pool (BAP).

The CIPCA, CIXCD, KFMSB, and Qlogic 1020ISP adapters are some of the adapters that use bus-addressable pool to improve performance. BAP is a non-paged dynamic, physical-address-filtered memory pool used to overcome I/O bus and 32-bit adapter physical addressing limits.

The following table lists the system parameters that control BAP operation along with their default values:

System Parameter	Default Value
NPAG_BAP_MIN	0
NPAG_BAP_MAX	0
NPAG_BAP_MIN_PA	0
NPAG_BAP_MAX_PA	-1

The default values of these parameters allow the system to boot with any configuration. When AUTOGEN is run on a configured system, it resets these parameters to values that should enhance performance for the current system configuration.

If the system fails to boot after an installation, upgrade, or configuration change, and displays a message that refers to incorrect BAP parameters, Compaq recommends that you perform the following steps:

1. Reset the BAP parameters to the default values.

2. Reboot the system.

3. Allow the installation procedure to run AUTOGEN, or manually run AUTOGEN yourself.

A typical AUTOGEN with FEEDBACK command to set these parameters follows:

$ @SYS$UPDATE:AUTOGEN SAVPARAMS SETPARAMS FEEDBACK

$Q:\adept8\entities\note.eps$ Note

These parameters are critical. Compaq recommends that you run AUTOGEN as described to ensure that they are set correctly.

If you prefer not to use this command because you want to adjust only the BAP parameters settings, use the following procedure:

1. Boot the system using the default BAP parameter values.

2. Manually run SYS$SYSTEM:AGEN$FEEDBACK.EXE:

$ @SYS$SYSTEM:AGEN$FEEDBACK.EXE

3. Search SYS$SYSTEM:AGEN$FEEDBACK.DAT for the BAP_* system parameter values:

$ SEARCH SYS$SYSTEM:AGEN$FEEDBACK.DAT "BAP_"

4. Run SYSGEN to set the following system parameters with the BAP values you obtained in Step 3:

AGEN$FEEDBACK Data	System Parameter	Units
BAP_MIN	NPAG_BAP_MIN	bytes
BAP_MAX	NPAG_BAP_MAX	bytes
BAP_MIN_PA	NPAG_BAP_MIN_PA	Mbytes^{1 (SEE NOTE)}
BAP_MAX_PA	NPAG_BAP_MAX_PA	Mbytes¹

The BAP allocation amount (specified by BAP_MIN and BAP_MAX) depends on the adapter type, the number of adapters, and the version of the operating system. The physical address range (specified by BAP_MIN_PA and BAP_MAX_PA) depends on the adapter type and the way the Galaxy logical partitions, if any, are defined.

$Q:\adept8\entities\note.eps$ Note

If you manually set parameters NPAG_BAP_MIN_PA and NPAG_BAP_MAX_PA, be sure to specify the value for each parameter in the correct units (bytes or megabytes) for your operating system version.

4.19 Postinstallation Checklist

Use the following checklist to make sure you perform all the necessary postinstallation tasks:

[ ] Register your licenses if you did not do so during the installation procedure.

[ ] Create accounts.

[ ] Back up the system disk as a safeguard before customizing the system.

[ ] Customize the system.

[ ] Initialize CDSA.

[ ] Configure and start the DECnet Phase IV for OpenVMS software.

[ ] Run the User Environment Test Package (UETP) to test the system.

[ ] Expand the system libraries using LIBDECOMP.COM.

[ ] Add and remove files.

[ ] Prepare your OpenVMS Alpha system and your PC to run OpenVMS Management Station by following the procedures described in Appendix D.

[ ] Install layered products.

[ ] Back up the system disk after you have customized it and installed layered products.

[ ] Configure your multihead system (if applicable).

[ ] After the system has been running for at least 24 hours, run AUTOGEN to collect feedback information and modify the MODPARAMS.DAT file (if necessary).

5 Before Upgrading the OpenVMS Alpha Operating System

This chapter describes which tasks you should perform prior to beginning an upgrade. Tasks described in this chapter include:

• Reviewing notes, cautions, and restrictions

• Preparing to upgrade in a volume shadowing environment

• Backing up the current system disk

• Preparing the system disk for the upgrade

• Shutting down the system

• Using the preupgrade checklist

In addition to reviewing the information in this chapter, you might need to refer to the following sources of information as well:

• OpenVMS Alpha Version 7.3–1 Release Notes

• OpenVMS System Manager’s Manual, for information about using AUTOGEN, modifying the system parameters file (MODPARAMS.DAT), and related operations

• OpenVMS System Management Utilities Reference Manual, for information about using system management utilities such as SYSMAN and ANALYZE/DISK_STRUCTURE

• OpenVMS Guide to System Security, for information about reestablishing your security environment after the upgrade

5.1 Notes, Cautions, and Restrictions

This section provides important information that can affect the success of your upgrade. Review the cautions, restrictions, and notes carefully before you begin the upgrade.

5.1.1 Spiralog File System Not Supported

The Spiralog file system will not work with OpenVMS Alpha Version 7.3–1. If Spiralog is installed on your system, you must uninstall it before upgrading to OpenVMS Alpha Version 7.3–1.

5.1.2 Upgrade Paths

The following sections describe the various types of upgrades to Version 7.3–1.

5.1.2.1 Direct Upgrade Paths

You can upgrade directly to OpenVMS Alpha Version 7.3–1 from only the following versions of OpenVMS Alpha:

Version 7.3

Version 7.2-2

Version 7.2-1

Version 7.2-1H1

Version 7.1-2

If you are currently running OpenVMS Alpha Version 6.2x, you can do a two-step upgrade: first to Version 7.2-2 or 7.3, and then to Version 7.3–1.

5.1.2.2 Cluster Concurrent Upgrades

During a concurrent upgrade, you must shut down the entire cluster and upgrade each system disk. No one can use the cluster until you upgrade and reboot every computer. Once you reboot, each computer will be running the upgraded version of the operating system.

5.1.2.3 Cluster Rolling Upgrades

During a cluster rolling upgrade, you upgrade each system disk individually, allowing old and new versions of the operating system to run together in the same cluster. There must be more than one system disk. The systems that are not being upgraded remain available.

Only the following OpenVMS Alpha and OpenVMS VAX versions are supported in mixed-version clusters that include OpenVMS Alpha Version 7.3–1:

Version 7.3–1 (Alpha)

Version 7.3 (Alpha and VAX)

Version 7.2–2 (Alpha)

Version 7.2–1 (Alpha)

Version 7.2–1H1 (Alpha)

Version 7.2 (VAX)

If you are upgrading in a cluster environment, rolling upgrades are supported from Version 7.2-x and 7.3 of the OpenVMS Alpha operating system. If you have other versions in a cluster, you cannot do a rolling upgrade until those versions are upgraded to a supported version. See Chapter 6, Preparing to Upgrade in an OpenVMS Cluster Environment for more information about upgrading clusters.

5.1.3 Update License

To upgrade to OpenVMS Alpha Version 7.3–1, you must have an appropriate license. Compaq’s software licenses grant the right to use the current version of a product or any previous version of the product at the time of purchase. If you have an OpenVMS Alpha license prior to Version 7.3–1 and are not covered by a Software Product Services agreement, which includes the right to use new versions (RTNV), you must purchase an Update License before upgrading to OpenVMS Alpha Version 7.3–1.

If you do not have an Update License, please contact your Compaq support representative who will assist you in obtaining the correct Product Authorization Key (PAK) needed to access the OpenVMS operating system.

5.1.4 Files and Directories

If you choose not to install optional OpenVMS Alpha software during the upgrade, the upgrade procedure removes existing files for those components from the system disk.

If you have changed directory structure on your system disk, the upgrade procedure will not work correctly. Restore your system disk to a standard directory structure before you attempt an upgrade.

The OpenVMS Alpha Version 7.3–1 upgrade procedure provides new files and directories in the directory [VMS$COMMON...]. If you had any special protections and access control lists (ACLs) before the upgrade, you need to reapply them to reestablish the security environment you had previously set up. For more information about creating and maintaining a secure environment, see the OpenVMS Guide to System Security.

5.1.5 Licenses and Layered Products

The upgrade procedure is designed so that you should not have to reinstall most layered products after the upgrade. However, you might need to reinstall certain layered products because of product-specific installation procedures.

The upgrade procedure leaves your OpenVMS Alpha license and layered product licenses intact. You do not need to reinstall these licenses after you upgrade.

5.2 Preparing to Upgrade in a Volume Shadowing Environment

Because you cannot upgrade the operating system on a shadowed system disk (the upgrade will fail), you need to disable shadowing on that disk and perform other operations before you can upgrade the operating system.

There are several methods for creating a nonshadowed target disk. This chapter describes how to change one of your existing shadowed system disks in a multimember shadow set to a nonshadowed disk that you can use as your target disk for the upgrade.

If you have a larger configuration with disks that you can physically access, you may want to use a copy of the system disk as your target disk. Volume Shadowing for OpenVMS describes two methods you can use to create this copy (using volume shadowing commands or BACKUP commands) and how to disable volume shadowing.

5.2.1 Creating a Nonshadowed Target Disk

Follow the procedure described in this section to change one of your existing shadowed system disks to a nonshadowed disk.

$Q:\adept8\entities\note.eps$ Caution

If you simply use a MOUNT/OVERRIDE=SHADOW_MEMBERSHIP command to mount the volume to be upgraded, volume shadowing can overwrite the newly upgraded disk with information from a prior volume that has not been upgraded.

1. Shut down all systems booted from the shadowed system disk.

2. Perform a conversational boot (see Appendix A if necessary) on the system disk you have chosen for your target disk. For example:

>>> BOOT -FLAGS 0,1 DKA100

3. At the SYSBOOT>prompt, enter the following command to disable volume shadowing on the disk:

SYSBOOT> SET SHADOW_SYS_DISK 0

4. Enter the CONTINUE command to resume the boot procedure. For example:

SYSBOOT> CONTINUE

5. After the boot completes, log in to the system.

After you have created a nonshadowed system disk that you can use for the upgrade, perform the additional preupgrade procedures described in the balance of this chapter.

5.2.2 Changing the Label

If you want to change the label on the upgrade disk, use the DCL command SET VOLUME/LABEL=volume-label device-spec[:] to perform this optional task. (The SET VOLUME/LABEL command requires write access [W] to the index file on the volume. If you are not the volume owner, you must have either a system UIC or the SYSPRV privilege.)

For OpenVMS Cluster systems, be sure that the volume label is a unique name across the cluster. Compaq strongly recommends that a volume label contain only alphanumeric characters and the dollar sign ($), underscore (_), and hyphen (-) characters. You can include other characters in a volume label, but doing so on a system disk can cause the upgrade procedure to fail.

$Q:\adept8\entities\note.eps$ Note

If you need to change the volume label of a disk that is mounted across the cluster, be sure you change the label on all nodes in the OpenVMS Cluster system. The following example shows how to use the SYSMAN utility to define the environment as a cluster and propagate the volume label change to all nodes in that cluster:

SYSMAN> SET ENVIRONMENT/CLUSTER
SYSMAN> DO SET VOLUME/LABEL=new-label disk-device-name:

5.2.3 Setting the Boot Device

Be sure your system is set to boot from the upgrade disk by default. Use the SHOW BOOTDEF_DEV and SET BOOTDEF_DEV console commands to accomplish this task. (See Appendix A for more information.)

5.3 Backing Up the System Disk

Compaq strongly recommends that you make a backup copy of the system disk and, if your configuration allows it, upgrade the backup copy. Then, if there are problems, you will still have a working system disk.

$Q:\adept8\entities\note.eps$ Note

OpenVMS Engineering has encountered cases where recovery from a failed upgrade has been difficult, expensive, or impossible because no backup of the preupgrade system disk was available. Various hardware or software failures or a power failure can make a partially upgraded system disk unusable. A backup copy may be the only route to recovery. The minimal time required to make a backup is a very wise investment!

To back up the system disk, do the following:

1. Shut down the system (described in Appendix A ).

2. Boot the operating system CD–ROM (locally or from the InfoServer).

3. Use the menu system to enter the DCL environment (option 7 ).

4. Mount the system disk and the target device on which you will make the backup copy.

5. Enter backup commands to back up the system disk to the target device.

6. Log out from the DCL environment.

7. Shut down the system by selecting option 8 from the menu.

8. Boot from the system disk.

For complete information about backup operations, including a description of an alternate method that does not require booting from the operating system CD–ROM, see Appendix B.

5.4 Preparing the System Disk

The following sections describe how to prepare the system disk for the upgrade. The operations include the following:

• Examining the system disk

• Checking the size of the system disk

• Verifying system parameters

5.4.1 Examining the System Disk

Examine and repair (if necessary) the system disk using the ANALYZE/DISK_STRUCTURE command. (See the OpenVMS System Management Utilities Reference Manual for more information about this command.) Use the following procedure:

1. Analyze the system disk for inconsistencies and errors in the file structure by entering the following command:

$ ANALYZE/DISK_STRUCTURE SYS$SYSDEVICE

Ignore the following message:

%ANALDISK-I-OPENQUOTA, error opening QUOTA.SYS

2. If you find any other errors on the system disk, repair the errors by entering the following command:

$ ANALYZE/DISK_STRUCTURE/REPAIR SYS$SYSDEVICE

5.4.2 Checking the SYSCOMMON Directories

For the upgrade to be successful, the SYSCOMMON directories in all system roots must be aliases (or hard links) for the VMS$COMMON directory. To check whether this is the case, execute the following DIRECTORY/FILE_ID commands and compare the displayed file identifiers to ensure that they are all the same.

$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING device:[000000]VMS$COMMON.DIR
$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING device:[SYS*]SYSCOMMON.DIR

If you are booted from the system disk that you will be upgrading, you can use SYS$SYSDEVICE as the device name in these commands, as follows:

$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING SYS$SYSDEVICE:[000000]VMS$COMMON.DIR
$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING SYS$SYSDEVICE:[SYS*]SYSCOMMON.DIR

If you did not boot from the system disk that you will be upgrading, mount the disk to be upgraded and specify the actual device name in the command. For example, if the system disk to be upgraded is mounted on DKA100, you would use commands similar to the following:

$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING DKA100:[000000]VMS$COMMON.DIR
$ DIRECTORY/FILE_ID/NOHEADING/NOTRAILING DKA100:[SYS*]SYSCOMMON.DIR

Output from the first command should list a single file. Output from the second command should list one file for each system root on the disk. Check whether the file ID is the same for all of the listed files and take action as follows:

• If all the file IDs are the same, continue with the procedure described in the next section.

• If all the file IDs are not the same, this system disk does not have the directory structure that OpenVMS requires, and the upgrade will not succeed.

Correcting this problem requires detailed knowledge about how the problem was created. There is no general solution. Because it can be difficult to correct this problem, it is often easier to reinstall OpenVMS (and any layered products) on a new system disk.

5.4.3 Checking the Size of the System Disk

It is difficult to determine in advance how many blocks of disk space you will need for the upgrade. It depends on how many files you have on the target disk already and on how many components you select during the upgrade procedure. However, the following information will help:

• The maximum amount of disk space you will need is approximately 360,000 blocks, but your system might use substantially less.

• After you select the components you want installed on the system for the upgrade, the upgrade procedure calculates whether you have enough disk space, displaying the number of available blocks and the number required for the upgrade. If the procedure determines that your disk does not have enough space to perform the upgrade, it displays a message to alert you and allows you to terminate the upgrade so you can create more disk space and try the upgrade again.

To see how much space you have on the system disk, enter the following command:

$ SHOW DEVICE SYS$SYSDEVICE

5.4.4 Verifying System Parameters

Verify (and modify if necessary) system parameters, described as follows. (If necessary, see the OpenVMS System Manager’s Manual for more information about modifying system parameters.) Any system parameters that you modified and did not enter in SYS$SYSTEM:MODPARAMS.DAT are lost during the upgrade. To retain these parameters, enter their names in SYS$SYSTEM:MODPARAMS.DAT and the value that AUTOGEN needs to add to the default minimum value. (When AUTOGEN runs after the upgrade, it uses the values in SYS$SYSTEM:MODPARAMS.DAT.)

For example, if you modified GBLPAGES by 128 pages above the default, add the following line to SYS$SYSTEM:MODPARAMS.DAT:

ADD_GBLPAGES=128

If your system was upgraded previously, a new SYS$SYSTEM:MODPARAMS.DAT file was created then. This file has comments and possibly duplicated entries that were created during that upgrade. If you upgrade again, SYS$SYSTEM:MODPARAMS.DAT can become unnecessarily large and potentially confusing. Compaq recommends that you edit and reorganize SYS$SYSTEM:MODPARAMS.DAT before you upgrade again.

$Q:\adept8\entities\note.eps$ Note

On a cluster system disk, MODPARAMS.DAT should exist in SYS$SYSROOT:[SYSEXE] for each root. You must edit MODPARAMS.DAT as necessary for each root.

5.5 FEEDBACK.DAT File

Compaq recommends that, before upgrading your system, you have a recent SYS$SYSTEM:AGEN$FEEDBACK.DAT file. In OpenVMS Cluster systems, there should be a copy of this file on each node. When the system (or each system in a cluster) is rebooted after the upgrade, AUTOGEN is run. If a recent AGEN$FEEDBACK.DAT file is available, it is used. The data in this file helps AUTOGEN set system parameters for your specific applications and workload.

$Q:\adept8\entities\note.eps$ Note

If you do not have a current AGEN$FEEDBACK.DAT file, AUTOGEN may calculate system parameters that do not reflect your system’s requirements. In that case, it can take multiple cycles of running AUTOGEN and rebooting before all layered products can be started. In some cases, successful startup can require additional entries in MODPARAMS.DAT. This should not be necessary when a current AGEN$FEEDBACK.DAT file is available.

You should create a current AGEN$FEEDBACK.DAT during a time when your system is running under a typical workload. When this condition exists, enter the following command:

$ SYS$UPDATE:AUTOGEN SAVPARAMS

This runs very quickly and should not affect the performance of your system while it executes. It is a good idea to run AUTOGEN in FEEDBACK mode on a weekly — or even daily — basis.

You can also specify the SAVE_FEEDBACK option when you execute SYS$SYSTEM:SHUTDOWN.COM. However, the data captured may not fully reflect the typical workload on your system.

5.6 Finish and Shutdown

Continue the preupgrade tasks as follows, depending on whether you are upgrading in a standalone or OpenVMS Cluster environment:

IF ...

THEN ...

you are upgrading a standalone system,

do the following:

1. Log in to the SYSTEM account.

2. Enter the following command and then press the Return key:

$ @SYS$SYSTEM:SHUTDOWN

3. When the procedure asks if an automatic system reboot should be performed, enter N (No) and press the Return key.

4. Go to the checklist at the end of this chapter to verify that you have performed the necessary tasks; then go to Chapter 7, Upgrading the OpenVMS Alpha Operating System to begin the upgrade procedure.

you are upgrading an OpenVMS Cluster system,

do the following:

1. Review the checklist at the end of this chapter.

2. Go to Chapter 6, Preparing to Upgrade in an OpenVMS Cluster Environment.

5.7 Preupgrade Checklist

Use the following checklist to make sure you have performed all the tasks before beginning the upgrade:

[ ] Review all cover letters and the release notes.

[ ] Review all cautions and notes.

[ ] If your system disk is part of a shadow set, create a nonshadowed system disk to upgrade.

[ ] Set up your system to record the upgrade procedure on either a hardcopy terminal or a printer attached to the console terminal. If you do not do this, the screen messages will be lost. You will need a transcript in case there is a problem during the upgrade. For information on how to record the procedure, see the hardware manuals that came with your Alpha computer.

[ ] Make a backup copy of the system disk.

[ ] Examine and repair (if necessary) the system disk using the ANALYZE/DISK_STRUCTURE command.

[ ] Check the size of the system disk.

[ ] Verify system parameters.

[ ] Shut down the system (if you are upgrading in a standalone environment).

[ ] If you are upgrading an OpenVMS Cluster system, go to Chapter 6, Preparing to Upgrade in an OpenVMS Cluster Environment. If you are not upgrading an OpenVMS Cluster system, go to Chapter 7, Upgrading the OpenVMS Alpha Operating System to begin the upgrade procedure.

Document revision date: 24 June 2002

Preface

Intended Audience

When to Use This Manual

Document Structure

Related Documents

Reader’s Comments

How to Order Additional Documentation

Conventions

1 Getting Started

1.1 Key Terms

1.2 Examining Software and Hardware Components

1.2.1 Hardware Components

1.2.2 Software Components

1.2.3 Operating System CD–ROM

1.2.4 Firmware Revision Checking

1.2.5 Device Naming Conventions

1.3 Using the Operating System CD–ROM

1.3.1 Using the Menu

1.3.2 Sample Menu Display

1.3.3 How the Install or Upgrade Option Works

1.3.3.1 Specifying the INITIALIZE Option

1.3.3.2 Specifying the PRESERVE Option

1.3.4 How the Layered Products Options Work

1.3.5 How the DCL Option Works

1.3.6 How the Shutdown Option Works

1.4 Making the Install/Upgrade/Backup Selection

2 Preparing to Install in an OpenVMS Cluster Environment

2.1 Mixed-Version Support

2.2 OpenVMS Cluster Information You Will Need

2.3 Beginning the Installation

3 Installing the OpenVMS Alpha Operating System

3.1 Preparing to Respond to Prompts During the Installation

3.2 Booting the Operating System CD–ROM

3.2.1 Booting from the Local Drive

3.2.2 Booting from the InfoServer

3.3 Creating the System Disk

3.3.1 Installing from the CD–ROM

3.3.2 Choosing INITIALIZE or PRESERVE

3.3.3 Specifying the Target Disk

3.3.4 Specifying the Volume Label

3.3.5 Specifying the On-Disk Structure Level

3.3.6 Setting the SYSTEM Account Password

3.3.7 Becoming a Cluster Member

3.3.8 Becoming an OpenVMS Galaxy Instance

3.3.9 Installing Windowing and Networking Products

3.3.10 Setting System Parameters

3.3.11 Setting Time Zone Information

3.4 Registering Licenses

3.4.1 Types of OpenVMS Alpha Licenses

3.4.2 How to Register Licenses

3.4.3 Using the Licensing Procedure

3.5 Completing the Installation

3.5.1 Choosing Descriptive Help Text

3.5.2 Selecting Components

3.5.3 List of Components

3.5.4 Completing the Procedure

3.6 Installing Layered Products

3.7 Booting the New System Disk

3.7.1 Preparing to Boot the New System Disk

3.7.2 How to Boot the New System Disk

3.8 Joining an OpenVMS Cluster

3.8.1 OpenVMS Cluster Prompts

3.9 Running AUTOGEN

3.9.1 Automatic Reboot after Autogen

3.9.2 Manual Reboot after Autogen

3.10 Logging in to the SYSTEM Account from a Character Cell Terminal

3.11 Logging in to the SYSTEM Account from a Workstation

3.12 Postinstallation Tasks

4 After Installing the OpenVMS Alpha Operating System

4.1 Registering Your Licenses

4.2 Creating Accounts

4.3 Backing Up Your System Disk

4.4 Customizing the System

4.5 Initializing CDSA

4.6 Configuring Kerberos

4.7 Configuring and Starting Networking Software

4.7.1 DECnet-Plus for OpenVMS

4.7.2 DECnet Phase IV for OpenVMS

4.7.3 Compaq TCP/IP Services for OpenVMS

4.8 Testing the System with UETP