OpenVMS VAX Version 7.1 Upgrade and Installation Manual

November 1996

Revision/Update Information: This is a new manual.

Operating System and Version: OpenVMS VAX 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 manor 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: Bookreader, CDA, CI, DEC, DECdirect, DECdtm, DEC PHIGS, DECnet, DECset, DECterm, DECtp, DECwindows, DEQNA, Digital, Digital UNIX, EDCS, HSC, HSC50, HSC70, InfoServer, LAT, MANAGEWORKS, MicroVAX, MicroVAX II, MUXserver, OpenVMS, OpenVMS Volume Shadowing, PATHWORKS, Q-bus, RX01, RX33, RX50, TK, UETP, ULTRIX, VAX, VAX 4000, VAX 6000, VAX 8200, VAX 8250, VAX 8300, VAX 8350, VAX 8530, VAX 8550, VAX 8600, VAX 9000, VAX--11/730, VAX--11/750, VAX--11/780, VAX--11/785, VAX C, VAXBI, VAXcluster, VAXELN, VAXft, VAXlink, VAXserver, VAXset, VAXstation, VIDA, VMS, VR150, VR160, WPS--PLUS, XMI, XUI, and the DIGITAL logo.

The following are third-party trademarks:

Adobe, Adobe Illustrator, Display POSTSCRIPT, and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated.

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

Motif, OSF, OSF/1, OSF/Motif, and Open Software Foundation are registered trademarks of the Open Software Foundation, Inc.

NetView is a registered trademark of International Business Machines Corporation.

OSI is a registered trademark of CA Management, Inc.

UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited.

X/Open is a trademark of X/Open Company Limited.

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

ZK6487

The OpenVMS documentation set is available on CD-ROM.

Preface

This manual is your primary source for information about upgrading and installing the OpenVMS VAX Version 7.1 operating system. Before you attempt to install or upgrade the operating system, be sure to read all the release notes and cover letters (if any) included in your distribution kit.

If you received factory-installed software with your computer, read that user documentation first for information about starting up your system. Otherwise, use this manual for step-by-step instructions for performing an installation or an upgrade. When the instructions in this manual direct you to do so, refer to the upgrade and installation supplement for information specific to your VAX computer.

Intended Audience

If you are responsible for installing or upgrading the OpenVMS operating system and for performing related backup, shutdown, and startup procedures, read this manual before you install or upgrade to Version 7.1 of the OpenVMS VAX operating system.

Document Structure

The information in this manual is organized as follows:

• Chapter 1 provides an overview of the upgrade and installation procedures. It describes what happens during an installation or an upgrade, lists some changes and restrictions you should be aware of, and refers you to the appropriate documentation.
• Chapter 2 describes the tasks you must perform before installing the OpenVMS VAX operating system.
• Chapter 3 describes how to install Version 7.1 of the OpenVMS VAX operating system on a VAXcluster or a standalone VAX computer.
• Chapter 4 lists the tasks you should perform after you install the OpenVMS VAX operating system.
• Chapter 5 contains cautions, restrictions, and requirements for upgrading your VAX computer system and tells you how to prepare your system for an upgrade.
• Chapter 6 contains additional information for upgrading a VAXcluster environment.
• Chapter 7 describes the procedure for upgrading a standalone VAX computer.
• Chapter 8 lists the tasks you should perform after the upgrade.
• Chapter 9 describes how to customize DECwindows device support software.
• Chapter 10 describes how to use VMSTAILOR and DECW$TAILOR to add or remove optional OpenVMS software.
• Appendix A provides a quick method of applying multiple upgrades to a VAX system.
• Appendix B provides notes and supplemental license management information to the upgrade and installation procedures.
• Appendix C describes how to boot from the [SYSF] directory on the different types of VAX computers.
• Appendix D lists the subclasses in the OpenVMS VAX optional save sets C, D, E, and F.
• Appendix E lists DECwindows display server and font files.
• Appendix F lists files installed either over or under the version numbers of existing files during an upgrade.
• Appendix G describes how to prepare your OpenVMS system and your PC to run the OpenVMS Management Station server and client software.
• Appendix H describes methods for managing small capacity system disks, including some specific recommendations for installing or upgrading to the OpenVMS VAX Version 7.1 operating system and the DECwindows Motif for OpenVMS Version 1.2--3 layered product.
• The Glossary defines commonly used terms.
• The Index provides a quick way to find information.

Related Documents

The following documents contain information associated with performing an upgrade or installation:

