# DIGITAL TCP/IP Services for OpenVMS

# Installation and Configuration

# October 1997

This manual explains how to install and configure the DIGITAL TCP/IP for OpenVMS (UCX) layered application product.

Revision Information: This is a revised manual.

Operating Systems: OpenVMS Alpha Versions 6.2, 7.0, 7.1 OpenVMS VAX Versions 6.2, 7.0, 7.1

Software Version: DIGITAL TCP/IP Services for OpenVMS Version 4.2

Digital Equipment Corporation Maynard, Massachusetts

October 1997

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.

© Digital Equipment Corporation 1997. All rights reserved.

The following are trademarks of Digital Equipment Corporation: ACMS, DECdtm, DDCMP, DEC, DECnet, DECNIS, DECserver, DECsystem, DECwindows, DIGITAL, DNA, InfoServer, LAT, OpenVMS, PATHWORKS, POLYCENTER, ULTRIX, VAX, VAXstation, VMS, VMScluster, and the DIGITAL logo.

The following are third-party trademarks:

OSF/1 is a registered trademark of Open Software Foundation, Inc.

OSI is a registered trademark of CA Management, Inc.

Sun, NFS, and PC-NFS are registered trademarks of Sun Microsystems, Inc.

UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd.

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

ZK6524

This document is available on CD-ROM.

# Contents

# Preface

This manual explains how to install and configure the DIGITAL TCP/IP Services for OpenVMS (UCX) networking software on an OpenVMS system.

# Intended Audience

This manual is intended for OpenVMS system managers or network managers who install and configure networking software. The system managers using this book should have an understanding of TCP/IP networks and terminology.

# Document Structure

This manual contains three chapters and one appendix:

- Chapter 1 outlines the tasks involved in getting the UCX software running successfully on your system and explains how to prepare for installing and configuring Version 4.2 of UCX.
- Chapter 2 describes how to install Version 4.2 of the UCX software using the POLYCENTER Software Installation utility (OpenVMS Alpha) and the VMSINSTAL procedure (OpenVMS VAX).
- Chapter 3 provides guidelines on how to configure the UCX components and services after you have installed the software successfully.
- Appendix A lists the locations of files installed on your OpenVMS system during the UCX installation procedure.

# Terminology

This manual uses the following terminology:

- The abbreviation for the product's name is UCX.
- DIGITAL TCP/IP Services for OpenVMS is used to mean both:
  - DIGITAL TCP/IP Services for OpenVMS Alpha
  - DIGITAL TCP/IP Services for OpenVMS VAX
- Software components
  - The auxiliary server is the DIGITAL TCP/IP Services for OpenVMS implementation of the UNIX internet daemon (inetd).
  - NFS is the DIGITAL TCP/IP Services for OpenVMS implementation of the Network File System (NFS) protocols, including the NFS server, the NFS client, and PC-NFS.
  - TN3270 is the TELNET software that emulates IBM 3270 model terminals.
- UNIX operating system
  UNIX refers to UNIX Version 4.3 of the Berkeley Software Distribution (BSD). The DIGITAL UNIX operating systems are fully compatible with UNIX BSD Version 4.3.
- Networking terms
  - Host and node both mean a system connected to an internet.
  - The term Internet means the network, as defined by RFC 1208, consisting of large networks that use the TCP/IP protocol suite and provide universal connectivity, reaching the Defense Advanced Projects Research Agency (DARPA) Internet, MILNET, NSFnet, CERN, and many worldwide universities, government research labs, military installations, and business enterprises.
    The term internet means interconnected networks using the TCP/IP protocols, functioning as one, virtual network.

# Acronyms

For a complete list of acronyms used throughout this and other manuals in the DIGITAL TCP/IP Services for OpenVMS documentation set, see the DIGITAL TCP/IP Services for OpenVMS Concepts and Planning guide.

# Conventions

The following conventions apply to this book.

