[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Compaq TCP/IP Services for OpenVMS

Installation and Configuration

Order Number: AA--LU49N--TE

April 2002

This manual explains how to install and configure the Compaq TCP/IP Services for OpenVMS product on your OpenVMS host.

Revision Information: This guide supersedes the Compaq TCP/IP Services for OpenVMS Installation and Configuration manual, Version 5.1

Software Version: Compaq TCP/IP Services for OpenVMS Version 5.3

Operating Systems: OpenVMS Alpha Versions 7.2-2, 7.3 OpenVMS VAX Versions 7.2, 7.3

Compaq Computer Corporation
Houston, Texas

Compaq, the Compaq logo, Alpha, OpenVMS, Tru64, VAX, VMS, and the Digital logo are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries.

All other product names mentioned herein may be 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 document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6524

This document is available on CD-ROM.

This document was prepared using DECdocument, Version V3.3-1e.

Contents

Index

Preface

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

TCP/IP Services 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 Compaq TCP/IP Services for OpenVMS (TCP/IP Services) networking software on an OpenVMS system. This manual reflects the installation and configuration procedures for Version 5.3 of the TCP/IP Services product. For information about last-minute changes to these procedures, see the Compaq TCP/IP Services for OpenVMS Release Notes.

Intended Audience

This manual is for experienced OpenVMS and UNIX system managers and assumes a working knowledge of OpenVMS system management, TCP/IP networking, and TCP/IP terminology.

Document Structure

This manual contains three chapters and one appendix:

Chapter 1 explains how to prepare for installing and configuring TCP/IP Services.
Chapter 2 describes how to install TCP/IP Services on an OpenVMS system using the POLYCENTER Software Installation utility.
Chapter 3 provides guidelines on how to configure the TCP/IP Services components and services after installation.
Appendix A provides a sample installation and configuration script as might appear on an OpenVMS system upon which TCP/IP Services has not been installed previously. The script examples in Chapter 3 show what might be seen when you upgrade TCP/IP Services software.

Related Documents

Table 1 lists the documents available with this version of TCP/IP Services.

**Table 1 TCP/IP Services Documentation**
Manual	Contents
Compaq TCP/IP Services for OpenVMS Concepts and Planning	This manual provides conceptual information about TCP/IP networking on OpenVMS systems, including general planning issues to consider before configuring your system to use the TCP/IP Services software. This manual also describes the manuals in the TCP/IP Services documentation set and provides a glossary of terms and acronyms for the TCP/IP Services software product.
Compaq TCP/IP Services for OpenVMS Release Notes	The release notes provide version-specific information that supersedes the information in the documentation set. The features, restrictions, and corrections in this version of the software are described in the release notes. Always read the release notes before installing the software.
Compaq TCP/IP Services for OpenVMS Installation and Configuration	This manual explains how to install and configure the TCP/IP Services product.
Compaq TCP/IP Services for OpenVMS User's Guide	This manual describes how to use the applications available with TCP/IP Services such as remote file operations, email, TELNET, TN3270, and network printing. This manual explains how to use these services to communicate with systems on private internets or on the worldwide Internet.
Compaq TCP/IP Services for OpenVMS Management	This manual describes how to configure and manage the TCP/IP Services product. Use this manual with the Compaq TCP/IP Services for OpenVMS Management Command Reference manual.
Compaq TCP/IP Services for OpenVMS Management Command Reference	This manual describes the TCP/IP Services management commands. Use this manual with the Compaq TCP/IP Services for OpenVMS Management manual.
Compaq TCP/IP Services for OpenVMS Management Command Quick Reference Card	This reference card lists the TCP/IP management commands by component and describes the purpose of each command.
Compaq TCP/IP Services for OpenVMS UNIX Command Reference Card	This reference card contains information about commonly performed network management tasks and their corresponding TCP/IP management and Compaq Tru64 UNIX command formats.
Compaq 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 RPCs). This manual also describes the RPC programming interface and how to use the RPCGEN protocol compiler to create applications.
Compaq TCP/IP Services for OpenVMS Sockets API and System Services Programming	This manual describes how to use the Sockets API and OpenVMS system services to develop network applications.
Compaq TCP/IP Services for OpenVMS SNMP Programming and Reference	This manual describes the Simple Network Management Protocol (SNMP) and the SNMP application programming interface (eSNMP). It describes the subagents provided with TCP/IP Services, utilities provided for managing subagents, and how to build your own subagents.
Compaq TCP/IP Services for OpenVMS Tuning and Troubleshooting	This manual provides information about how to isolate the causes of network problems and how to tune the TCP/IP Services software for the best performance.
Compaq TCP/IP Services for OpenVMS Guide to IPv6	This manual describes the IPv6 environment, the roles of systems in this environment, the types and function of the different IPv6 addresses, and how to configure TCP/IP Services to access the 6bone network.

