Advanced Server for OpenVMS

Updated: 24 May 2001

Server Installation and Configuration Guide

Order Number: AA--RFM3A--TE

January 1999

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

Revision/Update Information: This is a new manual.

Operating System: OpenVMS Alpha Version 7.2

Software Version: Advanced Server V7.2 for OpenVMS

Compaq Computer Corporation
Houston, Texas

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

ZK6540

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

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

Contents Index

Preface

This guide explains how to install and configure the 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.
External authentication software only, which may be used to provide external authentication on OpenVMS cluster member nodes that are not running the Advanced Server.

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

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 Advanced Server documentation set.

Convention Meaning

Advanced Server Advanced Server refers to the Advanced Server for OpenVMS file server.

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

[Return] Indicates a place where you should 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 actual commands and characters that you enter, and the system display.

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

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:

1.1 About the Advanced Server Software Kit

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

The Advanced Server file server
The Advanced Server standalone license server
The external authentication software only

1.1.1 About VAX Systems

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 server software, or upgrade to PATHWORKS V6 for OpenVMS (Advanced Server).

1.1.2 If You Are Upgrading to Advanced Server

The Advanced Server for OpenVMS software runs only on OpenVMS V7.2 systems. Therefore, it may be necessary to upgrade the operating system as well as the server software.

If you are installing the Advanced Server for OpenVMS software on a system where PATHWORKS for OpenVMS has been installed, prepare the system by following the migration path described in Section 1.1.2.1, Migrating the Server.
If you are upgrading from PATHWORKS V6 for OpenVMS (Advanced Server), refer to Chapter 5, After You Install the Advanced Server, for information about the changes you will encounter in the server environment and operation.

1.1.2.1 Migrating the Server

The Advanced Server for OpenVMS software can be installed on systems where PATHWORKS V6 for OpenVMS (Advanced Server) was installed. The configuration procedure (PWRK$CONFIG.COM) automatically upgrades server components and parameters. If the system is running a server version previous to PATHWORKS V6.0B for OpenVMS (Advanced Server), you should upgrade the operating system to OpenVMS Version 7.2, and then upgrade the server to V6.0B before you install Advanced Server for OpenVMS.

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

Upgrade the operating system to OpenVMS Version 7.1.
Upgrade the V5 file server to PATHWORKS V6.0B for OpenVMS (Advanced Server).
Upgrade the operating system to OpenVMS Version 7.2.
Upgrade the V6.0B file server to Advanced Server V7.2 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.2 Migrating LANMAN.INI Parameters

The Advanced Server relies on the OpenVMS Registry as the repository for server configuration parameters. In previous versions of the server software (for example, PATHWORKS for OpenVMS servers), the LANMAN.INI file is used to store server parameters. The Advanced Server 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.2 for OpenVMS, the parameters and settings in the existing LANMAN.INI file are migrated to registry parameters when you run the PWRK$CONFIG.COM initial configuration procedure. For more information, see Section 3.2, Migrating LANMAN.INI Parameters to the OpenVMS Registry.

1.1.2.3 Upgrading OpenVMS Clusters

You can install the Advanced Server on any OpenVMS cluster member running OpenVMS Alpha Version 7.2, as long as no other cluster members are running PATHWORKS for OpenVMS. If you are installing the Advanced Server on a cluster member node, you cannot run PATHWORKS V6 for OpenVMS (Advanced Server) or PATHWORKS V5 for OpenVMS (LAN Manager) on any other node in the same cluster.

The Advanced Server runs on OpenVMS Alpha systems only. If you are installing the Advanced Server in a mixed-architecture cluster (a cluster containing both Alpha and VAX members), you cannot continue to run PATHWORKS for OpenVMS on VAX members. However, you can provide external authentication support on all nodes in the cluster by setting up external authentication on VAX nodes, as described in Section 5.6, Setting Up External Authentication.

1.2 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 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 have acquired a client-based license before connecting to an Advanced Server.
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.02.

If you are upgrading from PATHWORKS V6 for OpenVMS (Advanced Server), refer to the Advanced Server for OpenVMS Guide to Managing Advanced Server Licenses for information about upgrading client license requests.

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. Therefore, 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 reliability.

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 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 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, and you want to enable external authentication on OpenVMS cluster member nodes where the Advanced Server is not installed, you can install the external authentication software only.

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

1.5 Reading the Release Notes

The following sections describe the product release notes and how to extract them from the software kit before installing Advanced Server for OpenVMS.

1.5.1 About the Release Notes

Compaq recommends that you print and read the release notes before starting the installation.

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

1.5.2 How to Access the Release Notes

If you want to print the release notes before the installation, do the following:
1. Load the installation kit on a drive.
2. Enter the following commands, replacing device with the name of the device and the directory where you loaded the installation kit:
  $ MOUNT device: FPS $ BACKUP/SELECT=ASOVMS072.RELEASE_NOTES device:ASOVMS072.A/SAVE_SET * $ PRINT ASOVMS072.RELEASE_NOTES
If you want to print the release notes during the installation, do the following:
1. Load the installation kit on a drive.
2. Enter the following command to start the installation procedure:
  $ @VMSINSTAL ASOVMS072 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.6 Using the Installation Checklist

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