PMDF System Manager's Guide

PMDF can connect to multiple Lotus Notes servers through a single channel, if those Lotus Notes servers have been configured to communicate with each other and to route messages out to the Internet to the Lotus Notes server which connects directly to PMDF. Rewrite rules can be used to associate multiple pseudodomains corresponding to multiple Lotus Notes domains with a single channel. For instance, suppose Lotus Notes domains HQ, ADMIN, and CS are all accessible through a single Lotus Notes server. Then rewrite rules might appear as

hq.lnotes.example.com $U%HQ@lnotes.example.com admin.lnotes.example.com $U%ADMIN@lnotes.example.com cs.lnotes.example.com $U%CS@lnotes.example.com

where the corresponding channel definition might appear as

ln_local slave defragment charset8 ibm850 lnotes.example.com

Alternatively, sites with administratively separate Lotus Notes servers can prefer to set up a separate channel for connecting to each separate Lotus Notes server. To set up separate channels, you will need to follow the steps described in Section 38.6.4 on each Lotus Notes server which is to have its own channel, and follow steps analogous to those described in Section 38.6.5 for each separate channel on the PMDF side. In particular, each new channel on the PMDF side must be given a unique name, ln_uniquestring and unique official host name (pseudodomain name), and the Dispatcher must be configured with a new master and slave service for each such channel.

For instance, suppose a site has three Lotus Notes servers to be called hq.lnotes.example.com, admin.lnotes.example.com, and cs.lnotes.example.com. In such a case the rewrite rules, usually stored in the lan.rules file, might appear as

hq.lnotes.example.com $U@hq.lnotes.example.com admin.lnotes.example.com $U@admin.lnotes.example.com cs.lnotes.example.com $U@cs.lnotes.example.com

with channel definitions such as

ln_local slave defragment charset8 ibm850 hq.lnotes.example.com ln_admin slave defragment charset8 ibm850 admin.lnotes.example.com ln_cs slave defragment charset8 ibm850 cs.lnotes.example.com

The PMDF Service Dispatcher will also need to be configured to handle these new channels. The service definitions might appear on UNIX as

! ! Definitions for the ln_local channel ! [SERVICE=LN_LOCAL_SLAVE] PORT=slave-port-1 IMAGE=/pmdf/bin/lnplc_slave LOGFILE=/pmdf/log/ln_local_server_slave.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_local ! [SERVICE=LN_LOCAL_MASTER] PORT=master-port-1 IMAGE=/pmdf/bin/lnplc_master LOGFILE=/pmdf/log/ln_local_server_master.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_local ! ! Definitions for the ln_admin channel ! [SERVICE=LN_ADMIN_SLAVE] PORT=slave-port-2 IMAGE=/pmdf/bin/lnplc_slave LOGFILE=/pmdf/log/ln_admin_server_slave.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_admin ! [SERVICE=LN_ADMIN_MASTER] PORT=master-port-2 IMAGE=/pmdf/bin/lnplc_master LOGFILE=/pmdf/log/ln_admin_server_master.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_admin ! ! Definitions for the ln_cs channel ! [SERVICE=LN_CS_SLAVE] PORT=slave-port-3 IMAGE=/pmdf/bin/lnplc_slave LOGFILE=/pmdf/log/ln_cs_server_slave.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_cs ! [SERVICE=LN_CS_MASTER] PORT=master-port-3 IMAGE=/pmdf/bin/lnplc_master LOGFILE=/pmdf/log/ln_cs_server_master.log MIN_PROCS=1 MAX_PROCS=1 MIN_CONNS=1 MAX_CONNS=1 PARAMETER=channel=ln_cs

where slave-port-1 and master-port-1 are the ports the Lotus Notes server serviced by the ln_local channel is configured to use, as described in Section 38.6.4, where slave-port-2 and master-port-2 are two different ports the Lotus Notes server serviced by the ln_admin channel is analogously configured to use, and where slave-port-3 and master-port-3 are two still different ports the Lotus Notes server serviced by the ln_cs channel is configured to use.

In addition, it is essential to set up a PORT_ACCESS mapping to ensure that only the correct Lotus Notes servers can connect to their respective ports and in particular, that no unauthorized system can connect to the master ports for the channels. For instance,

PORT_ACCESS TCP|*|master-port-1|notes-server-1-ip|* $Y TCP|*|slave-port-1|notes-server-1-ip|* $Y TCP|*|master-port-1|*|* $N TCP|*|slave-port-1|*|* $N TCP|*|master-port-2|notes-server-2-ip|* $Y TCP|*|slave-port-2|notes-server-2-ip|* $Y TCP|*|master-port-2|*|* $N TCP|*|slave-port-2|*|* $N TCP|*|master-port-3|notes-server-3-ip|* $Y TCP|*|slave-port-3|notes-server-3-ip|* $Y TCP|*|master-port-3|*|* $N TCP|*|slave-port-3|*|* $N

where notes-server-1-ip, notes-server-2-ip, and notes-server-3-ip are the IP addresses of the three sample Lotus Notes servers, the HQ, ADMIN, and CS servers respectively, and where the master and slave port numbers are those specified in the Dispatcher configuration for these respective three servers' use.