PATHWORKS for OpenVMS

Server Installation and Configuration Guide

Order Number: AA--R6G1B--TE

January 1999

This guide explains how to install and configure the components of PATHWORKS for OpenVMS software, including the PATHWORKS Advanced Server and the standalone license server.

Revision/Update Information: This guide supersedes the DIGITAL Advanced Server for OpenVMS Server Installation and Configuration Guide, AA--R6G1A--TE.

Operating System: OpenVMS Alpha Version 7.1
OpenVMS VAX Version 7.1
OpenVMS Alpha Version 7.2
OpenVMS VAX Version 7.2

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

Compaq Computer Corporation
Houston, Texas

First Printing, May 1988
Revised, January 1999

Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.

Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and community.

The following are trademarks of Compaq Computer Corporation

Alpha, Compaq, DECdirect, DECnet-Plus, DECprint, DIGITAL, OpenVMS, PATHWORKS, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.

The following are third-party trademarks:

AT&T is a registered trademark of American Telephone and Telegraph Company.
Apple, AppleShare, LaserWriter, Macintosh, and TRUETYPE are registered trademarks of Apple Computer, Inc.
DEC Rdb is a trademark of Oracle Corporation.
Hewlett-Packard, HP, LaserJet, and PCL are registered trademarks of Hewlett-Packard Company.
IBM and OS/2 are registered trademarks of International Business Machines Corporation.
Microsoft, MS-DOS, and Windows are registered trademarks, and Windows 95, Windows 98, and Windows NT are trademarks of Microsoft Corporation.
MultiNet and TCPWARE are registered trademarks of Process Software Corporation.
NetBIOS is a trademark of Micro Computer Systems, Inc.
Novell and NetWare are registered trademarks of Novell, Inc.
PostScript is a registered trademark of Adobe Systems Incorporated.

All other trademarks and registered trademarks are the property of their respective holders.

ZK6555

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

This document was prepared using VAX DOCUMENT, Version V3.2-1n.

Contents Index

Preface

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

PATHWORKS for OpenVMS (Advanced Server) file server
PATHWORKS standalone license server
Upgrade utility only
External Authentication software only

Intended Audience

This guide is written for the network server administrator. The administrator is assumed to be familiar with the following aspects of the OpenVMS operating system:

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

This guide also assumes that the administrator is familiar with the networking concepts for the PATHWORKS Advanced Server.

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 post-installation 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.

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 post-installation 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.

Document	Description
PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide	Explains how to upgrade a PATHWORKS V5 for OpenVMS (LAN Manager) server to PATHWORKS V6 for OpenVMS (Advanced Server).
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.
PATHWORKS for OpenVMS (Advanced Server) Server Administrator's Guide	Explains how to manage and customize the PATHWORKS Advanced Server software.
Advanced Server for OpenVMS Commands Reference Manual	Provides command syntax descriptions for all ADMINISTER commands and NET command equivalents.
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.

OpenVMS Document	Description
OpenVMS Alpha V7.1 Upgrade and Installation Manual	Describes how to install the OpenVMS Alpha V7.1 system software.
OpenVMS Alpha V7.2 Upgrade and Installation Manual	Describes how to install the OpenVMS Alpha V7.2 system software.
OpenVMS VAX V7.1 Upgrade and Installation Manual	Describes how to install the OpenVMS VAX V7.1 system software.
OpenVMS VAX V7.2 Upgrade and Installation Manual	Describes how to install the OpenVMS VAX V7.2 system software.
OpenVMS System Manager's Manual	A task-oriented guide to managing an OpenVMS system.
OpenVMS System Management Utilities Reference Manual	A reference guide 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 V7.1 New Features Manual	Describes the new features of OpenVMS Version 7.1, including procedures for enabling external authentication.
OpenVMS V7.2 Guide to System Security	Describes the system security features of OpenVMS Version 7.2, including procedures for enabling external authentication.

Reader's Comments

Compaq welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:

Internet openvmsdoc@zko.mts.dec.com

Fax 603-884-0120, Attention: OSSG Documentation, ZKO3-4/U08

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

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:

http://www.openvms.digital.com:81/

If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).

Conventions

The following conventions are used in the PATHWORKS Advanced Server documentation set.

Convention Meaning

"PATHWORKS Advanced Server" Refers to the PATHWORKS for OpenVMS (Advanced Server) file and print server.

DECnet Applies to both DECnet Phase IV and DECnet-Plus, unless otherwise specified.

[Ctrl/] x While you hold down the Ctrl key, press another key or a pointing device button.

[Return] Indicates a place to press the Return (or Enter) key.

Italic Indicates a place holder 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 also indicates new terms and the titles of other documentation referenced.

monospace Indicates the actual commands, words, or characters that you type in a dialog box or at a command prompt or system output.

Note: Provides information of special importance.

Caution: Provides information to avoid damaging software or hardware.

Warning: Provides information that is essential to people's safety.

/ A forward slash in command descriptions indicates that a command qualifier follows.

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

Convention	Meaning
"PATHWORKS Advanced Server"	Refers to the PATHWORKS for OpenVMS (Advanced Server) file and print server.
DECnet	Applies to both DECnet Phase IV and DECnet-Plus, unless otherwise specified.
`[Ctrl/]` x	While you hold down the Ctrl key, press another key or a pointing device button.
`[Return]`	Indicates a place to press the Return (or Enter) key.
Italic	Indicates a place holder 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 also indicates new terms and the titles of other documentation referenced.
`monospace`	Indicates the actual commands, words, or characters that you type in a dialog box or at a command prompt or system output.
Note:	Provides information of special importance.
Caution:	Provides information to avoid damaging software or hardware.
Warning:	Provides information that is essential to people's safety.
/	A forward slash in command descriptions indicates that a command qualifier follows.
...	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.

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 Advanced Server for OpenVMS Software Kit

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

PATHWORKS Advanced Server file server
PATHWORKS standalone license server

In addition, the kit includes an Upgrade utility that helps you to migrate from PATHWORKS V5 for OpenVMS (LAN Manager) to PATHWORKS V6 for OpenVMS (Advanced Server). The Upgrade utility may be installed separately.

The installation procedure also allows you to install only External Authentication software.

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 V5 for OpenVMS (LAN Manager)

If you have PATHWORKS V5 for OpenVMS (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. See the PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide for more information.

1.3 Installing DECprint Software

DECprint Supervisor for OpenVMS is a printing system that provides queue management and printing features for PostScript printers.

If you plan to use DECprint Supervisor for OpenVMS on your system, Compaq Computer Corporation recommends that you install it before installing PATHWORKS 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 PATHWORKS Advanced Server. However, DECprint Supervisor software must be installed before you configure and start PATHWORKS Advanced Server.

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 have acquired a client-based license before connecting 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 Advanced Server services is the PATHWORKS Client-Access license: PWLMXXXCA06.00.

If you are upgrading from PATHWORKS LAN Manager, refer to the 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 a software program that you can run on your OpenVMS system to grant licenses to clients.

The license server can be installed:

With the file server (automatically included with your file server installation)
Separately from the file 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 Computer Corporation recommends that you install the license server on a designated OpenVMS system without the PATHWORKS file server. Therefore, the PATHWORKS for OpenVMS (Advanced Server) software kit allows you to install the standalone license server separately from the file server. Alternatively, you can run the license server on an OpenVMS cluster with PATHWORKS file 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.

For more information about . . . Refer to . . .

Loading licenses OpenVMS License Management Utility Manual

Managing PATHWORKS Advanced Server licenses Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses

For more information about . . .	Refer to . . .
Loading licenses	OpenVMS License Management Utility Manual
Managing PATHWORKS Advanced Server licenses	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 PATHWORKS Advanced Server, the files required to support external authentication are automatically included in the installation process.

If you want to enable external authentication on a different node in an OpenVMS cluster), you may choose to install the External Authentication software only.

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

1.6 Reading the Release Notes

The PATHWORKS Advanced Server installation kit includes the PATHWORKS for OpenVMS (Advanced Server) Release Notes.

Compaq Computer Corporation recommends that you print and read the appropriate 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:

If you want to . . . Then . . .

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=PWRKV60B060.RELEASE_NOTES device:PWRKV60B060.A/SAVE_SET *
$ PRINT PWRKV60B060.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 PWRKV60B060 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.

If you want to . . .	Then . . .
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=PWRKV60B060.RELEASE_NOTES device:PWRKV60B060.A/SAVE_SET * $ PRINT PWRKV60B060.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 PWRKV60B060 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

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

1.8.2 Software Requirements

To install PATHWORKS Advanced Server successfully, you must have the following software properly installed and configured on your system:

OpenVMS V7.1 or V7.2
DECnet or DECnet-Plus (optional)
DECnet can be installed automatically with the OpenVMS operating system.
TCP/IP (optional)
TCP/IP Services for OpenVMS and a selection of third-party TCP/IP products on OpenVMS can be used to provide TCP/IP support.

Contents

Index

Internet	openvmsdoc@zko.mts.dec.com
Fax	603-884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698