PMDF Installation Guide
Solaris Edition
Previous Next Contents Index

1.3 Step-by-Step Installation Instructions

  1. 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

  2. If you have previously installed PMDF, you must first deinstall PMDF before attempting to reinstall or upgrade PMDF. To deinstall PMDF, see Section 1.6.
  3. Installation of PMDF should be done by root. If you are not logged in as root, do so now.
  4. If you are upgrading PMDF, you should check on your PMDF licenses and update them, if necessary, at this time. In particular, if you are upgrading from PMDF V5.2 or earlier, note that the format of PMDF license files has changed as of PMDF V6.0; you will need to obtain replacement licenses from Process Software if you have not already done so. (If this is your initial PMDF installation, instructions on initially installing PMDF licenses will be given in Section 1.5, Post-Installation Tasks for New Sites.) 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 /pmdf/table/PMDF-MTA-SUN.license and look something like: 


    Issuer:Process 
Authorization Number:auth-number
Product Name:PMDF-MTA-SUN 
Producer:Innosoft 
Product Release Date:January 2005 
Product Token:token
Checksum:checksum
    where auth-number, token, and checksum are specific to your own site's license. You should have received the correct license information for your system when you licensed PMDF, and new licenses for PMDF at renewal time. 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.
    If you already have existing licenses, you should check to make sure that they are valid for this release. Check that the release date for each product, i.e., that found on the fifth line of the file, is later than the release date of the new version of each PMDF product that you want to install.1
    New PMDF product licenses are issued when your maintenance contract is renewed, not when new versions of software are released. If you have received new PMDF licenses at your renewal time, you should register the new licenses. Edit the appropriate license file and enter the new license information.
    Note that the pmdf license -verify utility may be used to check the validity of the syntax, data, and checksum of PMDF license files.
    The following discussion outlines the steps in the PMDF installation procedure. Refer to Chapter 2 for a sample installation dialogue.

  5. Begin the installation procedure by invoking the pkgadd command procedure as shown below: 


    # cd /
# pkgadd -d location
    where location specifies the location of the appropriate PMDF packages. If you are installing the packages directly from CD-ROM and if volume management is not running, then you need to mount the distribution media first and then invoke the pkgadd command. For instance, assuming that the target id of the CD-ROM device is 6 , for a Solaris (SPARC) installation: 


    # cd /
# mount -o ro /dev/dsk/c0t6d0s0 /cdrom
# pkgadd -d /cdrom/Solaris-SPARC/PMDF621
    Or for a Solaris (x86) installation: 


    # cd /
# mount -o ro /dev/dsk/c0t6d0s0 /cdrom
# pkgadd -d /cdrom/Solaris-X86/PMDF621
    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.

  6. After pkgadd is invoked, you will be asked to select the package or packages to install. For instance, in a Solaris (SPARC) installation, you would see: 


     
The following packages are available: 
 
  1  PMDFbase     PMDF Base Product V6.2-1 
                  (sparc) 6.2-1 
 
  2  PMDFdoc      PMDF Documentation V6.2-1 
                  (sparc) 6.2-1 
 
  3  PMDFlan      PMDF LAN Product V6.2-1 
                  (sparc) 6.2-1 
 
  4  PMDFsync     PMDF Directory Synchronization Product V6.2-1 
                  (sparc) 6.2-1 
 
  5  PMDFtls      PMDF TLS Product V6.2-1 
                  (sparc) 6.2-1 
 
  6  PMDFx400     PMDF X.400 Product V6.2-1 
                  (sparc) 6.2-1 
 
  7  PMDFxgs      PMDF SNADS Gateway Product V6.2-1 
                  (sparc) 6.2-1 
 
Select package(s) you want to process (or 'all' to process 
all packages). (default: all) [?,??,q]: all
    At this last prompt, you should enter the number or numbers of your selection, or enter all to select all packages. 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 PMDF-MTA; your selection should include option 1. To install PMDF-MTA alone, enter 1; to install PMDF-MTA, PMDF-LAN, and the PMDF on-line documentation, enter 1-3. Note that you cannot install PMDF-DIRSYNC, PMDF-LAN, PMDF-TLS, PMDF-X400, PMDF-XGS, or the PMDF on-line documentation unless you are also concurrently installing or have already installed the PMDF Base Product. You may enter q to quit the installation, or ? to have a help message printed. After you enter your selection, the pkgadd installation utility will print PMDF copyright information.

  7. pkgadd will then ask you where to locate the /pmdf directory, with pkgadd 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 '/opt/pmdf' as the directory, a directory 
        '/opt/pmdf' will be created and a symbolic link 
        will be created that links '/pmdf' to '/opt/pmdf'. 
 
