Directories are noted in ant variable mode ; ${oxerp.home} stands for a directory you choose to be the main directory for oxerp, for instance "c:/oxerp" or "/oxerp" according to your platform. Be careful to choose 8 characters max under Win98 for directories names. You should use the quick install first. You can rebuild server and client using the "build section" below. You can manually install the prebuild bundles with the "server" and "client" sections.

• Install jvm1.4+ : java.sun.com

• Download the oxerp-xxx-jboss.jar ; if you want to use your database (currently mysql, oracle) instead of Hypersonic SQL, download oxerp-xxx-jca.zip too

• Drop those files in the directory you want oXerp to be installed

• Double-click on oxerp-xxx-jboss.jar or java -jar oxerp-xxx-jboss.jar

• Install jvm1.4+ : java.sun.com

• Install JBoss3.x : www.jboss.org, download and unzip in ${jboss.home}(we recommend JBoss but you can use another AppServer)

• Do the quickinstall above and pick up oxerp-server.ear under jboss/default/deploy and login-config.xml under jboss/default/config (security realm)

• Install oxerp-server.ear in ${jboss.home}/server/default/deploy

• Drop login-config.xml in ${jboss.home}/server/default/conf and oxerp-security-ds.xml in ${jboss.home}/server/default/deploy for configurig authentication realm

• Configure main database customizing and dropping the corresponding XXX-ds.xml from ${jboss.home}/docs/examples/jca/in ${jboss.home}/server/default/deploy ; drop the corresponding jdbc driver in ${jboss.home}/server/default/lib ; you can use the hsqldb2-ds.xml of the distrib if you can cope with a simple database.

• Run JBoss : ${jboss.home}/bin/run

• You are done with the server-side

• For other application server, you have to adapt the deployment descriptors in the ear.

• Copy the client directory under ${oxerp.home}, obtained through the quick install

• You can also use java -jar oxerp-client-XXX.jar, obtained too through the quick install

• Install ant-1.5 : download from jakarta.apache.org and unzip

• Install XDoclet : www.xdoclet.org

• Install JBoss : www.xdoclet.org

• Change the xdoclet and jboss dir in build.xml

• Download fop, jimi, struts, batik, drop them in a lib directory and change the 'lib' property in build.xml

• Unzip the oxerp-src.zip

• Drop a jboss.zip (JBoss bundled) and a jboss-client.zip in 'srclib/install'

• Drop any jdbc driver wished in 'srclib/jca'

• Use the script/build.xml file with the main target