DECnet-Plus for OpenVMS

Updated: 24 May 2001

Installation and Basic Configuration

Order Number: AA--QPSUB--TE

November 1996

This book explains how to install and configure the DECnet-Plus for OpenVMS software and how to perform the postinstallation steps.

Revision/Update Information: This is a revised manual.

Operating Systems: OpenVMS Alpha Version 7.1
OpenVMS VAX Version 7.1

Software Versions: DECnet-Plus for OpenVMS Version 7.1
X.25 for OpenVMS Alpha Version 7.1

Digital Equipment Corporation Maynard, Massachusetts

November 1996

Digital Equipment 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 DIGITAL or an authorized sublicensor.

DIGITAL 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 Digital Equipment Corporation: Bookreader, DDCMP, DEC, DECdirect, DECnet, DECNIS, DECserver, DECsystem, DECwindows, DIGITAL, DNA, InfoServer, OpenVMS, PATHWORKS, ULTRIX, VAX, VAX DOCUMENT, VAXcluster, VAXstation, VMS, VMScluster, and the DIGITAL logo.

The following are third party trademarks:

Macintosh is a registered trademark of Apple Computer, Inc.
MS-DOS is a registered trademark of Microsoft Corporation.
Multinet is a registered trademark of TGV, Inc.
OS/2 is a registered trademark of International Business Machines Corporation.
OSF/1 is a registered trademark of Open Software Foundation, Inc.
PATHways is a registered trademark of The Wollongong Group.
SCO is a trademark of Santa Cruz Operations, Inc.
TCPware is a registered trademark of Process Software Corporation.
UNIX is a registered trademark in the United States and other countries, licensed exclusively by X/Open Co. Ltd.

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

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

Contents Index

Preface

This is the first installation book you should read in order to successfully install DECnet-Plus for OpenVMS. It also includes how to configure DECnet-Plus for OpenVMS using the FAST and BASIC configuration options, and information about name services.

The second installation book (DECnet-Plus for OpenVMS Applications Installation and Advanced Configuration) describes using the ADVANCED configuration option, and how to install and configure:

X.25 for OpenVMS Alpha
VAX P.S.I. and VAX P.S.I. Access for OpenVMS VAX
OSI layered software applications:
- File Transfer, Access, and Management (FTAM)
- Virtual Terminal (VT)
- OSI Applications Kernel (OSAK)

Note

DECnet-Plus for OpenVMS must be installed on your system before you can install X.25, FTAM, VT, or OSAK software.

Intended Audience

This book is written for:

OpenVMS system managers
DECnet-Plus software installers
Network planners and managers

Structure of This Book

This book has three parts:

Part I Describes the pre-installation and installation steps necessary to install DECnet-Plus for OpenVMS.

Part II Provides help to determine which configuration option to use: FAST, BASIC or ADVANCED. Describes how to run a FAST configuration, and a BASIC configuration including examples for an Alpha and a VAX system. Also includes an overview of the naming services you can select during configuration.

Part III Includes a basic overview on the POLYCENTER Software Installation utility, an example of installing DECnet-Plus for OpenVMS from an InfoServer, and a list of system files loaded during installation.

Terminology

The following terms are used interchangeably in this book:

Alpha and AXP
Transition and migration
Phase IV and DECnet Phase IV
End system and end node
Intermediate system and router
DECnet-Plus and Phase V

Reader's Comments

DIGITAL welcomes your comments on this manual or any of the DECnet-Plus documents. Send us your comments through any of the following channels:

Internet openvmsdoc@zko.mts.dec.com

Fax 603 881-0120, Attention: OSSG Documentation, ZKO3-4/U08

Mail OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following table to order additional documentation or information. If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).

Conventions

The following conventions are used in this book.

Convention Meaning

special type Indicates a literal example of system output or user input. In text, indicates command names, keywords, node names, file names, directories, utilities and tools.

UPPERCASE Indicates keywords that you enter. You can type the characters in uppercase or lowercase. You can abbreviate command keywords to the smallest number of characters that OpenVMS, NCP, NCL, or the other tools accept.
Uppercase also indicates the names of files, directories, utilities, tools, commands, parameters, and procedures.

italic type Indicates a variable.

bold Indicates a new term defined in the text or important information.

[Return] Indicates that you press the Return key.

