HP OpenVMS Systems Documentation

HP TCP/IP Services for OpenVMS
Installation and Configuration

The TCP/IP Services software requires at least 160 global sections and 12,000 global pagelets be available. The minimum requirement is affected by the number of services you enable.

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

Add at least 500,000 bytes of available 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.

   Note On a system that uses FDDI, the default sizes for the TCP/IP socket buffer quotas are increased automatically. This increases throughput across the FDDI for local TCP connections.

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 HP TCP/IP Services for OpenVMS. ! ADD_NPAGEDYN=500000 ADD_NPAGEVIR=500000

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

1.2.8 Assigning a User Identification Code

An OpenVMS user or group of users is identified by a unique, assigned user identification code (UIC) in the format [group,member], where group and member are numeric, alphanumeric, or alphabetic 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 TCPIP$CONFIG configuration procedure uses a group UIC to create accounts for services. If a user-specified UIC is not in place from a previous configuration, the procedure creates the following UIC group numbers:

Before you assign a new group UIC, check that the number you chose is not already in use by entering the following commands:

$ RUN SYS$SYSTEM:AUTHORIZE

UAF> SHOW /BRIEF [your-group-number,*]

UAF> SHOW /IDENTIFIER /VALUE=UIC:[your-group-number,*]

To force TCPIP$CONFIG to allow you to specify a new UIC group number, assign the value TRUE to the logical name TCPIP$ASK_GROUP_UIC, as in the following example. When you configure TCP/IP Services, TCPIP$CONFIG prompts you for the group UIC.

$ DEFINE TCPIP$ASK_GROUP_UIC TRUE

If you have installed one or more of the following EAKs, you must use the PCSI REMOVE command to remove the EAKs before you install TCP/IP Services Version 5.5:

• Version 5.0 IPv6 EAK

  Note After you remove the Version 5.0 IPv6 EAK, you must do the following: Run the TCPIP$IP6_SETUP.COM command procedure. For more information, see Chapter 4. After you install the current version of TCP/IP Services, recompile and relink your applications.

• Version 5.3 SSH for OpenVMS EAK
• Version 5.3 failSAFE IP EAK

Use the worksheet in Table 1-3 to assemble configuration information.

If you are configuring TCP/IP Services on the system for the first time, the TCPIP$CONFIG configuration procedure prompts you for the information listed in Table 1-3. If you are reconfiguring after a product upgrade, the procedure uses the previous configuration information as the default for the new configuration.

For information to help you answer the questions on the configuration worksheet, refer to the appropriate chapters in the HP TCP/IP Services for OpenVMS Management manual. For information to help you answer SSH configuration options, refer to the HP TCP/IP Services for OpenVMS Guide to SSH.

This chapter explains how to install the HP TCP/IP Services for OpenVMS software as a layered product using the POLYCENTER Software Installation utility. The instructions are appropriate for an initial installation or an upgrade.

For information about how to install the product directly from the OpenVMS operating system CD/DVD menu, refer to the OpenVMS Upgrade and Installation Manual.

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

2.1 Invoking the Installation Procedure

When you have completed the recommended preinstallation tasks outlined in Chapter 1 and have read the release notes ( Section 1.2.2), you are ready to upgrade or install TCP/IP Services.

During a product upgrade, existing configuration files are preserved in case you want to use them when you configure this version of the software.

To install the TCP/IP Services software on an OpenVMS Alpha or I64 system, proceed as follows:

1. Log in to the SYSTEM account.
2. Check to make sure that other users are not logged in to the system.
3. Edit the SYS$STARTUP:SYSTARTUP_VMS.COM file and check to see if the command @SYS$STARTUP:UCX$STARTUP is defined. If this command is defined, edit the line, replacing the command definition with @SYS$STARTUP:TCPIP$STARTUP so that the current version of the product starts automatically when the system starts up.
4. If a previous version of the TCP/IP Services software is installed on the system, shut it down by using the appropriate command:

   If the software version is...	Use this command...
   Version 4. x	@SYS$MANAGER:UCX$SHUTDOWN.COM
   Version 5. x	@SYS$STARTUP:TCPIP$SHUTDOWN.COM

   
   
5. HP recommends that you log the installation procedure. If you have DECnet configured on your system, you can create a log of the installation procedure by entering the following command and then log in to the system account again:

   $ SET HOST 0/LOG=file-specification

   
   In this command, file-specification is the name of the file to which you want the log written. The log file is written to the current directory.
   If you do not have DECnet but have the LAT protocol (Version 5.0 or later), you can use the following command:

   $ SET HOST /LAT /LOG=file-specification

6. Start the POLYCENTER Software Installation utility by entering the PRODUCT INSTALL command with the directory path appropriate for your system. For example:

   $ PRODUCT INSTALL TCPIP /SOURCE=directory-path

   
   In this command, directory-path specifies the disk and directory name for the source drive that holds the TCP/IP Services kit. For example, /SOURCE=DKA400:[TCPIPAXP055].
   If you do not specify the source qualifier, the POLYCENTER Software Installation utility searches the location defined by the logical name PCSI$SOURCE. If not defined, the utility searches the current default directory.

After you invoke the installation procedure, you are prompted for information. Example 2-1 shows a sample installation on an OpenVMS Alpha system that has an earlier version of TCP/IP Services installed on it. Additional explanatory information follows each portion of the installation procedure. For a sample installation on a system on which the product has never been installed, see Appendix A.

The actual installation output that is displayed on your system might vary, depending on your current configuration and the operating system (Alpha or I64).

   1 - DEC AXPVMS TCPIP V5.5-xx            Layered Product
   2 - DEC AXPVMS TCPIP V5.1-15            Layered Product
   3 - DEC AXPVMS TCPIP V5.0-11            Layered Product
   4 - All products listed above
   5 - Exit

Choose one or more items from the menu separated by commas: 1 [Return]

The initial menu that is displayed includes the latest TCP/IP Services product and any versions of the product that are in place on the system. Install the latest version (option 1).

The following product has been selected:
    DEC AXPVMS TCPIP V5.5-xx                  Layered Product


Do you want to continue? [YES] [Return]

Pressing Return allows the procedure to continue.

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 TCPIP V5.5-xx: HP TCP/IP Services for OpenVMS.

    Copyright 1976, 2004 Hewlett-Packard Development Company, L.P.

    Hewlett-Packard Development Company, L.P.

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

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

Press Return (or enter YES) to choose the POLYCENTER Software Installation utility defaults for the options, or enter NO to choose other options.

Do you want to review the options? [NO] [Return]

Enter YES to review the POLYCENTER Software Installation utility options. Press Return (or enter NO) to continue with the final phase of the installation.

In this example, the options are not reviewed. If you enter YES to review the options, the procedure displays the options and asks whether you are satisfied with the options. To accept the options as listed, press Return. To change the options, enter NO.

Execution phase starting ...

The following product will be installed to destination:
    DEC AXPVMS TCPIP V5.5-xx              DISK$ALPHASYS:[VMS$COMMON.]
The following product will be removed from destination:
    DEC AXPVMS TCPIP V5.1-15              DISK$ALPHASYS:[VMS$COMMON.]

Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%

The following message appears only if an earlier version of TCP/IP Services was configured on your system. A similar message, verifying the product name and version, appears if you are installing for the first time.

%PCSI-I-PRCOUTPUT, output from subprocess follows ...
% TCPIP-W-PCSI_INSTALL
% - BG device exists.
%   To use the version of HP TCP/IP Services that was just installed,
%   system must be rebooted.
%
Portion done: 100%

The following product has been installed:
    DEC AXPVMS TCPIP V5.5-xx               Layered Product
The following product has been removed:
    DEC AXPVMS TCPIP V5.1-15               Layered Product

DEC AXPVMS TCPIP V5.5-xx: HP TCP/IP Services for OpenVMS.

    Check the release notes for current status of the product.

After the installation completes, perform the following steps:

1. Optionally, you can:
   • Read the HP TCP/IP Services for OpenVMS Release Notes on line or print the file from SYS$HELP:TCPIP055_RELEASE_NOTES.PS or
     SYS$HELP:TCPIP055.RELEASE_NOTES.
   • Display a list of the TCP/IP Services files that were installed. Enter the following command:

     $ PRODUCT LIST TCPIP /SOURCE=directory-path

     
     In this command, directory-path specifies the disk and directory name for the source drive that holds the TCP/IP Services kit (for example, /SOURCE=DKA400:[TCPIPAXP055]). If you do not specify the source qualifier, the POLYCENTER Software Installation utility searches the location defined by the logical name PCSI$SOURCE. If not defined, the utility searches the current default directory.
2. If you had a previous version of TCP/IP Services configured on your system and the software was previously started, reboot your system for the new TCP/IP Services software to take effect.

   Important Do not delete any files that remain from the previous version of the product. Many of these files are used by TCPIP$CONFIG for converting your existing configuration to the new configuration (described in Chapter 3). When rebooting OpenVMS, perform only a full boot. Any other kind of boot causes the product configuration and startup command procedures (TCPIP$CONFIG.COM and TCPIP$STARTUP.COM) to fail.

3. Proceed to Chapter 3 to configure TCP/IP Services.