Example 8-1 shows configuring the PMDF POP3 and IMAP mailbox servers.

Whenever appropriate, each prompt supplies a default answer which is enclosed within square brackets. Simple pressing return, [RETURN], selects the default answer.

Remember that the values entered in this sample are for purposes of example only. Be sure to use the values appropriate foryour system when you performthe actual configuration.

Example 8-1 Sample PMDF CONFIGURE MAILBOX_SERVERS dialogue

$ pmdf configure mailbox_servers PMDF mailbox servers configuration utility, V6.8 This utility creates the following files PMDF_TABLE:DISPATCHER_MAILBOX_SERVERS.CNF PMDF_TABLE:POP3D.CNF if native mail file is selected PMDF_TABLE:IMAPD.CNF if native mail file is selected PMDF_TABLE:IMAPPOP.CNF if MessageStore or popstore is selected PMDF_TABLE:MSGSTORE.CHANS if MessageStore or popstore is selected PMDF_TABLE:MSGSTORE.RULES if MessageStore or popstore is selected PMDF_TABLE:MSGSTORE_OPTION. if MessageStore or popstore is selected PMDF_TABLE:POPSTORE_OPTION. if MessageStore or popstore is selected Do you wish to continue [Y]? [RETURN] Do you wish to have a detailed explanation printed before each question [N]? YES Enter YES if you want to use a POP3 server in PMDF. Enter NO if you do not want any POP3 server at all. Do you wish to run a POP3 server [Y]? [RETURN] POP server (1) Native VMS MAIL mail files and popstore (2) MessageStore and popstore There are currently two POP servers in PMDF: Choosing (1) will select the POP server which serves out native VMS MAIL mail files or popstore messages depending on if the user has an account in popstore. The POP3 server looks for user account in popstore first; if user does not have a popstore account, then his native VMS MAIL mail file is served out. This allows you to migrate POP3 only users to the more efficient popstore. popstore is optimized for POP3 access. MessageStore is optimized for IMAP, but also can be used for POP. Native mail is not optimized for either POP or IMAP. If most of your users only use POP, then we recommend you choose (1) and put users in popstore. If most of your users use IMAP, then we recommend you use Message Store, and put your users in MessageStore while specifying each as either a POP or IMAP user. Choose (2) to use MessageStore for your POP users also. What do you want to use with this server [1]? 2 Enter the maximum number of connections you want to support concurrently on your system. Each POP3 user would normally have one connection when they connect to the server. MAXIMUM concurrent POP3 connections you want supported on this system [25]? [RETURN] Enter the maximum number of connections you want to support concurrently for each POP server process. MAXIMUM concurrent POP3 connections to allow per server process [5]? [RETURN] Enter YES if you want to turn on support for the POP3 command UIDL. Do you want the POP3 server to support the UIDL command [Y]? [RETURN] Enter YES if you want to use an IMAP server in PMDF. Enter NO if you do not want any IMAP server at all. Do you wish to run an IMAP server [Y]? [RETURN] IMAP server (1) Native VMS MAIL mail files (2) MessageStore There are currently two IMAP servers in PMDF: Choosing (1) will select the IMAP server which serves out native VMS MAIL mail files Choosing (2) will select the IMAP server which serves out the mail in the MessageStore. MessageStore is optimized for IMAP but also can be used for POP. Native mail is not optimized for either POP or IMAP. If you wish to serve out both native mail and MessageStore, you have to run the two servers on different ports, and you have to configure it manually. This procedure does not produce such a configuration for you. Choose the one you want to have on the standard IMAP port, and add the other one manually later to your dispatcher_mailbox_servers.cnf file. It is easier to choose the MessageStore and manually add the native mail than vice versa. What do you want to use with this server [1]? 2 Enter the maximum number of connections you want to support concurrently on your system. Each IMAP user would normally have several connections when connected to the server, and some may last hours or days. MAXIMUM concurrent IMAP connections you want to support on this system [25]? [RETURN] Enter the maximum number of connections you want to support concurrently per IMAP server process. MAXIMUM concurrent IMAP connections to allow per server process [5]? [RETURN] Enter YES if you want to log POP and/or IMAP connection information in the PMDF mail.log_current file. Do you wish to log connections [N]? YES Enter the domain name to associate with the msgstore; e.g., msgstore.example.com. Domain name corresponding to MessageStore/popstore []? msgstore.example.com Enter the default message quota in Kbytes where 1 Kbyte is 1024 bytes. Users may not receive new mail messages when their current storage usage is at or exceeds the sum of their message quota and message overdraft quota. A message quota of zero conveys unlimited storage quota. Default message quota in Kbytes [10240]? [RETURN] Enter the default message overdraft quota in Kbytes where 1 Kbyte is 1024 bytes. The overdraft quota is the amount by which users may exceed their account quota. Default message overdraft quota in Kbytes [512]? [RETURN] Enter the name to reserve for posting to public folders, so that sending to "post+foo" will go into that "Public Folders/foo" if permissions permit, Name to reserve for posting to public folders [post]? [RETURN] Enter YES if you wish to permit public posting to public folders by default, and NO if you do not. Should public folders default to permit public posting [Y]? [RETURN] Enter the name of the file for the Mailbox Servers to be included in the Dispatcher configuration. PMDF Mailbox Servers configuration file name [PMDF_TABLE:DISPATCHER_MAILBOX_SERVERS.CNF]? [RETURN] Enter the name of the POP/IMAP server configuration option file. IMAP/POP server for the MessageStore configuration option file name [PMDF_TABLE:IMAPPOP.CNF]? [RETURN] Enter the name of the MessageStore/popstore channel definition file. MessageStore channel definitions file name [PMDF_TABLE:MSGSTORE.CHANS]? [RETURN] Enter the name of the MessageStore/popstore rewrite rules file. MessageStore rewrite rules file name [PMDF_TABLE:MSGSTORE.RULES]? [RETURN] Enter the name of the MessageStore channel option file. MessageStore/popstore channel option file name [PMDF_TABLE:MSGSTORE_OPTION.]? [RETURN] Enter the name of the popstore channel option file. (It is used by the MessageStore also.) popstore option file name [PMDF_TABLE:POPSTORE_OPTION.]? [RETURN] >>> WARNING WARNING WARNING <<< WARNING: If you have popstore accounts which were created with USERNAME_STYLE other than 3 (including all popstore accounts created by versions prior to PMDF 6.0), then running this configuration utility could make those accounts inaccessible. Please see Sections 1.3.1 and 3.3 of the MessageStore and popstore Manager's Guide for information on the USERNAME_STYLE option. >>> WARNING WARNING WARNING <<< This procedure generates a checklist file that contains the list of steps you must perform in order to complete your PMDF configuration. This procedure does *NOT* perform these steps itself; you must do them manually. PMDF checklist file name [PMDF_TABLE:MAILBOX_SERVERS.CHECKLIST]? [RETURN] This question gives you a last chance to change your mind before any files are written. Answer NO if you are not sure you want to generate the configuration you have specified. Answer YES if you do. Do you wish to generate the configuration files [Y]? [RETURN] Generating the file PMDF_TABLE:dispatcher_mailbox_servers.cnf... Generating the file PMDF_TABLE:IMAPPOP.CNF... Generating the file PMDF_TABLE:MSGSTORE.RULES... Generating the file PMDF_TABLE:MSGSTORE.CHANS... Generating the file PMDF_TABLE:MSGSTORE_OPTION.... Generating the file PMDF_TABLE:POPSTORE_OPTION.... Spawning a subprocess to create a default user account... popstore "default" user account successfully created Generating the checklist file, PMDF_TABLE:MAILBOX_SERVERS.CHECKLIST... *********************************************************************** * * To complete your PMDF configuration, carry out the steps * detailed in the checklist file PMDF_TABLE:MAILBOX_SERVERS.CHECKLIST. * *********************************************************************** Enter YES if you want to see the checklist now. You can still type the file out later if you say NO. Do you want to see the checklist now [Y]? [RETURN] Checklist for completing the setup of your PMDF POP and IMAP servers Written by SYSTEM, 16-Nov-2011 13:23:51 This file was created by the PMDF configuration generator V6.8 (1) Be sure to shutdown any POP/IMAP servers currently running, and if they were not running under the PMDF Dispatcher, you should disable them using whatever method is appropriate for them so they won't interfere the next time the system reboots. (2) Uncomment the line in the file PMDF_DISPATCHER_CONFIG which looks like: !<PMDF_TABLE:dispatcher_mailbox_servers.cnf so that it looks like: <PMDF_TABLE:dispatcher_mailbox_servers.cnf (3) Uncomment the lines in the file PMDF_TABLE:HTTP.CNF for popstore and/or MessageStore cgi if you want to enable web-based access to MessageStore/popstore User Interface, popstore Administration, and/or MessageStore Administration. (4) Changes to existing configuration files won't be seen until you restart the Dispatcher with the command pmdf restart dispatcher for your node only, or pmdf restart/cluster dispatcher for all nodes in the cluster (5) If you want the SMTP/POP/IMAP connections to be logged to a different file other than the mail.log_current file, then set SEPARATE_CONNECTION_LOG=1 LOG_CONNECTION=3 in the PMDF option file, option.dat.