• The upgrade and installation supplement for your VAX computer---Provides supplemental information necessary during an installation or upgrade, such as booting the system and determining device names.
• OpenVMS Version 7.1 Release Notes ---Describes changed and enhanced software features, software problems and restrictions, and changes to the documentation for Version 7.1 of the OpenVMS VAX operating system.
• OpenVMS Version 7.1 New Features Manual---Describes new software features for the OpenVMS Version 7.1 operating system.
• OpenVMS Cluster Systems---Describes the procedures for establishing and managing VAXcluster configurations.
• OpenVMS License Management Utility Manual---Provides information about registering and managing licenses on an OpenVMS VAX system.
• OpenVMS Guide to System Security---Describes security features provided by the OpenVMS VAX operating system, including criteria for C2 systems.
• OpenVMS System Manager's Manual---Provides task-oriented information about managing an OpenVMS system, including how to use the VMSINSTAL command procedure.
• OpenVMS DCL Dictionary---Provides detailed reference information and examples for all OpenVMS DCL commands.
• OpenVMS System Management Utilities Reference Manual: M--Z---Provides complete information about using the POLYCENTER Software Installation utility PRODUCT command.
• The hardware manuals supplied with your VAX computer provide detailed information about system hardware.

For additional information about 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

In this manual, every use of OpenVMS VAX means the OpenVMS VAX operating system.

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.
PF1 x	A sequence such as PF1 x indicates that you must first press and release the key labeled PF1, then press and release 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.)
...	A horizontal ellipsis in examples indicates 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 format descriptions, parentheses indicate that, if you choose more than one option, you must enclose the choices in parentheses.
[ ]	In 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 format descriptions, braces surround 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 emphasizes important information, indicates variables, and indicates complete titles of manuals. Italic text also represents information that can vary in system messages (for example, Internal error number), command lines (for example, /PRODUCER= name), and command parameters in text.
UPPERCASE TEXT	Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
-	A hyphen in code examples indicates that additional arguments to the request are provided on the line that follows.
numbers	All numbers in text are assumed to be decimal, unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

This manual often refers to products by their abbreviated names. For example, the VAX 8200, VAX 8250, VAX 8300, and VAX 8350 computers are referred to as the VAX 8200, 8250, 8300, 8350. The MicroVAX 2000 computer is referred to as the MicroVAX 2000, and so on.

This chapter provides a general description of what happens during the installation and upgrade procedures, including information you should be aware of before you upgrade to or install the OpenVMS VAX Version 7.1 operating system.

This chapter also describes the contents of the distribution kit, tells you whether you should do an installation or an upgrade, and refers you to the appropriate documentation.

1.2 Important Information

Before you install or upgrade to OpenVMS VAX Version 7.1, you should review the information in this section.

1.2.1 DECnet--Plus

The OpenVMS VAX Version 7.1 kit includes the DECnet--Plus software. The DECnet Phase IV product is no longer part of the operating system installation and upgrade menus. During the OpenVMS VAX installation or upgrade procedure, you are given the option to install the DECnet--Plus product. Whether or not you chose to install DECnet--Plus, DECnet Phase IV will not be present on your system after you install or upgrade to OpenVMS VAX Version 7.1.

A kit containing the DECnet--Plus software is provided with the OpenVMS VAX Version 7.1 kit. In future releases, customers who do not receive the operating system installation kit on CD-ROM will need to purchase the DECnet--Plus media and documentation separately.

If you want to use the DECnet Phase IV product, a DECnet Phase IV kit is provided, which you can install after you have installed OpenVMS VAX Version 7.1. However, be aware that, if you install or reinstall DECnet Phase IV, you must purchase a separate support contract.

Note

If DECnet--Plus is installed on your system, you must remove that product before you install the DECnet Phase IV product. Both DECnet products cannot run at the same time.

To install DECnet Phase IV, do the following after the OpenVMS VAX installation or upgrade is complete:

• If DECnet--Plus is installed on your system, use the PRODUCT REMOVE command to remove that product. (See OpenVMS System Management Utilities Reference Manual: M--Z for complete information about using the PRODUCT command.)
• Mount the distribution media that contains the DECnet Phase IV kit.
  For example, if your OpenVMS VAX distribution media is on CD-ROM and you want to mount it on a local drive, DKA400, you would enter a command similar to the following:

  $ MOUNT/OVER=ID DKA400
  

  
  If you are using an InfoServer device, enter the following command to see if the device DAD0 is present on your system:

  $ SHOW DEVICE DAD0
  

  If DAD0 is not present, enter the following:

  $ @SYS$STARTUP:ESS$STARTUP CLIENT
  

  
  Once DAD0 is present, bind to the service and mount the CD. For example, if the service name is VAXVMS071, you would enter a command similar to the following:

  $ MCR ESS$LADCP BIND VAXVMS071
  $ MOUNT/OVER=ID DAD$VAXVMS071
  

  
  Now, invoke the POLYCENTER Software Installation utility and install DECnet Phase IV by entering a command similar to the following:

  $ PRODUCT INSTALL DECNET_PHASE_IV /SOURCE=DKA400:[KITS.DECNET_PHASE_IV_KIT]   
  

  For DKA400, substitute the correct name for your source drive.
