Making and Installing the UltraPossum
===============================================

This file provides brief instructions on how to build and install
UltraPossum on UNIX (and UNIX-like) system.

Making and Installing the UltraPossum
-----------------------------------------------

1. Unpack the distribution and change directory:

	% tar xfz ultrapossum-VERSION.tar.gz
	% cd ultrapossum-VERSION

   (replacing VERSION with the appropriate version string).  If you
    are reading this file, you probably have already done this!

2. Type:

	% ./configure [options]

    The UltraPossum understands all the standard options of
    configure. In addition, the following options are supported:

	* --with-ldapsysconfdir=DIR

	  This changes the default directory where slapd.conf is located.

	* --with-hasysconfdir=DIR

	  This changes the default directory where heartbeat configurations
	  are located.

	* --with-halocalstatedir=DIR

	  This changes the default directory of heartbeat localstatedir.

        * --with-modules=MODULES

	  This specifies modules to enable. MODULES is a comma separated
	  list of modules. By default, modules which work on your environment
	  are automatically enabled. Currentlly supported modules are:

	    server, startTLS, failover, vaj-robust, dnsbalance

          If you want to use startTLS, failover or vaj-robust, then
	  you must enable server module, too.

3. Type:

	% make check

    This command checks whether the configuration is sane.

4. Install the binaries and man pages. You may need to be come
   the super-user (e.g. root) to do this (depending on where
   you are installing things):

	% su -c "make install"

Making and Installing the UltraPossum Perl interface (OPTIONAL)
---------------------------------------------------------------

This is a optinal interface to perl. If you start to use UltraPossum
quickly, then you don't have to install this interface at first.
You can install this interface later when you want this.

1. Change directory to perl directory from the top source directory

	% cd perl

2. Type:

	% perl Makefile.PL
	% make
	% make test
	% make install

     See perl/README for more details.
