HP OpenVMS Systems Documentation
Compaq PATHWORKS for OpenVMS
The server VMSINSTAL installation utility will detect if any of these
conditions exist, and if the images or files are found, it will notify
you. The VMSINSTAL installation utility automatically deletes, without
notification, any files from a PATHWORKS Advanced Server or Advanced Server for OpenVMS kit found
in the SYS$SPECIFIC directory tree.
1.9.15 Step 15: Check OpenVMS Cluster Configuration
$ DEASSIGN/SYSTEM PWRK$REBOOT_REQUIRED
To install PATHWORKS Advanced Server, proceed to Chapter 2, Installing the PATHWORKS Advanced Server.
This chapter describes how to install the PATHWORKS for OpenVMS (Advanced Server) software. You must follow these procedures regardless of whether you are upgrading from a previous version of the server or installing the server for the first time.
Before you begin the installation procedure, make sure that you have completed the preinstallation tasks listed in Chapter 1, Before You Install PATHWORKS Advanced Server.
This chapter consists of the following sections:
The following sections describe the installation procedure and what it
2.1.1 What is VMSINSTAL?
VMSINSTAL is the standard command procedure for installing software on
the OpenVMS operating system. VMSINSTAL consists of a series of
questions (prompts). Your answers to these questions provide VMSINSTAL
with the information needed for installing PATHWORKS Advanced Server.
2.1.2 PATHWORKS Advanced Server Installation Kit
The VMSINSTAL installation kit includes several OpenVMS BACKUP save
sets. The save set PWRK061.A always contains the file KITINSTAL.COM and
the release notes. The savesets included in the software kit are listed
in the product release notes.
2.1.3 What VMSINSTAL Does
When you use VMSINSTAL, it:
The following sections describe how to prepare information required
during the installation procedure, and how to specify the required
information during the procedure.
2.2.1 Before You Start VMSINSTAL
Before you start the VMSINSTAL command procedure, be prepared to answer the following questions. The questions that VMSINSTAL asks depend on the software environment and options you select.
|You are installing PATHWORKS Advanced Server for the first time||The first available unused UIC group number, starting with 360|
|PATHWORKS (LAN Manager) is currently installed, an account named PCFS$ACCOUNT already exists||The same group number as that associated with the existing account PCFS$ACCOUNT|
|The file and print server accounts already exist||The same group number as the existing accounts|
An asterisk (*) at the beginning of a line in the installation procedure identifies a prompt to which you must respond.
Usually the prompt has a default answer, which the procedure displays in square brackets () at the end of the question.
To accept a default, press Return. For example:
* Is the selection correct [YES]? [Return]
When you have completed the recommended preinstallation tasks outlined in Chapter 1, Before You Install PATHWORKS Advanced Server, and have read the release notes, you are ready to use the VMSINSTAL installation procedure to install the PATHWORKS Advanced Server. To start VMSINSTAL:
$ SHOW DEVICE device_name
$ SHOW DEVICE $1$DUS0:
Device Device Error Volume Free Trans Mnt Name Status Count Label Blocks Count Cnt $1$DUS0: (HSC001) Mounted 0 HUBSYS 347718 628 4
$ SET DEVICE/AVAILABLE device_name
$ SET DEFAULT SYS$UPDATE
$ @SYS$STARTUP:PWRK$SHUTDOWN CLUSTER
$ SET HOST 0/LOG=file-name
|Access the Release Notes During Installation?||Command Line|
|Yes||@VMSINSTAL PWRK061 device_name OPTIONS N|
|No||@VMSINSTAL PWRK061 device_name|
To interrupt the installation procedure, press [Ctrl/Y] at any time. The installation procedure deletes any files that were created, then exits. Then you can restart the installation from the beginning.
|Example 2-1 Sample Installation Procedure---Part 1|
$@SYS$UPDATE:VMSINSTAL PWRK061 SYS$DEVICE:[KITS.PWRK] [Return] OpenVMS AXP Software Product Installation Procedure V7.2-1H1 It is 13-JUL-2001 at 16:59. Enter a question mark (?) at any time for help. %VMSINSTAL-W-ACTIVE, The following processes are still active: TCPIP$ESNMP TCPIP$OS_MIBS TCPIP$HR_MIB * Do you want to continue anyway [NO]? Y [Return] * Are you satisfied with the backup of your system disk [YES]? [Return] The following products will be processed: PWRK V6.1 Beginning installation of PWRK V6.1 at 16:59 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. PATHWORKS for OpenVMS Installation © Compaq Computer Corporation 2000. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. This software is proprietary to and embodies the confidential technology of Compaq Computer Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.
In Example 2-1, Sample Installation Procedure---Part 1, the installer specifies the source device SYS$DEVICE:[KITS.PWRK] for the installation kit.
The first part of the installation script indicates that certain processes are already running and gives you the option of continuing or stopping the procedure. In this example, the processes listed are part of the Compaq TCP/IP Services for OpenVMS software running on the system.
If you continue (respond YES to the prompt), the procedure asks if you are satisfied with the backup (backup of the system is recommended prior to installing the server), and then identifies the product being installed.
|Example 2-2 Sample Installation Procedure---Part 2|
Please select from the following install options: PATHWORKS V6.1 for OpenVMS (Advanced Server) PATHWORKS V6.1 for OpenVMS (Advanced Server) License Server (only) External Authentication images (only) * Do you want to install the complete PATHWORKS V6.1 for OpenVMS [NO]? Y [Return] %PWRK-I-OLDVERPWRK, PATHWORKS V6.0-400D for OpenVMS (Advanced Server) -PWRK-I-OLDVERPWRK, was previously installed The following components will be installed: PATHWORKS V6.1 for OpenVMS (Advanced Server) If the selection is correct, the installation will continue. If the selection is not correct, you can change your selection. Press CTRL/Y if you want to terminate the installation. * Is the selection correct [YES]? [Return]
This part of the script gives you the option of installing the complete PATHWORKS Advanced Server product, installing only the standalone License Server, installing only the standalone external authentication images, or installing only the Upgrade utility.
In Example 2-2, Sample Installation Procedure---Part 2, the complete installation was selected, and the procedure continues. A message indicates a previous version of the Advanced Server has been installed on this system.
|Example 2-3 Sample Installation Procedure---Part 3|
%PWRK-I-VERSION, Checking for OpenVMS version 6.2, or later... NOTE ---- Because this kit provides a new streams execlet for NetBEUI and TCP/IP, you MUST reboot the system to complete installation of PATHWORKS. If you do not reboot the system at this time, you must remember to reboot later before starting PATHWORKS. To complete the installation of this product, you should reboot the system. If it is not convenient to reboot at this time, then enter NO to the following question. If you enter NO, the installation procedure will continue. * Will you allow a system shutdown after this product is installed [YES]? [Return] * How many minutes for system shutdown : [Return] * Do you want to do an automatic system reboot [YES]? [Return] * Do you want to run the IVP after the installation is finished [YES]? [Return] * Do you want to purge files replaced by this installation [YES]? [Return] %PWRK-I-FREEBLKS, Checking for 160000 free blocks **************************************************************** * You must shut down the Advanced Server before you continue * * installing PATHWORKS V6 for OpenVMS. * **************************************************************** If you do not shut down the server, the installation will terminate. * Do you want to shut down the Advanced Server [YES]? [Return] Shutting down the currently running server(s)...
In Example 2-3, Sample Installation Procedure---Part 3, the installation procedure checks that the OpenVMS system for installation of the server is OpenVMS Version 6.2 or later. If it is an earlier version, the installation would abort.
The installation procedure then checks for circumstances requiring a system reboot. A reboot might be needed if:
If a Compaq OpenVMS file and print server has been installed and started previously, certain images remain in system memory even after the product has been stopped or removed. As a result, before the Advanced Server can be started, you need to reboot the system to remove the old image from memory.
To help minimize downtime, the installation procedure requests a reboot only if and when necessary. You are not forced to reboot after installation.
In Example 2-3, Sample Installation Procedure---Part 3, software from an earlier version of PATHWORKS for OpenVMS was detected (such as an earlier version of the PWRK$STREAMSOS_Vn.EXE execlet; note that the version, n, corresponds to the version of OpenVMS, not of PATHWORKS). A reboot is necessary unless you do not plan to run the Advanced Server on this system.
The installation procedure gives you the option of delaying the reboot by continuing the procedure. You might want to delay the reboot so that you can complete installation or configuration processes that would be expedient to finish before rebooting. For example, when installing the server on an OpenVMS Cluster, you might want to delay a reboot until you complete the server installation and configuration on all nodes of the cluster.
To delay the reboot, continuing the installation, enter NO at the prompt asking if you will allow a system shutdown after the product is installed. In this example, the reboot is opted for, and then the procedure prompts the installer for the number of minutes to elapse before the shutdown occurs.
The installer is also prompted whether an automatic system reboot is requested, whether the installation verification procedure should be run after the installation, and whether to purge files replaced by this installation or keep previous versions intact. The installation verification procedure (IVP) can be run automatically, as shown in Example 2-5, Sample Installation Procedure---Part 5, or independently of the installation procedure, as described in Section 5.2, Verifying the PATHWORKS for OpenVMS (Advanced Server) Installation.
|Example 2-4 Sample Installation Procedure---Part 4|
User Accounts and User Identification Codes (UICs) -------------------------------------------------- PATHWORKS for OpenVMS creates two OpenVMS accounts: a default account, PWRK$DEFAULT, and a guest account, PWRK$GUEST. The default UIC group number for both these new accounts depends on the following: o If you are installing the server for the first time, the default is the first unused UIC group number, starting with 360. o If there is an existing account PCFS$ACCOUNT, the default is the UIC group number associated with PCFS$ACCOUNT. o If there is an existing account PWRK$DEFAULT or PWRK$GUEST, the default is the UIC group number associated with PWRK$DEFAULT or PWRK$GUEST, in preference to PCFS$ACCOUNT. However, the default UIC group number will not be used to change the UIC of any existing accounts. For more information about UIC group numbers, see the OpenVMS System Manager's Manual. * Enter default UIC group number for PWRK$DEFAULT and PWRK$GUEST : [Return] All questions have been answered. The installation of PATHWORKS for OpenVMS will continue. %PWRK-I-ACCOUNTS, Creating OpenVMS accounts for PWRK$DEFAULT and PWRK$GUEST %PWRK-I-DEFAULTEXISTS, PWRK$DEFAULT account already exists %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %PWRK-I-DEFOBJS, Defining DECnet objects PCX$SERVER and PCSA$MAIL %PWRK-I-DCLCMDS, Installing PATHWORKS DCL commands %PWRK-I-SPECIFY, Specifying target directories for the provided files %PWRK-I-OBSOLETE, Deleting obsolete files Next Steps ---------- To continue the installation procedure, enter the following command to execute the server configuration command procedure: $ @SYS$UPDATE:PWRK$CONFIG For information about the configuration command procedure, see the PATHWORKS (Advanced Server) Installation and Configuration Guide. $ %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...