The following is a list of tasks which must be completed following a new installation of PMDF.

1. For an initial PMDF installation, load the appropriate PMDF license by entering your license information into the appropriate PMDF license file. PMDF license information is stored in files with names of the form product-name.license, located in the PMDF table directory. You will have a separate license file for each PMDF product you have licensed for the system in question. For instance, a PMDF-MTA license would be stored in a file named /pmdf/table/PMDF-MTA-SUN.license.
   You should have received the correct license information for your system when you licensed PMDF. A PMDF-MTA system will need a PMDF-MTA-SUN license.
   If you will also be installing any add-on layered product such as PMDF-LAN, then for each such layered product, an additional license will be required, named, e.g., PMDF-LAN-SUN; note that such layered products can only be licensed and installed on a system already licensed for PMDF-MTA.
   A PMDF license file has the format:

   Issuer:Process Authorization Number:auth-number Product Name:product-name Producer:Innosoft Product Release Date:release-date Product Token:token Checksum:checksum

   where auth-number, token, release-date, and checksum are specific to your PMDF license, and where product-name is a product name such as PMDF-MTA-SUN, PMDF-DIRSYNC-SUN, PMDF-LAN-SUN, PMDF-POPSTORE-SUN, PMDF-MSGSTORE-SUN, PMDF-XGS-SUN, PMDF-X400-SUN, or PMDF-TLS-SUN.
   Check that the release date for each product, i.e., the value on the fifth line of the file, is later than the release date of the current version of each PMDF product you have installed. PMDF licenses allow operation of PMDF software released before the license release date. New PMDF product licenses are issued when your maintenance contract is renewed, not when new versions of software are released.
   

2. PMDF documentation assumes that your UNIX shell process includes /usr/bin in the shell's search path, thereby making the pmdf command available in the form documented. If this is not the case, then you may either add /usr/bin to your shell's search path, or use the fully qualified command name, /usr/bin/pmdf.
   
3. Create PMDF's site specific configuration files using the automatic configuration generation utility; see Chapter 3. e.g., for a PMDF-MTA system, issue the command:

   # /pmdf/bin/http_server -s

   and then point your web browser (Netscape version 3.0 or later, or Microsoft Internet Explorer version 4.0 or later), with JavaScript enabled, at

   http://localhost:7633/

   Refer to Chapters 3 and 5 (PMDF-MTA regular configuration), Chapters 14 and 15 (PMDF-MTA firewall configuration), for information, step-by-step procedures, and an example configuration.
   

4. Once you have generated an initial configuration, you should take whatever additional steps may be required to complete the configuration of PMDF. The automatic configuration generator produces a check list which details any additional steps required to complete the configuration of PMDF. Make sure to look over this checklist file.
   
5. PMDF includes two shell scripts called post.sh and return.sh in the /pmdf/bin directory. You need to use cron to schedule two periodic jobs to run these shell scripts. It is recommended that the shell script post.sh be scheduled to run every four hours and that the shell script return.sh be scheduled to run at 30 minutes after midnight each day; however, you may want to schedule them differently according to the needs of your site. It is also suggested, particularly if your site includes multiple PMDF nodes, that you consider setting the minutes-after-the-hour offset at which the post.sh shell script runs to different values on different nodes to better balance mail flow. Typical scheduling for such cron jobs can be established by issuing the commands:

   # su pmdf $ crontab /pmdf/table/cronjobs $ exit

   Note If you want to set up site-specific cron entries manually, perform the following steps: Become the pmdf user: # su pmdf Edit the crontab entries by using the following command: $ crontab -e Use the editor to add entries similar to the following: 30 0 * * * /pmdf/bin/return.sh >/pmdf/log/return.log-`/pmdf/bin/unique_id` 2>&1 0 0,4,8,12,16,20 * * * /pmdf/bin/post.sh >/pmdf/log/post.log-`/pmdf/bin/unique_id` 2>&1 The first value in the second line, shown as 0 in the above example, is the minutes-after-the-hour offset. If you have multiple PMDF nodes, then this is a value that you might want to stagger between different nodes. For example, 0 on one node, 10 on a second node, 20 on a third node, etc. Also note the use of log files in the above. These log files can be useful in tracking down problems with the operation of return.sh and post.sh. Make sure to exit from the pmdf user shell when you have finished adding these entries. For example, $ exit

   
   
