HP OpenVMS Systems Documentation

Compaq PATHWORKS for OpenVMS

Server Installation and Configuration Guide

Order Number: AA--R6G1C--TE

October 2001

This guide explains how to install and configure the PATHWORKS for OpenVMS (Advanced Server) software, including the standalone License Server and external authentication software, and the Upgrade utility.

Revision/Update Information: This guide supersedes the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Installation and Configuration Guide, Version 6.0B.

Operating System: OpenVMS Alpha Version 6.2, 7.2-1, 7.2-2, 7.3
OpenVMS VAX Version 6.2, 7.2, 7.3

Software Version: PATHWORKS V6.1 for OpenVMS (Advanced Server)

Compaq Computer Corporation
Houston, Texas

COMPAQ, the Compaq logo, OpenVMS, Tru64, DECnet, VAX, VMS, and the DIGITAL logo are trademarks of Compaq Information Technologies Group, L.P.

Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation.
Intel is a trademark of Intel Corporation.
UNIX is a trademark of The Open Group.

All other product names mentioned herein may be trademarks of their respective companies.

Confidential computer software. Valid license from Compaq required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6555

The PATHWORKS for OpenVMS (Advanced Server) documentation set is available on CD-ROM.

Contents

Index

Preface

This guide explains how to install and configure the following PATHWORKS servers:

PATHWORKS for OpenVMS (Advanced Server) file and print server
PATHWORKS standalone License Server
Upgrade utility only
External authentication software only

Intended Audience

This guide is written for OpenVMS system managers and network server administrators. It assumes you are familiar with the following aspects of the Compaq OpenVMS operating system:

Digital Command Language (DCL)
A text editor, such as EDT or EVE
VMSINSTAL command procedure

This guide also assumes that you are familiar with basic Advanced Server and networking concepts.

Document Structure

The following list can help you find information in this guide:

Chapter	Description
Chapter 1	Describes prerequisites for the installation procedure
Chapter 2	Describes the installation procedure
Chapter 3	Describes the configuration procedure for the PATHWORKS Advanced Server
Chapter 4	Describes the configuration procedure for the standalone License Server
Chapter 5	Describes postinstallation tasks, such as running the Installation Verification Procedure and starting the server independent of the installation and configuration procedures
Chapter 6	Describes how to set up Wide Area Networks
Chapter 7	Describes how to remove the PATHWORKS Advanced Server from your system
Appendix A	Provides a checklist of installation and configuration tasks; you can photocopy Appendix A, Installation and Upgrade Checklist, and use it as a checklist as you read this guide
Appendix B	Shows a sample installation and configuration procedure for the PATHWORKS Advanced Server
Appendix C	Shows a sample installation and configuration procedure for the standalone License Server
Appendix D	Shows a sample installation procedure for the Upgrade utility
Appendix E	Shows a sample installation procedure for external authentication software only
Appendix F	Lists the files that are installed with PATHWORKS Advanced Server and shows the on-disk structure
Appendix G	Lists the logical names created for the PATHWORKS Advanced Server

Reader's Comments

Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet	openvmsdoc@compaq.com
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

Visit the following World Wide Web address for information about how to order additional documentation:

http://www.openvms.compaq.com/

If you need help deciding which documentation best meets your needs, call 800-282-6672.

Conventions

The term PATHWORKS Advanced Server is used in this guide to refer to the PATHWORKS for OpenVMS (Advanced Server) file and print server. Mentions of Compaq OpenVMS file and print servers refers to the PATHWORKS family of file and print servers, including PATHWORKS (LAN Manager), PATHWORKS for OpenVMS (NetWare), PATHWORKS for OpenVMS (Advanced Server), and the Advanced Server for OpenVMS.

The following conventions are used in the PATHWORKS Advanced Server documentation:

