PMDF Installation Guide
Linux Edition


Previous Next Contents Index

1.4 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.7.
  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. (If this is your initial PMDF installation, instructions on initially installing PMDF licenses are given in Section 1.6, 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-LINUX.license and look something like:


    Issuer:Process 
    Authorization Number:auth-number
    Product Name:PMDF-MTA-LINUX 
    Producer:Innosoft 
    Product Release Date:April 2012 
    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-LINUX 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-LINUX; 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 RPM utility as shown below:


    # cd /
    # rpm -i rpm-kit
    
    where rpm-kit specifies the appropriate PMDF package. If you are installing the PMDF kit directly from CD-ROM, then you need to mount the distribution media first and then invoke the RPM command. For instance:


    # cd /
    # mount -o ro /dev/cdrom /cdrom
    # rpm -i /cdrom/Linux-X86/PMDF670/pmdf-6.7.0-0.i386.rpm 
    
    There will be no questions asked during the installation. If the installation is completed successfully, it will print out nothing, and just return you to your shell prompt. Note that in some cases you may have to specify the --nodeps option on the rpm -i command, for example, if you have just installed RPM on your Linux system for the purpose of installing PMDF, and you have no other RPM packages installed.

  6. By default, PMDF is installed under /opt and /pmdf is created as a link to the /opt/pmdf directory. If you wish to install PMDF into a different location, you must specify that on the rpm -i command by using the --prefix option. For example, to install PMDF directly into the /pmdf directory, use the following command:


    # rpm -i --prefix / pmdf-6.7.0-0.i386.rpm 
    

  7. After the kit is installed, if you have been installing directly from the CD-ROM, you should unmount the distribution media. The exact command needed depends on which Linux distribution you have. For example, on Red Hat Enterprise Linux, 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.


Previous Next Contents Index