Ctrl/ x Indicates that you press the Control key while you press the key noted by x.

[YES] Brackets indicate that the enclosed item is a default value in an installation prompt.

{ } In command format descriptions, indicates you must enter at least one listed element.

Part 1
DECnet-Plus for OpenVMS Installation

Part I describes the prerequisite steps necessary to install DECnet-Plus for OpenVMS, and how to install it.

Chapter 1 --- Preparing to Install DECnet-Plus for OpenVMS
Chapter 2 --- Pre-Installation Tasks
Chapter 3 --- Installing DECnet-Plus for OpenVMS

Chapter 1
Preparing to Install DECnet-Plus for OpenVMS

This chapter describes the tasks you must perform before installing and configuring the DECnet-Plus for OpenVMS distribution kit.

1.1 The POLYCENTER Software Installation Utility

The POLYCENTER Software Installation utility replaces VMSINSTAL as the method of installing layered products for OpenVMS systems. It allows you to install several software products with a single command.

Full details for using the POLYCENTER Software Installation utility to install and manage software products on your system are provided in the OpenVMS System Management Utilities Reference Manual. This manual also provides information on removing products along with other POLYCENTER Software Installation utility features.

See Appendix A for a basic overview of the POLYCENTER Software Installation utility.

1.2 Inspecting the Distribution Kit

Before you install the DECnet-Plus for OpenVMS software, make sure you have a complete software distribution kit. If you have the OpenVMS condist CD-ROM distribution kit, check the CD master index for the kit location. If you have a magtape or TK50 kit, supply the device name when requested by the POLYCENTER Software Installation utility.

Check that the kit contains everything listed on the bill of materials (BOM). If anything is missing or damaged, contact your DIGITAL representative.

The distribution kit contains the following component kit files:

Base components software
- DECnet-Plus for OpenVMS base kit
Optional software
- OSI remote file operations support kit (FTAM software)
- OSI applications support kit (OSAK software)
- Virtual Terminal (VT) software kit

For a more detailed list, see Chapter 3.

Note

Before installing any of the software, read the DECnet-Plus Planning Guide (included with your DECnet-Plus for OpenVMS core documentation set). This guide contains installation planning information, including namespace planning instructions.

1.3 Time Required for Installation and Configuration

The time required to complete the DECnet-Plus installation and configuration procedures depends on the following:

Configuration option used (FAST, BASIC, or ADVANCED)
Optional software installed
CPU on the system
Type of distribution media

The time required to install and configure DECnet-Plus can vary from 30 minutes to 2 hours, depending on the combination of choices you make from the above list.

1.4 Prerequisite Software and Licenses

Before you can install and configure the software, the system must have the required operating system software and license(s).

1.4.1 Software and Licenses

The prerequisites for installing DECnet-Plus for OpenVMS software are as follows:

OpenVMS operating system Version 7.0 or 7.1
One of the available DECnet-Plus licenses

The specific license required on your system is determined by the functions you want to use:

Basic function license (DVNETEND) --- provides end system support.
Extended function license (DVNETEXT) for Alpha systems --- provides end system support, DECdts server, cluster alias, and OSI applications gateways.
Extended function license (DVNETRTG) for VAX systems --- provides end system support, DECdns server, DECdts server, cluster alias, and OSI applications gateways.
For the extended function licenses, the TELNET/VT gateway also requires the DIGITAL TCP/IP Services for OpenVMS product.
X.25 license (Alpha systems only) --- provides functionality over a wide area network link.

At least one node of an OpenVMS Cluster system requires the extended function license to use cluster alias.

1.4.1.1 DECnet and OSI Applications over TCP/IP

If you plan to use the DECnet-Plus over TCP/IP feature, then TCP/IP software is a prerequisite. Your end system will be able to operate over TCP/IP if and only if the TCP/IP product used on your system supports the PATHWORKS Internet Protocol (PWIP) interface.

The PWIP interface is currently supported by the products listed below. Contact the vendor for the required versions of their product.

