xenstatd XML-RPC server examples
================================
This tarball contains two example XML-RPC servers for the xenstat 
framework.  One is in Python, making use of the libxenstat Python 
bindings and the Python SimpleXMLRPCServer module.  The other is in 
C, using libxenstat's C API and the xmlrpc-c library.


xenstat Python XML-RPC Server
-----------------------------
To run the xenstat Python XML-RPC server, simply ensure that libxenstat 
and the libxenstat Python bindings are installed, and then run
./xenstatd.py as root.  The server listens on port 8000.  You can 
then use an XML-RPC client to call the function "xenstat_gather".


xenstat XMLRPC server in C
--------------------------
This requires libxenstat to be installed, and xmlrpc-c version 1.03. 
This is the only version currently known to work with this
xenstatd-standalone.c.

How To 
------
Download the xmlrpc-c version 1.03 and do the following steps:

1) ***********VERY IMPORTANT*************
when running the configure script for xmlrpc-c  ensure the "--disable-abyss-threads" option
is set ex:
  $ ./configure --disable-abyss-threads

then run make && make install in accordance with xmlrpc-c's README etc

threads must be disabled and forking enabled because abyss threading is incapable of running
libxenstat.  

2)
in xenstatd dir run:
make

3)
to run root is required and a port #, ex:
  $ sudo ./xenstatd 8000
 
4)
to connect to server point to:
http://address:port/RPC2

xml-rpc method "xenstat_gather"

Notes
-----
currently only a standalone version is implemented, which starts a 
small http server and serves data.

To Do
-----
needs more testing
xenversion is not used 
timestamp is not implemented, a place holder is used 
have the abyss server host a small webui to use xml-rpc 
cgi version

Author(s)
---------
Michael Running Wolf <marunnin@us.ibm.com>