Convention | Meaning
--- | ---
UPPERCASE TEXT | Indicates names of OpenVMS and UCX commands, options, utilities, files, directories, hosts, and users.
lowercase special type | Indicates UNIX system output or user input, commands, options, files, directories, utilities, hosts, and users.
italic type | Indicates a variable.
`[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.
[ ] | In command format descriptions, indicates optional elements. You can enter as many as you want.
{ } | In command format descriptions, indicates you must enter at least one listed element.

All node names and addresses in this book are fictitious and are included as examples only.

# Related Documents

The following manuals provide additional information about planning your network and configuring and managing UCX:

- DIGITAL TCP/IP Services for OpenVMS Concepts and Planning
- DIGITAL TCP/IP Services for OpenVMS Management

For a complete list of all manuals in the DIGITAL TCP/IP Services for OpenVMS documentation set, see the DIGITAL TCP/IP Services for OpenVMS Concepts and Planning guide.

For additional information about DIGITAL TCP/IP Services for OpenVMS products and services, access the DIGITAL OpenVMS World Wide Web site. Use the following URL:

    http://www.openvms.digital.com

# Reader's Comments

DIGITAL welcomes your comments on this manual or any of the DIGITAL TCP/IP Services for OpenVMS documents. Send us your comments through any of the following channels:

Internet | openvmsdoc@zko.mts.dec.com
Fax | 603 884-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).

Location | Call | Fax | Write
--- | --- | --- | ---
U.S.A. | DECdirect 800-DIGITAL 800-344-4825 | Fax: 800-234-2298 | Digital Equipment Corporation Mailstop: TAY2-2/11D 153 Taylor Street Littleton, MA 01460
Puerto Rico | 787-781-0505 | Fax: 787-749-8300 | Local DIGITAL subsidiary
Canada | DTN: 621-6005 800-DIGITAL | Fax: 613-592-1946 | Digital Equipment of Canada, Ltd. Box 13000 Kanata, Ontario, Canada K2K2A6 Attn: CICC
International | --- | --- | Local DIGITAL subsidiary or approved distributor
Internal Orders | DTN: 261-2010 603-791-2010 | Fax: 800-741-6970 | U.S. Software Supply Business Digital Equipment Corporation 8 Cotton Road Nashua, NH 03063-1260

# Chapter 1
Preparing to Install and Configure UCX

This chapter explains how to prepare for installing and configuring DIGITAL TCP/IP Services for OpenVMS Version 4.2 software (hereafter called UCX).

# 1.1 Understanding the Major Tasks Involved

Once you familiarize yourself with the UCX product and decide the components and functionality you want to enable, installing and configuring the software is a simple process that generally takes less than one hour to complete.

Table 1-1 lists the major tasks involved in installing and configuring the UCX software.

Table 1-1 Major Tasks: Installing and Configuring UCX
Task | Action | Go to...
--- | --- | ---
1 | Prepare for installation and configuration. | Sections 1.2.1 --- 1.3
2 | Install UCX, then reboot the system. | Chapter 2
3 | Configure UCX according to your network needs. | Chapter 3
4 | Verify the configuration. | Chapter 3
5 | Complete additional configuration and setup tasks, as appropriate. | Chapter 3

The UCX installation and configuration take about 40 minutes to complete: 20 minutes for the installation and 20 minutes for the basic configuration procedure where you enable the UCX components you plan to use.

You should allow additional time for running tests to verify the configuration and for follow-on configuration and setup tasks. The time required to complete these tasks will vary.

If you are upgrading from a previous version, you need to run the SYS$UPDATE:UCX$CLEANUP_HELPLIB.COM procedure to delete obsolete commands from the top-level online help. Running this procedure generally takes an additional few minutes; the instructions are displayed in the installation script.

# 1.2 Preinstallation Tasks

The following sections summarize important tasks you need to complete before you install the UCX software on your system.

## 1.2.1 Inspecting the Distribution Kit

Make sure you have a complete software distribution kit. If you have the OpenVMS consolidated distribution CD-ROM distribution kit, check the CD master index for the kit location. If you have a magnetic tape or TK50 kit, supply the device name when requested by the software installation procedure.

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

## 1.2.2 Registering the UCX License Product Authorization Key

Before you install the UCX software on a newly licensed node or cluster, you must register a License Product Authorization Key (PAK) using the OpenVMS License Management Facility (LMF). Without a PAK, you can use only DECwindows TCP/IP Transport software.

If you are installing the UCX software as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.

If you ordered the license and the media together, the PAK is included with your distribution kit. Otherwise, the PAK is shipped separately to the location specified on the license order.

If you are installing prerequisite or optional software along with the UCX software, review the PAK status and install the PAKs for any prerequisite or optional software before you install UCX.

To register a license, log into the system manager's account, SYSTEM, and do one of the following:

- Run the SYS$UPDATE:VMSLICENSE.COM file and enter the data from your License PAK.
- At the DCL prompt, issue the LICENSE REGISTER command and the appropriate qualifiers.

You must register a license for each node in an OpenVMS Cluster.

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

## 1.2.3 Upgrading OpenVMS and Backing Up the System Disk

Before you install the UCX software, DIGITAL recommends that you upgrade the OpenVMS operating system, if applicable, then back up the system disk using the backup procedures established at your site.

For information about how to install OpenVMS, refer to the appropriate OpenVMS upgrade and installation manual.

For information about backing up a system disk, see the OpenVMS System Manager's Manual: Essentials.

## 1.2.4 Checking the Disk Space

Make sure the system meets the following disk space requirements (block cluster size = 1):

Requirement | Minimum Block Size
--- | ---
Disk space for installation | 40,000 blocks (Alpha) 19,000 (VAX)
Disk space for product use | 32,000 blocks (Alpha) 18,000 (VAX)

The actual disk space needed will vary depending on the system environment, configuration, and software options.

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

    $ SHOW DEVICE SYS$SYSDEVICE

## 1.2.5 Checking the Memory

Make sure the system meets the following memory requirements:

System | Minimum Memory
--- | ---
OpenVMS VAX | 24 MB
OpenVMS Alpha | 32 MB

To check the memory, enter the following command:

    $ SHOW MEMORY/FULL

## 1.2.6 Changing the System Parameters

Most systems have adequate system resources readily available to include the UCX software. However, you should check the system parameters outlined in the following sections and make any necessary changes to the MODPARAMS.DAT file, then use AUTOGEN to reboot your system.

### 1.2.6.1 Global Pagelets and Global Sections

The UCX software requires 65 global sections and 8100 global pagelets.

To check the number of available global pagelets and global sections, issue WRITE commands with the F$GETSYI lexical functions. For example:

    $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLPAGES")
    1234

    $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS")
    189

To increase the global pagelets and global sections, add statements to the MODPARAMS.DAT file that increase the values of the system parameters GBLPAGES and GBLSECTIONS.

### 1.2.6.2 Nonpaged Dynamic Pool

Add at least 350,000 bytes of nonpaged dynamic pool (the default maximum size for the UCX software), as follows:

1. Log into the SYSTEM account.
2. Identify the amount of additional nonpaged pool your system requires. Use the default initial value of 342,000 or use the following formula and table to calculate the amount of NPAGEDYN required:
   nonpaged pool = socket * 1280 + dbuf * 1792 + cbuf * 256 + mtusers *700 + mrusers * 700

   Variable | Definition
   --- | ---
   socket | Maximum number of sockets. (A socket system call creates an end point for communication.)
   dbuf | Maximum number of data buffers.
   cbuf | Maximum number of control buffers.
   mtusers | Maximum number of TELNET users.
   mrusers | Maximum number of remote login users.

3. Refer to the following example, then edit the MODPARAMS.DAT file to reflect the newly calculated value for the NPAGEDYN and NPAGEVIR parameters:

       ! Add nonpaged pool for UCX.
       !
       ADD_NPAGEDYN=342000
       ADD_NPAGEVIR=342000

For more information about nonpaged dynamic pool, see the OpenVMS System Manager's Manual: Essentials.

### 1.2.6.3 Interrupt Stack Pages (OpenVMS VAX Only)

If you are using PATHWORKS Internet Protocol (PWIP) on an OpenVMS VAX system, you should increase the number of interrupt stack pages (INTSTKPAGES) to 10 or more to help eliminate system startup and system crash warnings.

> Note

> For information about PATHWORKS, see the PATHWORKS documentation. For a list of PATHWORKS files that the UCX installation procedure copies, see Table A-2.

To increase the number of INTSTKPAGES, add statements to the MODPARAMS.DAT file that increase the value of the SYSGEN and INTSTKPAGES parameters.

## 1.2.7 Assigning User Identification Codes

An OpenVMS user or group of users are identified by a unique, assigned user identification code (UIC) in the format [group,member], where group and member are numeric or alphanumeric characters. For example, a UIC can be either [306,210], [GROUP1, JONES], or simply JONES. The UIC is linked to a system-defined rights database that determines user and group privileges.

The UCX configuration procedure uses the existing group UIC, if the UIC exists. If not, the octal number 375 (the default UIC group number for service accounts) is used. If this is an initial UCX configuration, but the procedure detects that 375 is in use, you will be prompted for a new UIC group number.

Before you assign a new group number, check that the number you chose is not already in use by issuing the following commands (making sure to type the brackets):

    $ RUN SYS$SYSTEM:AUTHORIZE

    UAF> SHOW /BRIEF [your_group_number,*]

    UAF> SHOW /IDENTIFIER /VALUE=UIC:[your_group_number,*]

To specify a new UIC group number instead of using the default, assign the value TRUE to the logical name UCX$ASK_GROUP_UIC. The configuration procedure then prompts you for a group UIC.

# 1.3 Configuration Planning Worksheet

Complete the worksheet in Table 1-2 so that you are prepared to enter specific information during the configuration procedure.

For additional planning information, see the DIGITAL TCP/IP Services for OpenVMS Concepts and Planning guide.

Table 1-2 Configuration Planning Worksheet
Question | Answer
--- | ---
What is the system's host name (for example, MYNODE)? |
What is the system's Internet domain name (for example, widgets.com)? |
What are the system's addresses? IP address (for example, 19.112.139.14) Subnet (network mask) address (for example, 255.255.255.0) Broadcast address (for example, 19.112.139.255) Default gateway address (for example, 19.112.139.18) |
What is the system's Ethernet device (for example, ESA0)? |
What is the system's group user identification code (UIC); for example, [GROUP1,JONES]? |
What is your geographical area and time zone (for example, U.S.A./Eastern)? |
Which type of routing is appropriate for the network? Static --- for simple networks where routes do not change Dynamic --- for complex networks where flexibility is required |
What is the name of the system's remote BIND server (for example, MAINSV)? |

# Chapter 2
Installing UCX

This chapter explains how to install the UCX software using the POLYCENTER Software Installation utility (OpenVMS Alpha) or the VMSINSTAL procedure (OpenVMS VAX).

# 2.1 Installing UCX on an OpenVMS Alpha System

This section takes you through a UCX installation on an OpenVMS Alpha system using the POLYCENTER Software Installation utility. The instructions are appropriate for an initial product installation or a version upgrade.

For complete information about the POLYCENTER Software Installation utility, refer to the OpenVMS System Manager's Manual: Essentials.

## 2.1.1 UCX Installation Procedure (OpenVMS Alpha)

Install the UCX software on an OpenVMS Alpha system as follows. Note that the last step requires you to reboot the system to complete the installation.

1. Complete the recommended preinstallation tasks outlined in Chapter 1.
2. Log into the SYSTEM account.
3. If another version of the UCX software exists on your system, shut down that version by issuing the following command:

       $ @SYS$MANAGER:UCX$SHUTDOWN

4. Check to ensure that no one is logged onto the system.
5. Copy the UCX distribution kit into the SYS$SPECIFIC:[UCX42] directory.
6. Create a log file to record the installation or upgrade procedure, if you want a copy for your records.
7. To start the POLYCENTER Software Installation utility, enter the PRODUCT INSTALL command with the directory path appropriate for your system. For example:

       $ PRODUCT INSTALL UCX /SOURCE=SYS$SPECIFIC:[UCX42]

   where SYS$SPECIFIC:[UCX42] is the directory path for the UCX kit.
   If you do not specify the source qualifier, the POLYCENTER utility searches the location defined by the logical name PCSI$SOURCE. If you do not specify either the source qualifier or PCSI$SOURCE, the POLYCENTER utility searches the current default directory for the UCX kit.
8. The interactive installation procedure begins, and you are prompted for information.
   A sample installation script is shown in Example 2-1. Numbered callouts identify those areas that require your response. The callouts are explained at the end of the script.

   > Note

   > To stop the installation at any time, press Ctrl/Y. The installation procedure will delete any files that were created, then exit.

   For the complete list of the UCX files that are installed on your system, see Appendix A.

   Example 2-1 UCX Installation: POLYCENTER Software Installation Utility Procedure

       The following product has been selected:
           DEC AXPVMS UCX V4.2                    Layered Product [Installed]

       (1)Do you want to continue? [YES] [Return]

       Configuration phase starting ...

       You will be asked to choose options, if any, for each selected product and for
       any products that may be installed to satisfy software dependency requirements.

       DEC AXPVMS UCX V4.2: DIGITAL TCP/IP Services for OpenVMS. [Installed]

           (c) Digital Equipment Corporation 1997. All Rights Reserved.

           Digital Equipment Corporation

           DIGITAL TCP/IP Services for OpenVMS offers several license options.

       (2)Do you want the defaults for all options? [YES] [Return]

       (3)Do you want to review the options? [NO] YES [Return]

       DEC AXPVMS UCX V4.2: DIGITAL TCP/IP Services for OpenVMS. [Installed]
           DEC AXPVMS VMS V7.1 [Installed]
           Applications: YES

       (4)Are you satisfied with these options? [YES] [Return]

       Execution phase starting ...

       The following product will be installed:
           DEC AXPVMS UCX V4.2                     Layered Product

       Portion done: 0%
       ...10%
       ...20%
       ...30%
       ...40%
       ...50%
       ...60%
       ...70%
       ...80%
       ...90%
       %PCSI-I-PRCOUTPUT, output from subprocess follows ...
       % UCX-W-PCSI_INSTALL
       % - BG device exists.
       %   To use the version of DIGITAL TCP/IP Services that was just installed,
       %   system must be rebooted.
       %

       Portion done: 100%

       The following product has been installed:
           DEC AXPVMS UCX V4.2                      Layered Product

   - (1)Press Return to continue with the installation procedure.
   - (2)Answer YES to choose the POLYCENTER Software Installation utility defaults for the options or NO to choose other options.
   - (3)Answer YES to review the POLYCENTER Software Installation utility options.
   - (4)Press Return to accept the options as listed or answer NO to change the options.
9. Read the release notes online or print them after the installation completes from SYS$HELP:UCX042.RELEASE_NOTES.
10. If you had a previous version of UCX on your system:
    - Manually purge the files from the previous version, which are located in the following directories:
      - SYS$HELP
      - SYS$LIBRARY
      - SYS$MANAGER
      - SYS$COMMON:[SYSTEST.UCX]
      - SYS$COMMON:[SYSHLP.EXAMPLES.UCX]
      - SYS$SPECIFIC:[SYSEXE]
      - SYS$COMMON:[SYSEXE]
      - SYS$TEST
    - Issue the following command to delete obsolete information in the system Help file:

          $ @SYS$UPDATE:UCX$CLEANUP_HELPLIB

      The SYS$UPDATE:UCX$CLEANUP_HELPLIB procedure takes a few minutes to complete.
11. Reboot your system, then proceed to Chapter 3 for configuration information.

    # 2.2 Installing UCX on an OpenVMS VAX System

    This section takes you through a UCX installation on an OpenVMS VAX system using the VMSINSTAL procedure. The instructions are appropriate for an initial product installation or a version upgrade.

    Next | Contents