6. Replace the sendmail system startup script with PMDF's pmdf startup script. This may be performed by issuing the command:

   # /pmdf/bin/symlink install

   Note In each of the directories /etc/rc0.d, /etc/rc1.d, and /etc/rc2.d, there are files whose names begin with either the letter " " K or the letter " " S , followed by a two-digit number, followed by a command name. Remove the links where this command name is sendmail, and create a corresponding link with pmdf substituted for sendmail making sure to use the same inital letter and two-digit number. For example, you might see links such as the following: # ls -l /etc/rc0.d/*sendmail -rwxr--r-- 4 root sys 1183 Oct 25 04:14 /etc/rc0.d/K57sendmail # ls -l /etc/rc1.d/*sendmail -rwxr--r-- 4 root sys 1183 Oct 25 04:14 /etc/rc1.d/K57sendmail # ls -l /etc/rc2.d/*sendmail -rwxr--r-- 4 root sys 1183 Oct 25 04:14 /etc/rc2.d/S88sendmail In this case you would issue the following commands: # rm /etc/rc0.d/K57sendmail # rm /etc/rc1.d/K57sendmail # rm /etc/rc2.d/S88sendmail # cd /etc/rc0.d # ln -s ../init.d/pmdf K57pmdf # cd /etc/rc1.d # ln -s ../init.d/pmdf K57pmdf # cd /etc/rc2.d # ln -s ../init.d/pmdf S88pmdf In the example above, the first three commands remove the sendmail files, and the remaining commands create the corresponding pmdf links.

   Note The effect of the /pmdf/bin/symlink may be undone by issuing the command: # /pmdf/bin/symlink backout

   
   
7. When installing PMDF for the first time, or after an upgrade of the operating system if that upgrade installed a new version of sendmail, you must replace sendmail with PMDF's sendmail. First save the original sendmail by renaming it to sendmail.org, and then create a symbolic link that links sendmail to /pmdf/bin/sendmail as follows:

   # mv /usr/lib/sendmail /usr/lib/sendmail.org # ln -s /pmdf/bin/sendmail /usr/lib/sendmail

   You should also kill any old, pre-PMDF sendmail processes which might exist and be accepting connections. This may also be necessary if an operating system upgrade starts up non-PMDF sendmail processes. (Note that killing such processes is not necessary after an upgrade of PMDF. Even after the first installation of PMDF or after an upgrade of the operating system, there will be no non-PMDF sendmail processes if the system has been rebooted and the previous post-installation tasks have been performed.) To see if there are any such sendmail processes, issue the command:

   # ps -ef | grep sendmail

   If there are any such sendmail processes, you will see something similar to the following:

   root 23913 1 0 Apr 05 ? 0:01 /usr/lib/sendmail -bd -q1h

   You should kill any such processes using the kill command; e.g.,

   # kill 23913

   
   

8. The multithreaded POP3 and IMAP servers are handled by the PMDF Service Dispatcher. If you were previously using non-PMDF servers then you must shut down your old servers before you can use the PMDF multithreaded servers. Before you can use the multithreaded POP3 or IMAP servers, you must also configure the Dispatcher to run the desired service. Dispatcher configuration is normally performed as part of the initial web-based PMDF-MTA configuration; see Chapters 3 and 5 for instructions and sample configurations of the Dispatcher. See Chapter 4 for instructions and Chapter 3 for an example of configuring the POP3 and IMAP servers.
   
9. Start up the PMDF Job Controller and PMDF Service Dispatcher using the command:

   # pmdf startup

   
   

10. If you chose to install the PMDF on-line documentation, then the installation will have placed the HTML versions of the PMDF documentation under the /pmdf/doc directory. PMDF provides an HTTP server for serving out this documentation to Web browsers. To start up the PMDF HTTP server, the PMDF Service Dispatcher must be configured to handle the HTTP service, access to the HTTP server must be enabled, and then the Dispatcher must be started up (or restarted, if it was already running). The web-based PMDF-MTA configuration utility, discussed in Chapter 3 and Chapter 5, will automatically configure the PMDF Dispatcher.
    
11. If you have licensed any PMDF layered products, configure those layered products. For configuring PMDF-LAN, refer to Chapter 6 and Chapter 7. For configuring PMDF-X400, refer to Chapter 8 and Chapter 9. For configuring PMDF-XGS, refer to Chapter 10 to Chapter 13.
    
12. The PMDF installation installs man pages. If you want users to be able to use the man -k command in order to display a list of PMDF man pages, then you will need to manually issue the command:

    # catman 1pmdf 8pmdf

    Note that this command may take many minutes to complete.
    In addition to adding the PMDF man pages to the man page index as described above, you should also add PMDF sections numbers to the man.cf file. That file will look something like:

    # # Default configuration file for the SUNWman on-line manual pages. # MANSECTS=1,1m,1c,1f,1s,1b,2,3,3c,3s,3x,3xc,3n,3r,3t,3xn,3m,3k,3g,3e,3b, 9f,9s, 9e,9,4,5,7,7d,7i,7m,7p,7fs,4b,6,l,n

    You should add 1pmdf,8pmdf to the list of MANSECTS, so that the file is along the lines of:

    # # Default configuration file for the SUNWman on-line manual pages. # MANSECTS=1,1m,1c,1f,1s,1b,2,3,3c,3s,3x,3xc,3n,3r,3t,3xn,3m,3k,3g,3e,3b, 9f,9s,9e,9,4,5,7,7d,7i,7m,7p,7fs,4b,6,l,n,1pmdf,8pmdf

    This will enable users to use commands such as man pmdf_convertdb instead of having to specify a section as man 8pmdf pmdf_convertdb.