|Document revision date: 5 July 2000|
Order Number: AA--PV4CE--TE
This guide describes the installation procedure and the system configuration utility for the Compaq Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha.
Revision/Update Information: This guide supersedes the Compaq DCE for OpenVMS VAX and OpenVMS Alpha Installation and Configuration Guide Version 1.5.
OpenVMS VAX Version 6.2 or higher
OpenVMS Alpha Version 6.2 or higher
Software Version: Compaq DCE for OpenVMS Version 3.0
Compaq Computer Corporation
© 2000 Compaq Computer Corporation
Compaq, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark office.
OpenVMS is a trademark of Compaq Information Technologies Group, L.P.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation.
OSF/1 and UNIX are trademarks of The Open Group.
All other product names mentioned herein may be the trademarks or registered 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 publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY.
The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty.
The OpenVMS documentation set is available on CD-ROM.
This document was prepared using VAX DOCUMENT, Version V3.3-1b.
This guide describes the installation procedure and the system configuration utility for the Compaq Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha Version 3.0, which consists of the following services:
Four kits are installed:
Runtime Services Kit
Application Developer's Kit
CDS Server Kit
Security Server Kit
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 Compaq DCE.
This guide is intended for managers of distributed computing environments on one or more systems and installers of the Compaq DCE for OpenVMS VAX or OpenVMS Alpha Kit Version 3.0.
This guide is organized as follows:
For additional information about OpenVMS products and services, access the following World Wide Web address:
Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:
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-282-6672.
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 text indicates code examples and interactive screen displays.
In the C programming language, monospace 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 Compaq Distributed Computing Environment (DCE) for OpenVMS VAX and OpenVMS Alpha software.
Compaq 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 Compaq DCE. It presents a brief overview of some concepts that you need to understand before you install and configure Compaq 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 Compaq
DCE software, you must both install the software and configure DCE on
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, by
default, 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 Chapter 4 for cell configuration guidelines.
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 Compaq DCE. Some of this information may not be included in either this guide or the release notes.
Compaq 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 TCP/IP parameters before you begin
The Compaq 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 Compaq 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.
220.127.116.11 On OpenVMS Alpha and VAX Systems
Before installing Compaq 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 Compaq DCE are different for the DCE Runtime 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 DCE CDS Server and Security Server images are part of the DCE Kit and are enabled by license PAKs.
|Kit||Disk Space||Global Pages||Global Sections|
|OpenVMS VAX RTK||120,000||3750||40|
|OpenVMS VAX RTK & ADK||150,000||3750||40|
|OpenVMS Alpha RTK||48,000||7350||35|
|OpenVMS Alpha RTK & ADK||58,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 to run Compaq 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 Compaq 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 Compaq 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 Runtime Services Kit of Compaq DCE, you do not need a separate license. The right to use the Compaq DCE Runtime 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 Compaq 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.
|privacy and legal statement|