Convention	Meaning
DECnet	Applies to both DECnet Phase IV and DECnet-Plus, unless otherwise specified.
Italic	The use of italic text indicates a placeholder for information or parameters that you must provide. For example, if the procedure asks you to type file name, you must type the actual name of a file. Italic text also indicates new terms and the titles of other documentation referenced.
`monospace`	The use of monospace text indicates actual commands and characters that you enter, and the system display.
Note	The use of Note provides information of special importance.
Caution	The use of Caution provides information to avoid damaging software or hardware.
Warning	The use of Warning provides information that is essential to people's safety.
...	A horizontal ellipsis following an entry in a command line indicates that the entry or a similar entry can be repeated any number of times. An ellipsis following a file name indicates that additional parameters, values, or information can be entered.
. . .	A vertical ellipsis in an example indicates that not all the data is shown.
Ctrl/ x	While you hold down the Ctrl key, press another key or a pointing device button.
Return or Enter	Return or Enter in text indicates where you should press the Return or Enter key to execute a command or terminate a sequence. This key is labeled Return or Enter, depending on your keyboard.
`[Tab]`	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.
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.

Chapter 1
Before You Install PATHWORKS Advanced Server

This chapter describes the hardware and software you must have and the tasks you need to complete before you install PATHWORKS Advanced Server software.

This chapter consists of the following sections:

1.1 About the PATHWORKS for OpenVMS Software Kit

The PATHWORKS for OpenVMS (Advanced Server) kit contains the software required to run the following software installation options:

The complete PATHWORKS Advanced Server file and print server software, including the License Server, external authentication software, and Upgrade utility.
The standalone License Server
The standalone external authentication software
The Upgrade utility

The Upgrade utility helps you migrate from PATHWORKS (LAN Manager) to PATHWORKS V6 for OpenVMS (Advanced Server).

1.1.1 About the PATHWORKS for OpenVMS (NetWare) Server

The PATHWORKS for OpenVMS (NetWare) server is no longer supported. PATHWORKS for OpenVMS (Advanced Server) cannot be installed on a system where the PATHWORKS for OpenVMS (NetWare) server is installed. If the installation procedure finds the PATHWORKS for OpenVMS (NetWare) server, it optionally invokes the PATHWORKS for OpenVMS (NetWare) removal procedure (PWVN$DEINSTAL), to remove the NetWare server software before installing the PATHWORKS Advanced Server software. For more information about the NetWare server removal procedure, refer to Section 7.2, Removing the PATHWORKS NetWare Server.

If your clients continue to depend on NetWare software to connect to the system, or if you need the IPX/SPX transport for any reason, you should designate a system to run the PATHWORKS for OpenVMS (NetWare) server.

1.2 If You Are Upgrading from PATHWORKS (LAN Manager)

If you have PATHWORKS (LAN Manager) installed, you must install the new PATHWORKS Advanced Server. You can choose to install just the Upgrade utility initially, and install the PATHWORKS Advanced Server later. Refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide for more information.

1.3 Installing DECprint Software

DECprint Supervisor for OpenVMS (DCPS) is a printing system that provides queue management and printing features for PostScript printers. To share a PostScript printer, selected PostScript printers might require use of the DECprint Supervisor for OpenVMS (DCPS) software for communication with the printers over DECnet or TCP/IP.

If you plan to use DECprint Supervisor for OpenVMS on your system, Compaq recommends that you install it before installing the Advanced Server. You must reboot the system after installing the DECprint software. You can perform the reboot as part of the DECprint Supervisor installation procedure, or after you install the Advanced Server but before you configure it.

1.4 About Licensing

The following sections describe the way the PATHWORKS Advanced Server software is licensed, and how to ensure clients accessing the server are properly licensed.

1.4.1 License Requirements

The PATHWORKS Advanced Server requires that clients accessing file and print services be appropriately licensed. To conform to this requirement, one of the following must be true:

The client must present a client-based license before each attempt to connect to a PATHWORKS Advanced Server.
The PATHWORKS Advanced Server must have a server-based license available to assign to an unlicensed client attempting to use services of the PATHWORKS Advanced Server.

In either case, the license required to access PATHWORKS V6.1 for OpenVMS (Advanced Server) services is the PATHWORKS Client Access license: PWLMXXXCA07.03 or higher, or an equivalent client virtual license.

If you are upgrading from PATHWORKS LAN Manager, refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide for information about upgrading client license requests.

1.4.2 About the License Server

The PATHWORKS License Server is an optional software program that you can run on your OpenVMS system to grant licenses to clients.

