DIGITAL TCP/IP Services for OpenVMS

DIGITAL TCP/IP Services for OpenVMS

Installation and Configuration

Order Number: AA--LU49L--TE


January 1999

This manual explains how to install and configure the DIGITAL TCP/IP for OpenVMS layered application product on your OpenVMS host.

Revision Information: This is a revised manual.

Operating Systems: OpenVMS Alpha Versions 7.1, 7.2 OpenVMS VAX Versions 7.1, 7.2

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




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: ACMS, Alpha, Compaq, DEC, DECdtm, DECnet, DECNIS, DECserver, DECsystem, DIGITAL, DIGITAL UNIX, DNA, InfoServer, LAT, OpenVMS, PATHWORKS, POLYCENTER, ULTRIX, VAX, VAXstation, VMS, and the Compaq logo.

The following are third-party trademarks:

NFS, PC-NFS, and Sun 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.

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

Contents Index


Preface

The DIGITAL TCP/IP Services for OpenVMS product is Compaq's implementation of the TCP/IP networking protocol suite and internet services for OpenVMS Alpha and OpenVMS VAX systems.

A layered software product, DIGITAL TCP/IP Services for OpenVMS provides a comprehensive suite of functions and applications that support industry-standard protocols for heterogeneous network communications and resource sharing.

This manual explains how to install and configure the DIGITAL TCP/IP Services for OpenVMS (TCP/IP Services) 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 manual should have an understanding of TCP/IP networks and terminology.

New and Changed Features

DIGITAL TCP/IP Services for OpenVMS Version 5.0 provides a new kernel based on the IPv4 kernel ported from DIGITAL UNIX Version 4.0D.1

Other new features include:

For information about the changes to information in this document, see the DIGITAL TCP/IP Services for OpenVMS Release Notes.

This manual was revised to reflect the installation and configuration procedures for Version 5.0 of the DIGITAL TCP/IP Services for OpenVMS product.

Note

1 This kernel is based on the Berkeley Software Distribution (BSD) Versions 4.3 and 4.4 with enhancements from Compaq Computer Corporation.

Document Structure

This manual contains three chapters:

Related Documentation

Table 1 lists the manuals available with this version of DIGITAL TCP/IP Services for OpenVMS.

Table 1 DIGITAL TCP/IP Services for OpenVMS Documentation
Manual Contents
DIGITAL TCP/IP Services for OpenVMS Release Notes This text file describes new features and changes to the software including installation, upgrade, configuration, and compatibility information. These notes also describe new and existing software problems and restrictions, and software and documentation corrections.

Print this text file at the beginning of the installation procedure and read it before you install DIGITAL TCP/IP Services for OpenVMS.

DIGITAL TCP/IP Services for OpenVMS Installation and Configuration This manual explains how to install and configure the DIGITAL TCP/IP Services for OpenVMS layered application product.
DIGITAL TCP/IP Services for OpenVMS User's Guide This manual describes how to use the applications available with DIGITAL TCP/IP Services for OpenVMS such as remote file operations, e-mail, TELNET, TN3270, and network printing. This manual also explains how to use these services to communicate with systems on private internets or on the worldwide Internet.
DIGITAL TCP/IP Services for OpenVMS Management This manual describes how to configure and manage the DIGITAL TCP/IP Services for OpenVMS product.

Use this manual with the DIGITAL TCP/IP Services for OpenVMS Management Command Reference manual.

DIGITAL TCP/IP Services for OpenVMS Management Command Reference This manual describes the DIGITAL TCP/IP Services for OpenVMS management commands.

Use this manual with the DIGITAL TCP/IP Services for OpenVMS Management manual.

DIGITAL TCP/IP Services for OpenVMS ONC RPC Programming This manual presents an overview of high-level programming using open network computing remote procedure calls (ONC RPC). This manual also describes the RPC programming interface and how to use the RPCGEN protocol compiler to create applications.
DIGITAL TCP/IP Services for OpenVMS System Services and C Socket Programming This manual describes how to use the OpenVMS system services and C Socket programming interfaces to develop network-based applications.
DIGITAL TCP/IP Services for OpenVMS eSNMP Programming and Reference This manual describes the Extensible Simple Network Management Protocol (eSNMP), the eSNMP application programming interface (API), and how to build additional subagents to manage vendor-specific equipment.

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


http://www.openvms.digital.com 

You might find the Internetworking with TCP/IP: Principles, Protocols, and Architecture by Douglas Comer useful if you are looking for a comprehensive overview of the TCP/IP protocol suite.

Terminology

DIGITAL TCP/IP Services for OpenVMS Version 5.0 completes the change initiated several releases ago when the product name changed from "ULTRIX Connection (UCX)" to "DIGITAL TCP/IP Services for OpenVMS." To complete this change, the identifier "UCX" is replaced with "TCPIP" in the following cases:

DIGITAL TCP/IP Services for OpenVMS is used to mean both:

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 NFS protocols, including the NFS server, the NFS client, and PC-NFS.