• If your distribution media is on TK50 tapes, mount the TK50 volume that contains the DECnet Phase IV kit.
  For example, if the device name of your TK50 drive is MKA500, you would enter a command similar to the following:

  $ MOUNT/OVER=ID MKA500:
  

  
  Now, install the DECnet Phase IV product by entering a command similar to the following:

  $ PRODUCT INSTALL DECNET_PHASE_IV /SOURCE=MKA500:
  

  
  For MKA500:, substitute the correct name for your source drive.

For more information about the DECnet--Plus product, see the OpenVMS Version 7.1 New Features Manual and the DECnet/OSI for OpenVMS Installation and Configuration.

1.2.2 DECwindows Motif for OpenVMS---Minimum Version

For OpenVMS VAX Version 7.1, the minimum supported version of DECwindows Motif for OpenVMS is 1.2--3.

1.2.3 MACRO32.EXE and Standalone Backup

To build standalone backup onto tape, you must have the image MACRO32.EXE on your system disk. Do not tailor off the Macro libraries before building standalone backup onto tape.

1.2.4 Layered Product Availability

The most current information about layered product support is available in the Software Public Rollout Reports for OpenVMS. These reports are available from the OpenVMS World Wide Web site in the "literature" section. Use the following URL:

     http://www.openvms.digital.com 

If you do not have access to the Internet, you can find the operating system support information on any of the quarterly Software Products Libraries, in the following directory:

     [README]SW_COMPAT_MATRIX.PS  (.TXT) 

Restrictions for OpenVMS VAX Version 7.1 include:

• The minimum memory requirement is 4 megabytes.
• The MA780 shared memory is not supported.
• You cannot install or upgrade to Version 7.1 of the OpenVMS VAX operating system on the following VAX computers and system disks:

  Computers	MicroVAX I, VAXstation I, VAXstation 8000, VAX--11/725, and VAX--11/782
  System disks	RK07, RL02, RC25, RD32, RD51, RD52, RD53, RZ22, and RZ23L.

• If your system uses a small-capacity system disk (less than 210 megabytes), the entire OpenVMS VAX Version 7.1 operating system and the complete DECwindows Motif for OpenVMS VAX layered product will not fit on your disk. Appendix H describes some methods that will enable you to install or upgrade to OpenVMS VAX Version 7.1 and DECwindows Motif for OpenVMS VAX on a small-capacity system disk.
  Note that you can use the methods described in Appendix H to free up disk space on any system.

For more information about these restrictions, see the OpenVMS Operating System for VAX and Alpha, Version 7.1 Software Product Description (SPD).

1.3 Definitions: A Few Key Terms

You should be familiar with the following key terms before performing an installation or upgrade:

Term	Definition
Distribution Media	The media containing the OpenVMS VAX operating system software. This software is supplied in a format that the computer cannot use until you perform an installation or upgrade.
System Disk	The disk that contains (or will contain) the OpenVMS VAX operating system in a usable format. The installation or upgrade procedure converts the OpenVMS VAX operating system software to this usable format when transferring the software from the distribution media to the system disk.
Local Drive	A drive that is connected directly to a VAX computer. For example, a magnetic tape drive connected directly to a VAX computer is referred to as a local tape drive. If you have a standalone VAX computer, it is likely all the drives connected to your system are local drives.
InfoServer	A general-purpose disk storage server that allows you to use the distribution compact disc to install the operating system on remote client systems connected to the same LAN (local area network).
Source Drive	The drive that holds the distribution media during the upgrade or installation.
Target Drive	The drive that holds the system disk---or, for some files, the alternate disk---during the upgrade or installation.
HSC Drive	A drive connected to a hierarchical storage controller (HSC) device. For example, a magnetic tape drive connected to an HSC device is referred to as an HSC tape drive. The HSC is a self-contained, intelligent, mass storage subsystem that enables VAXcluster nodes to share Digital Storage Architecture (DSA) disks.

For definitions of other specialized terms used in this manual, see the Glossary at the end of this book.

1.4 Locating Files on the Distribution Media

The OpenVMS VAX files are stored on the distribution media as the following save sets:

Save Set Name	Description
VMS071.A	Required
VMS071.B	Required
VMS071.C	Library (optional)
VMS071.D	Optional (optional)
VMS071.E	Help Message (optional)
VMS071.F	OpenVMS Management Station software PC files (optional)

See Appendix D for descriptions of the file subclasses contained in the optional save sets.

The optional DECwindows support files are stored on the distribution media as the following save sets:

Save Set Name	Description
DECW071.C	Base support files
DECW071.D	Workstation support files
DECW071.E	75 dots-per-inch (dpi) font files
DECW071.F	100 dpi font files

