PATHWORKS for OpenVMS
Server Installation and Configuration Guide

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 pre-installation tasks listed in Chapter 1, Before You Install PATHWORKS Advanced Server.

This chapter consists of the following sections:

2.1 About the Installation Procedure

The following sections describe the installation procedure and what it does.

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 PWRKV60B060.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:

Determines whether the PATHWORKS for OpenVMS (NetWare) server is installed on the system, and if it is, optionally removes the NetWare server software.
Creates PATHWORKS Advanced Server accounts on the file server, if necessary.
Restores the files from the save sets in the installation kit.
Creates DECnet objects, if you are running DECnet or DECnet-Plus.
Installs the PATHWORKS Advanced Server DCL command definition file.
Installs the PATHWORKS Advanced Server logical names definition files.
Deletes obsolete files.
Installs the PATHWORKS Advanced Server files.
Verifies that the software has been installed successfully. (See Section 5.2, Verifying the PATHWORKS for OpenVMS (Advanced Server) Installation, for information on how to run the Installation Verification Procedure after installing the software.)

2.2 Installing the Server

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, answer the following questions:

What is the product identifier?
The product identifier tells VMSINSTAL which save sets to copy from the media to a disk on the system. The product identifier for PATHWORKS Advanced Server is:
PWRKV60B060
What is the name of the device on which you want to mount the media?
The device name depends on the type of media and computer you have. For example, if you want to mount a CD-ROM on the CD-ROM drive of your Alphastation 400, the device name might be DKA400.
Do you want to access the online release notes during the installation procedure?
You can tell VMSINSTAL to ask you whether you want to display or print the online release notes during installation. Because the release notes may describe important changes to the installation procedure, Compaq recommends that you read them. Procedures for obtaining the release notes are described in Section 1.6, Reading the Release Notes.
Do you want to install just the Upgrade utility?
If the PATHWORKS V5 for OpenVMS (LAN Manager) server is installed on the system, you are prompted to install the Upgrade utility separately, which allows you to upgrade server database files before you install the PATHWORKS for OpenVMS (Advanced Server).
To install the PATHWORKS Advanced Server, you must upgrade the server databases. If you choose to install just the Upgrade utility, you can install the PATHWORKS Advanced Server later, after you upgrade your databases. If you install the PATHWORKS Advanced Server software, the Upgrade utility is also installed.
Do you want to preserve the PATHWORKS V5 for OpenVMS (LAN Manager) environment, and if so, where?
If you are upgrading from PATHWORKS V5 for OpenVMS (LAN Manager), you can choose to have the PATHWORKS V5 for OpenVMS (LAN Manager) data files copied to the location you specify in the installation procedure. This allows you to roll back to PATHWORKS V5 for OpenVMS (LAN Manager) later, after configuring and starting the PATHWORKS Advanced Server. Refer to the PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide for more information about the PATHWORKS Rollback procedure.
If you have V4.x of PATHWORKS for OpenVMS, you must upgrade to PATHWORKS V5 for OpenVMS (LAN Manager) before installing PATHWORKS V6 for OpenVMS (Advanced Server). For instructions on upgrading from V4.x to V5, see the PATHWORKS for OpenVMS Server Migration Guide.
Do you want to install PATHWORKS Advanced Server software?
This option allows you to install the complete PATHWORKS for OpenVMS (Advanced Server) server, including the Upgrade utility and the integrated license server,
Do you want to install the standalone license server?
If the system is designated to run the standalone license server, you can install the license server software only. Compaq recommends that you run the standalone license server on a designated license server system.
The installation procedure gives you the option to install the standalone license server software from the PATHWORKS for OpenVMS (Advanced Server) software kit. In this case, the PATHWORKS Advanced Server is not installed. If the PATHWORKS Advanced Server is installed, you cannot choose the standalone license server installation option.
Do you want to install PATHWORKS External Authentication software only?
On OpenVMS clusters, you can install the External Authentication software only. This is useful on cluster member nodes that are not going to run the PATHWORKS Advanced Server. For more information, see Section 1.5, About External Authentication.

