Show INSTALL syntax highlighted
Full documentation of GBAgent can be found from gb-docs package.
It's also available with web browser at:
http://gridblocks.sourceforge.net/agent/index.html
========== Installation of binary releases ==========
GBAgent client does not need any kind of installation, see the README
file of how to use the client.
GBAgent server needs J2EE servlet container, such as Tomcat or JBoss.
Tomcat 5.5 and JBoss 4.0.2 are tested. To get Axis based communication
work inside JBoss, you need to remove the jboss-ws4ee.sar directory
from configuration's (ex. default) deploy directory.
GBAgent server can be deployed just by copying the WAR file
(gb-agent.war) into servlet container's deploy directory. The
service is accessible with your web browser at
http://server:8080/gb-agent.
============= Building from sources =============
I. Dependencies
GBAgent depends on Bluetooth plugin. It should be released first:
sh build.sh release [in plugins/fi.hip.gb.bluetooth directory]
sh build.sh release-plugins [in root directory]
You also need builder module if the code is taken from the CVS.
Builder is included into the source release of GBAgent.
II. Agent client
To build the client issue in gb-agent/gb-agent directory:
sh build.sh client
This compiles the client distribution into output/client directory
and packages the binary release into output/gb-agent.jar.
Now you can continue as described in README file.
III. GBAgent servers:
Compilation and deployment can be done automatically:
sh build.sh deploy [deploys under $TOMCAT_HOME]
sh build.sh deploy-ee [deploys under $JBOSS_HOME]
or by steps:
a) delete old ${TOMCAT_HOME}/webapps/gb-agent directory if exits
b) create gb-agent.war package
sh build.sh server
c) copy the resulting output/gb-agent.war into Tomcat's webapps directory
or link the deployment directory
ln -s output/gb-agent ${TOMCAT_HOME}/webapps/gb-agent
or modify Tomcat's server.xml to load the service from some other directory
See more files for this project here