PP-GEN(8)

NAME
pp-gen - generating the PP message system

You should read over this entire document first, before typing any commands.

READ THIS
This documentation describes how to configure, generate, and install the PP message system. It is intended only as a quick guide. The full details are in the PP documentation set - PP Manual$ Installation and Operation. This can be found in the doc/manual/volume1 directory

SYNOPSIS
make

DESCRIPTION
This is a description of how one can bring up the PP message system. It is assumed that you have super-user privileges in order to (re-)install the software. Super-user privileges are not required to configure or generate this software.

PP is normally installed with most programs and directories owned by a single user. Conventionally this username is “pp” and is not a normal user id but this is not required. You should normally do most of the compilation and configuration as this user.

The distribution tape contains the hierarchy for the pp-6.0/ directory. Bring the sources on-line by changing to a directory for local sources and running tar as the pp username you have chosen, e.g.:

% cd /usr/src/local/
% tar xf tarfile
% cd pp-6.0/

CONFIGURATION
First, go to the config/ directory:

% cd config

Select the Makefile and include-file skeletons which most closely match your system. The current choices are:

sun	Fairly standard sun configuration
vax	Fairly standard vax configuration
s5r4	System Five, release 4
hpux	Hewlet Packard

more samples welcome

The makefile skeleton has the extension .make, and the include-file skeleton has the extension .h.

  MAKEFILE
Copy the makefile skeleton of your choice to pickle.make, where “pickle” is the name of your system. Now edit this file to set the make variables. There are many of these, please refer to The PP Manual: Volume 1 - Installation and Operation. However, some of the more obvious variables are documented in ./OPTIONS.make.

Link pickle.make to Make.defs in the base directory.

% ln pickle.make ../Make.defs

  INCLUDE-FILE
Copy the include-file skeleton of your choice to pickle.h, where “pickle” is the name of your system. Now add any additional definitions you may need. Consult the file ./OPTIONS.h for a list.

Now, link pickle.h to ../h/config.h.

% ln pickle.h ../h/config.h

GENERATION
It is assumed that you have ISODE 7.0 installed on the machine in question, including the X.500 libraries -ldsap -lisode. If you wish to build the grey book channels for JANET mail, you should first build and install the unix-niftp package.

Go to the pp-6.0/ directory and generate the basic system:

% cd ..
% ./make

This will cause a complete generation of the system. If all goes well, proceed with the installation. If not, complain, as there “should be no problems” at this step. It may be worth saving the output of the make stage in a file in case things do go wrong.

INSTALLATION
You will need to be the super-user to install the software. There are two kinds of activities: once-only activities that you perform the first time the software is installed; and each-time activities that you perform every time the software is installed.

The first once-only activity is to create the necessary basic directories to install the commands. This is done by issuing the command as super-user:

# su
# ./make dirs

Note that the pp user id needs to have been allocated at this point.

The second once-only activity is to make sure that PP will run when when the machine goes multi-user. On Berkeley UNIX systems, add something along these lines to the /etc/rc.local file:

if [ -f /usr/lib/pp/pp.start ]; then
    /usr/lib/pp/pp.start & (echo -n ' pp') > /dev/console
fi

There are some examples of this start-up script in the config directory.

  NOTE
If you wish to use smtp then it may be appropriate to start the smtp server for /etc/inetd by adding a suitable line to /etc/inetd.conf. See Volume 1 for more details, but the basic format is something like:

smtp stream tcp nowait pp /usr/lib/pp/cmds/chans/smtpd smtpd /usr/lib/pp/cmds/chans/smtpsrvr smtp

To allow processes to contact the qmgr you must add a line to your isoentities file,

pickle "pp qmgr" 1.17.6.2.1 #1001/Internet=pickle+18000

You will need to replace “pickle” by your local host, and you may need to change the isomacro “Internet” to something else if you have a local ethernet or similar.

Alternatively you may add a suitable entry to the directory if this is being used as a nameserver. Some samples are given below the examples directory.

Then to install the following each-time activity is:

% su
Password:
# ./make install

If you plan to run the MTAconsole program (and you should!) you will need to install the application defaults file. This is in the MTAconsole directory and it should be installed as MTAconsole in the app-defaults directory in your X hierarchy. For instance:

# cd Src/MTAconsole
# cp MTAconsole.ad /usr/lib/X11/app-defaults/MTAconsole

The same is true of the user utility xalert. This has a similar set of application defaults that should be installed.

That's about it. This will install everything. To clean-up the source tree as well, then use:

% make clean

at this point. (However, unless you are very tight for space save this step until you are sure things are working.)

If this is the first time you have used PP it is worth picking one of the example configurations in the examples/ directory. Choose a sample that is close to your requirements as a starting point. The available samples are

LOCALSMTP	Very simple local smtp only
JANET	A simple JANET configuration
INTERNET	A simple Internet site

Change to one of these directories, and read the README there. This will tell you to do various things, depending on what configuration you have chosen. Remember, this is only an example and will not deal with all your needs.

After all is set up, and at regular intervals, you should check all is ok by running ckconfig (found in the tools directory) which will check things are installed correctly.

Finally, if you are interested in discussing PP with others running the software, drop a note to the Janet mailbox “pp-people-request@cs.ucl.ac.uk”, and ask to be added to the “pp-people@cs.ucl.ac.uk” list.

TAILORING
Tailoring is an essential part of running PP. This is somewhat complex to achieve the correct setup and so is described in Volume 1 of the PP manual. It is important that this is followed carefully.

GENERATING DOCUMENTATION
The directory doc/ contains the documentation set for this release. Consult the file doc/READ-ME for a description of each document. The directory doc/ps/ contains PostScript versions of each document. These can be used to generate standard documentation on PostScript printers, but users who want to preview the documentation should generate the .dvi files from the SLiTeX and LaTeX sources.

If you received this distribution from the network, then the directory doc/ps/ does not contain any PostScript files. There should be a separate compressed tar file, containing only PostScript files, available on the machine where you retrieved this distribution.

REPORTING PROBLEMS
Comments concerning this release should be directed to the authors. Consult the preface in the User's Manual for a current postal address. Alternately, if you have access to the Janet network, comments may be sent to the mailbox “pp-support@cs.ucl.ac.uk”. Do not send bug reports to the pp-people discussion group.

SEE ALSO
ckconfig(8), dbmbuild(8)
The PP Manual: Volume 1 - Installation and Operation