TN3270 means the TELNET client software that emulates IBM 3270 model terminals.

The term UNIX refers to the DIGITAL UNIX operating system. DIGITAL UNIX is fully compatible with Version 4.3 and Version 4.4 of the Berkeley Software Distribution (BSD).

Host and node both mean a system connected to an internet.

The term Internet refers to the global interconnection of networks, as defined by RFC 1208, which consists of large networks using TCP/IP to provide universal connectivity, reaching the Defense Advanced Projects Research Internet, MILNET, NSFnet, CERN, and many worldwide universities, government research labs, military installations, and business enterprises.

The term internet refers to private interconnected networks that use TCP/IP to connect together and function as one, virtual network.

Conventions

All IP addresses in this manual represent fictitious addresses. The following conventions apply to this manual.
Convention Meaning
UPPERCASE TEXT Indicates names of OpenVMS and DIGITAL TCP/IP Services for OpenVMS 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.
bold text Indicates a new term.
italic text 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 the enclosed element is optional. You can enter as many as you want.
{ } In command format descriptions, indicates you must enter at least one listed element. For readability, each element is either listed on a separate line or separated by vertical bars (|). Unless otherwise instructed, use a space to separate these elements when using them with commands.
... Horizontal ellipsis points in examples indicate additional optional arguments have been omitted.
.
.
.
Vertical ellipsis points indicate omission of items from a code example or display example; the items are omitted because they are not important to the topic being discussed.

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:
Internet openvmsdoc@zko.mts.dec.com
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

Visit the OpenVMS Documentation World Wide Web site at the following URL to learn how to order additional documentation:


http://www.openvms.digital.com:81/ 

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


Chapter 1
Preparing to Install and Configure TCP/IP Services

This chapter explains how to prepare for installing and configuring DIGITAL TCP/IP Services for OpenVMS software.

1.1 Understanding the Major Tasks Involved

Installing the TCP/IP Services software takes just a few minutes to complete. You can install the software during the OpenVMS operating system installation procedure or as a layered product.

After you install TCP/IP Services, you need to enable the components and verify the configuration through the menu-driven TCPIP$CONFIG configuration procedure. This step generally takes about 15 minutes to complete.

Table 1-1 lists the major tasks involved in installing and configuring TCP/IP Services.

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

1.2 Preinstallation Tasks

You should complete the following tasks before you install TCP/IP Services 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 for the media when you issue the command to install TCP/IP Services.

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

1.2.2 Extracting the Release Notes

The DIGITAL TCP/IP Services for OpenVMS Release Notes document contains important information you should know before you install the product.

To extract the release notes to a text file, enter the following POLYCENTER Software Installation utility command:


$ PRODUCT EXTRACT RELEASE_NOTES TCPIP/FILE=file_name.txt

where file_name.txt is the file name you specify. If you do not specify a file name, the release notes are written to a file called DEFAULT.PCSI$RELEASE_NOTES in the current directory.

1.2.3 Backing Up the System Disk and Upgrading OpenVMS

Before you install TCP/IP Services, Compaq recommends that you back up the system disk using the backup procedures established at your site. After the backup operation is complete, you should upgrade the OpenVMS operating system, if applicable.

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

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

1.2.4 Registering the License Product Authorization Key

Before you install TCP/IP Services 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 upgrading TCP/IP Services 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 also installing prerequisite or optional software, review the PAK status and install the PAKs for any prerequisite or optional software before you install TCP/IP Services.

To register a license, log in to the SYSTEM account and do one of the following:

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.5 Checking the Disk Space

Make sure the system meets the following disk space requirements:
System Minimum Block Size
OpenVMS Alpha 55,000
OpenVMS VAX 40,000

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

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


$ SHOW DEVICE SYS$SYSDEVICE 

1.2.6 Checking the Physical Memory

Make sure the system meets the following physical memory requirements:
System Minimum Memory
OpenVMS Alpha 32 MB
OpenVMS VAX 24 MB

To check the memory, enter:


$ SHOW MEMORY/FULL 

1.2.7 Checking the System Parameters

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

1.2.7.1 Global Pagelets and Global Sections

The TCP/IP Services software requires 65 global sections and 8100 global pagelets.

To check the number of available global pagelets and global sections, enter 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.7.2 Nonpaged Dynamic Pool

Add at least 500,000 bytes of nonpaged dynamic pool for the software, as follows:

  1. Log in to the SYSTEM account.
  2. Identify the amount of additional nonpaged pool your system requires. Use the estimated value of 500,000 bytes, and then increase the value depending on the maximum amount of sockets you have. For each socket, allow a value of 2,000 bytes.
  3. Refer to the following example, and then edit MODPARAMS.DAT to reflect the appropriate value for the NPAGEDYN and NPAGEVIR parameters:


    ! Add nonpaged pool for DIGITAL TCP/IP Services for OpenVMS. 
    ! 
    ADD_NPAGEDYN=500000 
    ADD_NPAGEVIR=500000 
    

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


Next Contents Index