- 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
- 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 .
- Installation of PMDF should be done by superuser. If you are not
logged in as
root, do so now.
- 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 Innosoft 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:Innosoft
Authorization Number:auth-number
Product Name:PMDF-MTA-SUN
Producer:Innosoft
Product Release Date:29-FEB-2000
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; a
PMDF-ACCESS system will need a PMDF-ACCESS-SUN license. Note that you
should not enter license information for both PMDF-MTA and PMDF-ACCESS
on the same machine as the license for PMDF-ACCESS will override the
license for PMDF-MTA!
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 wish to install.¹
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.
- 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/PMDF600
Or for a Solaris (x86) installation:
# cd /
# mount -o ro /dev/dsk/c0t6d0s0 /cdrom
# pkgadd -d /cdrom/Solaris-X86/PMDF600
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.
- 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.0-21
(sparc) 6.0-21
2 PMDFdoc PMDF Documentation V6.0-21
(sparc) 6.0-21
3 PMDFlan PMDF LAN Product V6.0-21
(sparc) 6.0-21
4 PMDFsync PMDF Directory Synchronization Product V6.0-21
(sparc) 6.0-21
5 PMDFx400 PMDF X.400 Product V6.0-21
(sparc) 6.0-21
6 PMDFxgs PMDF SNADS Gateway Product V6.0-21
(sparc) 6.0-21
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]:
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; ultiple, 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 both
PMDF-MTA and PMDF-ACCESS; regardless of which of these you are licensed
for and wish to install, your selection should include option 1. For
instance, if you wish to install PMDF-MTA alone, you should enter
1; on the other hand, if you wish to install PMDF-ACCESS
and the PMDF on-line documentation, you should enter 1-2;
if you wish to install PMDF-MTA, PMDF-LAN, and the PMDF on-line
documentation, then enter 1-3. Note that you cannot
install PMDF-DIRSYNC, PMDF-LAN, 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.
-
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' 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. Innosoft recommends 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 wish to locate the
/pmdf directory; the pkgadd procedure will
automatically create a symbolic link that links /pmdf to
the directory that you specify.²
-
pkgadd will then ask if you wish 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',
and '/var/spool/pmdf/locks' 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.
- 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.
7 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>
/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>
<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]
- The installation procedure will next print a warning that the
installation executes certain scripts as super-user, and asks if you
wish 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.
- Once it has finished installing all of the packages you selected,
the installation procedure will ask if you wish 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.
- 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
¹ PMDF license PAKs 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 PAKs do not prevent your current version of
PMDF from running after your maintenance contract has expired. This is
intentional.
² 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 wish to
change the location, you will need to deinstall PMDF and then reinstall
PMDF to the new location.
Previous
| Next
| Contents