Wiki source code of JBoss Installation
Version 18.1 by Vincent Massol on 2012/06/29
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | = JBoss AS 7.x = | ||
| 6 | |||
| 7 | * [[Download and install JBoss Application Server>>http://www.jboss.org/jbossas/]] | ||
| 8 | * Deploy the XWiki WAR either by using JBoss AS Admin (recommended) or by deploying on the filesystem. Read the [[JBoss AS docs>>https://docs.jboss.org/author/display/AS71/Documentation]] to learn how to do this | ||
| 9 | * If you have class loader issues read [[how JBoss AS7 Classloader works>>https://docs.jboss.org/author/display/AS71/Developer+Guide#DeveloperGuide-ClassloadinginJBossAS7]] | ||
| 10 | |||
| 11 | = JBoss AS 4.0.x = | ||
| 12 | |||
| 13 | * Download and install JBoss Application Server . It's usually as simple as unzipping it in a directory. Let's call this directory ##$JBOSS_HOME##. | ||
| 14 | * (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. | ||
| 15 | * 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. | ||
| 16 | * Edit ##$JBOSS_HOME/server/<mode>/deploy/jbossweb-tomcat55.sar/server.xml## to set UTF-8 encoding:((( | ||
| 17 | {{code}} | ||
| 18 | <Connector port="8080" ... URIEncoding="UTF-8"/> | ||
| 19 | <Connector port="8009" ... URIEncoding="UTF-8"/> | ||
| 20 | {{/code}} | ||
| 21 | ))) | ||
| 22 | |||
| 23 | == Classloading Isolation == | ||
| 24 | |||
| 25 | The default JBoss behavior is that classes inside of the ##WEB-INF/classes## and ##WEB-INF/lib## directories of the WAR file are incorporated into the default shared class loader repository. This allows classes and resources to be shared between web applications. However this means that JARs provided by XWiki in ##WEB-INF/lib## will get mixed with JARs provided by JBoss and if both application provide the same JAR but in a different version, class incompatibilities will occur. | ||
| 26 | |||
| 27 | To solve this, please read up on [[JBoss ClassLoading Configuration>>http://community.jboss.org/wiki/ClassLoadingConfiguration]] in order to configure JBoss to not use the unified class loader (set ##UseJBossWebLoader## to ##false## in ##META-INF/jboss-service.xml##). | ||
| 28 | |||
| 29 | Alternatively you may try to remove the clashing JARs from XWiki's ##WEB-INF/lib## hoping that the version provided by JBoss is compatible with XWiki's needs. | ||
| 30 | |||
| 31 | == Log4j Error == | ||
| 32 | |||
| 33 | {{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}} | ||
| 34 | |||
| 35 | * Edit ##$JBOSS_HOME/server/<server configuration>/jbossweb-tomcat55.sar/META-INF/jboss-service.xml## file and replace: | ||
| 36 | |||
| 37 | {{code}} | ||
| 38 | <attribute name="Java2ClassLoadingCompliance">false</attribute> | ||
| 39 | <attribute name="UseJBossWebLoader">false</attribute> | ||
| 40 | {{/code}} | ||
| 41 | |||
| 42 | with: | ||
| 43 | |||
| 44 | {{code}} | ||
| 45 | <attribute name="Java2ClassLoadingCompliance">true</attribute> | ||
| 46 | <attribute name="UseJBossWebLoader">true</attribute> | ||
| 47 | {{/code}} | ||
| 48 | |||
| 49 | This is to avoid class loading issues for Log4J library. Refer http://lists.xwiki.org/pipermail/users/2007-September/008503.html for more information. | ||
| 50 | |||
| 51 | = Using a JBoss DataSource = | ||
| 52 | |||
| 53 | * Uncomment the ##resource-ref## section in XWiki's ##web.xml## file. | ||
| 54 | * Modify XWiki's ##WEB-INF/hibernate.cfg.xml## file to tell Hibernate to use a DataSource rather than a direct JDBC connection | ||
| 55 | * Copy the attach:jboss-web.xml file to XWiki's ##WEB-INF/## directory | ||
| 56 | |||
| 57 | = Issues related to JBoss = | ||
| 58 | |||
| 59 | {{jira style="table" url="http://jira.xwiki.org" jql="true"}} | ||
| 60 | labels = jboss | ||
| 61 | {{/jira}} |
