This guide describes the installation procedure for DECram for OpenVMS.
Revision/Update Information This guide supersedes the DECram for OpenVMS Installation Guide Version 2.2.
Operating System and Version: OpenVMS VAX Version 6.2 or higher, OpenVMS Alpha Version 6.2 or higher
Software Version: DECram for OpenVMS Version 2.3
Compaq Computer Corporation
Houston, Texas
Compaq Computer 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 Compaq or an authorized sublicensor.
Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.
© Compaq Computer Corporation 1999. All rights reserved.
The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECdirect, DIGITAL, OpenVMS, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.
All other trademarks and registered trademarks are the property of their respective holders.
ZK6397
The DECram documentation set is available on CD-ROM.
| Contents |
This guide describes the installation procedure for the DECram for OpenVMS Device Driver (MDDRIVER).
This guide is intended for system managers who should be familiar with managing the OpenVMS VAX and the OpenVMS Alpha operating systems.
This guide consists of three chapters and one appendix, as follows:
See the following documents for information on installation and upgrading OpenVMS VAX or OpenVMS Alpha systems:
For additional information on the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:
http://www.openvms.digital.com |
Compaq 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 |
|
Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 |
Use the following World Wide Web address to order additional documentation:
http://www.openvms.digital.com:81/ |
If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).
The following conventions are 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 and 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.)
In the HTML version of this document, this convention appears as brackets, rather than a box. |
| ... |
A horizontal ellipsis in examples indicates one of the following
possibilities:
|
|
.
. . |
A vertical ellipsis indicates 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 you must enclose the options in parentheses if you choose more than one. |
| [ ] | 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, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options. |
| { } | In command format descriptions, braces indicate required elements; you must choose one of the options listed. |
| bold text | This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason. |
| 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 dd represents the predefined code for the device type). |
| 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 text |
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 guide describes how to install DECram for OpenVMS. You can install DECram for OpenVMS on OpenVMS Alpha Version 6.1 and subsequent versions, and on OpenVMS VAX Version 6.1 and subsequent versions.
Your bill of materials (BOM) and indented bills report (BIL) specify the contents of your kit. Be sure to verify the contents of your kit with this information. If your kit is damaged or if parts of it are missing, contact your Compaq representative.
DECram for OpenVMS provides online release notes. Compaq recommends that you
read the release notes before proceeding with the installation. To
access the online release notes, see Chapter 2.
1.1 License Registration
You must register and load your license for DECram for OpenVMS before you start the installation. This will allow you to run the Installation Verification Procedure (IVP) and use the software after the installation completes.
Log in to the system manager's account, SYSTEM, to register a license. You then have a choice of two ways to perform the registration:
If you plan to use DECram for OpenVMS on more than one node in an OpenVMS Cluster system, you will need to load a license, register it, and install DECram for OpenVMS on the other nodes as well. |
For complete information on using the License Management Facility
(LMF), see the OpenVMS License Management Utility Manual.
1.2 Installation Procedure Requirements
This section and those that follow discuss various requirements for
installing DECram for OpenVMS. The installation takes approximately 15
minutes, depending on your type of media and your system configuration.
1.2.1 Privileges and Disk Space
To install DECram for OpenVMS, you must be logged in to an account that has SETPRV or at least the following privileges enabled:
Note that VMSINSTAL disables BYPASS privilege at the start of the installation.
The requirements of DECram for OpenVMS for free disk storage space are different during installation and after installation. Table 1-1 summarizes the storage requirements.
| Kit | Blocks During Installation | Blocks After Installation |
|---|---|---|
| DECram for OpenVMS Version 2.3 | 2500 | 1655 |
To determine the number of free disk blocks on the system disk, enter the following command at the DCL prompt:
$ SHOW DEVICE SYS$SYSDEVICE |
To install DECram for OpenVMS on an OpenVMS Alpha or on an OpenVMS VAX operating system, you do not need to change the default system parameter settings.
Using DECram for OpenVMS on an OpenVMS VAX system requires that you increase the number of System Page Table Entries (SPTEs) and also increase the system parameter SPTREQ. The following sections contain information on how to perform these functions. |
The number of SPTEs is determined by the size of the DECram disk to be created. All SPTEs must be available contiguously or the configuration procedure will fail.
Additional SPTEs for a DECram disk can be created by increasing the size of the system parameter SPTREQ. Use the following algorithm to determine the SPTREQ increase:
(Size of DECram disk in blocks + 127)/128 + 128 = SPTREQ increase
For example, the following algorithm determines that an SPTREQ increase of 207 is required for a DECram disk of 10,000 blocks:
((10,000+127)/128)+128 = 207
1.2.2.2 Increasing the System Parameter SPTREQ (VAX Only)
If the current value of SPTREQ is inadequate for a given disk, the system must be rebooted to allow for a larger value. Therefore, Compaq recommends that you increase the SPTREQ value to a multiple of 128. Consequently, the increase for this example should be 256; the amount of memory wasted would be negligible.
To increase SPTREQ by 256, edit the file SYS$SYSROOT:[SYSEXE]MODPARAMS.DAT and add the following line:
ADD_SPTREQ 256 |
You must then run the command procedure AUTOGEN.COM using the following command:
$ @SYS$UPDATE:AUTOGEN GETDATA REBOOT |
The SPTREQ value now includes the increase required for the DECram disk.
If more than one DECram disk is created, use the algorithm to determine
the initial SPTREQ increase for each disk, then increase each initial
value to a multiple of 128. The sum of the individual SPTREQ increases
is the total amount required to accommodate all the disks.
1.2.3 VMSINSTAL Requirements
When you invoke the VMSINSTAL command procedure, it verifies the following, all of which are transparent:
If VMSINSTAL detects any problems during the installation, it notifies
you and asks if you want to continue the installation. In some
instances, you can enter YES and press Return to continue. To stop the
installation process and correct the situation, enter NO or press
Return. Then correct the problem and restart the installation.
1.2.4 Backing Up Your System Disk
At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Compaq recommends that you perform a system disk backup before installing any software.
Use the backup procedures that are established at your site.
For details on performing an OpenVMS Alpha system disk backup, see the OpenVMS Alpha Upgrade and Installation Manual.
For details on performing an OpenVMS VAX system disk backup, see the processor-specific upgrade and installation supplement for your system.
This chapter explains how to install DECram for OpenVMS, and includes
information on the Installation Verification Procedure (IVP) and
installation messages.
2.1 Installation Procedure
The DECram for OpenVMS installation procedure consists of a series of questions and informational messages. See the sample installation in Appendix A.
To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all files it has created up to that point and exits. You can start the installation again at a later time.
$ @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N |
The following list defines the elements of the VMSINSTAL command
procedure:
saveset-name
The installation name for the component. For DECram for OpenVMS, use the following installation name:
DECRAMdevice-name
The name of the device on which you plan to mount the installation media. For example, MTA0: is the device name for some tape drives. It is not necessary to use the console drive for this installation. However, if you do use the console drive, once the installation is complete you should return the console media to the console drive.OPTIONS N
An optional parameter that indicates you want to see the question on release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You should review the release notes before proceeding with the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N.
$ @SYS$UPDATE:VMSINSTAL DECRAM MTA0: OPTIONS A,N
VAX/VMS Software Product Installation Procedure V5.3
It is 15-Jul-1995 at 09:10.
Enter a question mark (?) at any time for help.
|
* Are you satisfied with the backup of your system disk [YES]? |
Please mount the first volume of the set on MTA0:.
* Are you ready? YES
%MOUNT-I-MOUNTED, DECRAM MOUNTED ON _$$MTA0: (NODE 1)
The following products will be processed:
DECRAM
Beginning installation of DECRAM V2.2B at 09:12
%VMSINSTAL-I-RESTORE, Restoring product saveset A...
|
Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: |
* Queue name [SYS$PRINT]: |
* Do you want to continue the installation [N]?: YES
%VMSINSTAL-I-RELMOVED, The product's release notes have been
successfully moved to SYS$HELP.
|
SYS$HELP:DECRAM.RELEASE_NOTES |
* Do you want to purge files replaced by this installation [YES]? |
* Do you want to run the IVP after the installation [YES]? |
The IVP creates a DECram disk MDA0 that remains after the IVP completes. If you do not want this disk, do not run the IVP. |
Successful Termination of DECram V2.2 IVP. |
Installation of DECRAM V2.2B completed at 09:27
Enter the products to be processed from the next distribution
volume set.
* Products: exit
VMSINSTAL procedure done at 09:27
|
$ LOGOUT SYSTEM logged out at 15-Jul-1995 13:21.13 |
If you plan to use DECram for OpenVMS on more than one node in an OpenVMS Cluster, you must install DECram for OpenVMS on the other nodes as well. |
| Next | Contents |