Getting Started with the Web Interface to Cerber Grid

1. Install the prerequisites

Java JDK 5 or greater - http://java.sun.com/javase/downloads/index.jsp

Standalone Cerber Grid EAR + JBoss here: Download Files

OR

JBoss 4.0.5 installed through the JEMS Installer with the ejb3 profile.
Invoke the installer like this:

java -jar <jems installer jar>
And accept all default values except the selection of the profile in which you will want to select ejb3 Test everything has been correctly setup by navigating to JBOSS_HOME/bin and executing:
./run.sh
If you see no exceptions you are good to go, if you do see exceptions make sure that java and javac are correctly on the path (in Linux). You can alternatively set the JAVA_HOME variable in JBOSS_HOME/bin/run.conf which is the method I prefer.

Any of the databases listed here can be used: Hibernate Dialects
For this example, I will be using MySQL 5.0 - MySQL 5.0 Downloads
The database must correspond to the database used to set up Cerber Grid noted here

-- Using the Standalone Web UI release

Download Files

The standalone release contains a slimmed down version of JBoss ~60M with the exploded Cerber Grid ear already in the deploy directory. All that is required is to change the cerbergrid-ds.xml to the values corresponding to your database. This standalone release already contains the mysql-connector jar.

-- Using your own JBoss

Download the cerbergrid ear zip Download Files

Make sure the server is stopped before you copy the files over, you will need to modify several files before deploying.

cp cerbergrid-ds.xml JBOSS_HOME/server/default/deploy

cp -R cerbergrid.ear JBOSS_HOME/server/default/deploy

After editing the cerbergrid-ds.xml file as highlighted in the next section, note the following:
If JBoss is not started start it and watch the console where you started JBoss. If you see exceptions when Cerber Grid is being deployed please report it to Bugs and I will handle it as soon as I am able. Otherwise, congratulations, Cerber Grid has been successfully deployed to JBoss.

A. Copy the database JDBC connector to JBoss

For mysql I downloaded mysql-connector-java-5.0.3-bin.jar and copied it to JBOSS_HOME/server/default/lib

B. Configure the cerbergrid-ds.xml file to point to the database

Edit cerbergrid-ds.xml

<?xml version="1.0" encoding="UTF-8"?>

<datasources>
	<local-tx-datasource>
		<jndi-name>CerberGridDatasource</jndi-name>
		<connection-url>jdbc:mysql://127.0.0.1/cerbergrid</connection-url>
		<driver-class>com.mysql.jdbc.Driver</driver-class>
		<user-name>root</user-name>
		<password>hardpassword</password>
	</local-tx-datasource>
</datasources>

C. Create the database/schema/catalog in your database

For Mysql do the following: mysql > create database cerbergrid;

D. Run the Cerber Grid Web Interface

Navigate to http://localhost:8080/cerbergrid and register.