Document revision date: 30 March 2001

Order Number: AA--RFM3B--TE

This guide explains how to install and configure the Advanced Server for OpenVMS software.

Revision/Update Information: This manual supersedes the Server Installation and Configuration Guide, AA--RFM3A--TE

Operating System: OpenVMS Alpha Version 7.2-1

Software Version: Advanced Server V7.3 for OpenVMS

Compaq Computer Corporation
Houston, Texas

© 2001 Compaq Computer Corporation

Compaq, the Compaq logo, VAX, and VMS Registered in U.S. Patent and Trademark Office.

AlphaStation, DEC, DECnet, DECwindows, PATHWORKS, OpenVMS, and POLYCENTER are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries.

Microsoft, MS-DOS, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States and other countries.
Intel is a trademark of Intel Corporation in the United States and other countries.
UNIX is a trademark of The Open Group in the United States and other countries.

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.

ZK6540

The Compaq Advanced Server for OpenVMS documentation set is available on CD-ROM.

Contents

Index

This guide explains how to install and configure the Compaq Advanced Server for OpenVMS software (also referred to as the "Advanced Server"). The installation procedure allows you to install:

• The complete Advanced Server
• The standalone License Server, which may run on a separate system in the local area network
• The standalone external authentication software, which may be used to provide external authentication on OpenVMS Cluster member nodes that are not running the Advanced Server
• Both the standalone License Server and external authentication software

Intended Audience

This guide is written for OpenVMS system managers and network administrators. It assumes that 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
• POLYCENTER Software Installation utility

This guide also assumes that you are familiar with basic Advanced Server 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 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 Advanced Server for OpenVMS software from your system.
Appendix A	Provides a summary of installation and configuration tasks. You can photocopy Appendix A and use it as a checklist as you read this guide.
Appendix B	Shows a sample installation and configuration procedure for the 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 External Authentication software only.
Appendix E	Lists the files that are installed with the Advanced Server for OpenVMS software.
Appendix F	Lists the logical names created for the Advanced Server.

Related Documents

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

Document	Description
Compaq Advanced Server for OpenVMS Concepts and Planning Guide	Provides an overview of and introduction to the Advanced Server software and associated networking concepts for system administrators and operators
Compaq Advanced Server for OpenVMS Server Administrator's Guide	Explains how to manage and customize the 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 Advanced Server licenses

The following table lists related OpenVMS documents:

OpenVMS Document	Description
OpenVMS Version 7.2-1 New Features Manual and Release Notes Manual	Describes the new features and related release notes of the OpenVMS Alpha system software.
OpenVMS Alpha Version 7.2 Upgrade and Installation Manual	Describes how to install the OpenVMS 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 Extended File Specifications	Describes Extended File Specifications on OpenVMS, including how to set up and enable the ODS-5 file system
OpenVMS Guide to System Security	Describes OpenVMS security features, including procedures for enabling external authentication
OpenVMS Connectivity Developer's Guide	Contains COM for OpenVMS, OpenVMS Registry, and OpenVMS Events information
Compaq C Run-Time Library Utilities Reference Manual	Describes utilities that help you manage localization and time zone data for international software applications

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

Use the following World Wide Web address 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 following conventions are used in the Advanced Server documentation set:

Convention	Meaning
Advanced Server	Advanced Server refers to the Advanced Server for OpenVMS file server.
Italic	The use of italic text 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 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.

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

This chapter consists of the following sections:

• Section 1.1, About the Advanced Server Software Kit
• Section 1.2, Installing DECprint Software
• Section 1.3, About Licensing
• Section 1.4, About External Authentication
• Section 1.5, About the Release Notes
• Section 1.6, Using the Installation Checklist
• Section 1.7, Requirements for Installing Advanced Server for OpenVMS Software
• Section 1.8, Preinstallation Tasks
• Section 1.9, Next Step

The Advanced Server for OpenVMS kit contains the software required to run the following server software options:

• The complete Advanced Server software, including the License Server and external authentication software
• The Advanced Server standalone License Server
• The standalone external authentication software
• Both the standalone License Server and the standalone external authentication software

The Advanced Server for OpenVMS product is supported on OpenVMS Alpha systems only. You cannot install the Advanced Server for OpenVMS software on OpenVMS VAX systems. On VAX systems, you should continue to use the current PATHWORKS server software. If you have not already done so, upgrade to PATHWORKS for OpenVMS (Advanced Server), Version 6.0C or later.

In mixed-architecture OpenVMS Clusters with the Advanced Server for OpenVMS running on Alpha members, VAX members can still use external authentication. For more information, see Section 5.7.1, Setting Up External Authentication in OpenVMS Clusters.

The Advanced Server for OpenVMS software may be installed and run only on OpenVMS Version 7.2-1 and higher Alpha systems. Therefore, it may be necessary to upgrade the operating system as well as the server software.

If the Advanced Server for OpenVMS Version 7.2 or later is already installed, the installation and upgrade do not require an intermediate upgrade.

If PATHWORKS V6 for OpenVMS (Advanced Server) is currently installed, ensure that it is Version 6.0C or later. Otherwise, upgrade to the current release of PATHWORKS V6 for OpenVMS (Advanced Server) before continuing. The Advanced Server configuration procedure (PWRK$CONFIG.COM) automatically converts the PATHWORKS for OpenVMS (Advanced Server) data files to formats compatible with the Advanced Server for OpenVMS, as described in Chapter 3.

