Skip to Content

Wiki source code of JBoss Installation

Version 21.3 by lcotonea on 2013/04/25
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 = JBoss AS 7.x =
6
7 * Download and install the [[JBoss Application Server>>http://www.jboss.org/jbossas/]]
8 * Deploy the XWiki WAR either by using the JBoss AS Admin (recommended) or by deploying on the filesystem. Read the [[JBoss AS documentation>>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 == Troubleshooting ==
12
13 === "More than the maximum number of request parameters" error ===
14
15 If you get the following error in the logs when trying to import a large XAR:
16
17 {{code}}
18 Servlet.service() for servlet action threw exception: java.lang.IllegalStateException: More than the maximum number of request parameters (GET plus POST) for a single request ([512]) were detected. Any parameters beyond this limit have been ignored. To change this limit, set the maxParameterCount attribute on the Connector.
19 {{/code}}
20
21 You'll need to [[configure Tomcat in JBoss to support more than 512 form fields>>https://community.jboss.org/thread/177942]].
22
23 = JBoss AS 4.0.x =
24
25 * Download and install the "JBoss Application Server". It's usually as simple as unzipping it in a directory. Let's call this directory ##$JBOSS_HOME##
26 * (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 it 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
27 * 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
28 * Edit ##$JBOSS_HOME/server/<mode>/deploy/jbossweb-tomcat55.sar/server.xml## to set UTF-8 encoding:(((
29 {{code}}
30 <Connector port="8080" ... URIEncoding="UTF-8"/>
31 <Connector port="8009" ... URIEncoding="UTF-8"/>
32 {{/code}}
33 )))
34
35 == Classloading Isolation ==
36
37 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.
38
39 To solve this please read up on [[JBoss ClassLoading Configuration>>https://community.jboss.org/wiki/ClassLoadingConfiguration]] in order to configure JBoss not to use the unified class loader (set ##UseJBossWebLoader## to ##false## in ##META-INF/jboss-service.xml##).
40
41 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.
42
43 == Log4j Error ==
44
45 {{warning}}
46 It was reported that with XWiki 1.6 and JBoss 4.0.4, using these settings would generate an error with hibernate. Everything seems to work fine without these settings including classloading of log4j.
47 {{/warning}}
48
49 * Edit ##$JBOSS_HOME/server/<server configuration>/jbossweb-tomcat55.sar/META-INF/jboss-service.xml## file and replace:
50 (((
51 {{code}}
52 <attribute name="Java2ClassLoadingCompliance">false</attribute>
53 <attribute name="UseJBossWebLoader">false</attribute>
54 {{/code}}
55 )))
56 with:
57 (((
58 {{code}}
59 <attribute name="Java2ClassLoadingCompliance">true</attribute>
60 <attribute name="UseJBossWebLoader">true</attribute>
61 {{/code}}
62 )))
63 This is to avoid class loading issues for the Log4J library.
64
65 = Using a JBoss DataSource =
66
67 JBoss links about this topic:
68
69 * [[JBoss AS 7.1 Datasource Configuration>>https://docs.jboss.org/author/display/AS71/DataSource+configuration]]
70 * [[DataSource configuration in AS 7>>https://community.jboss.org/wiki/DataSourceConfigurationInAS7]]
71 * [[JBoss AS 7.1.0.Final "Thunder" released - Java EE 6 Full Profile certified!>>http://planet.jboss.org/post/jboss_as_7_1_0_final_thunder_released_java_ee_6_full_profile_certified]]
72 * [[How do I migrate my application from AS5 or AS6 to AS7>>https://docs.jboss.org/author/display/AS7/How+do+I+migrate+my+application+from+AS5+or+AS6+to+AS7]]
73 * [[Excited about JBoss AS 7.1 Part I: Deployable Datasources>>https://community.jboss.org/en/tools/blog/2012/02/28/excited-about-jboss-as-71-part-i-deployable-datasources]]
74
75 == Tutorial for JBoss AS 7.1 ==
76
77 * Create a JBoss Module for your database driver. For example for HSQLDB, create the directory ##[ASROOT]/modules/org/hsqldb/main## and put the HSQLDB Driver JAR (e.g. ##hsqldb-2.2.9.jar##) in it and also create a ##module.xml## in it and write the following code inside:(((
78 {{code}}
79 <?xml version="1.0" encoding="UTF-8"?>
80 <module xmlns="urn:jboss:module:1.0" name="org.hsqldb">
81 <resources>
82 <resource-root path="hsqldb-2.2.9.jar"/>
83 </resources>
84 <dependencies>
85 <module name="javax.api"/>
86 </dependencies>
87 </module>
88 {{/code}}
89 )))
90 * Create a data source file named ##-ds.xml## (e.g. ##hsqldb-ds.xml##). If you're using a standalone deployment, put it in ##[ASROOT]/standalone/deployments/## (you can also put it in your ##WEB-INF/## dir). Example of content:(((
91 {{code}}
92 <?xml version="1.0" encoding="UTF-8"?>
93 <datasources xmlns="http://www.jboss.org/ironjacamar/schema">
94 <datasource jndi-name="java:jboss/datasources/XWikiDS" pool-name="XWikiDS" enabled="true" use-java-context="true">
95 <connection-url>jdbc:hsqldb:file:[path to your hsqldb db file, e.g. /tmp/xwiki-data/database/xwiki_db];shutdown=true</connection-url>
96 <driver>hsqldb</driver>
97 <security>
98 <user-name>sa</user-name>
99 <password></password>
100 </security>
101 </datasource>
102 </datasources>
103 {{/code}}
104 )))
105
106 == Old Tutorial ==
107
108 * Uncomment the ##resource-ref## section in XWiki's ##web.xml## file. You should have:(((
109 {{code}}
110 <resource-ref>
111 <description>DB Connection</description>
112 <res-ref-name>jdbc/XWikiDS</res-ref-name>
113 <res-type>javax.sql.DataSource</res-type>
114 <res-auth>Container</res-auth>
115 </resource-ref>
116 {{/code}}
117 )))
118 * Create the following ##jboss-web.xml## file in the deployed XWiki's ##WEB-INF/## directory:(((
119 {{code}}
120 <?xml version="1.0" encoding="ISO-8859-1"?>
121 <!DOCTYPE jboss-web PUBLIC "-//JBoss//DTD Web Application 2.3V2//EN" "http://www.jboss.org/j2ee/dtd/jboss-web_3_2.dtd">
122 <jboss-web>
123 <resource-ref>
124 <res-ref-name>jdbc/XWikiDS</res-ref-name>
125 <jndi-name>java:jboss/datasources/XWikiDS</jndi-name>
126 </resource-ref>
127 </jboss-web>
128 {{/code}}
129 )))
130 * Modify XWiki's ##WEB-INF/hibernate.cfg.xml## file to tell Hibernate to use the defined DataSource rather than a direct JDBC connection:(((
131 {{code}}
132 ...
133 <property name="connection.datasource">java:jboss/datasources/XWikiDS</property>
134 ...
135 {{/code}}
136 )))
137
138 = Issues related to JBoss =
139
140 {{jira URL="http://jira.xwiki.org" source="jql"}}
141 labels = jboss
142 {{/jira}}

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected