JBoss Installation Notes

Install JBoss using the instructions provided with the software. You may find helpful information at the JBoss Project site, at http://labs.jboss.com/portal/jbossas .

You may need to perform one or more of these general steps when installing the software:

• Install the full JBoss application server.

• Ensure that the JBoss installation path does not contain spaces.

• Specify the administrator name and password for Application Server administration.

• When configuring JBoss to support UTF-8, add the URIEncoding="UTF-8" attribute to the Connector element in the InstallDir\server\default\deploy\jbossweb-tomcat55.sar\server.xml file, for example:

  <!-- A HTTP/1.1 Connector on port 8080 -->
  <Connector port="17001" address="${jboss.bind.address}"
     maxThreads="250" strategy="ms" maxHttpHeaderSize="8192"
     emptySessionPath="true" enableLookups="false" redirectPort="8443"
     acceptCount="100" connectionTimeout="20000"
     disableUploadTimeout="true" URIEncoding="UTF-8" />

• When configuring JBoss to support UTF-8, also add -Dfile.encoding=UTF-8 in your Java VM options.

• Increase the JBoss PermGen space to avoid out-of-memory errors. For example, add the following arguments in your JAVA_OPTS environment variable to increase the space to 128 MB:

  -XX:PermSize=128m -XX:MaxPermSize=128m