OpenVMS Alpha Version 7.1
Upgrade and Installation Manual

November 1996

Revision/Update Information: This is a new manual.

Software Version: OpenVMS Alpha Version 7.1

Digital Equipment Corporation Maynard, Massachusetts

Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor.

Digital conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.

© Digital Equipment Corporation 1996. All rights reserved.

The following are trademarks of Digital Equipment Corporation: AlphaServer, AlphaStation, Bookreader, CI, DEC, DECdirect, DECdtm, DECnet, DECterm, DECwindows, Digital, HSC, InfoServer, LAT, ManageWORKS, MSCP, OpenVMS, OpenVMS Cluster, PATHWORKS, POLYCENTER, RRD42, RZ, TeamLinks, TURBOchannel, UETP, VAX, VAX DOCUMENT, VMS, VMScluster, XUI, and the DIGITAL logo.)

The following are third-party trademarks:

Adaptec is a trademark of Adaptec, Inc.

3Com is a registered trademark of the 3Com Corporation.

Microsoft, MS, and MS--DOS are registered trademarks of Microsoft Corporation.

Motif is a registered trademark of the Open Software Foundation, Inc.

NetView is a registered trademark of International Business Machines Corporation.

All other trademarks and registered trademarks are the property of their respective holders.

ZK6486

The OpenVMS documentation set is available on CD-ROM.

Preface

Intended Audience

This manual is intended for anyone responsible for installing or upgrading the OpenVMS Alpha operating system and for the startup, shutdown, and backup operations required on Alpha computers running this software.

When to Use This Manual

If you received factory-installed software (FIS) with your Alpha computer, refer to that user documentation to start up your system for the first time. Use this manual if you need to install or upgrade the OpenVMS Alpha operating system software yourself or if you need to perform certain startup, shutdown, or backup operations.

Document Structure

This manual is organized as follows:

• Chapter 1 defines key terms and provides information about hardware and software components. Review this chapter before performing any installation or upgrade.
• Chapter 2 provides preliminary information about installing the operating system in an OpenVMS Cluster environment.
• Chapter 3 describes how to install the operating system.
• Chapter 4 describes the tasks you must perform after installing the operating system.
• Chapter 5 describes how to prepare your system for an upgrade.
• Chapter 6 supplements Chapter 5 with additional tasks you must perform before upgrading an OpenVMS Cluster system.
• Chapter 7 describes how to upgrade the operating system.
• Chapter 8 describes the tasks you must perform after upgrading the operating system.
• Appendix A contains instructions for halting the system, booting the operating system CD--ROM and the system disk, using console commands to set system parameters, using the Writeboot utility, and invoking system shutdown procedures.
• Appendix B describes how to back up and restore the system disk.
• Appendix C contains supplementary information about registering licenses.
• Appendix D provides release notes, restrictions, and related information about using the OpenVMS Alpha operating system on specific Alpha computers.
• Appendix E describes how to prepare your OpenVMS system and your PC to run the OpenVMS Management Station server and client software.
• The Glossary defines key terms used in this manual.

Related Documents

Before installing, upgrading, or using the OpenVMS Alpha operating system on your Alpha computer, be sure you have access to the following documents:

• All cover letters included with your kit.
• The OpenVMS Version 7.1 Release Notes, which provides important supplementary information about the OpenVMS Alpha operating system.
• OpenVMS Cluster Systems and Guidelines for OpenVMS Cluster Configurations, if you plan to install your system in an OpenVMS Cluster environment.
• OpenVMS Version 7.1 New Features Manual, which describes enhancements and new support included in the OpenVMS Version 7.1 operating system.
• The most recent version of the DECwindows Motif for OpenVMS Installation Guide and Managing DECwindows Motif for OpenVMS Systems (if you plan to install and customize DECwindows Motif for OpenVMS Alpha software).
• The following DECnet-Plus (Phase V) documents:
  • DECnet-Plus Release Notes
  • DECnet-Plus for OpenVMS Installation and Basic Configuration
  • DECnet-Plus for OpenVMS Applications Installation and Advanced Configuration Manual
• The hardware manuals that are supplied with your Alpha computer. These manuals provide detailed information about your system hardware, including the operation of the system unit, the drives, and the monitor.

During the course of installing, upgrading, or using the OpenVMS Alpha operating system on your Alpha computer, you might need to refer to the following documents as well:

• OpenVMS License Management Utility Manual, which contains detailed information about registering your software licenses.
• OpenVMS System Manager's Manual and the OpenVMS System Management Utilities Reference Manual, which contain information about system management operations and utilities that you might need to use when you install, upgrade, customize, and maintain your OpenVMS Alpha system. The OpenVMS System Management Utilities Reference Manual: M--Z provides complete information about using the POLYCENTER Software Installation utility PRODUCT command to add or remove files, install other software, and related operations.
• DECnet for OpenVMS Guide to Networking, which contains detailed information about using the DECnet for OpenVMS Alpha (Phase IV) software (if you have chosen to use this DECnet product instead of DECnet-Plus (Phase V) software).
• Volume Shadowing for OpenVMS, which you might need if you are installing or upgrading the OpenVMS Alpha operating system on a shadowed system disk.
• OpenVMS Management Station Overview and Release Notes, which provides information about getting started, setting up, and using OpenVMS Management Station.

