Chapter 3. Configure

Before JBoss BRMS can be deployed as a web archive in IBM WebSphere 8, WebSphere server itself must be configured to accept the deployable. In this section, we will go through the different configuration steps that must be taken before deploying.
Login to your WebSphere 8 console using an administrative login before performing any of these steps. The usual login URL is: http://target-server:9060/ibm/console.

3.1. Increase JVM Heap Size

With the default JVM heap size, the WebSphere 8 server freezes and/or causes deployment errors when deploying Business Central. Increase the heap size by following these steps:
  1. Click on Servers --> Server Types --> WebSphere Application Servers in your WebSphere administrative console.
  2. In the list of application servers, click on the server on which you are going to deploy Business Central. This will open up the configuration page for that server.
  3. Under Server Infrastructure, click on Java and Process Management and then Process Definition. This will open the JVM process definition page.
  4. Click on Java Virtual Machine under the Additional Properties heading. This will open up the configuration properties for the JVM that is used to start WebSphere.
  5. Enter a value of 1536 for the maximum heap size changing it from the default of 1024. Click Apply at the bottom.
  6. You can choose to save these configuration settings to the master WebSphere configuration at this stage.
  7. Restart WebSphere at this point or wait till other configuration changes have been made.

Note

At this stage, you may want to increase the heap size in the Deployment Manager, if installed and being used. To do so, click on System administration → Deployment manager → Java and process management → Process definition → Java virtual machine in your WebSphere administrative console. Enter the maximum heap size and restart the Deployment Manager.