DIGITAL TCP/IP Services for OpenVMS
Installation and Configuration


Previous | Contents

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:

  1. Invoke the command procedure:
    $ @SYS$MANAGER:UCX$CONFIG 
    

    The main Configuration menu displays:
    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: 
    
  2. Enter option 4. The Optional Components menu displays:
     
    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 
     
    
  3. Enter the options that are appropriate for your system: the PWIP driver, the SRI QIO interface, or Anonymous FTP accounts or directories:

    3.3 Using UCX$CONFIG Option Commands

    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:

    1. Log into the SYSTEM account.
    2. Invoke the command procedure and include the appropriate options in the command line:

    @SYS$MANAGER:UCX$CONFIG
    • ALL
    • CLIENT
    • SERVER
    • MINIMUM
    • WORKSTATION
    • ENABLE
    • DISABLE

    or
    @SYS$MANAGER:UCX$CONFIG

    • ENABLE
    • DISABLE
    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).

    3.4 Starting UCX

    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:

    1. Access the main Configuration menu by entering the following command:
      $ @SYS$MANAGER:UCX$CONFIG 
      
    2. Enter option 6 to start UCX.

    3.5 Verifying the Configuration

    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:

    1. Invoke the command procedure:
      $ @SYS$MANAGER:UCX$CONFIG 
      
    2. Enter option 7. If the IVP does not complete successfully, the procedure displays error messages. All IVP errors are fatal and use the same format as system messages. For example:
      %UCX-E-IDENT, explanation of error. 
       
      

      Table 3-2 lists some common problems that cause IVP error messages. If the recommended action does not correct the problem, contact your DIGITAL support representative.

      Table 3-2 Troubleshooting IVP Errors
      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.

    3. To run the IVP any time after exiting the configuration procedure, invoke the IVP command procedure as follows:
      $ @SYS$TEST:UCX$IVP
      
    4. To activate the new configuration, reboot your system.

    3.6 Additional Configuration Tasks

    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 
    

    3.8 Automatically Starting UCX Services

    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 
    

    3.9 Specifying UCX as the Transport for DECwindows Applications

    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:

    1. Set up security on the remote host.
    2. Add the remote client to the local UCX hosts database.
    3. Edit the SYS$MANAGER:DECW$PRIVATE_SERVER_SETUP.COM command procedure by adding the following line:
      $ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP" 
      
    4. Set the display for the applications to the remote host:
      $ SET DISPLAY/CREATE/NODE=remote_host/TRANSPORT=TCPIP 
      


    Appendix A
    Installed Files

    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.

    Table A-1 UCX Files
    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


    +Specific to OpenVMS VAX

    A.2 Installed UCX Files for PATHWORKS Systems

    Table A-2 lists and describes the files for PATHWORKS systems that are installed on your system.

    Table A-2 PATHWORKS Files
    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


    Previous | Next | Contents