PMDF System Manager's Guide
Preface
Purpose of This Manual
This manual describes the structure, configuration, and use of PMDF.
The intended audience is system managers who want 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 4
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.1
PMDF, as you will find, has quite a few knobs and switches which you
can manipulate and more often than not you will 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 four volumes, together comprising forty-one
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, 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, The PMDF 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 Tru64 UNIX), describes two PMDF channels that run over DECnet
transport:
+ SMTP over task-to-task DECnet (OpenVMS and Tru64 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.
- 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
Compaq Computer Corporation's MAILbus product line, and Message Router
applications including:
+ Compaq 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 Tru64 UNIX), describes the optional layered product PMDF-MB400. In
this chapter, configuration and usage instructions for PMDF-MB400 are
given. PMDF-MB400 (OpenVMS or Tru64 UNIX) provides connectivity to
Compaq Computer 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)
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 Process
Software for ordering information, to include referral to an authorized
distributor where applicable:
- Process Software, LLC
959 Concord Street
Framingham, MA 01701 USA
+1 508 879 6994
+1 508 879 0042 (FAX)
sales@process.com
Note
1 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.
|