This chapter contains general information about the OpenVMS installation procedure (VMSINSTAL) and explains each step of the procedure. This chapter also describes additional DECdfs installation messages that you may receive during an installation.

2.1 Preliminary Information

Compaq recommends that you read Section 1.11 and this section before you install DECdfs. Compaq also recommends that you back up your system before beginning the installation.

Use the installation procedure, VMSINSTAL, to install the DECdfs software on an OpenVMS system. The sample procedure in Section 2.2 installs both client and server software on a node. If you are establishing a client-only node, you can delete the files that are used by only the server after the DECdfs installation is complete. See Section 3.8 for more information about reclaiming disk space.

VMSINSTAL asks a series of questions, to which you must provide appropriate responses. Default responses appear in brackets ([]). Press Return to accept the default response. For help while installing DECdfs, enter a question mark (?) after the prompt.

To abort the installation procedure, press Ctrl/Y. The installation procedure deletes all DECdfs files that it has created up to that point and returns to the DCL prompt ($). If you want to retry the installation procedure after you press Ctrl/Y, you must invoke VMSINSTAL again. See Step 2 in Section 2.2 for additional information.

To save a copy of the VMSINSTAL session on disk for future reference, use the SET HOST 0 /LOG command before invoking VMSINSTAL. Node 0 represents the local node. See Appendix B for sample installations.

Before you install DECdfs, ensure that:

• Your system is running the required software (see Section 1.3 for additional information).
• Your system has the required free disk space on the system disk (see Section 1.5 for additional information).
• You modified the SYSGEN parameters as described in Section 1.7.
• Your DECnet Phase IV or DECnet Phase V software is installed and running.
• At least one DECdfs server is installed, running, and accessible and at least one registered access point is available if you wish to create a DECdfs client-only configuration and run the Installation Verification Procedure (IVP).
• If you are running DECnet Phase IV on a VAX processor, the Digital Distributed Name Service is running on the network and is accessible (see Section 1.10.2 for additional information).
• If you are running DECnet Phase IV on a VAX processor, the file SYS$SYSTEM:DNS$DEFAULT_FILE.DAT is necessary for DECdns to work properly. If this file does not exist on your system, execute SYS$STARTUP:DNS$CHANGE_DEF_FILE.COM to obtain a copy of this file from your DECdns server. The file is not necessary if you are running DECnet Phase V. DECdns is not available on Alpha systems running DECnet Phase IV.

This section presents the steps of a sample installation procedure for installing DECdfs client and server software. To install the DECdfs software, follow these steps:

Step 1. Log in to the system manager account.

The system manager account has the necessary privileges to run VMSINSTAL.

Step 2. Invoke VMSINSTAL.

To invoke VMSINSTAL, enter the following command line:

$ @SYS$UPDATE:VMSINSTAL DECDFS023 ddcu: OPTIONS N

The value ddcu: represents the name of the device where you mounted the distribution media. For example, if the DECdfs kit is in a subdirectory on a user disk, you might construct the device name MY_SYS$DUA1:[MY_DIRECTORY]. When you invoke VMSINSTAL and include the OPTIONS N parameter in the command line, you can view or print the release notes automatically. If you omit OPTIONS N in the command line, you cannot print or read the release notes until after the installation procedure is complete.

The following message is displayed on the screen:

VAX/VMS Software Product Installation Procedure Vn.n It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help.

Step 3. Check the system environment.

VMSINSTAL checks your system environment and notifies you of any running processes. For example, your system might display the following message:

%VMSINSTAL-W-ACTIVE, The following processes are still active: MAIL_38503

* Do you want to continue anyway [NO]?

This message is informational only. Enter NO (or press Return) to end the installation and return to the DCL prompt ($). Enter YES to continue installing DECdfs.

Step 4. Check backup.

The following message reminds you to back up your system disk before installing software:

* Are you satisfied with the backup of your system disk [YES]?

Enter YES to continue installing DECdfs. Enter NO to end the installation and return to the DCL prompt ($).

Step 5. Mount the installation kit volume.

If the device you provided in step 2 for the distribution media is not mounted, VMSINSTAL prompts you to mount the installation kit volume. Mount the volume and ensure that the device is in the READY state. Enter YES and press Return when you are ready. A message confirms that the media is mounted and ready:

Please mount the first volume of the set on ddcu: * Are you ready? YES %MOUNT-I-MOUNTED, DECDFS023 mounted on _ddcu:.

Step 6. Start the installation.

After you mount the installation kit volume, VMSINSTAL displays the following messages:

The following products will be processed: DECDFS V2.3 Beginning installation of DECDFS V2.3 at hh:mm %VMSINSTAL-I-RESTORE, Restoring product save set A ...

Release notes included with this kit are always copied to SYS$HELP. If you included OPTIONS N in the command line in step 2, the Additional Release Notes Options menu is displayed. You can select one of the following options:

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]: 2

If you choose option 1, VMSINSTAL displays the release notes at your terminal.

If you choose option 2, VMSINSTAL prompts you to enter a print queue name as follows:

Queue name [SYS$PRINT]:

Type a print queue name or press Return. VMSINSTAL queues a copy of the release notes to print and displays a message such as the following:

Job DECDFS023 (queue queue, entry nnn) started on queue

If you select option 3, VMSINSTAL displays the release notes on your screen and prompts you for a print queue name.

If you select option 4, VMSINSTAL does not display or print the release notes at any time during the installation procedure.

After you select any of the options, VMSINSTAL displays the following message:

* Do you want to continue the installation [NO]?

One way to read the release notes now is to respond NO and locate them in SYS$HELP. A NO response terminates the installation and requires you to start again at step 1. Regardless of your response, the procedure displays the following message:

%VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP.

Step 7. Run the Installation Verification Procedure.

VMSINSTAL asks whether you want to run the Installation Verification Procedure (IVP) as part of the installation procedure. If you enter YES, you need to supply an access point name in step 13. If you enter NO, VMSINSTAL skips steps 13 and 14.

* Do you want to run the IVP after the installation [YES]?

Step 8. Purge old files.

VMSINSTAL asks whether you want to purge files that are replaced during the installation process. To retain the old copies, enter NO; otherwise, enter YES (or press Return).

* Do you want to purge files replaced by this installation [YES]?

If VMSINSTAL finds DFS*.EXE files in any SYS$SPECIFIC: directory, the procedure lists the files and asks whether you want to rename them. See Section 2.3.1 for the dialog and possible responses.

If VMSINSTAL finds DECdfs driver files in SYS$SYSTEM, the procedure asks whether you want to delete them. See Section 2.3.2 for the dialog and possible responses.

Step 9. Verify the configuration.

VMSINSTAL asks whether the stated configuration is correct or not.

DECnet Phase IV:

Current configuration: OpenVMS/xxx Vn.n - DECnet * Install the DFS files that support this configuration? [YES]?

DECnet Phase V:

Current configuration: OpenVMS/xxx Vn.n - DECnet-Plus * Install the DFS files that support this configuration? [YES]?

In the previous examples, the variables can have the following values:

• xxx can be either a VAX or an Alpha processor
• Vn.n can be Version 5.5--2, 6.2, 7.1, or 7.2 for VAX processors, and Version 6.2, 7.1, or 7.2 for Alpha processors

To use the configuration displayed, enter YES (or press Return). If this configuration does not represent the system, enter NO. If you enter NO, you are given the opportunity to choose one of the following alternate configurations:

Possible configurations: 1. OpenVMS VAX V5.5-2 - DECnet Phase IV 2. OpenVMS VAX V6.2 - DECnet Phase IV OpenVMS VAX V7.1 - DECnet Phase IV 3. OpenVMS VAX V6.2 - DECnet/OSI OpenVMS VAX V7.1 - DECnet-Plus 4. OpenVMS Alpha V6.2 - DECnet Phase IV 5. OpenVMS Alpha V6.2 - DECnet/OSI 6. OpenVMS Alpha V7.1 - DECnet-Plus 7. OpenVMS Alpha V7.1 - DECnet Phase IV 8. OpenVMS Alpha V7.2 - DECnet-Plus 9. OpenVMS Alpha V7.2 - DECnet Phase IV 10. OpenVMS VAX V7.2 - DECnet-Plus 11. OpenVMS VAX V7.2 - DECnet Phase IV 0. Stop installation * Enter number [8]