For additional information on the Open Systems Software Group (OSSG) products and services, access the Digital OpenVMS World Wide Web site. Use the following URL:

http://www.openvms.digital.com 

Reader's Comments

Digital welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:

Internet	openvmsdoc@zko.mts.dec.com
Fax	603 881-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail	OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following table to order additional documentation or information. If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).

Conventions

The name of the OpenVMS AXP operating system has been changed to the OpenVMS Alpha operating system. Any references to OpenVMS AXP or AXP are synonymous with OpenVMS Alpha or Alpha.

VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references in this document to OpenVMS Clusters or clusters are synonymous with VMSclusters.

In this manual, every use of DECwindows and DECwindows Motif refers to DECwindows Motif for OpenVMS software.

The following conventions are also used in this manual:

Ctrl/ x	A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
[Return]	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)
...	Horizontal ellipsis points in examples indicate one of the following possibilities: Additional optional arguments in a statement have been omitted. The preceding item or items can be repeated one or more times. Additional parameters, values, or other information can be entered.
. . .	Vertical ellipsis points indicate the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( )	In command format descriptions, parentheses indicate that, if you choose more than one option, you must enclose the choices in parentheses.
[ ]	In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
{ }	In command format descriptions, braces indicate a required choice of options; you must choose one of the options listed.
text style	This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. This style is also used to show user input in Bookreader versions of the manual.
italic text	Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where device-name contains up to five alphanumeric characters).
UPPERCASE TEXT	Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type	Monospace type indicates code examples and interactive screen displays. In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

This chapter defines key terms and describes preliminary procedures you must perform before an installation or upgrade.

1.1 Key Terms

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

Term	Definition
Operating system CD--ROM	The CD--ROM containing the OpenVMS Alpha operating system. This software is supplied in a format that the computer cannot use until you perform an installation or upgrade.
HS x 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 in a usable format. The installation or upgrade procedure converts the OpenVMS Alpha operating system to this usable format when transferring the software from the operating system CD--ROM 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.

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 Digital 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.

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 Operating System V7.1 Software
Volume Label:	ALPHA071

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 Required PALcode

The required and recommended minimum version of privileged architecture library code (PALcode) for Alpha computers is either 5.56 or 1.19, depending on your model.

If your computer console does not have a specific minimum version of the PALcode, you may not be able to boot your system during the installation or upgrade procedure. Digital recommends, therefore, that you do the following before performing an installation or upgrade:

1. At the console prompt (>>>) on your running Alpha system, enter the SHOW CONFIGURATION command (or SHOW PAL command on DEC 7000 and DEC 10000 Alpha series systems). The system display will indicate which version of PALcode your computer is running.
2. Refer to the most recent OpenVMS Alpha operating system cover letter or release notes, or contact your Digital support representative to determine whether your system is running the required or recommended minimum version of PALcode.
3. If the PALcode is below the required or recommended minimum, upgrade your console by following the directions contained in either the hardware manuals that came with your Alpha computer or supplementary release notes contained on the separate firmware CD--ROM.

Note: If you boot the operating system CD--ROM without first upgrading your console to the required or recommended minimum PALcode, the system will display messages similar to the following:

• If you do not have the required minimum PALcode, the system displays a fatal error message similar to the following:

  APB-F-PALREV, PALcode revision 5.48 is below required minimum of 5.56 
          UNABLE TO CONTINUE 
  

• If you do not have the recommended minimum PALcode, the system displays a warning message similar to the following:

  APB-W-PALREV, PALcode revision 1.17 is below recommended minimum of 1.19 
  

  
  Although you will still be able to boot your system, contact your Digital support representative about upgrading your console to the recommended minimum version of the PALcode before installing or upgrading the operating system.

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.

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, using the POLYCENTER Software Installation utility
• List the 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 (change options) 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

    OpenVMS Alpha (TM) Operating System, Version 7.1 
 
 
    Copyright (c) 1996 Digital Equipment Corporation.  All rights reserved. 
 
 
 
    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)  Install or upgrade OpenVMS Alpha Version V7.1 
        2)  Display products that this procedure can install 
        3)  Install or upgrade layered products 
        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 ? to repeat menu: (1/2/3/4/5/6/7/8/?) 

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

• 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.

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.

Note: If you intend to choose the PRESERVE option (because there are certain files on the disk that you want to retain), Digital 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.

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.

Note: When you boot the OpenVMS operating system CD--ROM and select the option to install layered products, that installation procedure does not run the Installation Verification Procedure (IVP) for each layered product. Because the operating system is booted from the CD--ROM and the layered products are installed on a different device (the target disk), 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 (4) 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 and utilities 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.

  6486P.HTM
  OSSG Documentation
   6-DEC-1996 10:35:06.72

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal