PMDF Installation Guide
Solaris Edition

1.1 What You Should Have

Prior to performing an installation or upgrade you should have received a PMDF distribution kit containing the distribution media and any necessary licenses. You can install any PMDF layered product even if you do not currently have a license for it: you just will not be able to use that layered product until you have installed the proper license.

1.1.1 Supported Solaris Versions

This version of PMDF-MTA, PMDF-DIRSYNC, PMDF-LAN, PMDF-TLS, PMDF-X400, and PMDF-XGS runs under Solaris versions 2.6, 8, 9, and 10.

For Solaris V2.6 SPARC, you must install Sun patch 105181, revision -29 or later; for Solaris V2.6 x86, you must install Sun patch 105182, revision -29 or later. Without this patch, various PMDF utilities may abort with a "libthread panic: fault in libthread critical section" error.

For Solaris V2.6 SPARC, you must install Sun patch 105755, revision -10 or later; on Solaris V2.6 x86, you should install Sun patch 105756, revision -10 or later. This fixes several BIND server and resolver problems, one of which may lead to hangs in the TCP SMTP client.

For Solaris V2.6, if you are using the Veritas File System you must be sure to be running (or upgrade to) VxFS 3.2.3. That fixes a bug in VxFS associated with UNIX domain sockets. Without this patch, the PMDF Dispatcher would be unable to start up properly, encountering a "comm_listen: bind Invalid argument" error.

1.1.2 Distribution Media

PMDF for Solaris is distributed on a single CD-ROM that contains Solaris, Tru64 UNIX, Windows, and OpenVMS distributions of PMDF and all PMDF layered products. In particular, the distribution includes the complete PMDF for Solaris product family: PMDF-MTA, PMDF-DIRSYNC, PMDF-LAN, PMDF-MSGSTORE, PMDF-POPSTORE, PMDF-TLS, PMDF-X400, and PMDF-XGS. The CD-ROM is an ISO 9660 with Rockridge extensions CD-ROM, readable from many different platforms.

Prior to installation, the CD-ROM should be inserted into a CD-ROM drive accessible to the system. If the Solaris automounter has not been disabled, the CD-ROM will be automatically mounted by the system in /cdrom/pmdf640. If the automounter has been disabled, manually mount the CD-ROM as follows:

# cd / # mount -o ro file-system directory

where file-system is the CD-ROM device, and directory is the location in the file tree at which to attach the newly mounted file-system. For example, if the target id of your CD-ROM device is 6 and you want to place the PMDF distribution files under /cdrom, you would issue the commands:

# cd / # mount -o ro /dev/dsk/c0t6d0s0 /cdrom

Note that the PMDF packages for Solaris (SPARC) reside under the directory /Solaris-SPARC/PMDF640 and the PMDF packages for Solaris (x86) reside under the directory /Solaris-X86/PMDF640. Thus the example above would result in the packages for Solaris (SPARC) being present under /cdrom/Solaris-SPARC/PMDF640 and the packages for Solaris (x86) being present under /cdrom/Solaris-X86/PMDF640. If the automounter is used, the packages for Solaris (SPARC) will be present in /cdrom/pmdf640/Solaris-SPARC/PMDF640. and the packages for Solaris (x86) will be present in /cdrom/pmdf640/Solaris-X86/PMDF640.

The PMDF on-line documentation resides on the PMDF distribution CD-ROM under the directory /documentation,

Once mounted, use the pkgadd installation procedure as presented in Section 1.4. Or, if you move the PMDF product packages to disk, you can install PMDF from that on-disk copy similarly, specifying as the location argument to pkgadd the path to the packages' directory.

1.1.3 Disk Space Requirements

The disk space requirements for PMDF are listed in Table 1-1.

Table 1-1 Disk space requirements for PMDF for Solaris
Package Name Kbytes Required

SPARC x86

PMDFbase 35100 32600

PMDFdoc 36000 36000

PMDFlan 1300 1200

PMDFsync 2000 1800

PMDFtls 2700 2500

PMDFx400 4800 4700

PMDFxgs 200 200

Note that the PMDFbase package includes PMDF-MTA.

**Table 1-1 Disk space requirements for PMDF for Solaris**
Package Name	Kbytes Required
	SPARC	x86
`PMDFbase`	35100	32600
`PMDFdoc`	36000	36000
`PMDFlan`	1300	1200
`PMDFsync`	2000	1800
`PMDFtls`	2700	2500
`PMDFx400`	4800	4700
`PMDFxgs`	200	200

These disk space requirements apply to the partition on which you load the PMDF packages. You can use the df command to check total space and free space for the filesystems in which you want to have PMDF reside.

1.1.4 Filesystem Requirements

PMDF makes heavy use of UNIX file locks. Therefore acceptable performance requires that PMDF directories reside on a filesystem which is local to the system running PMDF. In particular, PMDF directories should not reside on a remote, NFS mounted filesystem.

1.1.5 Swap Space Requirements

For proper PMDF operation it is important to have your system configured with enough swap space. How much swap space will be required will depend upon what components of PMDF you are using and how heavily they are used; heavy POP or IMAP usage, for instance, will increase the swap space needed. Note that a typical general system tuning recommendation, regardless of PMDF, is to have swap space at least three times the amount of main memory.

For PMDF, at a minimum you should have at least 320 megabytes of swap space configured on Solaris SPARC or at least 250 megabytes on Solaris x86. On a PMDF system with more than minimal usage, better values would be more along the lines of at least 750 megabytes of swap space on Solaris SPARC or at least 500 megabytes on Solaris x86.

Contents

Index