                         The UltraPossum Server

                                                    VA Linux Systems Japan, K,K.

The UltraPossum server provides a high-available robust LDAP server
environment on your network. This supports the following:

     * LDAPv3 Protocol Standard support
     * Automatic failover capability for a single-master LDAP environment
     * Automatic replication capability for load balancing
     * Automatic Installation Test capability
     * On-demand LDAP backup/slave servers registration (TODO)

The UltraPossum consists of several components such as OpenLDAP, heartbeat
and mon. It has a meta-configuration to create each configuraiton for them
by using the UltraPossum configuraiton system.

                    +------------------------------+
                    |UltraPossum META Configuration|
                    +------------------------------+
                                  ||
                  The UltraPossum Configuraiton System
                                  ||
            +---------++----------++-----------------------+
            |         ||          ||                       |
            |         ||   ( failover plugin )    ( failover plugin )
            |         --          ||                       |
  +----------------------+ +-----------------+ +-----------------------+
  |OpenLDAP Configuration| |Mon Configuariton| |Heartbeat Configuration|
  +----------------------+ +-----------------+ +-----------------------+
                      --
                      ||
                 ( TLS/SSL plugin )
                      ||
                    +----------------------+
		    |startTLS Configuration|
                    +----------------------+

  * QuickStart

    At first, check whether the UltraPossum server is installed.
    If not, you have to install the UltraPossum server. 
    See INSTALL for more info.

    First, you have to set PATH environment variable.
    Usually, the following directories are needed:

      ${prefix}/bin
      ${prefix}/sbin

    So if you configure this like ./configure --prefix=/usr/local/ultrapossum,
    then you would specify

      PATH=/usr/local/ultrapossum/bin:/usr/local/ultrapossum/sbin:$PATH

    Next, this makes the UltraPossum server start.

      % ${prefix}/share/ultrapossum/module.d/server/startup start

      ${prefix} is /usr/local by default. you can specify this value
      in --prefix argument of configure.

      This command prints the list of daemons executed to stdout.

        or

      % /etc/init.d/ultrapossum-server start

       if you installed ultrapossum from package.
       or you can copy the following scripts directly:

         debian/ultrapossum-server.init.d ( for Debian )
	 redhat/ultrapossum.init ( for Fedora )
         tools/solaris.init ( for Solaris ) 

    - Customizing

        See /etc/ultrapossum/ultrapossum.cf

