PMDF Installation Guide
Tru64 UNIX Edition
PMDF-INST-DUX-60

• If you have previously installed PMDF, you must shutdown the PMDF detached processes before attempting to reinstall or upgrade PMDF. Issue the command:

  # pmdf shutdown
  

  
  
• If you have previously installed PMDF, you must first deinstall PMDF before attempting to reinstall or upgrade PMDF. To deinstall PMDF, see Section 1.8 .
  
  The following discussion outlines the steps in the PMDF installation procedure. Refer to Chapter 2 for a sample installation dialogue.
• Installation of PMDF should be done by superuser. If you are not logged in as root, do so now.
  
• If this is your initial PMDF installation, load the appropriate license PAKs using the License Management Facility, lmf. You need a PAK for either PMDF-MTA or PMDF-ACCESS; the PAK name will be PMDF-MTA-OSF or PMDF-ACCESS-OSF, respectively. Note that you should not load license PAKs for both PMDF-MTA and PMDF-ACCESS on the same machine as the license PAK for PMDF-ACCESS will override the license PAK for PMDF-MTA! If you will also be installing any add-on layered product such as PMDF-DIRSYNC, PMDF-LAN, PMDF-MB400, PMDF-MSGSTORE, PMDF-POPSTORE, PMDF-TLS, PMDF-X400, or PMDF-XGS, then for each such layered product, an additional PAK will be required, named, e.g., PMDF-DIRSYNC-OSF, PMDF-LAN-OSF, PMDF-MB400-OSF, PMDF-MSGSTORE-OSF, PMDF-POPSTORE-OSF, PMDF-TLS-OSF, PMDF-X400-OSF, or PMDF-XGS-OSF; note that such layered products can only be licensed and installed on a system already licensed for PMDF-MTA. If you already have existing PAKs, you should check to make sure that they are valid for this release. Use the command

  # lmf list full for licensename
  

  where licensename is the name of the license in question, e.g., PMDF-MTA-OSF, PMDF-ACCESS-OSF, PMDF-DIRSYNC-OSF, PMDF-LAN-OSF, PMDF-MB400-OSF, PMDF-MSGSTORE-OSF, PMDF-POPSTORE-OSF, PMDF-TLS-OSF, PMDF-X400-OSF, or PMDF-XGS-OSF, to check the release date of the existing PAKs, and make sure that the date displayed is later than the release date of the new version of PMDF that you wish to install.¹ New PAKs are issued when your maintenance contract is renewed, not when new versions of software are released. If you have received new PAKs at your renewal time, you should register the new PAKs. First delete the old PAKs; then register and load the new PAKs. For example, if you received a new PMDF-MTA-OSF PAK, then the following commands would start up an editor with which to edit the license information in the License Database:

  # lmf delete PMDF-MTA-OSF
  # lmf register
  

  After registering all the new information on your license PAKs, you must then load the PAKs. You may either load any required PAK individually, e.g.,

  # lmf load 0 PMDF-MTA-OSF
  

  or you can instead load all PAKs at once by issuing the command

  # lmf reset
  

  
  
• Begin the installation procedure by invoking the setld command procedure as shown below.

  # cd /
  # setld -l location
  

  where location specifies the location of the PMDF subsets. If you are installing the subsets directly from CD-ROM, then you need to mount the distribution media first and then invoke the setld command as follows (assuming the CD-ROM device is located on the rz4c disk):

  # cd /
  # mount -t cdfs -o noversion,rrip /dev/rz4c /mnt
  # setld -l /mnt/OSF1-Alpha/PMDF600 
  

  To stop the installation procedure at any time, use Ctrl/C. Note, however, that if the installation procedure is terminated forcibly via Ctrl/C, then any files created by the installation up to the point where Ctrl/C was pressed will not be deleted, and therefore you must delete any such files manually.
  
• After setld is invoked, you will be asked where to locate the /pmdf directory, with setld displaying the following message:

  PMDF will be installed in the directory '/pmdf'.  If you 
  want to install it under some other directory, a symbolic 
  link will be created that links '/pmdf' to the directory 
  that you specify. 
   
    E.g.: If you specify '/usr/pmdf' as the directory, a directory 
        '/usr/pmdf' will be created and a symbolic link 
        will be created that link '/pmdf' to '/usr/pmdf'. 
   
  Under which directory will PMDF be installed: 
  

  At this last prompt, you should enter your choice of where to locate the /pmdf directory. Innosoft recommends that you locate the /pmdf directory under some directory other than the root directory since the root file-system is usually quite limited in size. Enter the directory name under which you wish to locate the /pmdf directory; the setld procedure will automatically create a symbolic link that links /pmdf to the directory that you specify. After you specify a directory location, a confirmation message will be displayed. Enter y followed by RETURN if the location is correct. Otherwise, enter n followed by RETURN; in this case you will be presented with another opportunity to specify the directory name.
  