If you want to stop the installation, enter 3. The default is the stated configuration. If you prefer the alternate configuration, enter one of the other numbers. If you choose an alternate configuration, a difference will exist between the stated configuration and the chosen configuration, and a warning message and question therefore will be displayed.

%DECDFS_-VRMISM-E, Architecture type, VMS version, -DECDFS_-VRMISM-E, or DECnet version mismatch detected * Do you wish to continue with this configuration? [NO]

If you answer NO, the installation ends. If you answer YES, it continues.

Step 10. Install the Help Message Utility.

If you are installing on a system that is running OpenVMS Version 6.2 or later, the following question is displayed:

* Install DFS Help Message file? [YES]

If you answer YES, the installation procedure displays the following message:

Add SYS$HELP:DFS.MSGHLP$DATA to the searchlist defined by MSGHLP$LIBRARY in order to include the DFS messages in your HELP/MESSAGE search. Please refer to the OpenVMS SYSTEM MANAGER'S MANUAL: ESSENTIALS for more information.

Step 11. Install client or server software.

Indicate whether you want to install client or server software on this node at this VMSINSTAL prompt. Enter YES to install both the client and server software. Enter NO to establish a client-only node.

* Do you want to install the DECDFS V2.3 SERVER software on this node [YES]?

After you answer these questions, VMSINSTAL displays the following message:

Product: DFS Producer: DEC Version: 2.0 Release Date: 20-JUN-1994

The Product name DFS indicates a server software installation; the Product name DFS-CLIENT indicates a client software installation. The Product name is also the PAK name, which is checked in the next step.

Step 12. Check for a License Product Authorization Key (PAK).

VMSINSTAL checks for a registered and loaded DECdfs license PAK.

* Does this product have an authorization key registered and loaded?

Enter YES or press Return to indicate that the DECdfs license PAK is installed. Enter NO and press Return if the DECdfs license PAK is not installed.

If you are installing DECdfs client software (you answered NO in step 11), the installation procedure looks for a PAK named DFS-CLIENT, which includes only the client. If you are installing DECdfs server software (you answered YES in step 11), the installation procedure looks for a PAK named DFS, which includes both server and client.

You can continue to install DECdfs without a license, but the IVP cannot run and DECdfs cannot be started as part of the installation or when the installation finishes. After using the License Management Facility (LMF) to register and load the license PAK, you can start DECdfs or run the IVP.

Step 13. Read informational messages.

VMSINSTAL displays the following informational messages:

Installation will be complete in approximately 1 - 5 minutes depending upon your configuration. There are no more questions unless you choose to run the IVP. Installing DECdfs software . . . %VMSINSTAL-I-RESTORE, Restoring product save set B ...

The following table shows the save sets installed for each possible operating system/processor/network transport combination:

DECnet Phase IV
Operating System	Save Sets
VAX/VMS Version 5.5--2	A,B
OpenVMS VAX Version 6.2	A,C
OpenVMS VAX Version 7.1	A,C
OpenVMS VAX Version 7.2	A,L
OpenVMS Alpha Version 6.2	A,E
OpenVMS Alpha Version 7.1	A,H
OpenVMS Alpha Version 7.2	A,J
DECnet Phase V
Operating System	Save Sets
OpenVMS VAX Version 6.2	A,D
OpenVMS VAX Version 7.1	A,D
OpenVMS VAX Version 7.2	A,K
OpenVMS Alpha Version 6.2	A,F
OpenVMS Alpha Version 7.1	A,G
OpenVMS Alpha Version 7.2	A,I

Step 14. Complete the DECdfs installation.

If the installation has proceeded without errors on a node that does not have DECdfs running, VMSINSTAL displays the following text as it completes the installation of DECdfs:

DECnet Phase IV:

The following line should be added to your SYSTARTUP command file to automatically start DFS at system startup time: "@SYS$STARTUP:DFS$STARTUP.COM" Put DFS$STARTUP after the statement that invokes the DECnet startup command file (STARTNET.COM). The DECnet software must be started before the DECdfs software. %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

DECnet Phase V:

The following line should be added to your SYSTARTUP command file to automatically start DFS at system startup time: "@SYS$STARTUP:DFS$STARTUP.COM" %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

