In this section, a cook book approach is used to demonstrate how to set up a Lotus Notes configuration.
for use by the PMDF Notes Gateway Server Add-ins. Note that the PMDF Notes Server Add-ins do not create the path for the temporaries they create: if the necessary directory or directories do not exist, the Gateway will not be able to process messages.
- Install the PNGATECIN and PNGATECOUT programs on the PC server system. For this example, we suppose that the PC server system is an NT Intel system. So we copy the NT Intel version of the PMDF Notes Gateway Server Add-in images,
pngatecin.exe, from the
/pmdf/other/nt-intel/notes(UNIX) directory on the PMDF system, or directly from the
\other\nt-intel\notes(NT) directory on the PMDF distribution CD-ROM (an ISO standard CD-ROM directly readable from many platforms including most PC operating systems) to the Lotus Notes program directory on the NT Intel system.
- Configure options for the PMDF Notes Gateway Server Add-ins. Edit the Lotus Notes initialization file,
notes.ini, which on NT based servers can be usually be found in the
\winntdirectory. Add the following lines to this file:
Here we have selected the Lotus Notes domain name
PNGateDomain=PMDF PNGateInTemp=c:\tmp\ PNGateHost=mailhub.example.com PNGateInPort=9972 PNGateOutPort=9971 PNGateInterval=2 MailTimeout=72 PNGateCharSet=l_cp850.cls
PMDFas the domain name to which Lotus Notes users will address messages they want to have go through PMDF. The Lotus Notes server will run the PMDF Notes Gateway Server Add-ins (the PNGATECOUT and PNGATECIN programs) every two minutes. When PNGATECOUT runs, it will find any messages addressed to the Lotus Notes domain
PMDFand send them to the PMDF system; when PNGATECIN runs, it will find any messages in the PMDF system's Lotus Notes channel directory and send them to Lotus Notes.
- Have the Lotus Notes server start up PNGATECOUT and PNGATECIN. Add PNGATECOUT and PNGATECIN to the
notes.ini, file ServerTasks line, i.e.,
so that the Lotus Notes server will start up PNGATECOUT and PNGATECIN automatically next time the Lotus Notes server software is restarted. If it is convenient for you to restart the Lotus Notes server software now, then restart it so that it starts up the PNGATECOUT and PNGATECIN tasks; otherwise, you can manually start PNGATEC up at this time without having to restart the Lotus Notes server by issuing the commands
from the Lotus Notes server console.
LOAD PNGATECOUT LOAD PNGATECIN
- Add the Lotus Notes domain corresponding to PMDF to the Lotus Notes server. With a Lotus Notes client, use the Domain/Foreign form to add a foreign domain record to the Lotus Notes server's Public Name & Address Book. Set the fields as follows:
Foreign domain name: PMDF Gateway server name: EXAMPLE Gateway mail file name: pngate.nsf
EXAMPLEis assumed to be the Lotus Notes server's name for itself.
- Add rewrite rules to your PMDF configuration. Now, suppose that the local Lotus Notes domain is named EXAMPLE and the official local host name for the system running PMDF is EXAMPLE.COM. Then, a suitable domain name to associate with the EXAMPLE Lotus Notes domain might be notesmail.example.com. You need rewrite rules in your PMDF configuration file corresponding to these values. The PMDF-LAN configuration utility would create a file
lan.rulesof such rules, suitable for inclusion into the PMDF configuration file;if you have run it, you need merely uncomment the reference to
lan.rulesOtherwise, edit the PMDF configuration file,
/pmdf/table/pmdf.cnfon UNIX, to include the rewrite rules:
Add these rules towards the top of the file. They must appear before the first blank line in the file. Also, be sure to not introduce any blank lines to the file at this stage.
notesmail $u%notesmail.example.com notesmail.example $u%notesmail.example.com notesmail.example.com $email@example.com
- Define the ln_local channel. The PMDF-LAN configuration utility would create a file
lan.chansdefining such a channel, suitable for inclusion into the PMDF configuration file;if you have run it, you need merely uncomment the reference to
lan.chans. Otherwise, add the following channel definition to the
pmdf.cnffile. To the very end of the file, add a blank line followed by these two lines:
When you have finished adding these lines, save the configuration file. If you are using a compiled configuration, then be sure to recompile and reinstall your configuration.
ln_local slave defragment charset8 ibm850 notesmail.example.com
- Create the option file. The PMDF-LAN configuration utility would create a suitable file
ln_local_option; if you have run it, you need do nothing at this step. Otherwise, create the world readable file
ln_local_optionin the PMDF table directory,7 containing lines such as:
ACCESS_METHOD=3 LN_GATEWAY_NAME=PMDF LN_DEFAULT_DOMAIN=EXAMPLE
- Configure the Dispatcher to handle the Lotus Notes channel. If you have not previously used the PMDF Service Dispatcher, you will need to start by generating a basic Dispatcher configuration to which the Lotus Notes channel will be added; see Chapter 11 for details on configuring the Dispatcher. As for adding the Lotus Notes channel to the Dispatcher configuration, the PMDF-LAN configuration utility will create a file
dispatcher_lan.cnfsuitable for inclusion into the Dispatcher configuration file. If you have run the PMDF-LAN configuration utility, you need merely to uncomment the reference to
Otherwise, add the following channel definition to the Dispatcher configuration file. To the very end of the file, add the following:
! [SERVICE=LN_LOCAL_SLAVE] PORT=9971 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=9972 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
- Add a PORT_ACCESS mapping blocking outside access to the Lotus Notes channel ports. To prevent other systems connectiong to PMDF and pretending to be the Notes server, you will want to add PORT_ACCESS mapping entries disallowing such connections. In your PMDF mapping file (see Chapter 5 for details about the location and format of the PMDF mapping file), add PORT_ACCESS entries such as
That ensures that only the Notes server (address 184.108.40.206) can connect to PMDF on ports 9971 and 9972.
PORT_ACCESS TCP|*|9971|220.127.116.11|* $Y TCP|*|9972|18.104.22.168|* $Y TCP|*|9971|*|* $N TCP|*|9972|*|* $N
- Restart the Dispatcher so that the changes take effect. You will need to restart the Dispatcher so that it starts up the new services and the new PORT_ACCESS controls.
- Send a test message to Lotus Notes. At this point you should be able to send mail back and forth. From a UNIX mail client such as mail, you can send mail to the Lotus Notes user
John Smithusing the address
or from Pine using the address
Next time PNGATECIN runs, the message should appear in the user's inbox. If you want to stop and restart PNGATECIN manually to force the message through immediately rather than waiting for the Lotus Notes server to execute the PNGATECIN task, issue the commands
at the Lotus Notes server console.
TELL PNGATECIN QUIT LOAD PNGATECIN
- Sending a test message from Lotus Notes. Address mail to the PMDF Lotus Notes domain with an address such as
The next time PNGATECOUT runs, the message should get extracted from Lotus Notes and sent to PMDF. Or if you want to stop and restart PNGATECOUT manually to force the message through immediately rather than waiting for the Lotus Notes server to execute the PNGATECOUT task, issue the commands
firstname.lastname@example.org @ PMDF
at the Lotus Notes server console.
TELL PNGATECOUT QUIT LOAD PNGATECOUT
7 I.e., create the file