DIGITAL TCP/IP Services for OpenVMS

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:

Terminology

This manual uses the following terminology:

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:

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:

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 
    


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