• setld will then ask you if you wish to relocate heavily accessed PMDF subdirectories to a different filesystem:

  Some PMDF subdirectories are likely to contain large numbers 
  of transient files, such as queued messages and log files. 
  If you like, this procedure will install these subdirectories 
  to a different filesystem and create symbolic links to them. 
   
    E.g.: If you specify '/var/spool/pmdf' for transient PMDF files, 
          the subdirectories '/var/spool/pmdf/queue', '/var/spool/pmdf/log', 
          '/var/spool/pmdf/locks', '/var/spool/pmdf/tmp' and 
          '/var/spool/pmdf/queue_cache' will be created and 
          symbolic links created under '/pmdf'. 
   
  Would you like to relocate subdirectories of transient files (y/n)? 
  

  At this last prompt, answer y followed by RETURN if you would like the installation procedure to perform this relocation for you. If you are upgrading PMDF and answer yes to this question, the installation procedure will move your current versions of the directories in question to the new specified location. If you do answer y, you will next be asked where you wish to locate the subdirectories:

  Under which directory will these subdirectories be located: 
  

  Enter the directory name under which you wish to locate the heavily accessed subdirectories; the setld procedure will automatically create symbolic links that link some heavily accessed subdirectories normally under /pmdf to the directory that you specify.
  
• setld will then ask you to select the subset or subsets to install:

  The subsets listed below are optional: 
   
       There may be more optional subsets than can be presented on a single 
       screen. If this is the case, you can choose subsets screen by screen 
       or all at once on the last screen. All of the choices you make will 
       be collected for your confirmation before any subsets are installed. 
   
       1) PMDF V6.0 Base Product                                               
       2) PMDF V6.0 Directory Synchronization Product                          
       3) PMDF V6.0 Documentation                                              
       4) PMDF V6.0 LAN Product                                                
       5) PMDF V6.0 MB400 Product                                              
       6) PMDF V6.0 SNADS Gateway Product                                      
       7) PMDF V6.0 X.400 Product                                              
   
  Or you may choose one of the following options: 
   
       8) ALL of the above 
       9) CANCEL selections and redisplay menus 
       10) EXIT without installing any subsets 
   
  Enter your choices or press RETURN to redisplay menus. 
   
  Choices (for example, 1 2 4-6): 
  

  At this last prompt, you should enter the number or numbers of your selection. Multiple, nonsequential numbers should be entered separated by spaces, not by commas, e.g., 1 3 ; multiple, sequential numbers can either be entered separated by spaces or as a range, e.g., 1-3. Note that the PMDF Base Product refers to both PMDF-MTA and PMDF-ACCESS; regardless of which of these you are licensed for and wish to install, your selection should include option 1. For instance, if you wish to install PMDF-MTA alone, you should enter 1; on the other hand, if you wish to install PMDF-ACCESS and the PMDF on-line documentation, you should enter 1 3; if you wish to install PMDF-MTA, PMDF-DIRSYNC, and the PMDF on-line documentation, then enter 1-3. Note that you cannot install PMDF-DIRSYNC, PMDF-LAN, PMDF-MB400, PMDF-X400, PMDF-XGS, or the PMDF on-line documentation unless you are also concurrently installing or have already installed the PMDF Base Product. After you enter your selection, a confirmation message will be displayed. Enter y followed by RETURN if the selection is correct. Otherwise, enter n followed by RETURN; in this case the subset selection menu will again be displayed, and you may correct your choice of subsets.
  
• After you confirm your selection of subsets, the installation procedure will continue with no further questions, displaying informational messages as it progresses. Please note that such informational messages regarding "configuring" a subset refer solely to the installation process; the configuration of PMDF itself is a separate function entirely, which remains to be performed as presented in Chapter 5 and Chapter 6 .
  
• After the subsets are installed, if you have been installing directly from the CD-ROM, then unmount the distribution media, e.g.:

  # umount /mnt
  

  ---

  Note

  ¹ PMDF license PAKs do not use a termination date; they instead use a release date. The release date merely prevents you from running newer versions of PMDF released after your maintenance contract has expired. The PAKs do not prevent your current version of PMDF from running after your maintenance contract has expired. This is intentional.

  ---

  ---

  Previous | Next | Contents