Instructions on how to run XWiki on JBoss

JBoss installation

These instructions are for the JBoss Application Server 4.0.X and MySQL ; other versions may differ.

* Download and install JBoss Application Server . It's usually as simple as unzipping it in a directory. Let's call this directory [JBOSS_HOME].
* (optional) If you want to modify the port on which JBoss is running, edit [JBOSS_HOME]/server/default/deploy/bossweb-tomcat55.sar/server.xml. Search for "8080" and replace with the port value you wish to use. Change the [JBOSS_HOME]/server/default/deploy/http-invoker.sar/META-INF/jboss-service.xml using the same way to the port you like.

Configure JBoss

* If your datasource is a MySQL database then copy the file called "mysql-xa-ds.xml" in to the "[JBOSS_HOME]/server/default/deploy" directory.
* Put the relevant mysql java connector jar file to the "[JBOSS_HOME]/server/default/lib".


Install XWiki application

* Add a jboss-web.xml to the "WEB-INF" directory in the XWiki WAR.
* Copy the XWiki WAR into a directory named xwiki/ in [JBOSS_HOME]/server/default/deploy.