The License Server can be installed:

With the file and print server (automatically included with your file and print server installation)
Separately from the file and print server (called the "standalone License Server")

In either case, you can configure the License Server to support clients using any of the following network protocols:

DECnet
LAN Manager (NetBEUI)
TCP/IP

Compaq recommends that you install the License Server on a designated OpenVMS system without the PATHWORKS file server. (The PATHWORKS Advanced Server installation procedure allows you to install the License Server separately from the file server.) Alternatively, you can run the License Server on an OpenVMS Cluster with PATHWORKS file and print servers, where cluster failover provides reliability.

Each LAN needs only one active PATHWORKS License Server. (The same License Server can support both PATHWORKS LAN Manager and PATHWORKS Advanced Server clients.) The license product authorization keys (PAKs) must be loaded on the system that runs the PATHWORKS License Server. In an OpenVMS Cluster, the PAKs must be loaded into a shared license database.

Information Required	Source
Loading licenses	OpenVMS License Management Utility Manual
Configuring the License Server	Chapter 4, Configuring and Starting the Standalone License Server
Managing PATHWORKS Advanced Server licenses	Compaq Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses

1.5 About External Authentication

External authentication is an optional feature of OpenVMS systems that allows system managers to set up user accounts for which login authentication is based on a security mechanism other than OpenVMS security.

The PATHWORKS Advanced Server takes advantage of this feature by providing the ability to use the PATHWORKS Advanced Server or Windows NT-compatible user authentication mechanisms to authenticate OpenVMS user logins. This allows users to log in at the OpenVMS login prompt using the PATHWORKS Advanced Server user name and password. In addition, it provides automatic password synchronization for user accounts.

When you install the complete PATHWORKS Advanced Server, the files required to support external authentication are automatically included in the installation process.

When you install the Advanced Server in an OpenVMS Cluster, if you want to enable external authentication on OpenVMS Cluster member nodes on which the server is not running and which share the same system disk, you can install the standalone external authentication software on that disk (without installing the Advanced Server software). On OpenVMS Version 7.1 Alpha and VAX cluster members, you must copy the external authentication files from a system on which the Advanced Server is installed to the OpenVMS Version 7.1 systems.

For more information about enabling external authentication, refer to Section 5.6, Setting Up External Authentication.

1.6 Reading the Release Notes

The PATHWORKS Advanced Server installation kit includes the Compaq PATHWORKS for OpenVMS (Advanced Server) Release Notes. Compaq recommends that you read the release notes before starting the installation.

Note

The installation procedure copies the release notes into the SYS$HELP: area, where they are available after server installation.

1.6.1 How to Access the Release Notes

Use the following table to decide how to print the release notes:

Desired Result

Required Steps

Print the release notes before the installation

Do the following:

Load the installation kit on a drive.
Enter the following commands, replacing device with the name of the device (and if the device is a disk, also designate the directory) where you loaded the installation kit:

$ MOUNT
device: PWRK

$ BACKUP/SELECT=PWRK061.RELEASE_NOTES
device:PWRK061.A/SAVE_SET *

$ PRINT PWRK061.RELEASE_NOTES

Print the release notes during the installation

Do the following:

Load the installation kit on a drive.
Enter the following command to start the installation procedure:
```
$ @VMSINSTAL PWRK061
device_name: OPTIONS N
```

The installation procedure prompts you to either print or display the release notes. In any case, the release notes are always copied to the SYS$HELP: area.

1.7 Using the Installation Checklist

Appendix A, Installation and Upgrade Checklist, provides an installation and configuration summary checklist. You can photocopy the summary checklist and use it to track the completion of the installation and configuration tasks described in this guide.

1.8 Requirements for Installing PATHWORKS Advanced Server Software

The following sections describe the hardware and software that may be required to install PATHWORKS Advanced Server on the system.

1.8.1 Hardware Requirements

All Alpha and VAX processors supported by the OpenVMS operating system are also supported by the PATHWORKS Advanced Server. For the latest information on the hardware that the server supports, refer to the Software Product Description (SPD).

Make sure that the network (including cables, PCs, servers, and other hardware) is connected. For a list of the hardware that the server supports, refer to the Software Product Description (SPD).