1.4.1 On Magnetic Tape

The OpenVMS VAX Version 7.1 magnetic tape kit contains OpenVMS VAX software on four tapes. The first tape contains the required save sets VMS071.A and VMS071.B. The second tape contains the save set VMS071.C. The third tape contains save sets VMS071.D, VMS071.E, and VMS0701F. The fourth tape contains the DECwindows base support and workstation support files, and DEC AMDS files.

1.4.2 On Tape Cartridges

The OpenVMS VAX Version 7.1 TK50 tape kit contains OpenVMS VAX software on two tape cartridges. The first cartridge contains VMS071.A, VMS071.B, and VMS071.C save sets. The second cartridge contains standalone BACKUP, VMS071.D, VMS071.E, and VMS071.F save sets, DECwindows base support and workstation support files, and DEC AMDS files.

1.4.3 On Compact Disc

The OpenVMS VAX Version 7.1 compact disc kit contains all the save sets and DECwindows base and workstation support files on one compact disc. (For more information, see the Guide to OpenVMS Version 7.1 CD--ROMs.)

Note that you can install or upgrade the operating system from a local compact disc drive as well as from an InfoServer device.

1.4.4 DECamds and Monitoring Performance History (MPH) Files

The DECamds software is included as save sets AMDS071.A and AMDS071.B on the OpenVMS VAX distribution media. The save sets are located on the third magnetic tape volume, on the second tape cartridge, and on the compact disc in the [AMDS071] directory.

The Monitoring Performance History (MPH) kit is also included on the OpenVMS VAX distribution media. The MPH kit is located on the third magnetic tape, on the second tape cartridge, and on the compact disc in the [MPH] directory.

1.4.5 Software Product Descriptions (SPDs)

The following SPD files are located on the second tape cartridge of the TK50 distribution kit and the third tape of the magnetic tape distribution kit. These SPD files have been grouped into an OpenVMS BACKUP save set named VMS071_SPD.BCK. File names with the .PS extension are in PostScript format. File names with the .TXT extension are in plain ASCII text format.

DECNET_SPD.PS DECNET_SPD.TXT	DECnet--Plus for OpenVMS VAX and Alpha, Version 7.1
OVMS_71_SPD.PS OVMS_71_SPD.TXT	OpenVMS Operating System for VAX and Alpha, Version 7.1
RMS_SPD.PS RMS_SPD.TXT	RMS Journaling for OpenVMS, Version 7.1
CLUSTER_SPD.PS CLUSTER_SPD.TXT	OpenVMS Cluster Software
VOL_SHAD_SPD.PS VOL_SHAD_SPD.TXT	Volume Shadowing for OpenVMS, Version 7.1

To obtain all the SPD files and restore them to your current default directory, enter a BACKUP command using the following format:

BACKUP source-drive:VMS071_SPD.BCK /SAVE_SET *.*;* 

For source-drive, substitute the name of the device that holds your distribution kit. For example, if your source-drive is a local magnetic tape drive with the device name MUAO, you would enter the following command:

$ BACKUP MUAO:VMS071_SPD.BCK/SAVE_SET  *.*;*

To restore all the SPD files in PostScript format to your default directory, enter the following:

$ BACKUP MUAO:VMS071_SPD.BCK/SAVE_SET/SELECT=*.PS  *.*;*

The following command restores the PostScript SPD file for the OpenVMS VAX and OpenVMS Alpha operating systems to your current default directory:

$ BACKUP MUAO:VMS071_SPD.BCK/SAVE_SET/SELECT=OVMS_71_SPD.PS  *.*;*

If your distribution kit is on compact disk, the SPD files are located in the [DOCUMENTATION.V071] directory. For information about locating and printing these SPD files, see the Guide to OpenVMS Version 7.1 CD--ROMs.

1.5 What Happens During an Installation

When you install the OpenVMS VAX operating system, the installation procedure does the following:

• Initializes the system disk, overwriting its contents.
• Creates a system directory structure.
• Transfers the OpenVMS VAX files from the distribution media to the system disk. Some files can be transferred to an alternate disk.

Use the installation procedure under the following conditions:

• If your VAX computer is new (it has never had any version of the operating system running on it, including factory-installed software).
• If your VAX computer is running a previous version of the operating system and you want to overwrite the entire contents of the system disk (the OpenVMS VAX operating system, application software, and user files).
• If you are running a previous version of the operating system, but you cannot upgrade. For example, if you changed the names of system directories on the system disk, the upgrade procedure will not work correctly. You can either restore the system disk to its original directory structure, or you can reinstall the OpenVMS VAX operating system.

  6487P.HTM
  OSSG Documentation
   9-DEC-1996 10:53:39.23

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal