After you configure the server components, as in the preceding example
script, press Return to go to the main Configuration menu. Enter option
4, Optional Components.
3.2.2 Configuring the Optional Components
You may need to configure optional UCX components if you plan to do one or more of the following:
Configure the optional components as follows:
$ @SYS$MANAGER:UCX$CONFIG
DIGITAL TCP/IP Services for OpenVMS Configuration Menu Configuration options: 1 - Core environment 2 - Client components 3 - Server components 4 - Optional components 5 - Shutdown TCP/IP Services for OpenVMS 6 - Startup TCP/IP Services for OpenVMS 7 - Run tests A - Configure options 1 - 3 [E] - Exit configuration procedure Enter configuration option:
DIGITAL TCP/IP Services for OpenVMS Optional Components Menu Configuration options: 1 - Configure PWIP Driver 2 - Configure SRI QIO Interface 3 - Set up Anonymous FTP Account and Directories [E] - Exit menu
$ @SYS$MANAGER:UCX$LOAD_INETDRIVER.COM
If you are an experienced user of the UCX product, you may want to bypass the configuration menus to enable or disable functionality, as follows:
or
@SYS$MANAGER:UCX$CONFIG
CLUSTER
For example, the following command enables the client components for the entire cluster:
$ @SYS$MANAGER:UCX$CONFIG CLIENT ENABLE CLUSTER
The available options are as follows:
Parameter | Description |
---|---|
ALL | Configures the core environment and all client and server components. |
CLIENT | Configures all client components and related software. |
SERVER | Configures all server components and related software. |
WORKSTATION | Configures the BIND resolver, the domain, dynamic routing, Internet interfaces, time zone, remote login, remote shell, remote executive, FTP client, FTP server, TELNET client, TELNET server, and SMTP. |
MINIMUM | Configures the domain, Internet interfaces, remote login, FTP client, FTP server, TELNET client, and TELNET server. |
ENABLE | Enables all the configured components. |
DISABLE | Disables all the configured components. |
CLUSTER |
Configures all selected components clusterwide (except for the BIND
server and SMTP, which you cannot configure clusterwide).
If you configure at least one cluster interface, the procedure automatically enables IP forwarding. |
Note
The procedure implements two levels of enabling and disabling: clusterwide and single node (except for the BIND server and SMTP, which are configured and enabled as node-specific only).
You must start UCX after you configure the standard software and optional components, but before you run tests or customize the UCX environment.
Start UCX on your system as follows:
$ @SYS$MANAGER:UCX$CONFIG
You can verify the UCX configuration by running the installation verification procedure (IVP).
You should run the IVP if the following apply:
Before you run the IVP, make sure the UCX software is started and you have SYSPRV, OPER, NETMBX, and TMPMBX privileges. (You use the SETPRV command to set the privileges.)
Run the IVP as follows:
$ @SYS$MANAGER:UCX$CONFIG
%UCX-E-IDENT, explanation of error.
Problem | Corrective Action |
---|---|
Network configuration is incorrect. | Shut down the UCX software and rerun the configuration procedure. |
Startup fails. |
Check the SYSGEN parameters in the MODPARAMS.DAT file and increase them
if necessary.
Shut down and restart UCX. |
The installation kit is defective. | Request a replacement kit. |
The IVP fails because the PAK is missing. | Register a DIGITAL TCP/IP Services for OpenVMS PAK. |
$ @SYS$TEST:UCX$IVP
After you run the configuration procedure and enable the functionality and components appropriate for your network, you need to complete additional configuration tasks to enable access to UCX applications. UCX provides a management command interface and logical names you can use to modify or customize the software for your environment.
The additional configuration tasks include:
For information about these and other configuration tasks, see the
DIGITAL TCP/IP Services for OpenVMS Management guide.
3.7 Automatically Starting and Stopping UCX
To start the UCX software automatically when the system starts up, edit the SYS$MANAGER:SYSTARTUP_VMS.COM file and include the following command line after the command line that starts the procedure:
@SYS$MANAGER:UCX$STARTUP
To stop UCX automatically when the system shuts down, add the following command line to the SYS$MANAGER:SYSHUTDOWN.COM file:
@SYS$MANAGER:UCX$SHUTDOWN
For the UCX services to start after you log into your OpenVMS account, the OpenVMS systemwide login procedure (typically SYS$MANAGER:SYLOGIN.COM) must be world-readable and world-executable.
To display the current privileges, issue:
$ DIRECTORY SYS$MANAGER:SYLOGIN.COM /PROTECTION
If the protections are not world read and edit (W:RE), issue:
$ SET PROTECTION=(W:RE) SYS$MANAGER:SYLOGIN.COM
To enable the UCX software as the transport interface for DECwindows applications, add the following line to the SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM command procedure:
$ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP"
Then restart DECwindows by entering the following command:
$ @SYS$STARTUP:DECW$STARTUP RESTART
If DECnet or DECnet-Plus runs on the same system, start it.
To display DECwindows applications from a DECwindows client (remote host) to a DECwindows server (your workstation), proceed as follows:
$ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP"
$ SET DISPLAY/CREATE/NODE=remote_host/TRANSPORT=TCPIP
The installation procedure installs all the UCX distribution files appropriate for your operating system.
If you are upgrading from a previous version of UCX, the procedure
renames the configuration database in SYS$COMMON:[SYSEXE] from
UCX$CONFIGURATION.DAT to UCX$CONFIGURATION.OLD.
A.1 Installed UCX Files
Table A-1 outlines the UCX files installed on your system.
File Name / Logical Name | Description |
---|---|
SYS$COMMON:[SYS$LDR] / SYS$LOADABLE_IMAGES: | |
UCX$BGDRIVER.EXE | Internet device driver |
UCX$DNFSDRIVER_V5.EXE+ | OpenVMS Version 5 NFS client driver |
UCX$DNFSDRIVER_V6.EXE+ | OpenVMS Version 6 NFS client driver |
UCX$DNFSDRIVER.EXE | AXP image |
UCX$INETDRIVER.EXE | SRI QIO driver |
UCX$INTERNET_SERVICES.EXE+ | Internet software |
UCX$INTERNET_SERVICES_V6.EXE+ | Internet software |
UCX$TNDRIVER.EXE | TELNET and remote login drivers |
SYS$COMMON:[SYSEXE] / SYS$SYSTEM: | |
UCX$CONVERT.FDL | File definition used by UCX$CONVERT.COM |
UCX$CONVERT.COM | Procedure for converting files to STREAM_LF |
UCX$BIND_SERVER.EXE | BIND server |
UCX$BIND_SERVER_XFER.EXE | BIND server's zone transfer |
UCX$BOOTP.EXE | Remote boot server |
UCX$ENCODE.COM | Procedure to execute UUencode program |
UCX$EXE.ADF | Attributes file for NFS client |
UCX$DECODE.COM | Procedure to execute UUdecode program |
UCX$DNFSMOUNT_V5.EXE | VAX image |
UCX$DNFSMOUNT_V6.EXE | VAX image |
UCX$DNFSDISMOUNT_V5.EXE | VAX image |
UCX$DNFSDISMOUNT_V6.EXE | VAX image |
UCX$DNFSACP_V5.EXE | VAX image |
UCX$DNFSACP_V6.EXE | VAX image |
UCX$ESNMP_SERVER.EXE | eSNMP server |
UCX$FINGER.EXE | Finger client |
UCX$FINGER_SERVER.EXE | Finger server |
UCX$FTP.EXE | FTP client |
UCX$FTPC.EXE | FTP server |
UCX$FTPD.EXE | FTP control command server (daemon) |
UCX$FTPSERVER.COM | Procedure that starts an FTP child process |
UCX$HLB.ADF | Attributes file for NFS client |
UCX$HR_MIB.EXE | SNMP Host Resources MIB |
UCX$INETACP.EXE | Network ancillary control process (NETACP) for the Internet device driver |
UCX$INETACP.STB | Global symbol definitions for UCX$INETACP.EXE |
UCX$INETDRIVER.STB | Global symbol definitions for the Internet device driver |
UCX$INTERNET_SERVICES_V6.STB+ | Global symbol definitions for UCX$INTERNET_SERVICES_V6.EXE |
UCX$INTERNET_SERVICES_V6_SEC.STB+ | Global symbol definitions for UCX$INTERNET_SERVICES_V6_SEC.EXE |
UCX$INTERNET_SERVICES.STB | Global symbol definitions for UCX$INTERNET_SERVICES.EXE |
UCX$INTERNET_SERVICES_SEC.STB | Global symbol definitions for UCX$INTERNET_SERVICES_SEC.EXE |
UCX$INET_ROUTING.EXE | Dynamic routing |
UCX$INET_ROUTING.STB | Global symbol definitions for UCX$INET_ROUTING.EXE |
UCX$LPD_RCV.EXE | Print receiver |
UCX$LPD_SMB.EXE | Print symbiont |
UCX$LPRM.EXE | LPRM command |
UCX$LPRSETUP.EXE | Setup utility for network printing |
UCX$LPQ.EXE | LPQ command |
UCX$METRIC.EXE | Metric server |
UCX$METRIC_VIEW.EXE | Metricview utility |
UCX$MIBCOMP.EXE | SNMP MIB compiler |
UCX$MLB.ADF | Attributes file for NFS client |
UCX$MOSY.EXE | MIB compiler images |
UCX$NET_GLOBALS.STB | Global symbol definitions for UCX data structures |
UCX$NSLOOKUP.EXE | NSLOOKUP utility |
UCX$NTPD.EXE | NTP service |
UCX$OBJ.ADF | Attributes file for NFS client |
UCX$OLB.ADF | Attributes file for NFS client |
UCX$OS_MIBS.EXE | MIB-II subagent image |
UCX$PCNFSD.EXE | PC-NFS server (daemon) |
UCX$POP_SERVER.EXE | POP server image |
UCX$PING.EXE | PING command image |
UCX$PORTMAPPER.EXE | Program that maps processes to ports |
UCX$RLOGIN.EXE | Remote login client |
UCX$RPCGEN.EXE | Portmapper image |
UCX$RPCINFO.EXE | SHOW PORTMAPPER command |
UCX$RSH.EXE | Remote shell |
UCX$SERVER_NFS.EXE | NFS server (daemon) |
UCX$SMTP_RECEIVER.EXE | SMTP receiver |
UCX$SMTP_SYMBIONT.EXE | SMTP symbiont |
UCX$SNMP_AGENT.EXE | SNMP agent |
UCX$SNMPI.EXE | MIB compiler images |
UCX$SNMP_REQUEST.EXE | MIB browser |
UCX$STB.ADF | Attributes file for NFS client |
UCX$TELNET.EXE | TELNET client |
UCX$TELNETSYM.EXE | TELNET print symbiont |
UCX$TFTP.EXE | TFTP server (daemon) |
UCX$TLB.ADF | Attributes file for NFS client |
UCX$TNDRIVER.STB | Global symbol definitions for UCX$TNDRIVER.EXE |
UCX$RCP.EXE | RCP image |
UCX$RMT.EXE | RMT/RCD server |
UCX$UCP.EXE | UCX Management Control Program (UCP) |
UCX$UUENCODE.EXE | UUencode program image |
UCX$UUDECODE.EXE | UUdecode program image |
UCX$VERSIONS.EXE | Image for the SHOW VERSION command |
SYS$COMMON:[SYSLIB] / SYS$LIBRARY: | |
UCX$ACCESS_SHR.EXE | Database access routines |
UCX$CFS_SHR.EXE | Container file system runtime library |
UCX$ESNMP_SHR.EXE | Sharable image version of routines in UCX$SNMP:*.OLB |
UCX$INETDEF.ADA | Internet Ada definitions file |
UCX$INETDEF.BAS | Internet BASIC definitions file |
UCX$INETDEF.FOR | Internet FORTRAN definitions file |
UCX$INETDEF.H | Internet C definitions file |
UCX$INETDEF.MAR | Internet MACRO definitions file |
UCX$INETDEF.PAS | Internet Pascal definitions file |
UCX$INETDEF.PLI | Internet PL/1 definitions file |
UCX$INETDEF.R32 | Internet BLISS definitions file |
UCX$IPC_SHR.EXE | IPC runtime library |
UCX$IPC.OLB | IPC object library |
UCX$LPD_SHR.EXE | Shared library for printing processes |
UCX$RPCXDR.H | Sun RPC header file |
UCX$RPCXDR_SHR.EXE | Sun RPC routines library |
UCX$SDA.EXE | SDA extensions |
UCX$SMTP_MAILSHR.EXE | SMTP shared library |
UCX$SMTP_PARSESHR.EXE | SMTP parsing routines |
SYS$COMMON:[UCX$LIB.RPC] / SYS$LIBRARY: | |
UCX$RPCXDR.OLB | Library file for Portmapper service |
SYS$COMMON:[UCX$LIB.SNMP] / SYS$LIBRARY: | |
UCX$ESNMP.OLB | Library file for creating SNMP subagents |
SYS$COMMON:[SYSHLP] / SYS$HELP: | |
UCX042.RELEASE_NOTES | Release notes |
UCX$FTP_HELP.HLB | FTP online help |
UCX$TELNET_HELP.HLB | TELNET online help |
UCX$NSLOOKUP_HELP.HLB | NSLOOKUP online help |
UCX$UCP_HELP.HLB | Online help for the management commands |
UCX$VMS_FILES.DOC | Online information about file restrictions for UNIX users of NFS server |
SYS$COMMON:[SYSHLP.EXAMPLES.UCX] / UCX$EXAMPLES: | |
BUILD_UCX_SECURITY_DRIVER.COM | Sample file to build the security driver |
TN3270DEF.MAR | For IBM 3270TE; translation table template that you edit to modify the translation tables |
TRACEROUTE.EXE | Traceroute facility |
UCX$CHESS_SUBAGENT.EXE | Linker image |
UCX$INTERNET_SERVICES_V6_SEC.EXE+ | Internet software with security for OpenVMS Version 6 |
UCX$INTERNET_SERVICES_V5_SEC.EXE | Internet software with security for OpenVMS Version 5 |
UCX$IOCTL_ROUTINE.C | C Programming example |
UCX$NFSSETUP.COM | NFS setup procedure |
UCX_SECURITY_DRIVER.MAR | MACRO security driver source sample |
UCX$TCP_CLIENT_IPC.C | C Programming example |
UCX$TCP_CLIENT_QIO.C | C Programming example |
UCX$TCP_CLIENT_QIO.MAR | C Programming example |
UCX$TCP_SERVER_IPC.C | C Programming example |
UCX$TCP_SERVER_IPC_AUXS.C | C programming example |
UCX$TCP_SERVER_QIO.C | C Programming example |
UCX$TCP_SERVER_QIO.MAR | MACRO Programming example |
UCX$TCP_SERVER_QIO_AUXS.C | C programming example |
UCX$TCP_SERVER_QIO_AUXS.2ND.C | C programming example |
UCX$TCP_SOCKET_QIO.3RD.C | C programming example |
UCX$TCP_SOCKET_QIO_3RD.H | Data and structure definitions that make up the exterior interface to UCX$TCP_SOCKET_QIO_3RD.C |
UCX$TRACE.EXE | Protocol trace facility |
UCX$TRACE_HAS_MOVED.EXE | Trace facility |
UCX$UDP_CLIENT_IPC.C | C programming example |
UCX$UDP_CLIENT_QIO.C | C programming example |
UCX$UDP_CLIENT_QIO.MAR | MACRO programming example |
UCX$UDP_SERVER_IPC.C | C programming example |
UCX$UDP_SERVER_QIO.C | C programming example |
UCX$UDP_SERVER_QIO.2ND.C | C programming example |
UCX$UDP_SERVER_QIO.3RD.C | C programming example |
UCX$UDP_SERVER_QIO.MAR | MACRO Programming example |
SYS$COMMON:[SYSHLP.EXAMPLES.UCX.SNMP] / UCX$EXAMPLES: | |
CHESS_METHOD.C | C programming example |
CHESS_MIB.C | C programming example |
CHESS_MIB.MY | Sample MIB chess game |
CHESS_SUBAGENT.OPT | Linker options file |
CHESS_TBL.C | C programming example |
CHESS_TBL.H | C header file |
SYS$COMMON:[SYSHLP.EXAMPLES.UCX.RPC] / UCX$EXAMPLES: | |
DIR_EXAMPLE.COM | DIR program procedure |
DIR.X | Remote OpenVMS directory listing protocol |
DIR_SERVER.C | C programming example |
MSG.X | Remote message printing protocol |
MSG_EXAMPLE.COM | Local version of PRINTMSG program procedure |
MSG_SERVER.C | C programming example |
PRINTMSG.C | C programming example |
RLS.C | C programming example |
RPRINTMSG.C | C programming example |
SYS$COMMON:[SYSMGR] / SYS$MANAGER: | |
SYS$NET_SERVICES_UCX.COM | DCL interface support procedure |
UCX$BINDSETUP.COM | BIND setup procedure |
UCX$BINDSETUP_HELP.TXT | Information about setting up the BIND server |
UCX$BIND_SHUTDOWN.COM | BIND server shutdown procedure |
UCX$BIND_STARTUP.COM | BIND server startup procedure |
UCX$BOOTP_SHUTDOWN.COM | Remote boot server shutdown procedure |
UCX$BOOTP_STARTUP.COM | Remote boot server startup procedure |
UCX$CALLBACKS.COM | Configuration procedure |
UCX$CONFIG.COM | Configuration procedure |
UCX$DNFS_SHUTDOWN.COM | NFS client shutdown procedure |
UCX$FINGER_SHUTDOWN.COM | Finger server shutdown procedure |
UCX$FINGER_SRVR_STARTUP.COM | Finger server startup procedure |
UCX$FTPD_SHUTDOWN.COM | FTP server shutdown procedure |
UCX$FTPD_STARTUP.COM | FTP server startup procedure |
UCX$INET_STARTUP.COM | Internet startup procedure |
UCX$INET_SHUTDOWN.COM | Internet shutdown procedure |
UCX$LOAD_INETDRIVER.COM | Command file that loads the SRI QIO programming interface |
UCX$LPD_RCV_STARTUP.COM | Print receiver startup procedure |
UCX$LPD_STARTUP.COM | Print server startup procedure |
UCX$LPD_SHUTDOWN.COM | Print server shutdown procedure |
UCX$METRIC_STARTUP.COM | Metric startup procedure |
UCX$METRIC_SHUTDOWN.COM | Metric shutdown procedure |
UCX$NFS_SERVER_STARTUP.COM | NFS server startup procedure |
UCX$NFS_SHUTDOWN.COM | NFS server shutdown procedure |
UCX$NFS_STARTUP.COM | NFS client startup procedure |
UCX$PCNFSD_SHUTDOWN.COM | PC-NFS server shutdown procedure |
UCX$PCNFSD_STARTUP.COM | PC-NFS server startup procedure |
UCX$PORTM_SHUTDOWN.COM | Portmapper shutdown procedure |
UCX$PORTM_STARTUP.COM | Portmapper startup procedure |
UCX$PRINTCAP.DAT | Printcap database |
UCX$REGISTER.COM | Command file that registers privileged UCX images for OpenVMS Version 6.2 |
UCX$REMOTE_TTY_STARTUP.COM | TELNET and remote login server startup procedure |
UCX$REXECD_STARTUP.COM | Remote executive startup procedure |
UCX$RSHD_STARTUP.COM | Remote shell startup procedure |
UCX$SERVICE_SETUP.COM | UCX services set up procedure |
UCX$SHUTDOWN.COM | UCX shutdown procedure |
UCX$SMTP_STARTUP.COM | SMTP queue startup procedure |
UCX$SMTP_SHUTDOWN.COM | SMTP queue shutdown procedure |
UCX$SMTP_RECV_STARTUP.COM | SMTP receiver startup procedure |
UCX$SNMP_STARTUP.COM | SNMP startup procedure |
UCX$SNMP_SHUTDOWN.COM | SNMP shutdown procedure |
UCX$SNMPD_MIR.DAT | SNMP dictionary of MIB variables |
UCX$STARTUP.COM | UCX startup procedure |
UCX$SYMBOLS.COM | Configuration logical names |
UCX$TELNET_SHUTDOWN.COM | TELNET shutdown procedure |
UCX$TFTP_SHUTDOWN.COM | TFTP shutdown procedure |
UCX$TFTP_STARTUP.COM | TFTP startup procedure |
UCX$TIMEZONE.COM | Time zone procedure |
UCX$UCP_STARTUP.COM | Management control program startup |
SYS$COMMON:[SYSMSG] / SYS$MESSAGES: | |
UCX$MSG.EXE | UCX message file |
SYS$COMMON:[SYSTEST.UCX] / SYS$TEST: | |
UCX$INET_IVP.EXE | Auxiliary server IVP |
UCX$RPCIVP_CLIENT.EXE | RPC client routines IVP |
UCX$RPCIVP_SERVER.EXE | RPC server routines IVP |
UCX$SNMPIVP.EXE | SNMP IVP |
SYS$COMMON:[SYSTEST] | |
UCX$IVP.COM | UCX IVP procedure |
SYS$COMMON:[SYSUPD] | |
UCX$CLEANUP.COM | Procedure to remove UCX software from the OpenVMS system |
UCX$CLEANUP_HELPLIB.COM | Procedure to update the UCX help library |
Table A-2 lists and describes the files for PATHWORKS systems that are installed on your system.
File | Description |
---|---|
SYS$COMMON:[SYSLIB]PWIP$SDA.EXE | PATHWORKS extensions to SDA |
SYS$COMMON:[SYSEXE]UCX$PWIPACP.EXE | PATHWORKS IP ACP |
SYS$COMMON:[SYS$LDR]UCX$PWIPDRIVER.EXE | PATHWORKS IP driver |
SYS$COMMON:[SYSEXE]UCX$PWIPDRIVER.STB | Global symbol definitions for UCX$PWIPDRIVER.EXE |
SYS$COMMON:[SYSMGR]UCX$PWIP_SHUTDOWN.COM | PATHWORKS IP driver shutdown |
SYS$COMMON:[SYSMGR]UCX$PWIP_STARTUP.COM | PATHWORKS IP driver startup |
SYS$COMMON:[SYSEXE]UCX$PWIPSHUT.EXE | PATHWORKS IP driver shutdown |
SYS$COMMON:[SYSEXE]UCX$PWIPSYM.STB | Global symbol definitions for UCX$PWIPSYM.EXE |