What is the User Identification Code (UIC) group number?
The PATHWORKS Advanced Server installation procedure creates the OpenVMS user accounts PWRK$DEFAULT and PWRK$GUEST, if they do not already exist. When an OpenVMS user account is created, it is assigned a UIC group number. The default selection displayed by the installation procedure is determined as follows:

If...	The default is...
You are installing PATHWORKS Advanced Server for the first time	The first available unused UIC group number, starting with 360.
If PATHWORKS V5 for OpenVMS (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.
If the file server accounts already exist	The same group number as the existing accounts.

2.2.2 How to Start VMSINSTAL

To start VMSINSTAL:

Ensure that you are logged in to the SYSTEM account.
Load the installation kit media onto a drive. (It is not necessary to mount the drive, but it must be on line so that the installation procedure can mount it.)

Enter the following command to check the status of the device on which you have loaded the installation kit, replacing device_name with the name of the applicable device:

$ SHOW DEVICE device_name

For example:

$ 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

If the device status is Offline, enter the following command to place the device online, replacing device_name with the name of your device:

$ SET DEVICE/AVAILABLE device_name

Change your default directory to SYS$UPDATE:
$ SET DEFAULT SYS$UPDATE

Start VMSINSTAL and specify the PWRKV60B060 product identifier, the media device, and whether you want access to the online release notes during the installation procedure:

If you...	Then enter...
Want access to the release notes during the installation procedure	`@VMSINSTAL PWRKV60B060 device_name OPTIONS N`
Do not want access to the release notes during the installation procedure	`@VMSINSTAL PWRKV60B060 device_name`

2.2.3 How to Respond to Prompts

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:

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

2.2.4 How to Interrupt the Installation

To interrupt the installation procedure, press [Ctrl/Y] at any time. Then you can restart the installation from the beginning.

2.2.5 How to Answer Installation Questions

Table 2-1 tells you how to respond to the questions VMSINSTAL displays.

Note

Table 2-1 shows only the questions VMSINSTAL displays; it does not show any informational messages. For a complete sample installation script, see Appendix B, Sample PATHWORKS Advanced Server Installation and Configuration Procedure.

Table 2-1 Installation Questions
For this question... If you want the installation procedure to... Enter...

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

Exit NO

Select option [2]: ¹ Display the release notes on the screen 1
To stop the display at any time, press [Ctrl/C].

Print the release notes [Return]
The release notes file is sent to the default print queue SYS$PRINT. You can enter the name of another print queue.

Print the release notes and display them on the screen 3
To send the release notes to another print queue, enter the name of another print queue.
To stop the screen display at any time, press [Ctrl/C].

Continue without displaying or printing the release notes 4
The release notes are automatically copied to SYS$HELP.

Do you want to install the upgrade utility only [NO]? ² Install one or more servers [Return]

Install only the Upgrade utility YES

Do you want to continue the installation [NO]? ¹ Continue YES

Exit [Return]

Do you want to install the complete PATHWORKS V6.0B for OpenVMS [NO]? Install the PATHWORKS Advanced Server YES

Omit the PATHWORKS Advanced Server [Return]

Do you want to preserve the V5 (LAN Manager) environment [YES]? ² Retain the PATHWORKS V5 for OpenVMS (LAN Manager) environment so that you can use the rollback procedure described in the PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide [Return]

Not retain the V5 environment NO

Enter the directory to preserve the V5 environment [SYS$SYSDEVICE:[000000]]: ³ Preserve the V5 environment in the default directory shown [Return]

Preserve the V5 environment on another device or in another directory A different device or directory.

Do you want to install the PATHWORKS license server only [NO]? ⁴ Install the standalone license server YES
This option installs the license server and transport software without the PATHWORKS Advanced Server. Refer to Chapter 4, Configuring and Starting the Standalone License Server for more information.

Install the PATHWORKS Advanced Server with the license server [Return]
This option causes the installation procedure to proceed to the next question.

Do you want to install only the External Authentication images [NO]? ⁴ Install only the external authentication software YES
This option installs the external authentication software without the PATHWORKS Advanced Server.

Install the complete PATHWORKS Advanced Server or install the standalone license server [Return]
This option causes the installation procedure to repeat the previous questions so that you can select the complete PATHWORKS Advanced Server or only the license server.

Is the selection correct [YES]? Use the selection [Return]

Change the selection NO

Terminate the installation [Ctrl/Y]

Will you allow a system shutdown after this product is installed [YES]? Shut down the system as part of the product installation procedure [Return]

Complete the installation procedure without shutting down the system NO
System shutdown is required, to complete the product installation. If you answer NO, you must shut down the system manually after the installation procedure is finished.

Do you want to do an automatic system reboot [YES]? Reboot the system automatically after system shutdown [Return]

Reboot the system manually NO

Do you want to run the IVP after the installation is finished [YES]? Run the Installation Verification Procedure (IVP) automatically after the installation procedure completes [Return]

Not run the IVP NO
You can run the IVP independent of the installation procedure. For detailed information on running the IVP independently, see Section 5.2, Verifying the PATHWORKS for OpenVMS (Advanced Server) Installation.

Do you want to purge files replaced by this installation [YES]? Purge all files it replaces [Return]

Not purge any files it replaces NO

Do you want to continue with the installation [YES]? ⁵ Delete the files and continue the installation [Return]

Leave the files intact and terminate the installation NO

Do you want to shut down the PATHWORKS license server [YES]? ⁶ Shut down the license server and continue the installation [Return]

Keep the server running and terminate the installation NO

Do you want to shut down the PATHWORKS Advanced Server [YES]? ⁶ Shut down the server and continue the installation [Return]

Keep the server running and terminate the installation NO

Enter default UIC group number for PWRK$DEFAULT and PWRK$GUEST[ nnn]: Associate the newly created OpenVMS accounts PWRK$DEFAULT and PWRK$GUEST with the default user identification code (UIC) group number ( nnn) [Return]

Associate the newly created accounts with the UIC group number you specify A three-digit UIC number.
For detailed information about UIC group numbers, see the OpenVMS System Manager's Manual.

**Table 2-1 Installation Questions**
For this question...	If you want the installation procedure to...	Enter...
Are you satisfied with the backup of your system disk [YES]?	Continue	`[Return]`
	Exit	NO

Select option [2]: ¹	Display the release notes on the screen	1 To stop the display at any time, press `[Ctrl/C]`.
	Print the release notes	`[Return]` The release notes file is sent to the default print queue SYS$PRINT. You can enter the name of another print queue.
	Print the release notes and display them on the screen	3 To send the release notes to another print queue, enter the name of another print queue. To stop the screen display at any time, press `[Ctrl/C]`.
	Continue without displaying or printing the release notes	4 The release notes are automatically copied to SYS$HELP.

Do you want to install the upgrade utility only [NO]? ²	Install one or more servers	`[Return]`
	Install only the Upgrade utility	YES

Do you want to continue the installation [NO]? ¹	Continue	YES
	Exit	`[Return]`

Do you want to install the complete PATHWORKS V6.0B for OpenVMS [NO]?	Install the PATHWORKS Advanced Server	YES
	Omit the PATHWORKS Advanced Server	`[Return]`

Do you want to preserve the V5 (LAN Manager) environment [YES]? ²	Retain the PATHWORKS V5 for OpenVMS (LAN Manager) environment so that you can use the rollback procedure described in the PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide	`[Return]`

	Not retain the V5 environment	NO

Enter the directory to preserve the V5 environment [SYS$SYSDEVICE:[000000]]: ³	Preserve the V5 environment in the default directory shown	`[Return]`
	Preserve the V5 environment on another device or in another directory	A different device or directory.

Do you want to install the PATHWORKS license server only [NO]? ⁴	Install the standalone license server	YES This option installs the license server and transport software without the PATHWORKS Advanced Server. Refer to Chapter 4, Configuring and Starting the Standalone License Server for more information.
	Install the PATHWORKS Advanced Server with the license server	`[Return]` This option causes the installation procedure to proceed to the next question.

Do you want to install only the External Authentication images [NO]? ⁴	Install only the external authentication software	YES This option installs the external authentication software without the PATHWORKS Advanced Server.
	Install the complete PATHWORKS Advanced Server or install the standalone license server	`[Return]` This option causes the installation procedure to repeat the previous questions so that you can select the complete PATHWORKS Advanced Server or only the license server.

Is the selection correct [YES]?	Use the selection	`[Return]`
	Change the selection	NO
	Terminate the installation	`[Ctrl/Y]`

Will you allow a system shutdown after this product is installed [YES]?	Shut down the system as part of the product installation procedure	`[Return]`
	Complete the installation procedure without shutting down the system	NO System shutdown is required, to complete the product installation. If you answer NO, you must shut down the system manually after the installation procedure is finished.
Do you want to do an automatic system reboot [YES]?	Reboot the system automatically after system shutdown	`[Return]`
	Reboot the system manually	NO
Do you want to run the IVP after the installation is finished [YES]?	Run the Installation Verification Procedure (IVP) automatically after the installation procedure completes	`[Return]`
	Not run the IVP	NO You can run the IVP independent of the installation procedure. For detailed information on running the IVP independently, see Section 5.2, Verifying the PATHWORKS for OpenVMS (Advanced Server) Installation.

Do you want to purge files replaced by this installation [YES]?	Purge all files it replaces	`[Return]`
	Not purge any files it replaces	NO

Do you want to continue with the installation [YES]? ⁵	Delete the files and continue the installation	`[Return]`
	Leave the files intact and terminate the installation	NO

Do you want to shut down the PATHWORKS license server [YES]? ⁶	Shut down the license server and continue the installation	`[Return]`
	Keep the server running and terminate the installation	NO

Do you want to shut down the PATHWORKS Advanced Server [YES]? ⁶	Shut down the server and continue the installation	`[Return]`
	Keep the server running and terminate the installation	NO

Enter default UIC group number for PWRK$DEFAULT and PWRK$GUEST[ nnn]:	Associate the newly created OpenVMS accounts PWRK$DEFAULT and PWRK$GUEST with the default user identification code (UIC) group number ( nnn)	`[Return]`
	Associate the newly created accounts with the UIC group number you specify	A three-digit UIC number. For detailed information about UIC group numbers, see the OpenVMS System Manager's Manual.

¹This question is displayed only if you specify OPTIONS N when you start the VMSINSTAL command procedure or if there are active processes on the system.
²This question is displayed only if your system is currently running the previous version of PATHWORKS for OpenVMS.
³This question is displayed only if you chose to preserve the PATHWORKS V5 for OpenVMS (LAN Manager) environment.
⁴This question is displayed only if you chose not to install the PATHWORKS Advanced Server.
⁵This question is displayed only if there are PATHWORKS files in system-specific directories.
⁶This question is displayed only if a server is running.

2.3 Troubleshooting Installation Problems

The following sections describe some problems you can encounter if you install the PATHWORKS Advanced Server in an environment that is not appropriate.

2.3.1 Installing the PATHWORKS Advanced Server on a System with the NetWare Server

The PATHWORKS Advanced Server cannot be installed on a system where the NetWare server is installed. If you attempt to install the PATHWORKS Advanced Server on a system where the NetWare server is installed, the installation procedure optionally invokes the NetWare server software removal procedure (SYS$STARTUP:PWVN$DEINSTAL.COM).

When the installation procedure detects the presence of the NetWare server, it displays the following message and question:

%PWRKV60B-E-OLDVERPWNV, PATHWORKS V6.0-nnnx for OpenVMS (NetWare) was previously installed. This product is no longer supported. To install the PATHWORKS V6.0B for OpenVMS product, the NetWare product must be deinstalled. * Will you allow this installation procedure to deinstall * the NetWare product [NO]?

To remove the NetWare server software, enter YES.

To terminate the installation procedure without removing the NetWare server software, enter NO, or press [Return].

You can remove the NetWare server manually using the procedure in Section 7.2, Removing the PATHWORKS NetWare Server. Then start the VMSINSTAL procedure again after the NetWare server has been removed.

Contents

Index

PATHWORKS for OpenVMSServer Installation and Configuration Guide

Chapter 2Installing the PATHWORKS Advanced Server