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
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.
This manual explains how to install and configure the DIGITAL TCP/IP Services for OpenVMS (UCX) networking software on an OpenVMS system.
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.
This manual contains three chapters and one appendix:
This manual uses the following terminology:
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.
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.
The following manuals provide additional information about planning your network and configuring and managing UCX:
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
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 |
|
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd. Nashua, NH 03062-2698 |
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 |
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.
| 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:
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
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
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:
| 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. |
! 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.
| 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?
|
|
| 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?
|
|
| What is the name of the system's remote BIND server (for example, MAINSV)? |
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.
$ @SYS$MANAGER:UCX$SHUTDOWN
$ PRODUCT INSTALL UCX /SOURCE=SYS$SPECIFIC:[UCX42]
Note
To stop the installation at any time, press Ctrl/Y. The installation procedure will delete any files that were created, then exit.
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
$ @SYS$UPDATE:UCX$CLEANUP_HELPLIB
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.