This chapter describes how to start and stop TCPware, and remove TCPware files. It is for the OpenVMS system manager, administrator, or operator responsible for system startup.
Before you start TCPware for the first time, be sure you have:
· Installed your TCPware components.
· Correctly configured your TCPware components.
· Registered TCPware through your Product Authorization Key (PAK).
If you run DECnet, DECwindows, HYPERchannel, or another vendor's TCP/IP product, there are a few things you need to keep in mind:
|
If you... |
Then you must... |
|
Run DECnet |
Start DECnet before starting TCPware. If DECnet and TCPware use the same Ethernet controller, DECnet cannot start if TCPware is already running. (You do not have to run DECnet to use TCPware). |
|
Run DECwindows |
Set up the DECwindows transport interface. You can use the TCPware DECwindows transport interface only if your system runs VMS 5.5-2 or later, and if you enabled this feature during network configuration. To set up and use the TCPware DECwindows transport interface, see Chapter 28 in the Management Guide. |
|
Use HYPERchannel support |
Start and load the Network Systems Corporation H269 driver (as described in the H269 documentation) before starting TCPware. |
You can use the SYSGEN utility in OpenVMS to examine the system parameters described in this section. Edit the SYS$SYSTEM:MODPARAMS.DAT file and use AUTOGEN to change the system parameters. System parameter settings need to be as follows:
· The TCPware shareable Socket Library, SMTP ONC RPC Run-Time Library and the TCPware DECwindows transport interface require a modest number of global pages and sections for the shareable images they install.
· GBLPAGES refers to the global page table entries. GBLSECTIONS refers to the number of global section descriptors. If an insufficient number of GBLPAGES or GBLSECTIONS are free, the shareable images might fail to install. If this happens, increase the number of each.
· The below table lists the minimum free requirements for global pages and sections required after installation but before starting TCPware.
· If you plan to use Serial Line IP (SLIP) lines, make sure you set the maximum buffer size (MAXBUF) and alternate type-ahead (TTY_ALTYPAHD) system parameters properly. Change the following parameters:
o MAXBUF should be at least twice the maximum transmission unit (MTU) of the SLIP line plus 144. The default MTU for SLIP lines is 1006 bytes; therefore, MAXBUF must be at least 2156. Increase MAXBUF if necessary.
o MAXBUF is dynamic. If you use SYSGEN to change it, you do not need to reboot the system for the change in value to take effect.
o TTY_ALTYPAHD should be larger than its default value. This prevents characters from being lost. The greater the line speed, the higher you should set this parameter. For most applications, 1024 is appropriate.
o TTY_ALTYPAHD is not dynamic. If you use SYSGEN to change this parameter, you must reboot the system for the change to take effect.
Make sure each TCPware user account has TMPMBX and NETMBX privileges. These are the normal default privileges required to use TCPware. Use the OpenVMS AUTHORIZE utility to grant these privileges to the appropriate users.
|
Shareable Image |
GBLPAGES |
GBLSECTIONS |
|
DECW_TRANSPORT_TCPWARE* |
8 |
2 |
|
SMTP_MAILSHR |
20 |
2 |
|
SMTP_MAILSHRP* |
10 |
2 |
|
TCPWARE_RPCLIB_SHR |
5 |
1 |
|
TCPWARE_SOCKLIB_SHR |
10 |
2 |
To automatically start TCPware each time you boot your system, add TCPware to your system startup file. Edit your system startup file and add these lines after the ones that start DECnet (note that they are valid only for the default TCPware installation common files location):
$ @SYS$SYSROOT:[TCPWARE]TCPWARE_LOGICALS
$ @TCPWARE:STARTNET
To configure the TCPware commands, edit your SYLOGIN.COM file to define all the TCPware commands. Add the following line to the "all accounts" definition section of the system-wide login file, SYS$MANAGER:SYLOGIN.COM:
$ @TCPWARE:TCPWARE_COMMANDS
To prevent any errors in the SYLOGIN.COM file from causing a TCPware module to fail, you might want to include this line at the beginning of the file to disable error checking:
$ SET NOON
|
Note: If you chose to install TCPware common files in a location other than the default, you must redefine SYS$SYSROOT to point to that location.
|
|
If your VMS version is... |
Your startup file is... |
|
OpenVMS VAX V6.x |
SYS$MANAGER:SYSTARTUP_VMS.COM |
|
OpenVMS Alpha |
SYS$MANAGER:SYSTARTUP_VMS.COM |
|
OpenVMS I64 |
SYS$MANAGER:SYSTARTUP_VMS.COM |
|
VMS V5.x |
SYS$MANAGER:SYSTARTUP_V5.COM |
You can start all components or selected components from the configuration menu system. At the DCL prompt enter:
$ @TCPWARE:CNFNET MENU
At the menu shown below, enter 1 if you want to start up TCPware’s services.
TCPware(R) for OpenVMS Configuration Menu
Configuration Options:
1 - Configure TCPware
Services
2 - Startup/Restart all TCPware Services
3 - Shutdown all TCPware Services
L - Display the software licensing information (PASSWORD)
E - Exit the configuration procedure (changes will be saved)
Enter configuration option: 1
If you enter 1, another menu appears from which you can select to start or restart the entire service (4), or start or restart a particular component (6). In the latter case, a menu such as the one below appears.
Starting a Specific TCP/IP Component
Startup options:
1 - ACCOUNTING Startup the TCP/IP Services accounting facility
2 - CNFS Startup the NFS-OpenVMS Client
3 - DHCP4 Startup the Dynamic Host Configuration Protocol V4 Server
4 - DHCP Startup the Dynamic Host Configuration Protocol Server
5 - DNIP Startup DECnet over IP tunnels
6 - DNS Startup the Domain Name Server
7 - FTP Startup the FTP-OpenVMS Server
8 - GATED Startup the Gate Daemon
9 - IMAP Startup the Internet Message Access Protocol Server
10 - IPP Startup the Internet Printing Protocol Client
11 - IPS Startup the IPS subsystem
12 - KERBEROS Startup the Kerberos Services
13 - LPS Startup the Line Printer Services
14 - MISC Startup the Miscellaneous Services
15 - NFS Startup the NFS-OpenVMS Server
16 - NTP Startup the Network Time Protocol Daemon
17 - POP3 Startup the Post Office Protocol V3 Server
18 - PWIP Startup the PWIPDRIVER
19 - RCMD Startup the Berkeley R Commands
20 - SMTP Startup the Simple Mail Transfer Protocol Services
21 - SNMP Startup the Simple Network Management Protocol Agents
22 - SSH Startup the SSH-OpenVMS Server
23 - TALK Startup the TALK Server
24 - TELNET Startup the TELNET-OpenVMS Server
25 - TIMED Startup the TIMED Server
26 - XDM Startup the XDM Server
Enter menu option (E to exit):
|
CAUTION! Do not use the STOP PROCESS/ID command to stop TCPware or any of its components. Use the SHUTNET command as described on the following page.
|
You can also use the DCL command method to start TCPware or one of its components:
|
@TCPWARE:STARTNET [component] |
STARTNET by itself starts all TCPware. If you specify a component with the command, you start that component only (see Error! Reference source not found.the output listing above for the TCP/IP Services; note that your list of available components may be different). Start the TCP/IP Services components using
$ @TCPWARE:STARTNET TCPWARE
Upon startup, TCPware checks for the logicals TCP, UDP, IP, INET, RMT, RCD, BG, and QX. If any of these logicals have been previously defined on your system, the following warning is generated:
%TCPWARE-W-BADLOGICAL
Redefine the conflicting logicals and restart TCPware. |
|
@TCPWARE:SHUTNET [component] |
SHUTNET by itself shuts down all TCPware. If you specify a component with the command, you shut down that component only (use one of the component names from the above output listing). |
If your network configuration has special requirements, you might need to create the file TCPWARE:TCPWARE_STARTUP.COM and call it from the OpenVMS system startup file. (See the comments in the STARTNET.COM file for more details about special requirements.)
To configure special requirements:
1. Copy the TCPWARE:TCPWARE_STARTUP.TEMPLATE template file to the TCPWARE:TCPWARE_STARTUP.COM file:
$ COPY TCPWARE_COMMON:[TCPWARE]TCPWARE_STARTUP.TEMPLATE
-
_$ TCPWARE_COMMON:[TCPWARE]TCPWARE_STARTUP.COM
2. Edit the VMS system startup file.
a. Delete the following line or pair of lines, whichever the file contains:
$ @SYS$SYSROOT:[TCPIP]STARTNET
$ @SYS$SYSROOT:[TCPWARE]TCPWARE_LOGICALS
$ @TCPWARE:STARTNET
b. Add the following line to the VMS system startup file:
$ @TCPWARE_COMMON:[TCPWARE]TCPWARE_STARTUP.COM
3. Edit the TCPWARE_STARTUP.COM file as needed and as described in the rest of this section.
|
Note: Changes you make to network parameters using Network Control Utility (NETCU) commands are active until TCPware shuts down. Update the TCPWARE_STARTUP.COM file with these commands to make them permanent.
|
For example, you might want to do the following:
|
Step |
Task |
Action |
|
1 |
Override the default TCP maximum segment size or window size |
See the description of the START/TCP command /MSS and /MWS qualifiers in the NETCU Command Reference, Chapter 2, NETCU Commands.
If you use TCP over a satellite link with a line speed greater than 384 Kbits, configure TCPware on both sides with a window size greater than 63448 bytes. See the description of the START TCP command for details on using satellite links. |
|
2 |
Override the default UDP maximum datagram size |
See the description of the START/UDP command /MDS qualifier. |
|
3 |
Enable packet forwarding capability |
See the description of the ENABLE FORWARDING command /MDS qualifier. You can also add the ENABLE FORWARDING command to the TCPWARE_STARTUP.COM file. |
|
4 |
Join multicasting host group addresses |
You may have applications that rely on multicasting yet do not want to change the application code to join the specific groups so that they can receive the multicast datagrams. Therefore, you can include ADD MULTICAST_GROUP commands to the TCPWARE_STARTUP.COM file to add the multicast IP addresses. |
START/TCP/MWS=value/MSS=value /NOKEEPALIVE [1]
START/UDP/MDS=value [2]
ENABLE FORWARDING [3]
ADD MULTICAST_GROUP 224.0.0.2 /LINE=ISA-0 [4]
If you want any user-written servers to start automatically when you start TCPware, edit the SERVERS.COM file. CNFNET creates a template of this file if none existed previously.
To start a user-written server automatically, do the following:
1. Edit the TCPWARE:SERVERS.COM file.
2. Enter the ADD SERVICE command in the file for each server you add.
For example, if you built FINGERD from the sources TCPware provides, you might add the command below to the end of the SERVERS.COM file.
The various quotas and parameters might be different for your system, or you might choose to take the defaults for most values.
See the description for the ADD SERVICE command in the NETCU Command Reference, Chapter 2, NETCU Commands.
ADD SERVICE FINGER TCP TCPWARE:FINGERD
-
/PROCESS_NAME = FINGERD -
/NOACCOUNTING -
/NOAUTHORIZE -
/INPUT = NLA0: -
/OUTPUT = NLA0: -|
/ERROR = NLA0: -
/UIC = [SYSTEM] -
/AST_LIMIT = 10 -
/BUFFER_LIMIT = 10240 -
/ENQUEUE_LIMIT = 100 -
/EXTENT = 500 -
/FILE_LIMIT = 20 -
/IO_BUFFERED = 6 -
/IO_DIRECT = 6 -
/MAXIMUM_WORKING_SET = 300 -
/PAGE_FILE = 10000 -
/PRIORITY = 4 -
/PRIVILEGES = (NOSAME, SYSPRV, NETMBX, TMPMBX, WORLD) -
/QUEUE_LIMIT = 8 -
/WORKING_SET = 200 -
/SUBPROCESS_LIMIT = 0
Actian’s INGRES/Net product can use TCPware as the TCP/IP network protocol. For supported versions of INGRES/NET, use TCPware's UCX Compatibility mode, which is the TCP_HP protocol at INGRES/Net startup.
You can remove any or all TCPware components:
· To remove a single component:
$ @TCPWARE:TCPWARE_REMOVE component
· To remove all TCPware components:
$ @TCPWARE:TCPWARE_REMOVE TCPware
|
CAUTION! This command deletes all relevant files in all TCPware-specific directories and the TCPWARE directory.
|
Registering this PAK allows you to start and run TCPware for all the products you install.
To register your PAK, do the following:
1. Copy down the string of digits representing your hardware ID. This is your Ethernet controller's hardware ID.
2. With your hardware ID number and product names and version information available, contact Process Software's Licensing Desk.
3. The Licensing Desk will ask you for the required information and provide you with the various values you must enter during the LMF procedure. Be sure to enter these values exactly as you see them, especially the Authorization Number.
4. Use the OpenVMS License Management Facility (LMF) in one of the two following ways, depending on your preference:
· SYS$UPDATE:VMSLICENSE command: The menu- and prompt-driven method that takes you through each licensing step in detail. Enter:
$ @SYS$UPDATE:VMSLICENSE
· LICENSE REGISTER command: The single command method where you can specify licensing information through qualifiers. Enter:
$ LICENSE REGISTER TCPWARE /qualifier /qualifier ...
See HP's OpenVMS License Management Utility Manual (or A Practical Guide to OpenVMS Software License Management and Tools) for details on the VMSLICENSE or LICENSE REGISTER procedures.
Sample Hardware ID Information
Provide your distributor or Process Software with the following information to obtain Product Authorization Key(s) for this system:
* Hardware ID: "12-34-56".
* The product name and version number for the product(s) you are
installing on this system.
Refer to your product documentation for more information on obtaining Product Authorization Key(s).
Sample VMSLICENSE Command Procedure Menu
VMS License Management Utility Options:
1. REGISTER a Product
Authorization Key
2. AMEND an existing Product Authorization Key
3. CANCEL an existing Product Authorization Key
4. LIST the Product Authorization Keys
5. MODIFY an existing Product Authorization Key
6. DISABLE an existing Product Authorization Key
7. DELETE an existing Product Authorization Key
8. COPY an existing Product Authorization Key
9. MOVE an existing Product Authorization Key
10. ENABLE an existing Product Authorization Key
11. SHOW the licenses loaded on this node
12. SHOW the unit requirements for this node
99. EXIT this procedure
Type '?' at any prompt for a description of the information requested.
Press Ctrl/Z at any prompt to exit this procedure.
Enter one of the above choices [1]
Sample VMS PAK Information
ISSUER: PSC
AUTHORIZATION NUMBER: 9145685760
PRODUCT NAME: TCPWARE-TCP
PRODUCER: PSC
NUMBER OF UNITS: 200
VERSION:
PRODUCT RELEASE DATE:
KEY TERMINATION DATE:
AVAILABILITY TABLE CODE: F
ACTIVITY TABLE CODE:
KEY OPTIONS: NO_SHARE
PRODUCT TOKEN:
HARDWARE I.D.:
CHECKSUM: 4-ABCD-EFGH-IJKL-MNOP
Use the following steps to test your TCPware connections after a startup:
1. Verify that the databases you need are properly updated by the startup. Among these are:
· TCPWARE:HOSTS.
· TCPWARE:HOSTS.EQUIV
· .RHOSTS
· ROUTING.COM
2. Log out of the system account - TCPware for OpenVMS is ready for general use.
3. Test TCPware - perform connectivity tests for each TCPware component you installed and configured. For example, use FTP to transfer some files.
If you uncover problems during testing, review the network configuration. If you need to reconfigure a component, stop TCPware first.