                     UltraPossum SI Testing Framework

                                                    VA Linux Systems Japan, Inc.

  UltraPossum SI Testing Framework provides a framework to test your 
  UltraPossum server on your installation.

  As examples, this framework includes the following simple tests:

    * Basic LDAP protocol tests
        - Add
        - Modify
        - Delete
        - Search

    * Basic Replication test
         (If you setup your server with replication capability)

    * Failover availability test
         (If you setup your server with failover capability)
        - Simple Failover

  1) Writing your own test scripts

      All your settings (see ultrapossum.cf (5)) are gotten from
      environment variables.

      You don't have to initialize nor finalize LDAP directory for tests
      because this testing framework cares all the stuff about initialization
      and finalization. You can touch any DN under SUFFIX environment variable.

      All tests are independent from other scripts about directory.

      All messages to stdout/stderr are logged.


  2) Testing your LDAP server

      UltraPossum SI Testing Framework can be also used from your own LDAP
      server. In order to to this:

       - SLAPD_PIDFILE=<YOUR_OWN_SLAPD_PIDFILE> in ultrapossum.cf
       - Copy your own slapd.conf to UltraPossum's slapd.conf
       - Insert the folloing line at the last line of your all slapd.conf

          include <prefix>/share/ultrapossum/conf.d/ultrapossum.conf

