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.
© 2002 Compaq Information Technologies Group, L.P. 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.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v 1 Preparing to Install and Configure TCP/IP Services 1.1 Understanding the Major Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 Preinstallation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.1 Inspecting the Distribution Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2.
3.3.7 Configuring the Optional Components . . . . . . . . . . . . . . . . . . . . . . . 3.3.7.1 Configuring and Enabling Kerberos Support . . . . . . . . . . . . . . . 3.4 Using TCPIP$CONFIG Option Commands to Bypass TCPIP$CONFIG Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3.5 Making Configuration Changes Take Effect . . . . . . . . . . . . . . . . . . . . . . 3.6 Stopping TCP/IP Services Using TCPIP$CONFIG . . . . . . . . . . . . . . . . . 3.
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.
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.
Table 1 (Cont.) TCP/IP Services Documentation Manual Contents 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.
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 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.
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.
Preparing to Install and Configure TCP/IP Services 1.2 Preinstallation 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.
Preparing to Install and Configure TCP/IP Services 1.2 Preinstallation Tasks 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.
Preparing to Install and Configure TCP/IP Services 1.2 Preinstallation Tasks 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.
Preparing to Install and Configure TCP/IP Services 1.2 Preinstallation Tasks 1.2.7.3 Interrupt Stack Pages (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 12 or more to help eliminate system startup warnings and failures. For information about the PATHWORKS for OpenVMS (Advanced Server), see the PATHWORKS documentation.
Preparing to Install and Configure TCP/IP Services 1.2 Preinstallation Tasks $ 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 1.
Preparing to Install and Configure TCP/IP Services 1.3 Assembling Configuration Information Table 1–3 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.
Preparing to Install and Configure TCP/IP Services 1.3 Assembling Configuration Information Table 1–3 (Cont.
2 Installing TCP/IP Services This chapter explains how to install the Compaq 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 Alpha CD–ROM menu, refer to the OpenVMS Alpha Upgrade and Installation Manual.
Installing TCP/IP Services 2.1 Invoking the Installation Procedure $ 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. 6. Start the POLYCENTER Software Installation utility by entering the PRODUCT INSTALL command with the directory path appropriate for your system.
Installing TCP/IP Services 2.2 Stepping Through the Installation Procedure Press Return to continue with the installation procedure. 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.3-xx: Compaq TCP/IP Services for OpenVMS. Copyright 2002 Compaq Information Technologies Group, L.P.
Installing TCP/IP Services 2.3 Postinstallation Tasks 1. Optionally, you can: – Read the Compaq TCP/IP Services for OpenVMS Release Notes on line or print the file from SYS$HELP:TCPIP053_RELEASE_NOTES.PS or SYS$HELP:TCPIP053.RELEASE_NOTES. – Display a list of the TCP/IP Services files that were installed.
3 Configuring TCP/IP Services After you install Compaq TCP/IP Services for OpenVMS, you need to enable the components and characteristics you require for your particular system using the menu-driven TCPIP$CONFIG procedure. This chapter explains the TCPIP$CONFIG menus, provides sample installation output, and summarizes additional configuration and setup tasks. 3.
Configuring TCP/IP Services 3.2 Automatic Configuration of TCP/IP Services Using DHCP Client The startup procedure invokes TCPIP$CONFIG, which sets up the environment for the DHCP client and designates any unconfigured interfaces to be under DHCP client control. The procedure enables the following set of services automatically: FTP client TELNET client TELNET server SMTP For more information about DHCP, see the Compaq TCP/IP Services for OpenVMS Management manual. • Run TCPIP$CONFIG.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG The following sample output shows the start of the TCPIP$CONFIG procedure and a portion of the conversion of a previous configuration: TCP/IP Network Configuration Procedure This procedure helps you define the parameters required to run Compaq TCP/IP Services for OpenVMS on this system. NOTE: TCP/IP has been previously configured from an earlier version of this product.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG Creating Creating Creating Creating Creating Creating Creating SYS$COMMON:[SYSEXE]TCPIP$SERVICE.DAT SYS$COMMON:[SYSEXE]TCPIP$HOST.DAT SYS$COMMON:[SYSEXE]TCPIP$NETWORK.DAT SYS$COMMON:[SYSEXE]TCPIP$ROUTE.DAT SYS$COMMON:[SYSEXE]TCPIP$PROXY.DAT SYS$COMMON:[SYSEXE]TCPIP$CONFIGURATION.DAT TCPIP$ETC:SYSCONFIGTAB.DAT Compaq TCP/IP Services for OpenVMS requires a definition for at least one interface. There are no interfaces defined on this system.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG software and want to bypass the menus, you can add one or more command parameters when you run TCPIP$CONFIG. For information about the command parameters, see Section 3.4. 3.3.4 Configuring the Core Environment To display the Core Environment Configuration menu, choose option 1 (Core environment) from the Main Configuration menu.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG 3.3.4.2 Interface Configuration The following is sample output for configuring the Internet interface: INTERFACE Configuration The Ethernet device(s) on your system are: EWA0: Start of configuration questions for Internet interface WE0. WE0 is the Ethernet device EWA0: Interface: WE0 IP_Addr: 10.10.2.2 C_Addr: Flags: Receive buffer: NETWRK: 255.255.255.0 BRDCST: 10.10.2.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG DYNAMIC ROUTING Configuration Dynamic routing has not been configured. You may configure dynamic ROUTED or GATED routing. You cannot enable both at the same time. If you want to change from one to the other, you must disable the current routing first, then enable the desired routing.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG TIME ZONE Configuration TCPIP uses timezone information provided by the OpenVMS Operating System. No additional timezone configuration is needed for TCPIP when the operating system is configured correctly. This section verifies the current OpenVMS timezone configuration. A warning message (TCPIP-W-) indicates that corrective action should be taken.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG The initial status of the components depends on whether you have other TCP/IP Services installations in place on the system, and whether the software or individual components have been started. On a new system, all the components would be disabled (the default). The status of components is also affected by the selections you made from the Core Environment menu.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG After you configure the client component environment, press Return or choose option E to exit from the Client Components menu. If you chose option A from the Main Configuration menu to configure all the TCP/IP Services components, the Server Components Configuration menu displays next; otherwise, the procedure returns to the the Main Configuration menu. 3.3.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG client, and disable and stop the service by choosing the ‘‘Disable & Stop service on this node’’ option. The following is an example of an XDM server configuration output. The configuration displays for other server components might vary. Enter configuration option: 21 Return XDM Configuration Service Service Service Service is is is is defined in the SYSUAF. not defined in the TCPIP$SERVICE database. not enabled. stopped.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG • Initialize Kerberos authentication for the TELNET server. To display the Optional Components Configuration menu, choose option 4 (Optional components) from the Main Configuration menu. If you chose option A from the Main Configuration menu to configure all the TCP/IP Services components, the Optional Components Configuration menu displays automatically after you finish configuring the server components.
Configuring TCP/IP Services 3.3 Running TCPIP$CONFIG 3.3.7.1 Configuring and Enabling Kerberos Support To configure the TELNET service to support Kerberos, follow these steps. For more details about Kerberos features, including prerequisites and instructions for using Kerberos, see the Compaq TCP/IP Services for OpenVMS Release Notes. Note Before you begin the following steps, make sure the TELNET service is stopped. 1. From the the TCPIP$CONFIG.
Configuring TCP/IP Services 3.4 Using TCPIP$CONFIG Option Commands to Bypass TCPIP$CONFIG Menus 3.4 Using TCPIP$CONFIG Option Commands to Bypass TCPIP$CONFIG Menus If you are an experienced TCP/IP Services user, you may want to bypass the configuration menus to enable or disable functionality, as follows: 1. Log in to the SYSTEM account. 2.
Configuring TCP/IP Services 3.5 Making Configuration Changes Take Effect 3.5 Making Configuration Changes Take Effect Whenever you configure the core TCP/IP Services software (the core environment), you must then start (or restart) TCP/IP Services to make the changes take effect. Do this before you run tests or customize the environment. Start TCP/IP Services from TCPIP$CONFIG by following the procedure described in Section 3.7.
Configuring TCP/IP Services 3.6 Stopping TCP/IP Services Using TCPIP$CONFIG %TCPIP-I-INFO, TCP/IP Services shutdown beginning at 5-MAR-2002 15:26:14.
Configuring TCP/IP Services 3.7 Starting TCP/IP Services Using TCPIP$CONFIG Enter configuration option: 6 Begin Startup... %TCPIP-I-INFO, TCP/IP Services startup beginning at 5-MAR-2002 15:27:08.
Configuring TCP/IP Services 3.8 Verifying the Configuration • You require the software to transfer device socket packets that continuously vary in size between a sender and a receiver. • You need to test the Portmapper service with a pair of client/server programs. The IVP reports the time it took to run the test to SYS$OUTPUT. • You need to test your SNMP service. Before you run the IVP, make sure TCP/IP Services has started and you have SYSPRV, OPER, NETMBX, and TMPMBX privileges.
Configuring TCP/IP Services 3.8 Verifying the Configuration %%% TCPIP IVP: completed successfully %%% IVP request completed. Press Return to continue ... If the IVP does not complete successfully, the procedure displays error messages. All IVP errors use the same format as OpenVMS system messages. For example: %TCPIP-E-IDENT, explanation of error. Table 3–2 lists some common problems that cause IVP error messages.
Configuring TCP/IP Services 3.8 Verifying the Configuration Deleting temporary read/write community SNMPIVP_6520. Shutting down and restarting the SNMP service... Shutting down the SNMP service... done. Starting up the SNMP service... done. SNMP IVP request completed. Press Return to continue ... If one of the SNMP tests fails, you will see messages such as the following: SNMPIVP: unexpected text in response to SNMP request: "No reply." See file SYS$SYSDEVICE:[TCPIP$SNMP]TCPIP$SNMP_REQUEST.
Configuring TCP/IP Services 3.10 Starting and Stopping TCP/IP Services by Command 3.10.1 Automatically Starting and Stopping TCP/IP Services To allow TCP/IP Services software to start automatically when the system starts up, and to stop automatically when the system shuts down, edit the SYS$COMMON:[SYSMGR]SYSTARTUP_VMS.COM file and include the following command: @SYS$STARTUP:TCPIP$STARTUP If your system had earlier versions of TCP/IP Services, UCX$STARTUP.COM and UCX$SHUTDOWN.COM files might be present.
Configuring TCP/IP Services 3.10 Starting and Stopping TCP/IP Services by Command For more information, see the Compaq TCP/IP Services for OpenVMS Management guide. 3.10.4 Starting and Stopping User-Written Services TCP/IP Services supplies command procedures for starting and stopping userwritten services.
A Sample New TCP/IP Services Installation and Configuration This appendix shows a sample installation and configuration of the TCP/IP Services product on a system on which the product has never been installed. A.1 Sample New Installation Procedure The following example shows a sample installation dialog for the TCP/IP Services. In this example, the installation takes place on a system where the product has not been installed.
Sample New TCP/IP Services Installation and Configuration A.1 Sample New Installation Procedure Portion done: 100% The following product has been installed: DEC VAXVMS TCPIP V5.3-xx Layered Product DEC VAXVMS TCPIP T5.3-xx: Compaq TCP/IP Services for OpenVMS. Check the release notes for current status of the product. A.
Sample New TCP/IP Services Installation and Configuration A.2 Sample New Configuration Procedure 1 2 3 4 5 - Domain Interfaces Routing BIND Resolver Time Zone A - Configure options 1 - 5 [E] - Exit menu Enter configuration option: A Return DOMAIN Configuration Enter Internet domain: budget.acme.com INTERFACE Configuration The Ethernet device(s) on your system are: EWA0: * Not Configured * Start of configuration questions for Internet interface WE0.
Sample New TCP/IP Services Installation and Configuration A.
Sample New TCP/IP Services Installation and Configuration A.
Sample New TCP/IP Services Installation and Configuration A.
Sample New TCP/IP Services Installation and Configuration A.
Index A D Advanced Server for OpenVMS configuring, 3–11 Anonymous FTP configuring, 3–11 Automatic configuration of TCP/IP Services, 3–1 DECnet over TCP/IP configuring to use, 3–11 DECwindows components required for XDM, 3–11 defining TCP transport, 3–22 requirements for product installation, 1–3 DHCP client configuring, 3–8 DHCP server configuring, 3–10 configuring TCP/IP Services, 3–1 Disk space requirements, 1–3 system, backing up, 1–2 Distribution kit inspecting, 1–2 Domain configuring, 3–5 Dynamic ro
Interface configuring, 3–6 IVP (Installation Verification Procedure) description, 3–17 K Kerberos benefits, 3–12 configuring and enabling, 3–13 optional component configuration, 3–11 Kerberos authentication configuring and enabling, 3–13 configuring to use, 3–11, 3–12 L LBROKER server configuring, 3–10 License Product Authorization Key See PAK LOCKD/STATD server configuring, 3–10 LPR/LPD client configuring, 3–8 LPR/LPD server configuring, 3–10 M Memory physical memory requirements, 1–3 Menus TCPIP$CONFIG
SRI QIO configuring to use, 3–11 Starting TCP/IP Services after configuration, 3–16 automatically, 3–21 by command, 3–20 manually, 3–21 using TCPIP$CONFIG, 3–16 Stopping TCP/IP Services automatically, 3–21 by command, 3–20 manually, 3–21 using TCPIP$CONFIG, 3–15 System parameters checking and changing before installing, 1–4 to 1–5 setting the SPTREQ parameter, 1–5 T Tasks major, installing and configuring, 1–1 TCP/IP Services and Anonymous FTP access, 3–12 client components configuring, 3–8 to 3–10 startin
