This is a simple XML-RPC interface for dbXML. It defines only basic operations
which do not include the administration methods. If you need to admin the server
you should use the default XML:DB API.


Configuring dbXML:

1. Copy the helma-xmlrpc.jar and dbxml-xmlrpc.jar files from the distribution 
   lib directory into $DBXML_HOME/java/lib.

2. Add the XMLRPCHandler to your dbXML configuration. To do this you must edit 
   $DBXML_HOME/config/system.xml.

   Right after the line that looks like

      <components class="org.dbxml.server.standard.StdComponentManager">
      
   You should add this line.      

      <component class="org.xmldatabases.xmlrpc.XMLRPCHandler" name="XMLRPCHandler"/>

3. Start dbXML as usual and you should see the following show up among the 
   startup messages.

   Filter: 'XMLRPCHandler' added to filtering chain

   If you don't get this message double check your configuration.      

   
From here the server is ready and you should look at the users guide to see how
to call the new XML-RPC methods exposed by the server.

Optional: Once you have your server setup you can test your setup by running the
   following commands. Make sure your dbXML instance is running
   
   Create the collection required by the tests.
   
   dbxmladmin ac -c /db -n rpctests
   
   Run the tests (You need the ant script from your dbXML installation)
   
   ant tests
   
   If the tests passed, remove the collection.
   
   dbxmladmin dc -c /db -n rpctests
   
This will run the basic test suite and if everything is setup properly all 
tests should pass.