If PATHWORKS V5 for OpenVMS (LAN Manager) is currently installed, there is no direct upgrade to the Advanced Server for OpenVMS. If you want to retain the existing user, group, share, and security objects, you must first upgrade to PATHWORKS for OpenVMS (Advanced Server), Version 6.0C or later. For more information, refer to the Compaq PATHWORKS for OpenVMS Server Migration Guide.

For systems running the PATHWORKS V5 for OpenVMS (LAN Manager) file server on OpenVMS Alpha Version 6.2 systems, Compaq recommends the following migration path:

1. Upgrade the Version 5 file server to PATHWORKS V6 for OpenVMS (Advanced Server), Version 6.0C or later.
2. Upgrade the operating system to OpenVMS Version 7.2-1 or higher.
3. Upgrade the Version 6 file server to Advanced Server V7.3 for OpenVMS.

Refer to the appropriate Software Product Description (SPD) for information about the OpenVMS versions supported by each version of PATHWORKS for OpenVMS and Advanced Server for OpenVMS.

1.1.2.1 LANMAN.INI Parameters Migrate to OpenVMS Registry

Previous versions of the server software (for example, PATHWORKS for OpenVMS) use the LANMAN.INI file to store server parameters. The Advanced Server for OpenVMS stores these parameters in the OpenVMS Registry, which is similar to the Windows NT Registry.

If you are upgrading a system from PATHWORKS V6 for OpenVMS (Advanced Server) to Advanced Server V7.3 for OpenVMS, the parameters and settings in the existing LANMAN.INI file are migrated to registry parameters when you run the PWRK$CONFIG.COM configuration procedure for the first time. For more information, see Section 3.2, Migrating LANMAN.INI Parameters to the OpenVMS Registry.

1.1.2.2 Upgrading OpenVMS Clusters

You can install the Advanced Server for OpenVMS on any OpenVMS Cluster member running OpenVMS Alpha Version 7.2-1 or higher. However, if PATHWORKS for OpenVMS (Advanced Server) or Advanced Server for OpenVMS is currently running on any cluster member, it must be stopped prior to installation. If the cluster members that will run the Advanced Server for OpenVMS share a common system disk, the installation can be performed on any cluster member that shares the system disk. If cluster members that will run the Advanced Server for OpenVMS use separate system disks, install the Advanced Server for OpenVMS on each system.

If the OpenVMS Cluster contains other system disks (for example, to support VAX systems in the cluster or systems running earlier versions of OpenVMS Alpha), these disks might have older versions of the PATHWORKS for OpenVMS (Advanced Server) installed on them. If so, remove the older versions to prevent accidental startup while the Advanced Server for OpenVMS is running on the OpenVMS Alpha Version 7.2-1 or later systems. To remove the PATHWORKS for OpenVMS (Advanced Server) product, execute the command procedure SYS$UPDATE:PWRK$DEINSTAL from a cluster member that uses the system disk from which PATHWORKS is to be removed. For more information on using PWRK$DEINSTAL.COM, refer to the Compaq PATHWORKS for OpenVMS (Advanced Server) Server Installation and Configuration Guide.

Note, however, if you are using external authentication, Compaq recommends that you set up external authentication software on all the nodes in the cluster. To set up external authentication support on nodes that do not run Compaq OpenVMS file servers, see Section 5.7, Setting Up External Authentication.

1.2 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.3 About Licensing

The following sections describe the licensing software and the license requirements for the Advanced Server.

1.3.1 License Requirements

The 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 acquire a client-based license before connecting to an Advanced Server for the first time.
• The Advanced Server must have a server-based license available to assign to an unlicensed client attempting to use services of the Advanced Server.

In both cases, the license required to access Advanced Server services is a Client Access license: PWLMXXXCA07.03.

If you are upgrading from PATHWORKS V6 for OpenVMS (Advanced Server) or Advanced Server for OpenVMS, Version 7.2, refer to the Compaq Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses for information about upgrading client licenses.

1.3.2 About the License Server

The Advanced Server 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 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 protocols:

• DECnet
• LAN Manager (NetBEUI)
• TCP/IP

Compaq recommends that you install the License Server on a designated OpenVMS system without the Advanced Server. The Advanced Server for OpenVMS 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 the Advanced Server, where cluster failover provides increased availability. (Cluster failover also provides increased availability for the Advanced Server file server.)

Each LAN needs only one active License Server. The license product authorization keys (PAKs) must be loaded on the system that runs the 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
Configuring the License Server	Chapter 4, Configuring and Starting the Standalone License Server
Managing licenses	Compaq Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses

1.4 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 Advanced Server takes advantage of this feature by providing the ability to use the 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 Advanced Server user name and password, and provides automatic password synchronization for user accounts. External authentication may be required if you are using the COM for OpenVMS product.

When you install the complete 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 VAX member nodes, you must copy the external authentication files from an Alpha system on which the Advanced Server is installed to the VAX node. For more information about enabling external authentication, see Section 5.7, Setting Up External Authentication.

	privacy and legal statement
6540PRO.HTML