PMDF Installation Guide
OpenVMS Edition

If you are upgrading from an earlier version of PMDF and have been using one of PMDF's older single-threaded, TCP/IP-package-specific, TCP/IP channels, you must convert to using the new, higher performance multithreaded TCP/IP channel as the old single-threaded channels are no longer provided. The steps in converting to using the multithreaded SMTP server are as follows:

1. Modify your PMDF configuration file, PMDF_TABLE:pmdf.cnf, by converting any old xtcp_* channels to tcp_* channels. For instance, if you previously had channel definitions of

   ptcp_local smtp single_sys mx PTCP-DAEMON ptcp_internal smtp single_sys mx PTCP-INTERNAL

   you should modify your configuration to be

   tcp_local smtp single_sys mx PTCP-DAEMON tcp_internal smtp single_sys mx PTCP-INTERNAL

2. If using a compiled PMDF configuration, recompile and reinstall it to get these configuration changes to take effect.
3. Disable the old single threaded, TCP/IP-package-specific, PMDF SMTP server, as discussed in more detail below.
4. Configure the PMDF Dispatcher, as described in Chapter 5 and Chapter 6.
5. When the Dispatcher is configured, start it with the command:

   $ PMDF STARTUP DISPATCHER

   Starting the Dispatcher starts the new, multithreaded SMTP server.

6. Note that if there are any old, existing processes on your system that have been submitting messages to the old xtcp_* channels, such old processes may continue to try to submit to the old channel until the old process terminates. So unless you are making this configuration change on a system that has no other users or processes, you need to keep an eye out for new message files appearing in the old PMDF_QUEUE:[xtcp_*] directories as long as the old processes continue to run. If you see any such message files showing up, then to get such messages delivered you need to manually move the message files to the corresponding new PMDF_QUEUE:[tcp_*] directories, making sure to change the filename slightly in the process (say from *.00 to *.01), and issue the command:

   $ PMDF CACHE/SYNCH

   The messages will then get delivered the next time the PMDF periodic delivery job runs. Or if you want them to get an immediate delivery attempt, you can release the PMDF periodic delivery job which should be holding in the MAIL$BATCH queue.

Disabling a PMDF UTCP SMTP server

To disable a previous PMDF UTCP channel's SMTP server, issue the commands:

$ UCX UCX> DISABLE SERVICE SMTP UCX> SET NOSERVICE SMTP UCX> SET CONFIGURATION DISABLE SERVICE SMTP UCX> EXIT

If your site was previously using the PMDF UCX_SMTPD dispatcher, you must also delete that process; it will have a process name of UCX/PMDF server. Also remove any command from your system startup that starts up that process; e.g., remove any commands such as:

$ @PMDF_COM:start_ucx_smtpd.com

Disabling a PMDF PTCP SMTP Server

To disable a previous PMDF PTCP's channel SMTP server, issue the commands:

$ RUN TCPWARE:netcu NETCU REMOVE SERVICE 25 TCP NETCU EXIT

Or if you are running Process Software TCPware V5.3, you can disable the SMTP server using the interactive configuration tool

$ @TCPWARE:CNFNET TCP

by answering NO to the question regarding using the SMTP server, along the lines of:

Do you want to use the SMTP Mail Transfer Agent?

When you have disabled the SMTP server native to Process Software TCPware, or a previous PMDF PTCP channel, TCPware should then be shutdown and restarted with the commands:

$ @TCPWARE:shutnet.com $ @TCPWARE:startnet.com

If you have TCPware installed in a cluster environment you must restart TCPware on every node in the cluster to ensure that each node knows about the change.

Disabling a PMDF MTCP SMTP Server

To disable a previous PMDF MTCP channel's SMTP server, issue the commands:

$ MULTINET CONFIGURE/SERVERS SERVER-CONFIG> DISABLE SMTP SERVER-CONFIG> RESTART SERVER-CONFIG> EXIT

If you have MultiNet installed in a cluster environment you must restart MultiNet on every node in the cluster to ensure that each node knows about the change.

Disabling a PMDF WTCP SMTP Server

To disable a previous PMDF WTCP channel's SMTP server, edit the PathWay Access servers.dat database and comment out the SMTP service definition. For instance, such a commented out definition might appear as follows, if PMDF previously had been using a single threaded PathWay TCP/IP channel:

# SMTP # service-name SMTP # program PMDF_EXE:WTCP_SLAVE.EXE # socket-type SOCK_STREAM # socket-options SO_ACCEPTCONN | SO_KEEPALIVE # socket-address AF_INET , 25 # working-set 1024 # maxservers 4 # priority 4 # INIT TCP_Init # LISTEN TCP_Listen # CONNECTED TCP_Connected # SERVICE Run_Program

Next, delete the INET_SERVERS process. Restart the INET_SERVERS process by issuing the command:

$ @TWG$TCP:[NETDIST.MISC]INETSERV.COM