PMDF Installation Guide
Solaris Edition
PMDF-INST-SOL-6.0

This section presents a step-by-step procedure for generating your PMDF configuration files using the command line PMDF automatic configuration utility. The command line utility is normally used when generating a PMDF-ACCESS configuration, via the command pmdf configure access. Although typically PMDF-MTA configurations are instead generated using the web-based PMDF automatic configuration utility described in Section 5.2 , there is also a command line pmdf configure mta utility that provides an alternative for PMDF-MTA configuration for sites for whom web configuration is inconvenient. The instructions below are relevant for use of pmdf configure mta as well as for use of pmdf configure access. Refer to Chapter 7 for a sample PMDF-ACCESS configuration dialogue; see the PMDF Obsolete Features Guide for a sample PMDF-MTA configuration dialogue.

• Configuration of PMDF should be done by superuser to ensure that the necessary privileges are available to create the configuration files. If you are not logged in as root, do so now.
• Begin the configuration procedure by invoking the PMDF configuration utility as follows, assuming that you have /usr/bin in your search path:

  # cd /pmdf/table
  # pmdf configure access
  

  to configure an ACCESS system, or with

  # cd /pmdf/table
  # pmdf configure mta
  

  to configure an MTA system. Note that a system should be configured as either an ACCESS system or an MTA system, but not both.
• The configuration procedure will optionally print out detailed explanations of each prompt as it proceeds. Unless you are conversant with the procedure, you should enable the detailed output.
• The answers to all the prompts are logged to a file in the /pmdf/table directory. After the first configuration, pmdf configure can use the answers to the previous run as the default answers. The utility will ask:

  Do you want to use answers from the previous run as defaults? 
  

  Answer YES if you wish to have your previous answers presented as default answers. You may use the backslash character, \, to clear a default answer.
• If this is the first time that PMDF has been configured on this system, the configuration utility will ask if you would also like to configure the PMDF Dispatcher. (The PMDF Service Dispatcher is a resident process that listens for incoming TCP/IP connections on various ports and matches those incoming connection requests to various servers, e.g., the multithreaded SMTP server, a POP3 server, an IMAP server, an HTTP server, etc. See PMDF System Manager's Guide for a more detailed discussion of the purpose and function of the PMDF Service Dispatcher.) You should answer YES.
• If this is the first time that the Dispatcher has been configured, the utility will ask if you would also like to configure PMDF POP and IMAP mailbox servers.
• If you are planning a PMDF-ACCESS configuration, closely example the example configuration presented in Chapter 7 . Parts of the sample site are probably representative of your own network configuration. In addition, the example was run with detailed prompting enabled, and will prepare you for the answers you need to provide for your own site.
• Once you've completed running pmdf configure, type out or print out the checklist file, /pmdf/table/access.checklist for an ACCESS configuration or /pmdf/table/pmdf.checklist for an MTA configuration, and complete the configuration by following the steps outlined in the checklist.
• Note that if this is your initial configuration of PMDF, the configuration utility will ask at the end of its other tasks whether you wish to invoke the pmdf configure dispatcher utility at that time. You may either answer YES and perform the Dispatcher configuration then and there, or else answer NO and then configure the Dispatcher as a separate step subsequently, by issuing the command

  # pmdf configure dispatcher
  

  
  Note that if this is your initial configuration of the PMDF Service Dispatcher, the configuration utility will ask at the end of its other tasks whether you wish to invoke the pmdf configure mailbox_servers utility at that time. You may either answer YES and perform the Mailbox Servers configuration then and there, or else answer NO and then configure the Mailbox Servers as a separate step subsequently. The Mailbox Servers are usually configured using the web-based configuration utility, as in the later portion of the example in Chapter 6 ; note that the Mailbox Servers portion (IMAP/POP Servers) of the web-based configuration utility may be used on a PMDF-ACCESS system. Alternatively, however, the Mailbox Servers may be configured on the command line via:

  # pmdf configure mailbox_servers
  

  ---

  Previous | Next | Contents