
Argo
----

  Argo is a distributed monitor for the Xen hyperviser / virtual machine
 host.

  Argo is released as a simple Perl server and a number of clients.

  The server runs upon your Xen host, and will allow you to manipulate
 the Xen instances running upon it via any Argo-client running anywhere
 upon your network.



Network API
-----------

  The server implements a simple text-based protocol which allows
 clients to connect and control the Xen instances upon your Xen
 server.

  The network protocol, and primitives used, is documented upon 
 the project's homepage:

		http://www.steve.org.uk/Software/argo/

  Whilst the protocol may be improved and updated in the future it
 is currently extensible and deliberately simple to write clients
 for.



Using Argo-Server
-----------------

  Install the server packages:

  apt-get install argo-server

  Once the server is installed you should review the configuration
 file which contains details of users who are allowed to connect to
 the server:

		 /etc/argo-server/argo-server.conf

  NOTE: You should make sure this file is not world-readable upon 
        your server if you have untrusted users.

  Once you're happy with the setup there then start the server:

  /etc/init.d/argo-server start



Perl Client
-----------

  Run 'argo-perl' and connect to your Argo-server using the 'File | Connect'
 menu option.


PHP Client
----------

  Setup your Apache server to read content from the installed directory
 with a setup similar to this:


<VirtualHost *>
        DocumentRoot /usr/share/argo/
	ServerName   xen
	ServerAlias  xen.my.flat

        DirectoryIndex index.php

	# Logfiles
        ErrorLog  /var/log/apache2/argo-error.log
        CustomLog /var/log/apache2/argo-access.log combined
</VirtualHost>

  Now reload Apache, and point a browser at http://xen/index.php


Comments?
---------

  If you have comments, feedback, questions, or you wish to 
 tell me about your client then please feel free to mail me.

  All feedback is appreciated, whether it is a simple thanks
 or a bugreport.


Steve
-- 
$Id: README,v 1.7 2006/03/02 17:17:18 steve Exp $
