PMDF Installation Guide
OpenVMS Edition


Previous Contents Index

1.7.5 Converting to Using the Multithreaded SMTP Server

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


Previous Next Contents Index