DIGITAL TCP/IP Services for OpenVMS
TCPware
Process Software Corporation
959 Concord Street
Framingham, MA 01701
800-722-7770
info@process.com
MultiNet for OpenVMS
Cisco Systems, Inc. (formerly TGV, Inc.)
101 Cooper Street
Santa Cruz, CA 95060
408-457-5200
sales@tgv.cisco.com
PATHway for OpenVMS
The Attachmate Corp. (formerly The Wollongong Group, Inc.)
1129 San Antonio Road
Palo Alto, California 94303
800-872-8649 (800-962-8649 in CA)
sales@twg.com

Note

For more information on using DECnet over TCP/IP or the OSI applications over TCP/IP, refer to the DECnet-Plus for OpenVMS Network Management guide.

1.4.2 Checking Licenses

To determine the OpenVMS operating system version number, enter the following DCL command:

$ show system [Return]

To determine whether a DECnet-Plus license is registered, enter the following DCL command:

$ show license dvnet* [Return]

If the system does not have the required license(s), obtain the Product Authorization Key (PAK) and register the license. For instructions on registering a license, refer to the OpenVMS License Management Utility Manual.

1.5 System Requirements

Before you install the DECnet-Plus for OpenVMS software, make sure that your system meets the following requirements.

1.5.1 Disk Space

If this is the first time you are installing DECnet-Plus on a particular system, ensure that you have enough free space on the system disk. You need enough space to install the DECnet-Plus Base components and any options you select.

If you already have DECnet-Plus installed, you need considerably less free space for the installation because the earlier installation allocated most of the space that a subsequent installation needs.

Required Disk Space --- Base Components

The total amount of disk space required to install the software for base components is 77,000 blocks for VAX systems and 85,000 blocks for Alpha systems.

Disk Space --- Optional Software

Table 1-1 shows the amount of disk space needed to install the optional software. Make sure you have enough free space to install the required software and the optional software.

Table 1-1 Disk Space Requirements --- Optional Software
Component Blocks for Alpha Blocks for VAX

DECdts server 1400 1800

DECdns server N/A 3000 ¹

VAX P.S.I. N/A 7000

VAX WANDD N/A 5500

X.25 12144 N/A

FTAM 28000 12000

Virtual Terminal 4000 2000

OSAK 6900 6000

¹Approximate amount --- actual amount depends on the size of the namespace, the number of logs created, and so forth. The amount of required disk space could double when running tests, then return to original amount when duplicate files are deleted.

To find out how many free blocks exist on the system disk, enter the following command:

$ show device sys$sysdevice [Return]

If the number of required blocks exceeds the number of free blocks, you must clear space on the system disk.

1.5.2 Required Memory

The minimum amount of memory required is 24 MB for VAX systems and 64 MB for Alpha systems.

To check memory on your system, enter the following command:

$ show memory/full [Return]

1.5.3 Required System Parameters

This section provides information about the system parameters, their values, and how to modify them.

Table 1-2 lists the minimum system parameters required for the base software.

Table 1-2 Minimum System Parameters Required --- Base Software Installation
Parameter Minimum Value for Alpha Minimum Value
for VAX

MIN_GBLSECTIONS 512 400

MIN_GBLPAGES 100000 60000

MIN_GBLPAGFIL 1024 4096

MIN_CLISYMTBL 750 500

MIN_KSTACKPAGES 2 N/A

MIN_VIRTUALPAGES N/A 35000

To check these parameters, invoke the SYSGEN utility and enter the following command:

$ mcr sysgen SYSGEN> show gblsections

If any of the system parameters need to be modified, follow these steps:

Edit the modparams.dat file by entering:
$ edit sys$system:modparams.dat

Enter the values into the file in the following format:

SCSSYSTEMID=65187 SCSNODE="SUPER1" MIN_GBLSECTIONS=512 . . . MIN_GBLPAGFIL=1024

Exit from the editor.
Run AUTOGEN by entering the following command:
$ @sys$update:autogen getdata reboot

Note

Run AUTOGEN to ensure that your system is tuned with the appropriate parameters.

1.5.3.1 SYSGEN Parameters for OpenVMS Cluster Members

When installing DECnet-Plus for OpenVMS on an OpenVMS Cluster, make sure that all cluster members have the suggested SYSGEN parameters set correctly. If a node in the cluster does not have the required minimum parameters, startup of the network will fail. If the network fails to start for this reason, the logical NET$STARTUP_STATUS is set to OFF-AUTOGENREQ. Set the parameters to the recommended values before you run net$configure.

Contents

Index