For a comprehensive overview of the TCP/IP protocol suite, you might find the book Internetworking with TCP/IP: Principles, Protocols, and Architecture, by Douglas Comer, useful.

Reader's Comments

Compaq welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet	openvmsdoc@compaq.com
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 following World Wide Web address for information about how to order additional documentation:

http://www.openvms.compaq.com/

Conventions

The name TCP/IP Services means both:

Compaq TCP/IP Services for OpenVMS Alpha
Compaq TCP/IP Services for OpenVMS VAX

The name UNIX refers to the Compaq Tru64 UNIX operating system.

The following conventions are used in this manual. In addition, please note that all IP addresses are fictitious.

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.
PF1 x	A sequence such as PF1 x indicates that you must first press and release the key labeled PF1 and then press and release another key or a pointing device button.
`[Return]`	In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.) In the HTML version of this document, this convention appears as brackets, rather than a box.
...	A horizontal ellipsis in examples indicates one of the following possibilities: Additional optional arguments in a statement have been omitted. The preceding item or items can be repeated one or more times. Additional parameters, values, or other information can be entered.
. . .	A vertical ellipsis indicates the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( )	In command format descriptions, parentheses indicate that you must enclose choices in parentheses if you specify more than one.
[ ]	In command format descriptions, brackets indicate optional choices. You can choose one or more items or no items. Do not type the brackets on the command line. However, you must include the brackets in the syntax for OpenVMS directory specifications and for a substring specification in an assignment statement.
\|	In command format descriptions, vertical bars separate choices within brackets or braces. Within brackets, the choices are optional; within braces, at least one choice is required. Do not type the vertical bars on the command line.
{ }	In command format descriptions, braces indicate required choices; you must choose at least one of the items listed. Do not type the braces on the command line.
bold text	This typeface represents the introduction of a new term. It also represents the name of an argument, an attribute, or a reason.
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 dd represents the predefined code for the device type).
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`	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.
-	A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers	All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

Chapter 1
Preparing to Install and Configure TCP/IP Services

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

1.1 Understanding the Major Tasks

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 may take about 15 minutes to complete.

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

**Table 1-1 Major Tasks: Installing and Configuring**
Step	Task	Described in...
1	Prepare for installation and configuration.	Sections 1.2 and 1.3
2	Shut down any previous versions of TCP/IP Services running on the system.	Section 2.1
3	Install TCP/IP Services.	Chapter 2
4	Configure TCP/IP Services according to your network needs.	Chapter 3
5	Start TCP/IP Services.	Section 3.5
6	Verify the configuration.	Section 3.8
7	Complete additional configuration and setup tasks, as appropriate.	Section 3.9

1.2 Preinstallation Tasks

Table 1-2 lists the tasks you should complete before you install TCP/IP Services on your system, and the sections that describe these tasks.

**Table 1-2 Preinstallation Tasks**
Step	Task	Described in...
1	Inspect the distribution kit.	Section 1.2.1
2	Extract and read the TCP/IP Services release notes.	Section 1.2.2
3	Back up the system disk.	Section 1.2.3
4	Perform an OpenVMS operating system upgrade, if applicable.	Section 1.2.3
5	Register the TCP/IP Services license PAK.	Section 1.2.4
6	Check the disk space, memory, and system parameters.	Sections 1.2.5 through 1.2.7
7	Assign a user identification code (UIC), if necessary.	Section 1.2.8
8	Assemble information for configuration.	Section 1.3

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 kit, check the CD master index for the kit location. If you have an individual CD-ROM, supply the device name (such as DKAn) 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 Compaq TCP/IP Services for OpenVMS Release Notes document contains important information you should know before you install the product.

You can have the POLYCENTER Software Installation utility extract the release notes as either a text file or a PostScript file. To extract the release notes as a text file, enter the following POLYCENTER Software Installation utility command:

$ PRODUCT EXTRACT RELEASE_NOTES TCPIP/SELECT=TCPIP053.RELEASE_NOTES

To extract the release notes as a PostScript file, enter the following:

$ PRODUCT EXTRACT RELEASE_NOTES TCPIP/SELECT=TCPIP053_RELEASE_NOTES.PS

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 that is 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:

Run the SYS$UPDATE:VMSLICENSE.COM file and enter the data from your License PAK.
At the DCL prompt, enter 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.5 Checking the Disk Space

Make sure your system meets the following disk space requirements:

System	Minimum Block Size
OpenVMS Alpha	125,000
OpenVMS VAX	70,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 run AUTOGEN, and 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. The following is an example from an OpenVMS Alpha system:

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

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

To increase the global pagelets and global sections, add statements to the SYS$SYSTEM:MODPARAMS.DAT file that increase the values of the system parameters GBLPAGES and GBLSECTIONS, as in the following example:

ADD_GBLPAGES = 7500
ADD_GBLSECTIONS = 75