Last Update:            10-FEB-2011
Operating System:       Linux, Solaris, Tru64, Windows
Component:              PMDF Shared Library
Base Level Required:    PMDF V6.5
Other Requirements:     tcp_smtp_server

Platform                Subdirectory            File(s) to download
--------                ------------            --------------------
Linux			linux/lib/		libpmdf_smtp.tar
Solaris SPARC           solaris-sparc/lib/      libpmdf_smtp.tar
Solaris x86             solaris-x86/lib/        libpmdf_smtp.tar
Tru64                   osf/lib/                libpmdf_smtp.tar
Windows                 windows/                pmdf_65_x7.exe


General info
------------

     You will need to have a License PAK with a release date after the date of
  PMDFSHR.EXE or libpmdf.so to run PMDF.  Note that this may apply to other
  images as well.

     Patches may be obtained from the anonymous FTP account on
  ftp.pmdf.process.com.  Use FTP to connect to the host ftp.pmdf.process.com
  and login as the user anonymous.  Use your e-mail address as the login 
  password.

     Move to the pmdf_65_patches subdirectory:

        ftp> cd pmdf_65_patches

     Patches will be located in platform-specific sub-trees, as follows:

        Platform        Subdirectory
        --------        ------------
	Linux		linux
        Solaris/SPARC   solaris-sparc
        Solaris/x86     solaris-x86
        Tru64           osf
	Windows		windows

     When FTPing images, be sure to FTP them as binary.  Before retrieving
  such an image with the GET command, be sure to put your FTP into binary
  mode with a command such as TYPE IMAGE or TYPE BINARY.


Change history
--------------
IMPORTANT: Starting with ident V6.4-x4, libpmdf.so *requires* an updated 
tcp_smtp_server image (due to a previous change for PMAS support). If
libpmdf.so is installed without the updated tcp_smtp_server, crashes will
result.

10-FEB-2011 (ident V6.5-x6)
  ** IMPORTANT **
  Fixed a security vulnerability with the SMTP, POP, and IMAP protocols when
  TLS is used. (d/e 11113)
  Addresses the STARTTLS vulnerability in CERT bulletin CVE-2011-0411 
  (see http://www.kb.cert.org/vuls/id/555316).

9-DEC-2010 (ident V6.5-x5)
  Fixed a problem with the defragment channel where messages could get stuck in
  the channel without being processed. (D/E 11092)

9-DEC-2010 (ident V6.5-x5)
  Added code to prevent infinite loops of inline directory channel lookups.
  Once the maximum (10 iterations) is reached, the message will be enqueued to
  the directory channel itself for further processing. (D/E 9761)

4-AUG-2010 (ident V6.4-x4) [Unix only]
  This image, together with other database-related images, fixes problems
  with accessing the various PBL databases. (D/E 11056)

25-JUN-2010 (ident V6.5-x2)
  Fixed a problem with the parsing of ranges in patterns in mapping table
  entries, for example $[A-Z]. (D/E 11034)

25-JUN-2010 (ident V6.5-x2)
  Added support to the POPPROXY authentication source in the SECURITY.CNF file
  for using TLS, and for specifying more than one server. To use multiple
  servers, specify up to three comma-separated server:port pairs on the SERVER
  option in the [AUTH_SOURCE=POPPROXY] section. To use TLS, add to the 
  [AUTH_SOURCE=POPPROXY] section TLS_MODE=1. It will use port 995 as the
  default if no port is specified with the server name(s). Note that the port
  specified must be a dedicated TLS port as POPPROXY will not do STARTTLS to
  the stardard POP port. (D/E 10904)


Installation
------------
Linux, Solaris, Tru64

	Before installing a new libpmdf.so, issue the following command:

		# pmdf shutdown

	Failure to issue the above command could result in the current
	processes not recognizing commands (i.e. restart and shutdown) with
	the new libpmdf.so in place.

	Download the libpmdf_smtp.tar file. Use 'tar' to unpack the tar
	file into files libpmdf.so.Z and tcp_smtp_server. Use 'uncompress'
	on libpmdf.so.Z to get the libpmdf.so library.

	To install the new shared library, place it into the /pmdf/lib/
	directory and then execute the following commands:
        
		# chown pmdf:bin /pmdf/lib/libpmdf.so
		# chmod 755 /pmdf/lib/libpmdf.so

	To install the new SMTP server, place the tcp_smtp_server image
	into the /pmdf/bin/ directory, and execute the following commands:

		# chown pmdf:bin /pmdf/bin/tcp_smtp_server
		# chmod 755 /pmdf/bin/tcp_smtp_server

	In some cases new versions of libpmdf.so may alter the format of
	compiled configurations. When this happens recompilation is also
	necessary:
 
		# pmdf cnbuild

	Failure to recompile the configuration after installing new versions
	of libpmdf.so may lead to "compiled configuration version mismatch"
	errors.

	Next, be sure to start PMDF by issuing the following command:

		# pmdf startup

Windows

       Follow the PMDF Installation Guide for Windows platforms to install
       the V6.5-x7 kit.