PMDF System Manager's Guide
PMDF-REF-6.0
Previous
| Contents
Preface
Purpose of this Manual
This manual describes the structure, configuration, and use of PMDF.
The intended audience is system managers who wish to become familiar
with how PMDF operates. In particular, this document describes many
customizable parts of PMDF that can be altered to adapt PMDF to a
particular environment. The reader is assumed to be quite familiar with
networking concepts and the operating system on which PMDF is to be
installed.
This manual does not provide a description of PMDF suitable for end
users; end users should refer to the appropriate edition of the
PMDF User's Guide .
Overview of this Manual
This guide is a long and technical document. If you are new to PMDF,
you should skim the entire document, skipping the discussion in Part 3
of those PMDF layered products which you will not be installing, as
well as the channels described in Chapters 17 --27
for which you do not have any use. Once you are somewhat familiar with
PMDF you can then perform the installation described in the appropriate
edition of the PMDF Installation Guide , referring back to this manual as needed.
PMDF is a large and complex package capable of being configured to meet
almost any task. If your site is typical of most, the initial
configuration generated by the configuration utilities will suffice to
get you up and running in a minimal amount of time. After you have an
initial configuration, study it and use it as an example as you read
the following chapters. As you become comfortable with PMDF, you will
find that you want to make changes here and there, modify the behavior
of some channels, or even add additional channels to your
configuration. Or perhaps you will want to set up some databases, or
implement a centralized naming system. By all means do so.¹ PMDF,
as you will find, has quite a few knobs and switches which you can
manipulate and more often than not you'll discover that there are not
one but several means of dealing with a given issue. If anything, PMDF
is too flexible.
This manual consists of three volumes, together comprising forty-two
chapters:
- Chapter 1, Structure and Overview , describes the overall structure of PMDF and the
components which together form PMDF.
- Chapter 2, The Configuration File: Domain Rewrite Rules & the Channel/Host Table , describes the PMDF configuration file, including
domain rewriting rules and the channel/host table, channel definitions,
and the available channel keywords.
- Chapter 3, Aliases, Forwarding, and Centralized Naming , describes the alias file and database, and other
means of changing addresses, forwarding mail, and establishing
centralized naming schemes, including the directory channel.
- Chapter 4, Mailing Lists and MAILSERV , describes mailing lists. It also describes automated
message processing via the MAILSERV channel.
- Chapter 5, The Mapping File , describes the mapping file.
- Chapter 6, Conversions , describes conversions, both internal message
reformatting conversions and external document conversions, the
conversions file, and the conversion channel.
- Chapter 7, The PMDF Option File , describes the PMDF option file.
- Chapter 8, Maintaining the Configuration: Restarting after Changes, Compiling for Efficiency , describes how to compile your PMDF configuration
information so as to decrease the time required for processing jobs to
load configuration information. It also discusses restarting PMDF
components after PMDF configuration changes.
- Chapter 9, The PMDF Process Symbiont (OpenVMS) , describes the PMDF Process Symbiont which is used to
schedule and execute PMDF processing jobs through the OpenVMS queuing
system.
- Chapter 10, The PMDF Job Controller (UNIX and NT) , describes the PMDF Job Controller which is used to
control PMDF processing jobs on UNIX and NT.
- Chapter 11, The PMDF Multithreaded Service Dispatcher , describes the PMDF Service Dispatcher which is used
to oversee the handling of multithreaded services such as the POP3,
IMAP, and SMTP services.
- Chapter 12, Miscellaneous Dispatcher Services: the HTTP Server , describes some miscellaneous Dispatcher services,
including the PMDF HTTP server which is used to serve out PMDF
documentation and monitoring information.
- Chapter 13, POP and IMAP Mailbox Servers , documents the mailbox servers (POP and IMAP servers)
supplied with PMDF.
- Chapter 14, Connection Authentication, SASL, and Password Management , describes connection authentication and password
management.
- Chapter 15, PMDF-TLS: Transport Layer Security , describes the optional layered product PMDF-TLS. In
this chapter configuration and usage instructions are given for
PMDF-TLS. PMDF-TLS provides for using Transport Layer Security to
provide data encryption and integrity checking.
- Chapter 16, Mail Filtering and Access Control , describes filtering of unwanted e-mail.
- Chapter 17, The UNIX Local Channel , describes the local channel on UNIX systems, the
single most important PMDF channel which is used by all PMDF
configurations on UNIX. The UNIX Edition of the PMDF User's Guide provides
documentation suitable for end users.
- Chapter 18, The NT Local Channel , gives an overview of the local channel (normally the
msgstore channel) on NT systems, a channel which is used by all PMDF
configurations on NT. Complete information on the msgstore channel may
be found in the PMDF popstore & MessageStore Manager's Guide .
- Chapter 19, The Local, DECnet MAIL, and General MAIL_ Channels (OpenVMS) , describes the local channel on OpenVMS systems, the
single most important PMDF channel which is used by all PMDF
configurations on OpenVMS. This chapter also describes MAIL-11 over
DECnet (called DECnet MAIL in this document) channels.
- Chapter 20, The PMDF User Interface on OpenVMS , decribes the PMDF interface presented to OpenVMS
users. The OpenVMS Edition of the PMDF User's Guide provides documentation
suitable for OpenVMS end users.
- Chapter 21, Pop-up Addressing Forms (OpenVMS) , describes the pop-up addressing forms which may be
used to address FAXes, and query LDAP/X.500 and CCSO/ph/qi directory
databases from within VMS MAIL, PMDF MAIL, and DECwindows MAIL.
Chapters 22 --27 describe how to configure
various additional PMDF channels.
- Chapter 22, DECnet Channels (OpenVMS and Digital UNIX) , describes two PMDF channels that run over DECnet
transport:
+ SMTP over task-to-task DECnet (OpenVMS and Digital UNIX only), and
+ PhoneNet over task-to-task DECnet (OpenVMS only).
- Chapter 23, TCP/IP Channels , describes one of the most important sorts of PMDF
channel, SMTP over TCP/IP channels.
- Chapter 24, BSMTP Channels: MTA to MTA Tunnelling , describes Batch SMTP channels that can be used for
MTA to MTA tunnelling.
- Chapter 25 , describes PhoneNet channels using the PhoneNet
protocol over asynchronous terminal lines or modems.
- Chapter 26 , describes UUCP channels.
- Chapter 27 , describes additional channels, including:
+ Alphanumeric pagers,
+ Paper mail (e-mail directed to a printer),
+ SMTP over an arbitrary I/O channels, and
+ VAX Notes (OpenVMS only).
- Chapter 28, The PMDF Queue to E-mail Symbiont (OpenVMS) , describes the PMDF Queue to e-mail Symbiont which
can be used to allow users of word processors to send FAXes directly
from their word processing applications.
- Chapter 29, E-mail Firewalls and Other E-mail Security Considerations , describes configuring PMDF for use as an e-mail
firewall.
- Chapter 30, Utilities on OpenVMS , documents the various PMDF utility programs
available on OpenVMS platforms.
- Chapter 31, Utilities on UNIX and NT , documents the various PMDF utility programs
available on UNIX and NT platforms.
- Chapter 32, Monitoring , describes the PMDF counters and monitoring PMDF with
DEC PolyCenter MAILbus Monitor, or with SNMP clients, or with web
clients via the PMDF HTTP CGI.
- Chapter 33, Performance Tuning , provides some ideas and hints on how to get the most
performance out of PMDF.
- Chapter 34, Maintenance and Troubleshooting on OpenVMS , provides some general guide lines for diagnosing
problems with PMDF on OpenVMS and documents some of the more common
problems that arise from time to time.
- Chapter 35, Maintenance and Troubleshooting on UNIX , provides some general guide lines for diagnosing
problems with PMDF on UNIX and documents some of the more common
problems that arise from time to time.
Chapters 36 --42 describe optional layered
products.
- Chapter 36, PMDF-DIRSYNC , describes the optional layered product PMDF-DIRSYNC.
In this chapter configuration and usage instructions are given for
PMDF-DIRSYNC. PMDF-DIRSYNC provides directory coordination and
automatic synchronization between a variety of disparate directories.
- Chapter 37, PMDF-FAX (OpenVMS) , describes the optional layered product PMDF-FAX. In
this chapter configuration and usage instructions are given for
PMDF-FAX. PMDF-FAX provides a mechanism for converting electronic mail
messages and PostScript files into Group 3 facsimiles which are then
transmitted with a FAX modem.
- Chapter 38, PMDF-LAN , describes the optional layered product PMDF-LAN. In
this chapter configuration and usage instructions are given for
PMDF-LAN. PMDF-LAN provides connectivity to LAN-based e-mail systems:
+ Lotus cc:Mail
+ Lotus Notes
+ Microsoft Mail for DOS and Windows
+ Novell MHS
+ WordPerfect Office (GroupWise)
- Chapter 39, PMDF-MR (OpenVMS) , describes the optional layered product PMDF-MR. In
this chapter, configuration and usage instructions for PMDF-MR are
given. PMDF-MR provides connectivity to Message Router, the backbone of
Digital Equipment Corporation's MAILbus product line, and Message
Router applications including:
+ Digital Office Server,
+ ALL-IN-1 Electronic Messaging,
+ DEC MailWorks,
+ Teamlinks, and
+ other Message Router (MAILbus) applications. Note that such DEC user
agents if connected to DEC Mailbus 400 instead of DEC Message Router
are supported via PMDF-MB400 or PMDF-X400.
- Chapter 40, PMDF-MB400 (OpenVMS and Digital UNIX) , describes the optional layered product PMDF-MB400.
In this chapter, configuration and usage instructions for PMDF-MB400
are given. PMDF-MB400 (OpenVMS or Digital UNIX) provides connectivity
to Digital Equipment Corporation's MAILbus 400 product line.
- Chapter 41, PMDF-X400 (OpenVMS and UNIX) , describes the optional layered product PMDF-X400. In
this chapter, configuration and usage instructions for PMDF-X400 are
given. PMDF-X400 provides connectivity to Message Transfer Agents
employing the X.400-1992, X.400-1988, and X.400-1984 P1/P2 protocol.
Transport services can be provided either by TCP/IP (using RFC 1006 to
implement the necessary ISO functionality) or by OSI Transport
Services. In particular, PMDF-X400 supports:
+ X.400-1992, X.400-1988, and X.400-1984 (using RTSE) over TCP/IP (RFC
1006)
+ X.400-1992, X.400-1988, and X.400-1984 (using RTSE) over OSI CLNS
+ X.400-1992, X.400-1988, and X.400-1984 (using RTSE) over OSI CONS
(X.25)
- Chapter 42, PMDF-XGS , describes the optional layered product PMDF-XGS. In
this chapter, configuration and usage instructions for PMDF-XGS are
given. PMDF-XGS provides connectivity to SNADS mail systems, supporting
SNADS over SNA.
Suggested starting points in this manual
PMDF includes a spectrum of features; the precise features of interest
will vary greatly from site to site. A first reading of this manual
might focus on a careful reading of Chapter 1 and Chapter 33 , and
then skimming Section 2.2 (omitting Section 2.2.6 on first reading),
Section 2.3.1 , Section 2.3.2 , Section 2.4 , Section 3.1 , the
beginning of Chapter 5 , Chapter 8 , the beginning of
Chapter 9 (for OpenVMS sites) or Chapter 10 (for UNIX sites), the
beginning of Chapter 11 , if using POP or IMAP then Chapter 13 ,
any channels discussed in Chapter 17 through Chapter 27 which you
will be using (with particular attention to Chapter 23 discussing
TCP/IP channels which are one of the most important sorts of channels
for most sites), and Section 32.1 .
Mail user agents
This manual focuses on PMDF's function as a Message Transfer Agent
(MTA), to provide a uniform message distribution network that can be
interfaced to multiple user interfaces (Mail User Agents, or MUA's).
For further information on user interfaces, see documentation for that
user agent, or the appropriate edition of the PMDF User's Guide . For
instance:
On OpenVMS systems, PMDF uses the standard VMS MAIL facility as its
primary
user interface. PMDF also supplies a VMS MAIL-compatible user interface
of
its own, PMDF MAIL. PMDF MAIL is an extension of VMS MAIL which better
understands network messaging (e.g., supports RFC 822 and
MIME) and
uses the same message store as VMS MAIL. PMDF Pine, a port of the
popular
UNIX mail user agent Pine to OpenVMS, is also supplied as part of PMDF
for
OpenVMS and also uses the same message store as VMS MAIL. Information
on PMDF
MAIL and the OpenVMS-specific implementation details of PMDF Pine may
be found
in the OpenVMS Edition of the PMDF User's Guide . PMDF also supports
Gold-Mail.
The optional layered product PMDF-MR provides transparent support for
MAILbus
agents such as ALL-IN-1 and A1MAIL.
On UNIX systems, PMDF can use as its mail user interface any such
interface
which normally submits its messages using sendmail or SMTP. For
convenience,
the PMDF distribution includes a copy of one such mail user interface
for
UNIX, the University of Washington's Pine.
Availability
PMDF software products are marketed directly to end users in North
America, and either directly or through distributors in other parts of
the world depending upon the location of the end user. Contact Innosoft
for ordering information, to include referral to an authorized
distributor where applicable:
- Innosoft International, Inc.
1050 Lakes Drive
West Covina, CA 91790 USA
+1 626 919 3600
+1 626 919 3614 (FAX)
sales@innosoft.com
Credits
PMDF was originally developed by Ira Winston of the Department of
Computer and Information Science at the University of Pennsylvania, Ned
Freed of the Department of Mathematics at Oklahoma State University,
Mark Vasoll of the Department of Computer and Information Sciences at
Oklahoma State University, and Kevin Carosso of the Space and
Communications Group of Hughes Aircraft. Further development of PMDF is
now being coordinated by Innosoft International, Inc. Contributors
include Todd Aven, who contributed the MAKE facility used to build
PMDF; Scott Ballew, who developed PMDF's logging facility; Goran
Bengtson, who developed an SMTP over X.25 channel; Dennis Boylan, who
developed the original UUCP channel programs; John Carosso, who
developed much of the early BITNET support; Gerson Cohen, who developed
the original support for ANJE; Mike Iglesias, who provided numerous
command files and other enhancements; Warwick Jackson, who developed
several channel programs; Matts Kallioniemi, who provided many
enhancements; Pekka Kytolaakso, who provided enhancements to BSMTP for
BITNET channels; Marc Shannon, who provided enhancements to the Jnet
channel; Robert Smart, who provided numerous enhancements to the PMDF
interface to VMS MAIL; Larry Snodgrass, who contributed to the BITNET
documentation; Klaus Steinberger, who enhanced generation of PMDF
configuration information from BITNET NAMES files; Robert Stodola, who
implemented the original MX record lookup support for the CMU-Tek
TCP/IP channel; Don Stokes, who enhanced the DEC/Shell UUCP channel to
support DECUS UUCP; Mike Sullenberger, who provided additional command
file enhancements; Bob Tinkelman, who provided additional command file
enhancements; Gregg Wonderly, who developed the CTLSMB detached process
symbiont and provided many enhancements as well; and Craig Watkins who
provided the low level IXO interaction routines for the pager channels.
The development of PMDF would not have been possible without the
enthusiastic support of the PMDF user community, and the developers of
PMDF would like to thank the many users of PMDF (both the contributors
listed above as well as others too numerous to list here) for their
help and suggestions that have helped to make PMDF a better product.
Note
¹ There are, of course, some problems best
left alone or for which what seems the obvious solution is not really a
good one. When in doubt just ask.
Previous
| Next
| Contents