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
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.
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.
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.
This guide is organized as follows:
For additional information on the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:
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|
Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698
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 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.|
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.
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
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.
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.
184.108.40.206 On OpenVMS Alpha and VAX Systems
Before installing Digital DCE, you need the following software on your system:
Depending on your configuration, the installation can take from 10 to
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.
|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:
$ SHOW DEVICE SYS$SYSDEVICE
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:
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")
$ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
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:
$ EDIT SYS$SYSTEM:MODPARAMS.DAT
For details on using AUTOGEN, see the OpenVMS System Manager's
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:
$ SHOW PROCESS/PRIVILEGES
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:
$ RUN SYS$SYSTEM:AUTHORIZE UAF> MODIFY account-name /BYTLM = 18000 UAF> SHOW account-name UAF> EXIT $ LOGOUT
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.