# 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

© 2001 Compaq Computer Corporation

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

# Related Documents

The following manuals provide more information about topics discussed in this guide:

Document | Description
--- | ---
Compaq PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide | Explains how to upgrade a PATHWORKS (LAN Manager) server to PATHWORKS V6 for OpenVMS (Advanced Server)
Compaq Advanced Server for OpenVMS Concepts and Planning Guide | Provides an overview of and introduction to the PATHWORKS Advanced Server software and associated networking concepts for system administrators and operators
Compaq PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide | Explains how to manage and customize the PATHWORKS Advanced Server software
Compaq Advanced Server for OpenVMS Commands Reference Manual | Provides command syntax descriptions for all ADMINISTER commands and NET command equivalents
Compaq Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses | Describes the License Server software and how to manage PATHWORKS for OpenVMS (Advanced Server) licenses

The following table lists related OpenVMS documents.

OpenVMS Document | Description
--- | ---
x New Features and Documentation Overview Manual | Describes the new features of the OpenVMS software and provides an overview of the documentation that supports it
x Upgrade and Installation Manual | Describes how to install the OpenVMS Alpha system software
x Upgrade and Installation Manual | Describes how to install the OpenVMS VAX system software
OpenVMS System Manager's Manual | A task-oriented guide (in two volumes) to managing an OpenVMS system; describes how to set up the required system services
OpenVMS System Management Utilities Reference Manual | A reference guide (in two volumes) to the utilities and tools used in managing an OpenVMS system
OpenVMS License Management Utility Manual | Explains how to load and manage license Product Authorization Keys (PAKs)
OpenVMS Guide to System Security | Describes the system security features of OpenVMS, including procedures for enabling external authentication

For additional information about the OpenVMS products and services, access the following OpenVMS World Wide Web address:

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

# 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:

- Section 1.1, About the PATHWORKS for OpenVMS Software Kit
- Section 1.2, If You Are Upgrading from PATHWORKS (LAN Manager)
- Section 1.3, Installing DECprint Software
- Section 1.4, About Licensing
- Section 1.5, About External Authentication
- Section 1.6, Reading the Release Notes
- Section 1.7, Using the Installation Checklist
- Section 1.8, Requirements for Installing PATHWORKS Advanced Server Software
- Section 1.9, Preinstallation Tasks
- Section 1.10, Next Step

# 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
2. 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).

Next | Contents | Index