Installation
============

 * To compile the code and create the packages, please refer to README.txt.
 * To install the software from the package, 
 	* please unpack them into a folder within user's home directory,
 	* all the packages should be installed in the same folder,
 	* the CLASSPATH environment variable has to point to the folder containing the external JARs the packages depend on (please see README.txt for the full list or refer to the Support/libs folder in the source bundle), e.g., $CLASSPATH:/usr/lib/xos/dixi/*
 	* The .jar files can be moved into /usr/share/java as long as CLASSPATH will contain string /usr/share/java/*.
 	
It would be possible to install the non-jar files and binaries into another fixed folder, such as /etc/xos/dixi but there are two problems:
 * this configuration has not been fully tested,
 * the *.sh files, located in Support/runscript/maintenance, need to all have modified the line containing "AEM_HOME=`pwd`" into "AEM_HOME=/etc/xos/dixi",
 * all the xosd.sh executions require the -C /etc/xos/dixi command-line parameter, and with sudo, because they may alter the configuration files.
 
Testing the installation
========================

Testing the service start-up
----------------------------

 * cd into the folder containing the *.sh files,
 * execute ./xosd.sh
 * if the script does not stop executing, dumping many exceptions, then it is likely everything is ok.
 * Ctrl+C the script and examine xosd.log
 * If the log contains "INFO  XOSD loaded." and "DEBUG **** Service started: " do not end in errors, then the installation is ok.
 * If the "DEBUG **** Service started: " lines end in exceptions indicating the classes are not found, then it is likely the required packages have not been installed.
 
Testing the clients
-------------------

 * Execute ./xosd.sh.
 * In another console, execute ./xconsole.sh
 * In the XConsole, execute xrs -a
 * After a short time, the console should return something like the following:
 Listing all resources:
   Address = [://194.249.173.88/194.249.173.88:60000(/194.249.173.88)]
