JBoss Typical Configurations

JBoss Typical Configurations

  
Hi,
Everytime you install an OutSystems Platform with a JBoss application server, there are a couple of customizations that most people perform, namely:
  • Configuring the maximum post size
  • Enabling HTTPS
  • Configuring the maximum number of connection requests.
This post guides you on how to perform these customizations.

Before you start

 Before doing these customizations you should read the OutSystems Platform Installation Prerequisites technical note to find where the OutSystems Platform stores the several existing configuration files.

For JBoss 5 there are two configuration files:
$JBOSS_HOME/server/outsystems/deploy/jbossweb.sar/server.xml
$JBOSS_HOME/server/outsystems/deploy/jbossweb.sar/context.xml
While in JBoss 7 the configurations are stored in a single file:
$JBOSS_HOME/standalone/configuration/standalone-outsystems.xml
Before changing these files, you should check JBoss official documentation to understand the side effects of these changes:

Configuring the maximum post size

For JBoss5, find the <Connector> XML element with the attribute port="8080" or port="8443" , and modify the maxHttpHeaderSize attribute (or create it if it does not exist) to set it with the maximum post size in bytes you want to allow for this application server.

For JBoss7, find the <Connector> XML element with the attribute port="8080" or port="8443" , and modify the max-post-size attribute (or create it if it does not exist) to set it with the maximum post size in bytes you want to allow for this application server.

 

Enabling HTTPS

For JBoss 5 simply uncomment the XML element after <!-- SSL/TLS Connector configuration using the admin devl guide keystore -->

For JBoss 7, find the <Connector> XML element with the attribute port="8443", and make sure it contains enabled="true"

Configuring the maximum number of connection requests

For JBoss5, find the <Connector> XML element with the attribute port="8080" or port="8443" , and modify the maxThreads attribute (or create it if it does not exist) to set it with the maximum number of threads you want to allow for dealing with requests.

For JBoss7, find the <Connector> XML element with the attribute port="8080" or port="8443" , and modify the max-connections attribute (or create it if it does not exist) to set it with themaximum number of threads you want to allow for dealing with requests.