Step 15. Run the Installation Verification Procedure (IVP).

If you answered NO to the question in step 7, proceed to step 15c.

If you previously specified that you want to run the IVP after the installation and no errors occurred, VMSINSTAL starts DECdfs and displays the following message:

The Installation Verification Procedure will now be run. Please review preceding messages and take note of postinstallation actions that may be required (such as editing the SYSTARTUP procedure). Begin the DECdfs IVP? [YES]

Enter YES to start the IVP; enter NO to skip the IVP. VMSINSTAL displays a message that is specific for either a client-only (step 15a) or a server (step 15b) installation. The IVP prompts you for an access point name. Section 3.1 describes how to run the IVP and Section B.1 includes an example of the IVP.

Step 15a. Client-Only IVP.

If you are verifying a client-only software installation, the IVP displays the following message and prompts you for an existing access point name (a DECdns name that you can get from the system manager of a DECdfs server node). The IVP uses an access point name to test a DECdfs mount and dismount operation.

This system will run as a DECdfs Client. To verify the installation, an Access Point must exist on a Server Node. You must have already ADDed this Access Point on one of your Server Nodes. To do this, use the DFS$CONTROL command ADD ACCESS_POINT on a Server Node. * Enter an Access Point name [] ? access_point_name

The IVP verifies that the DECdfs client can communicate with the DECdfs server and at least one DECdns server. The IVP displays the following messages:

$ DFSCP MOUNT access_point_name DFS$IVP_DISK %MOUNT-I-MOUNTED, access_point_name mounted on _DFSC1001: (40FORD) $ DFSCP DISMOUNT DFS$IVP_DISK %DFS-S-DISMNT_SUCCESS, Dismount was successfully performed

Step 15b. Server IVP.

If you are verifying a server software installation, the IVP displays the following message and prompts you for a unique name to use as a temporary access point. This name must follow the DECdns naming conventions in use in your namespace. Ask the DECdns manager about your network naming conventions. The IVP uses this name to add the access point, mount and dismount the access point, and remove the access point. The IVP can then verify whether there is communication among the DECdfs clients and the DECdfs and DECdns servers.

This system will run as a DECdfs Server. To verify the installation, an Access Point must be ADDed on the Server. This procedure creates an Access Point for its own use. You must supply a name for this Access Point that does not already exist and is consistent with the DECdns naming policy used in your network. * Enter an Access Point name [] ? access_point_name

The IVP now executes while displaying the following messages:

$ DFSCP ADD ACCESS_POINT access_point_name SYS$SYSDEVICE:[000000] $ DFSCP MOUNT access_point_name DFS$IVP_DISK %MOUNT-I-MOUNTED, access_point_name mounted on _DFSC1001: . . . $ DFSCP DISMOUNT DFS$IVP_DISK %DFS-S-DISMNT_SUCCESS, Dismount was successfully performed $ DFSCP REMOVE ACCESS_POINT access_point_name

Step 15c. End the IVP.

After the specific client or server IVP in step 15a or step 15b, VMSINSTAL displays a message verifying that either the DECdfs software was installed successfully or the IVP failed. If you receive any error messages during the IVP, see the explanations in the DECdfs for OpenVMS Management Guide.

****************************************************************** DECdfs V2.3 IVP Successful ******************************************************************

You can run the IVP at any time to check the DECdfs software. See Section 3.1 for more information and for instructions on how to run the IVP after installing DECdfs.

Step 16. End the installation procedure.

After the installation of the DECdfs software is complete, VMSINSTAL displays the following message:

Installation of DECdfs V2.3 completed at hh:mm.

The following message then indicates that VMSINSTAL successfully completed installation and verification of the DECdfs software:

VMSINSTAL procedure done at hh:mm

If VMSINSTAL reports a failure, review the installation prerequisites. If you removed console media before you installed the software, replace the media in the console drive.

2.3 Additional DECdfs Messages

You may receive additional messages during a DECdfs installation. The following sections describe those DECdfs messages and the conditions that can cause them.

2.3.1 Renaming Files Message

If VMSINSTAL finds existing DECdfs files in any SYS$SPECIFIC: directory, the following message appears after step 8 in Section 2.2:

