Wiki source code of JBoss Installation
Version 14.1 by Vincent Massol on 2011/05/03
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | These instructions are for [[JBoss Application Server>>http://labs.jboss.com/jbossas/download]] 4.0.X. | ||
| 2 | |||
| 3 | * Download and install JBoss Application Server . It's usually as simple as unzipping it in a directory. Let's call this directory ##$JBOSS_HOME##. | ||
| 4 | * (optional) By default JBoss runs on port 8080. If you want to modify the port on which JBoss is running, edit ##$JBOSS_HOME/server/<mode>/deploy/jbossweb-tomcat55.sar/server.xml##. Search for ##8080## and replace with the port value you wish to use. Similarly change the port in ##$JBOSS_HOME/server/<mode>/deploy/http-invoker.sar/META-INF/jboss-service.xml## to the value you like. | ||
| 5 | * Copy and expand the XWiki WAR into a directory named ##xwiki.war/## (note that unlike most servlet containers JBoss wants the directory name to end with ##.war##) in ##$JBOSS_HOME/server/<server configuration>/deploy## where ##server configuration## is the JBoss configuration you're using. | ||
| 6 | |||
| 7 | = Classloading Isolation = | ||
| 8 | |||
| 9 | It seems that by default JBoss AS doesn't isolate JARs located in ##WEB-INF/lib## from the JARs provided by the appserver itself, thus leading to version clashing between JARs provided by XWiki and JARs provided by JBoss. | ||
| 10 | To solve this, please read up on [[JBoss ClassLoading Configuration>>http://community.jboss.org/wiki/ClassLoadingConfiguration]]. | ||
| 11 | |||
| 12 | = Log4j Error = | ||
| 13 | |||
| 14 | {{warning}}It was reported that with XWiki 1.6 and JBoss 4.0.4, these settings change would generate an error with hibernate. Everything seems to work fine without these settings including classloading of log4j{{/warning}} | ||
| 15 | |||
| 16 | * Edit ##$JBOSS_HOME/server/<server configuration>/jbossweb-tomcat55.sar/META-INF/jboss-service.xml## file and replace: | ||
| 17 | |||
| 18 | {{code}} | ||
| 19 | <attribute name="Java2ClassLoadingCompliance">false</attribute> | ||
| 20 | <attribute name="UseJBossWebLoader">false</attribute> | ||
| 21 | {{/code}} | ||
| 22 | |||
| 23 | with: | ||
| 24 | |||
| 25 | {{code}} | ||
| 26 | <attribute name="Java2ClassLoadingCompliance">true</attribute> | ||
| 27 | <attribute name="UseJBossWebLoader">true</attribute> | ||
| 28 | {{/code}} | ||
| 29 | |||
| 30 | This is to avoid class loading issues for Log4J library. Refer http://lists.xwiki.org/pipermail/users/2007-September/008503.html for more information. | ||
| 31 | |||
| 32 | = Configuration XWiki to use a JBoss DataSource = | ||
| 33 | |||
| 34 | * Uncomment the ##resource-ref## section in XWiki's ##web.xml## file. | ||
| 35 | * Modify XWiki's ##WEB-INF/hibernate.cfg.xml## file to tell Hibernate to use a DataSource rather than a direct JDBC connection | ||
| 36 | * Copy the attach:jboss-web.xml file to XWiki's ##WEB-INF/## directory |
