Order Number: AA--R6G2C--TE

This guide describes the types of Advanced Server licenses, license management software, and how to configure your system as a License Server.

Revision/Update Information: This guide supersedes the Advanced Server for OpenVMS Guide to Managing PATHWORKS Licenses, AA--R6G2B--TE

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

Software Versions: Advanced Server V7.3 for OpenVMS
PATHWORKS V6 for OpenVMS (Advanced Server)

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.

ZK6554

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

Contents

Index

This guide describes:

• Types of Advanced Server licenses
• Step-by-step instructions for using the Advanced Server license management software
• How to use the Advanced Server License Manager
• How to troubleshoot licensing problems

This guide contains information about licensing requirements for both PATHWORKS V6.0C for OpenVMS (Advanced Server) and Advanced Server V7.3 for OpenVMS. The term "Advanced Server license" applies to the license required to access the specific version of the file server.

About This Guide

This guide is written for system administrators who need to:

• Gain a basic understanding of Advanced Server licensing concepts.
• Ensure that valid clients receive licenses.
• Manage licenses.
• Solve and eliminate license management problems.

This guide assumes you are familiar with basic license management software provided with the Compaq OpenVMS operating system.

Organization of This Guide

This guide contains the following sections:

Chapter	Description
Chapter 1	Provides an overview of the License Server software and the license management tasks you perform
Chapter 2	Describes how you configure and manage the License Server software in your network environment
Chapter 3	Describes how to configure the License Server software components on OpenVMS systems
Chapter 4	Describes how to use the License Manager
Chapter 5	Describes client software components that might be used with the License Server and how to obtain them, if necessary
Appendix A	Lists and describes the messages that are generated in response to server events

Related Documents

The following table lists related Advanced Server for OpenVMS documents:

Document	Description
Compaq Advanced Server for OpenVMS Server Installation and Configuration Guide	Explains how to install and configure Advanced Server software
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

The following table lists related PATHWORKS for OpenVMS (Advanced Server) documents:

Document	Description
Compaq PATHWORKS for OpenVMS Server Migration Guide	Explains how to upgrade a PATHWORKS (LAN Manager) server to PATHWORKS V6 for OpenVMS (Advanced Server)
Compaq PATHWORKS for OpenVMS (Advanced Server) Server Installation and Configuration Guide	Explains how to install and configure PATHWORKS for OpenVMS software
Compaq Advanced Server for OpenVMS Concepts and Planning Guide	Provides an overview of and introduction to the PATHWORKS for OpenVMS (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 for OpenVMS (Advanced Server) software
Compaq Advanced Server for OpenVMS Commands Reference Manual	Provides command syntax descriptions for all ADMINISTER commands and NET command equivalents

The following table lists related OpenVMS documents:

OpenVMS Document	Description
OpenVMS Alpha Version 7.1 Upgrade and Installation Manual	Describes how to install the OpenVMS Alpha Version 7.1 system software
OpenVMS Alpha Version 7.2 Upgrade and Installation Manual	Describes how to install the OpenVMS Alpha Version 7.2 system software
OpenVMS VAX Version 7.1 Upgrade and Installation Manual	Describes how to install the OpenVMS VAX Version 7.1 system software
OpenVMS VAX Version 7.2 Upgrade and Installation Manual	Describes how to install the OpenVMS VAX Version 7.2 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)

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 PATHWORKS for OpenVMS (Advanced Server) as well as Advanced Server for OpenVMS file server.
Italic	Italics 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 path names, new terms, and the titles of other documents.
monospace	Monospace text indicates the actual commands, words, or characters that you type in a dialog box or at a command prompt or system output.
Note	The use of Note provides information of special importance.
Caution	The use of Caution provides information to avoid damaging the software or hardware.
Warning	The use of 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.
Ctrl/ x	While you hold down the Ctrl key, press another key or a pointing device button.
Return or Enter	The use of 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.

Any client accessing an Advanced Server must be sufficiently licensed. This chapter describes how the license software works, the licenses required to access the server, and how license management works. The following topics are discussed:

• Section 1.1, The Advanced Server Licensing System, describes the different components of the licensing system and describes how licensing works.
• Section 1.2, License Management Models, describes the different license management approaches to providing access to the Advanced Server.
• Section 1.3, License Management Tasks, describes the tasks involved in managing Advanced Server licenses and the features of the License Manager that allow you to perform these tasks.

The Advanced Server license software on the server runs on the OpenVMS operating system and includes the following components:

• License Server -- A software program that assigns and verifies client-based licenses and performs license management tasks.
• License Manager---A management interface between the system administrator and the Advanced Server License Server.
• License Registrar---A program that runs on every Advanced Server node and validates that client access to the file server is licensed. The License Registrar also grants server-based licenses.

The licensing software that runs on the client includes the following components:

• Client License Requester---A program that runs on the client and requests licenses from the License Server.
• Client License Transponder---A program that runs on the client and communicates information about the client's license to the License Registrar.

See Chapter 5, Client Licensing Software, for more information about the client licensing software.

The organization of these components is shown in Figure 1-1, Advanced Server Licensing System.

Figure 1-1 Advanced Server Licensing System

1. Client requests license assignment or verification.
2. Client establishes new session with file server.
3. File server requests to validate that the client is licensed for access to file server resources.
4. License Registrar validates a client's license or assigns a server-based license.

The following list summarizes how the components of the licensing system interact:

• The Advanced Server License Server is installed and configured on an OpenVMS system. This can be a standalone system or an OpenVMS Cluster and does not necessarily have to be on the same system as the Advanced Server. The Advanced Server License Server is an interface between the LMF database and the client licensing software. It services requests for client-based licenses.
• The License Registrar runs on every Advanced Server system and determines if a client is licensed to use the Advanced Server resources. The License Registrar validates client-based licenses and grants server-based licenses when they are needed and available.
  For server-based licensing, Advanced Server licenses are loaded and registered on the file server system. The License Registrar also maintains information about the licenses and periodically interfaces to LMF to determine changes to licenses, such as the addition of new licenses and the removal of licenses.
  When unlicensed clients access the Advanced Server resources, they are granted server-based licenses by the License Registrar, if they are available. These licenses must be available to the License Registrar for such server-based use ahead of time.
• The License Manager:
  • Manages client-based licenses
  • Specifies how many licenses will be used as client-based licenses and how many licenses will be used as server-based licenses
  • Organizes client-based licenses into license groups
  • Generates reports of licensing activities
  • Displays lists of clients that have been granted licenses
  • Revokes licenses
• Clients use the client license requester (CLR) and the client license transponder (CLT) programs to request and verify licenses. The CLR program requests client-based licenses from the License Server. When the License Server assigns a license to the client, the client provides license information to the CLT program. Each time the client establishes a session with Advanced Server resources, the CLT program presents this license information to the License Registrar so that the license can be validated.

For a system to be an Advanced Server License Server, no special attributes are required. However, make sure that the system is configured for, and running, all of the transports used by clients requesting licenses.

A small amount of disk storage space on the server, less than 500 bytes per license managed, is also required.

Compaq recommends that you use a single License Server to provide client-based licenses to all clients requiring a client-based license in a local area network (LAN). There is no technical reason why you could not use a single License Server per wide area network (WAN) or multiple License Servers per LAN; these models are also supported. However, using a single License Server per LAN, at least to start, provides a good degree of local control while keeping the administrative activity to a minimum. Also, operating too many License Servers within a single LAN can result in performance degradation.

For increased availability, a License Server can be run in an OpenVMS Cluster. Alternatively, two or more License Servers can be run, although any given PAK can only be loaded on one OpenVMS system at a time.

When registering and loading a new Advanced Server license PAK on an OpenVMS Cluster, use the LICENSE REGISTER command on one node of the cluster to register the PAK and then use the LICENSE LOAD command on each cluster member to load the licenses on that cluster member. This ensures that Advanced Server license components running on any member of the cluster will be able to detect the new licenses. Failure to load the licenses on each cluster member may cause failures due to the Advanced Server licenses components' inability to detect licenses that are not loaded.

1.1.2 Configuring License Services

When you install the Advanced Server, the License Registrar is automatically installed to ensure that access to the server resources is validated. The License Server, however, is an optional component that is installed only if you answer YES to the appropriate prompt in the initial configuration dialog, PWRK$CONFIG, described in the Server Installation and Configuration Guide for your Advanced Server product.

The License Server manages client-based licenses, including assignment of licenses to clients and allocation of licenses to license groups.

If you choose not to configure the License Server to run, the License Registrar takes its licenses directly from LMF (the License Management Facility) and uses them exclusively as server-based licenses. Simply load the licenses as described in the OpenVMS License Management Utility Manual.

If you choose to configure the License Server, use the procedures described in this guide to allocate and manage licenses. For more information on choosing client-based versus server-based licensing, see Chapter 2, Setting Up License Management.

When the Advanced Server is started, the License Server (if configured) and the License Registrar are started using the following command procedures:

• SYS$STARTUP:PWRK$LICENSE_S_START.COM
• SYS$STARTUP:PWRK$LICENSE_R_START.COM

These command procedures contain complete descriptions of the configuration parameters used by each process when it runs. For more information about these parameters, see Section 2.6, License Server and License Registrar Configuration Parameters. In addition, Section A.2, License Server Events, includes information about parameters that control the reporting of events that are logged to the License Server log file. Section A.3, License Registrar Events, includes information about parameters that control the reporting of events that are logged to the License Registrar log file.

1.1.2.1 Configuring Standalone License Servers

The License Server can run on a different system than the one that is running the file server (such as the Advanced Server or the PATHWORKS Advanced Server). Compaq recommends this configuration for the best performance of the file server system. The system running the License Server without a file server is referred to as a "standalone License Server."

To configure a system to run the standalone License Server, install the file server software as described in the Server Installation and Configuration Guide for your Advanced Server product. During the product installation procedure, you should answer NO to the question about installing the Advanced Server, and answer YES to the question, "Do you want to install only the Advanced Server License Server?" When the procedure completes, configure and start the License Server as described in the Server Installation and Configuration Guide for your Advanced Server product.

When you install the file server on another system in the local area network (LAN), configure the server so that the License Server is not started on the same system with the file server.

For more information about License Server configuration, see Chapter 3, Configuring License Servers.

1.1.2.2 Configuring LANs and WANs

Compaq recommends that the License Server be installed and running in the same LAN as the file server that the clients need to access, if you are using client-based license management. Clients on computers outside of the LAN can obtain licenses for access to the file server, if the License Server is configured for wide area network access. For more information about how to provide WAN access to the License Server, see Section 5.3, Enabling Wide Area Network (WAN) Operations,