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"