Previous versions of the following files were found in the SYS$SPECIFIC directories. In order for DECdfs to be installed properly, the files must be renamed so that they do not interfere with the installation. You may continue with the installation by answering "YES" to the following question; otherwise, the installation will be aborted. Also, as part of a cluster, please delete or rename the following files on ALL members of the cluster. SYS$SPECIFIC:[SYSEXE]DFSCDRIVER.EXE SYS$SPECIFIC:[SYSEXE]DFSRRDRIVER.EXE SYS$SPECIFIC:[SYSEXE]DFS$COM_ACP.EXE SYS$SPECIFIC:[SYSEXE]DFSSDRIVER.EXE SYS$SPECIFIC:[SYSEXE]DFS$SERVER_ACP.EXE SYS$SPECIFIC:[SYSEXE]DFS$COM_LOGGER.EXE SYS$SPECIFIC:[SYSEXE]DFS$CONTROL.EXE SYS$SPECIFIC:[SYS$LDR]DFSCDRIVER.EXE SYS$SPECIFIC:[SYS$LDR]DFSRRDRIVER.EXE SYS$SPECIFIC:[SYS$LDR]DFSSDRIVER.EXE SYS$SPECIFIC:[SYSLIB]DFS$MESSAGE.EXE SYS$SPECIFIC:[SYSLIB]DFS$MNGT_SHR.EXE SYS$SPECIFIC:[SYSLIB]DFS$MOUNT_SHR.EXE * Do you want to rename all SYS$SPECIFIC DECdfs files to .OLD [YES]?

If you enter YES, VMSINSTAL renames the listed DFS*.EXE files to DFS*.OLD and continues with the installation procedure.

If you enter NO, VMSINSTAL ends the installation and displays the following error message:

%VMSINSTAL-E-INSFAIL, The installation of DECdfs V2.3 has failed.

If you are installing the software on a cluster, you must delete the listed files or rename them on all cluster members before retrying the DECdfs installation procedure.

2.3.2 Deleting Old Driver Files Message

VMSINSTAL displays the following message after step 8 in Section 2.2 if you chose to purge files and if it finds old DECdfs driver files in the SYS$SYSTEM directory:

* Do you want to delete old DECdfs driver images from SYS$SYSTEM [YES]?

If you enter YES, VMSINSTAL deletes the obsolete DECdfs driver files. If you enter NO, DECdfs operates successfully but the obsolete DECdfs driver files remain in the SYS$SYSTEM directory.

2.3.3 DECdfs License PAK Message

VMSINSTAL displays the following message after step 9 in Section 2.2 if the DECdfs license PAK is not installed:

The startup file will not be executed after installation and the IVP will not run. Install the DECdfs license PAK before you start DECdfs and run the IVP.

2.3.4 DECdfs Startup Messages

The following is a list of all the possible messages that can be displayed before step 12 in Section 2.2 if VMSINSTAL cannot start DECdfs or run the IVP:

Before starting DECdfs . . . * You must install the DECdfs license PAK. * You must increase your GLOBAL PAGES. * You must increase your GLOBAL SECTIONS. * You must start DECnet. * You must execute SYS$STARTUP:DNS$CHANGE_DEF_FILE.COM. * You must increase the size of your nonpaged pool. See the DECdfs for OpenVMS Installation Guide * You must reboot your system because you already have DECdfs drivers loaded. Since DECdfs is not being started, you cannot run the Installation Verification Procedure (IVP). A copy of the DFS$IVP.COM file is in the SYS$TEST directory, so you can run the IVP after you start DECdfs.

The message about executing the command procedure SYS$STARTUP:DNS$CHANGE_DEF_FILE.COM appears if the installation procedure did not find file SYS$SYSTEM:DNS$DEFAULT_FILE.DAT on your node. This file defines the default DECdns namespace for your node. Executing this procedure copies file SYS$SYSTEM:DNS$DEFAULT_FILE.DAT from the DECdns server node (whose name you provide). Then DECdns can start and DECdfs can run.

VMSINSTAL displays the following message after step 12 in Section 2.2 if you need to increase the size of your interrupt stack:

You should also increase the size of your Interrupt Stack before starting the DECdfs server software. See the DECdfs for OpenVMS Installation Guide for more information.