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

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

• If you are using a compiled configuration, you must recompile it after an upgrade of PMDF with the command

  # pmdf cnbuild
  

  
  
• As of PMDF V6.0, there is a new PMDF periodic job that you need to schedule cron to run periodically. If you have not customized your pmdf crontab entries, then you may simply issue the commands:

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

  Otherwise, if you prefer to add the new crontab entry manually so as not to overwrite your existing, possibly customized, pmdf crontab entries, then issue the commands

  # su pmdf
  # crontab -e
  

  and use the editor thus invoked to add an entry such as the following:

  0  0,10,20,30,40,50 * * * * /pmdf/bin/pmdf_lg_purge >/dev/null 2>&1 
  

  Make sure to exit from the pmdf user shell when you have finished adding this entry; i.e.,

  $ exit
  

  
  
• The underlying storage of all PMDF databases has changed as of PMDF V6.0 from the format used in PMDF V5.2 and earlier. In particular, all PMDF crdb databases must be rebuilt or converted using the pmdf convertdb utility. The /pmdf/bin/finddb.sh shell script may be used to attempt to detect the major PMDF databases; running this utility will create a script file that may then be run in order to actually convert the databases. Note, however, that if you have additional PMDF databases on your system (for instance, users' own personal alias databases), then you will also need to convert those databases.
  Users wishing to convert their own personal alias database may do so with the command

  % pmdf convertdb aliasesdb aliasesdb
  

  which will create a new file aliasesdb.db that will replace in functionality the previous files aliasesdb.dat and aliasesdb.idx.
  Please also note that the base name (name sans file extension) of the PMDF password database has been changed from pauth to passworddb, so if your sites uses the PMDF password database (not all sites do) be sure to use the new name when you are converting the password database.
• The format of the PMDF queue cache database has changed as of PMDF V6.0 from the format used in PMDF V5.2 and earlier. Therefore the PMDF queue cache database must be rebuilt, via the commands

  # rm /pmdf/table/queue_cache/*
  # pmdf cache -synchronize
  

  Note that it is a good idea to rebuild the PMDF queue cache database with the above commands or with the command

  # pmdf cache -rebuild
  

  after any upgrade of PMDF, including after minor interim releases.
  
• UNIX sites which were using the popstore under PMDF V5.2 or earlier and which are upgrading to PMDF V6.0 must rebuild (or should build for the first time) the PMDF popstore user database since its format has changed. (As of PMDF V5.2, in order to accelerate certain management functions such as generating listings of user accounts, using wild cards in conjunction with account management commands, etc., a database of user accounts is used by the popstore. This database, referred to as the popstore user database, is located in the /pmdf/user/ directory on UNIX systems. This database is only used for management functions and does not in any way impact the performance of the popstore.) The PMDF popstore user database is located via the PMDF_POPSTORE_USER_DATABASE PMDF tailor file option, and so is usually /pmdf/user/userdb. Sites upgrading from PMDF V5.2 must rebuild their existing popstore user database using the commands

  # rm /pmdf/user/userdb.*
  # pmdf popstore x_build_user_db
  

  Sites which were using the PMDF popstore under PMDF V5.1 and which are upgrading to PMDF V6.0 should create a popstore user database using the command

  # pmdf popstore x_build_user_db
  

  after upgrading to PMDF V6.0. This command will scan the profile directory tree and build a user database.
  
• The multithreaded PMDF POP3 and IMAP servers are handled by the PMDF Service Dispatcher. If you were previously using non-PMDF servers, or older PMDF singlethreaded servers running under the inetd daemon, 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. If you will be reconfiguring PMDF-MTA using the web-based configuration utility, the Dispatcher will be configured automatically. Otherwise, you may use the command line pmdf configure dispatcher utility (on either a PMDF-MTA or PMDF-ACCESS system) to configure the Dispatcher; note that the final portion of Example 7-1 includes an example of configuring the Dispatcher.
  
• If you are using the pmdfcyrus program to deliver to the Cyrus message store, you should check the permission settings for the /pmdf/bin/pmdfcyrus image to make sure that they are still correct. The PMDF installation attempts to set the permissions properly when it updates the image. But if the permissions are not correct, you will need to reset them manually with the commands:

  # chown cyrus-user /pmdf/bin/pmdfcyrus
  # chmod 4755 /pmdf/bin/pmdfcyrus
  

  where cyrus-user is whatever userid was selected when installing Cyrus, typically cyrus.
  
• If you are using the PMDF-LAN Lotus Notes channel or PMDF-XGS, be sure to upgrade the PMDF images used on the Lotus Notes server or XGS transport bridge system. These are OS/2 or NT PMDF images, available under the /pmdf/other/ directory on the PMDF system, or available directly off the PMDF distribution CD-ROM under the other directory. Note that this is an ISO 9660 with Rockridge extensions CD-ROM, readable from many different platforms including OS/2 and NT.
  • a. For PMDF-XGS, shutdown all the PMDF-XGS processes on the transport bridge and then copy the respective files to the transport bridge system. Then restart the PMDF-XGS processes on the transport bridge system.
  • b. For a PMDF-LAN Lotus Notes channel, shut down the PMDF Lotus Notes Server Add-ins, using Lotus Notes server console commands such as TELL PNGATECIN QUIT, and TELL PNGATECOUT QUIT (or just TELL PNGATEC QUIT if you were using just the one Server Add-in). Then copy the new server Add-ins to the Lotus Notes server, and startup them back up (e.g., LOAD PNGATECIN and LOAD PNGATECOUT). If you have not already done so, note that this is a good time to switch to using the two independent Server Add-ins PNGATECIN and PNGATECOUT in place of the single PNGATEC Add-in originally released in PMDF V5.1: change the line in the Lotus Notes initialization file, notes.ini, defining server tasks from

    ServerTasks=...,PNGATEC 
    

    to

    ServerTasks=...,PNGATECIN,PNGATECOUT 
    

    
    
  • Start up the PMDF Job Controller and PMDF Service Dispatcher using the command:

    # pmdf startup    
    

    
    
  • The PMDF installation installs man pages. If you wish 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,1 
    b,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.
    
  • If you also installed PMDF-DIRSYNC, PMDF-LAN, PMDF-MB400, PMDF-X400, or PMDF-XGS for the first time, then you should configure them now. Configuration instructions for PMDF-LAN may be found in Chapters 9 and 10 ; configuration instructions for PMDF-X400 may be found in Chapters 11 and 12 ; configuration instructions for PMDF-XGS may be found in Chapters 13 through 16 .

    1.4.1 Additional post-installation tasks for sites upgrading from PMDF V5.1

    The following is a list of additional post-installation tasks that must be completed following an upgrade from V5.1 of PMDF-MTA, PMDF-ACCESS, PMDF-LAN, or PMDF-X400. Sites upgrading from PMDF V5.2 should skip this section.
    • Update configuration:
      • a. V5.1 PMDF-X400 sites that were using the former MIME-CONTENT-TYPES-TO-X400 mapping table to control the mapping of MIME attachments to X.400 attachments should note that that mapping table became obsolete as of PMDF V5.2, having been superseded by the more general, MIME-TO-X400-CONTENT-TYPES mapping table. You must convert the name of the mapping table to the new name, and also include the new channel name argument on the left hand (pattern) side; the file /pmdf/table/x400_mappings.sample may provide a useful sample starting point.
      • b. If you are using PMDF POP or IMAP servers, be aware that some password handling changed between PMDF V5.1 and PMDF V5.2. The new, configurable authentication source control used as of PMDF V5.2 by, for instance, the POP and IMAP servers has default behavior that is intended to operate "naturally" and usually means no visible change to users. But a few users with less natural setups (for instance, non-popstore users who have PMDF password database entries different from their system password) can see a change in behavior.
        To achieve the PMDF 5.1 behavior in PMDF 6.0, a PORT_ACCESS mapping would need to segregate POP and IMAP connections into different rulesets, e.g.,

        PORT_ACCESS 
         
         TCP|*|110|*|*        $YPOP-RULES 
         TCP|*|143|*|*        $YIMAP-RULES 
         
        

        and the security configuration file security.cnf would need corresponding ruleset definitions of:

        [RULESET=DEFAULT] 
        ENABLE=MSGSTORE/*,PASSDB/*,SYSTEM/* 
        ! 
        [RULESET=POP-RULES] 
        ENABLE=MSGSTORE/*,PASSDB/CRAM-MD5,PASSDB/APOP,SYSTEM/* 
        ! 
        [RULESET=IMAP-RULES] 
        ENABLE=SYSTEM/* 
        

      • c. The LOG_CONNECTION PMDF option for controlling logging of connection information is now not simply an on/off setting as in PMDF V5.1, but rather as of PMDF V5.2 is bit-encoded for more specific controls.

        ---

        Previous | Next | Contents