Digital DCE for OpenVMS VAX and OpenVMS Alpha

Digital DCE for OpenVMS VAX and OpenVMS Alpha

Installation and Configuration Guide

January 1999

This guide describes the installation procedure and the system configuration utility for the Digital Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha.

Revision/Update Information: This guide supersedes the Digital DCE for OpenVMS VAX and OpenVMS Alpha Installation and Configuration Guide Version 1.3.

Software Version: Digital DCE for OpenVMS Version 1.5

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.

© Compaq Computer Corporation 1999. All rights reserved.

The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECnet, DECthreads, DIGITAL, OpenVMS, VAX, VMS, VMScluster, and the Compaq logo.

The following are third-party trademarks:

Kerberos is a trademark of the Massachusetts Institute of Technology.

Microsoft, MS, and MS--DOS are registered trademarks of Microsoft Corporation.

MultiNet is a registered trademark of the Open Software Foundation, Inc.

NetView is a registered trademark of International Business Machines Corporation.

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


The OpenVMS documentation set is available on CD-ROM.

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

Contents Index


This guide describes the installation procedure and the system configuration utility for the Digital Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha Version 1.5, which consists of the following services:

Information on Microsoft's NT Lan Manager (NTLM) is provided as a preview of functionality that will be available in a future version of Digital DCE for OpenVMS (Alpha only). This advanced documentation will help you in future planning.

Four kits are installed:

The Runtime Services Kit contains the following:

The Application Developer's Kit contains the following:

The CDS Server Kit contains the following:

The Security Server Kit contains the following:

Keep this document with your distribution kit. You will need it to install maintenance updates or to reinstall Digital DCE.

Intended Audience

This guide is intended for managers of distributed computing environments on one or more systems and installers of the Digital DCE for OpenVMS VAX or OpenVMS Alpha Kit Version 1.5.

Document Structure

This guide is organized as follows:

Related Documents

For additional information on the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address: 

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

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


VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references in this document to OpenVMS Clusters or clusters are synonymous with VMSclusters.

The following conventions are also used in this guide:
Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where device-name contains up to five alphanumeric characters).
UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type Monospace type indicates code examples and interactive screen displays.

In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

Case-sensitivity OpenVMS operating system commands do not differentiate between uppercase and lowercase. However, many DCE commands do make this distinction. In particular, the system configuration utility interprets names in a case-sensitive manner.

Chapter 1
Preparing for Installation

This chapter describes the preparations you must make before you install and configure the Digital Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha software.

Digital DCE is an enabling software technology for the development of distributed applications. It provides a variety of common services needed for the development of distributed applications, such as name services and a standard remote procedure call interface.

1.1 Planning for Installation and Configuration

This section helps you plan for the installation and configuration of the Digital DCE. It presents a brief overview of some concepts that you need to understand before you install and configure Digital DCE software. This understanding can help you decide how to configure DCE. Refer to Understanding DCE for detailed explanations of DCE concepts.

The installation and configuration procedures set up the DCE environment so that you can use DCE services. Before you can use Digital DCE software, you must both install the software and configure DCE on your system.

1.1.1 What Is a Cell?

A cell is the basic DCE unit consisting of a group of nodes that share a directory service namespace and a security service registry under a common administration. Usually, the nodes in a cell are in the same geographic area, but cell boundaries are not limited by geography. Although a cell can contain from one to several thousand nodes, each node can belong only to one cell at a time.

The system configuration utility allows you to join an existing cell. The cell must provide a directory server and a security server. These servers may be resident on the same system or may be running on separate systems.

Note that if you rely on DCE time services for time synchronization, you need a minimum of three time servers to synchronize time in a cell. See the section on the DCE Distributed Time Service in the OSF DCE Administration Guide for more information.

1.1.2 Creating a Cell

See the chapter on initial cell configuration guidelines in Understanding DCE for information about creating a cell.

1.1.3 Joining a Cell

You need the following information to join a DCE cell:

When the client joining the cell is on the same LAN as the CDS directory master server, the CDS advertiser automatically determines the server's location by using IP (Internet Protocol) broadcast packets. If the CDS master server is not on the LAN, then you need to provide the host name where the CDS master server is running.

1.2 Inspecting the Distribution Kit

The Software Bill of Materials (BOM) included with your distribution kit specifies the contents of your distribution kit. Carefully compare the items you received with the items listed in the BOM. If any components are missing or damaged, contact your Compaq customer service representative before you continue with the installation.

The Read Before Installing letter listed on your BOM provides important information that you should be aware of before you install Digital DCE. Some of this information may not be included in either this guide or the release notes.

Digital DCE provides online release notes. Read the release notes before you install the product. They contain information about changes to the product. For example, the release notes contain important information on modifications you should make to UCX parameters before you begin the installation.

1.3 Troubleshooting

The Digital DCE for OpenVMS VAX and OpenVMS Alpha Product Guide includes a chapter on troubleshooting. Read this chapter if you are having installation or configuration problems. For example, the Troubleshooting chapter discusses problems you may encounter with time and time zones.

1.4 Installation Procedure Requirements

The following sections discuss the requirements for installing Digital DCE.

The length of time the installation takes to complete depends on the type of machine, the load on that machine, and the kit you choose to install.

1.4.1 Required Hardware

To perform the installation, you need the following hardware:


Systems running OpenVMS Alpha should have access to a CD-ROM reader so you can install the software. Please check to see that you have a CD-ROM reader installed.

1.4.2 Required Software

This section describes the software that must be installed on an OpenVMS system before you can properly perform the installation, configure the system, or use the software. In cases where the minimum version is not specified, refer to the Software Product Description (SPD) for more information. On OpenVMS Alpha and VAX Systems

Before installing Digital DCE, you need the following software on your system:

1.4.3 Time Required for Installation

Depending on your configuration, the installation can take from 10 to 30 minutes.

1.4.4 Disk Space, Global Pages, and Global Sections Required

The disk space, global pages, and global sections requirements of Digital DCE are different for the Run Time Services Kit (RTK) and for the Application Developer's Kit (ADK). These requirements also differ on OpenVMS VAX and on OpenVMS Alpha systems. Table 1-1 lists the requirements before the installation for each kit on each platform. (Disk space requirements are listed in blocks.) Note that the CDS Server and Security Server images are part of the Run Time Services Kit and are enabled by PAKs.

Table 1-1 Disk Space, Global Pages, and Global Sections Requirements
Kit Disk Space Global Pages Global Sections
OpenVMS VAX RTK 22,000 3750 40
OpenVMS VAX RTK & ADK 36,000 3750 40
OpenVMS Alpha RTK 36,000 7350 35
OpenVMS Alpha RTK & ADK 48,000 7350 35

To determine how much free disk space is on your system disk, enter the following command:


The system responds with a short table; the column labeled Free Blocks shows the amount of storage space remaining on your system disk. If there is not enough disk space to install or run Digital DCE, work with your system manager to delete and purge files that are no longer needed.

To determine the number of free global pages and global sections on your system, enter the following commands:



If the values displayed by the system are greater than the minimum required, your system has adequate free global pages and global sections. If the values are less than the minimum required, use the AUTOGEN command procedure to increase the values, as follows:


For details on using AUTOGEN, see the OpenVMS System Manager's Manual.

1.4.5 Privileges and Quotas Required

To install Digital DCE for OpenVMS VAX and OpenVMS Alpha, log in to the system manager account. If you are not logged in to the system manager's account during installation, you must have at least the SETPRV privilege. To determine the privileges you have, enter the following command:


If you do not have sufficient privileges to install Digital DCE, see your system manager.

The DCE system management utility requires WORLD privileges for the SHOW command and WORLD, SYSPRV, and CMKRNL privileges for all other commands.

You should also check to make sure you have adequate quotas for the installation. You need the following quota values:

Use the OpenVMS Authorize Utility if you want to verify and change process quotas for the installation account in the user authorization file (UAF). For example, to change the BYTLM quota for your installation account, enter the following command sequence:

UAF> MODIFY account-name /BYTLM = 18000
UAF> SHOW account-name

After you change the quotas for your installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.

User account quotas are stored in the file SYSUAF.DAT. For more information on modifying account quotas, see the description of the Authorize Utility in the OpenVMS system management documentation.

1.4.6 Completing License Management Facility Requirements

If you are installing only the Run Time Services Kit of Digital DCE, you do not need a separate license. The right to use the Digital DCE Run Time Services Kit is granted with the OpenVMS operating system.

The installation procedure for DCE installs the following kits by default without checking for licences: DCE Runtime Services, CDS Server Kit, and the Security Server Kit. To install the Application Developer's Kit, you must override the installation defaults by answering NO to the following question:

Do you want the defaults for all options? [YES]

If you are installing the Application Developer's Kit and plan on using LSE templates, LSE and an appropriate license must be installed before you install DCE.

To register a license under OpenVMS, first log in to the system manager's account, SYSTEM. Then use either of two ways to perform the registration:

The license for the Application Developer's Kit is DCE-APP-DEV. The license for the Security Server Kit is DCE-SECURITY. The license for the CDS Server Kit is DCE-CDS.

Although it is necessary to have only one license active for this product, the License Management Facility (LMF) checks for the existence of any valid license. If LMF displays license failures for some of these other licenses, disregard the messages.

If you plan to use Digital DCE on more than one node in a VMScluster environment, you must register and load a license for each of the other nodes before you configure them.

For complete information about using LMF, see the OpenVMS License Management Utility Manual.

Next Contents Index