The PMDF distribution kit contains the distribution media and all necessary license PAKs. (You must have license for a layered product before you can install it.)
You can install any of the PMDF layered products, even if you do not have a PAK for it. However, you will not be able to use that layered product until you have registered and loaded the proper PAK. If you are upgrading PMDF, you can continue to use your old PAKs. Upgrading sites are only sent new PAKs when they renew their maintenance contracts. 2
1.1.1 Supported OpenVMS and Other Software Versions
This version of PMDF only operates under OpenVMS VAX or Alpha AXP V6.1
PMDF requires that Compaq Pascal RTL V5.0-15 or later (VAX), or V5.0-18 or later (Alpha) be installed on your system before you can install PMDF. Process Software has received permission from Compaq Computer Corporation to include this DEC Pascal RTL in the PMDF distribution kit. If RTL is not on your system, the PMDF installation procedure will install it automatically.
If you will be using TCP/IP-based components of PMDF (for example, the PMDF Service Dispatcher and all its services), then you must have a TCP/IP package installed and configured. The TCP/IP package must be one of the following:
There are also several important OpenVMS patches that you should obtain and install (if you have not done so already). The following OpenVMS patches will fix bugs which exist, regardless of whether or not you run PMDF.
There are no patches required for OpenVMS V7.2 or later. If you are running versions of OpenVMS earlier than V7.2, you should make sure you have installed the following patches.
See also the Process Software PMDF support web pages for the latest
list of required operating system patches
mail.log_current, and the PMDF queue cache database files.
mail.maifiles when they use VMS MAIL's PURGE/RECLAIM command, or when users exit from VMS MAIL and have their wastebasket folder "auto-purged"). This bug also impacts PMDF's queue cache database.
This problem occurred primarily at sites that had many thousands of simultaneous mail users.
If appropriate, contact Compaq to obtain these patches. You should also check to see if there are even more recent patches that supersede those listed above. You should also ask Compaq for a list of recommended patches that you need to apply to your version of the operating system.
1.1.2 Distribution Media
PMDF is distributed on a single CD-ROM containing a single VMSINSTAL
installation kit for the PMDF product family: PMDF-MTA, PMDF-DIRSYNC,
PMDF-FAX, PMDF-LAN, PMDF-MB400, PMDF-MR, PMDF-MSGSTORE, PMDF-POPSTORE,
PMDF-X400, PMDF-TLS, and PMDF-XGS.
CD-ROM distributions contain a standard OpenVMS file system with PMDF
product save sets residing in the
Prior to installation or upgrade with VMSINSTAL, the CD-ROM should be inserted into a CD-ROM drive accessible to the system and mounted as follows:
$ MOUNT device pmdf621
deviceis the OpenVMS device name of your CD-ROM drive.
Once mounted, use the VMSINSTAL installation procedure as documented below. For the location of the distribution volume in step 4 of Section 1.6, use the format
Please note that PMDF distributions are not compatible with the VMSINSTAL option G, which is sometimes used to move product save sets from distribution media to disk. If you choose to move PMDF product save sets from the distribution CD-ROM to disk, simply mount the CD-ROM and use the COPY command. For example:
$ MOUNT dka500: PMDF621 $ COPY/LOG dka500:[PMDF621.OPENVMS]*.* disk:[vmsinstal]
disk:[vmsinstal]) rather than a device name.
While you can copy PMDF product save sets to disk, this is not required. As with any VMSINSTAL compatible product, PMDF can be installed directly from the distribution media.
You should read through this guide before beginning the installation of or upgrade to PMDF V6.2-1. Release notes (bug fixes and new features) for PMDF V6.2-1 can be found in the PMDF V6.2-1 Release Notes, visible at the Process Software web site.
1.1.3 Disk Space Requirements
Table 1-1lists the disk space requirements for PMDF.
PMDF is no longer copied to the system disk during installation. This means that during installation very few files are resident on the system disk unless they are actually being installed there. PMDF only requires about 2,000 temporary blocks on the system disk as a result.
All these numbers assume that PMDF is installed in a new location and/or existing files are not purged during the installation. Much less space is needed when PMDF is installed on top of an existing copy and purging is enabled. However, it is not possible for the kit to determine the exact amount of space needed in this case, so the worst case is assumed.
The installation procedure checks to make sure that enough space is available and will not install PMDF if there is not enough room. PMDF can be "trimmed" after installation to use less space by selective deletion of unneeded programs. However, this can only be done after the entire package is installed.
PMDF should be installed on a disk with no disk quotas active (e.g., a system disk) if possible. If this cannot be done, a disk quota entry should be set up for PMDF's UIC at this point in the installation. Use the PMDF server account UIC as described in Section 1.4.1. Be sure to give PMDF enough quota to handle large numbers of messages (10,000 free blocks or more is recommended).
1.1.4 System Parameters
If this is a new installation you would need at least 23000 free
GBLPAGES and about 70 free GBLSECTIONS. The need for GBLPAGES is
increased by the size of your compiled configuration file if a compiled
configuration is used. VIRTUALPAGECNT might also need to be increased
if you have a very large configuration.
Note that these numbers are only the best estimates available at press time. They can change from release to release. It would be better to err on the side of having too many free GBLPAGES and GBLSECTIONS than try to add the exact number each time.
PMDF servers normally run using the SYSTEM account and need an ENQLM of at least 400 and a FILLM of at least 200; so modify the quotas for your SYSTEM account if they are not already at or above these values. The SYSGEN parameters should also be modified so that PQL_MENQLM and PQL_DENQLM are at least 400 and PQL_MFILLM and PQL_DFILLM are at least 200, if they are not already at or above these values. These are dynamic parameters so no reboot is needed.
On OpenVMS VAX, as of version 6.0, PMDF requires significantly more page file and more page file quota than previous versions of PMDF: perhaps 20000 pages per PMDF process. Such processes include each Worker Process under the Dispatcher, as well as each channel job running in a Process Symbiont or batch queue. For instance, even on a system with very little message traffic at least a minimum of 150,000 block page file is likely required. A system with a basic PMDF configuration (allowing up to 5 each of SMTP, POP, IMAP, HTTP, and POPPASSD processes, and with four PMDF Process Symbiont queues) that is running full out (all processes active) might require a 600,000 block page file.
Page file requirements have not changed substantially on OpenVMS ALPHA.
2 PMDF license PAKs use a release date, not a termination date. The release date prevents you from running newer versions of PMDF that were released after your maintenance contract expired. The PAKs do not prevent your current version of PMDF from running after your maintenance contract has expired. This is intentional.