Under which directory will PMDF be installed: [?,q]
    At this last prompt, you should enter your choice of where to locate the /pmdf directory. It is recommended 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 want to locate the /pmdf directory; the pkgadd procedure will automatically create a symbolic link that links /pmdf to the directory that you specify.2

  8. pkgadd will then ask if you want to relocate heavily accessed (and transient) PMDF files 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', and '/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,?,q]
    If you would like to relocate these directories, answer y followed by [RETURN]. If so, the procedure will then ask: 


    Under which directory will these subdirectories be located:  [?,q]
    At this last prompt, you should enter your choice of where to locate the heavily accessed subdirectories.

  9. After you select where to locate your selection of packages, the installation procedure will then begin checking package information. It will ask you whether to install certain files as setuid/setgid files. You must answer y meaning yes: 


    WARNING: There are files that need to be installed with setuid in 
order for PMDF to work correctly.  Answer 'y' to the question later 
to install the programs as setuid/setgid files 
 
Using </> as the package base directory. 
## Processing package information. 
## Processing system information. 
   9 package pathnames are already properly installed. 
## Verifying disk space requirements. 
## Checking for conflicts with packages already installed. 
## Checking for setuid/setgid programs. 
 
The following files are being installed with setuid and/or setgid permissions: 
  /usr/opt/pmdf/bin/l_master <setuid root setgid mail> 
  /usr/opt/pmdf/bin/master <setgid uucp> 
  /usr/opt/pmdf/bin/msgstoremgr <setuid pmdf> 
  /usr/opt/pmdf/bin/pager <setgid uucp> 
  /usr/opt/pmdf/bin/pipe_master <setuid root setgid mail> 
  /usr/opt/pmdf/bin/pmdf <setuid pmdf> 
  /usr/opt/pmdf/bin/popmgr <setuid pmdf> 
  /usr/opt/pmdf/bin/profile <setuid pmdf> 
  /usr/opt/pmdf/bin/qm <setuid pmdf> 
  /usr/opt/pmdf/bin/send <setuid pmdf> 
  /usr/opt/pmdf/bin/sendmail <setuid pmdf> 
  /usr/opt/pmdf/bin/slave <setgid uucp> 
  /usr/opt/pmdf/bin/uucp_slave <setuid pmdf> 
 
Do you want to install these as setuid/setgid files [y,n,?,q]

  10. The installation procedure will next print a warning that the installation executes certain scripts as super-user, and asks if you want to continue. You must answer y meaning yes: 


    This package contains scripts which will be executed with super-user permission 
during the process of installing this package. 
 
Do you want to continue with the installation of <PMDFbase> [y,n,?]
    After you answer yes, the installation procedure will begin installing each package you selected for installation in turn, printing informational messages as it does so.

  11. Once it has finished installing all of the packages you selected, the installation procedure will ask if you want to install anything else: 


    Select package(s) you wish to process (or 'all' to process 
all packages). (default: all) [?,??,q]:
    Enter q to exit the installation procedure.

  12. After the packages are installed, if you have been installing directly from the CD-ROM, you should unmount the distribution media. If volume management is running, you may use the eject command; otherwise, to unmount the distribution media use a command such as: 


    # umount /cdrom

Note

1 PMDF licenses 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 licenses do not prevent your current version of PMDF from running after your maintenance contract has expired. This is intentional.

2 Note that manually relocating PMDF after installation is unsupported as it confuses the Solaris utilities pkginfo, pkgrm, and pkgadd, and may cause file system corruption upon subsequent use of such utilities. Specifically, if after installation to another area the PMDF tree is manually moved to /pmdf, where normally only a softlink to the actual PMDF area exists, then subsequently using pkgrm to remove the PMDF package, besides removing the entire PMDF tree (including site-supplied configuration files which one normally does not want removed), has also been observed in some cases on Solaris x86 to cause file system corruption. So be sure to carefully consider your choice of where to install PMDF now; if you later want to change the location, you will need to deinstall PMDF and then reinstall PMDF to the new location.

Previous Next Contents Index