Setting up WebSphere Application Server

Use the console to set up your WebSphere® Application Server before you deploy the adapter web application.

Before you begin

The following tasks are done:

About this task

You use the console to set up the application server with specific properties for the adapter web application that you are about to deploy.

Procedure

  1. Open the Admin console.
  2. To start the application server profile that you created, in the console, click Servers > Server Types > WebSphere application servers > ProfileName where ProfileName is the name of your application server profile.
  3. Under Server Infrastructure, click Java and Process Management > Process definition.
  4. Under Additional Properties, click Java Virtual Machine.
  5. Add the value 4096 to Initial Heap.
  6. Add the value 4096 to Maximum Heap Size.
    Tip: The figure here is only a suggestion; set the value according to your environment. A typical medium-size team can use a value of 4096 MB, providing 4 GB of heap memory for the application server process on a 64-bit computer. It is important to use the same amount for Initial and Maximum heap sizes. If you reduce the initial and maximum heap sizes from 4 GB, you must also change the JVM arguments -Xmx4g and -Xms4g to match the specified heap size

    It is also important to have more physical memory than is required by all of the processes on the system that is combined to prevent paging or swapping. Paging reduces the performance of the system and affects the performance of the Java memory management system.

    When you increase the Java heap size, ensure that enough unused physical memory is available on the system to cover the increase. If sufficient physical memory is not available, either install more memory or take into account the effect on overall performance that occurs.

  7. In the Generic JVM arguments field, type the following line:
    For Windows
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    For Linux
    -Xmx4g -Xms4g -Xmn512m
    -Xgcpolicy:gencon -Xcompressedrefs
    -Xgc:preferredHeapBase=0x100000000
    Tip: If you need more heap size, then you can use a different size. Replace {N} with the amount of memory to be used and {N/8} with 1/8 of the total memory. For example, if -Xmx is set to 8g, set -Xmn to 1g.
    -Xgcpolicy:gencon -Xmx{N} -Xms{N} -Xmn{N/8}
    -Xcompressedrefs  -Xgc:preferredHeapBase=0x100000000
  8. Click Apply, and then click Save directly to the master configuration.
  9. One of the custom properties you must add is derby.system.home, a property that specifies where to find the adapter database.
    1. Under Java Virtual Machine > Additional Properties, click Custom properties.
    2. Click New, enter derby.system.home in the Name field, and enter Absolute path to the location where you want to create the Rational Adapter for HP ALM database in the Value field.
  10. Click OK.
  11. Click Save directly to the master configuration.
  12. For changes to take effect, restart the application server. Use the application server profile that you set up previously.

What to do next

Deploy the adapter web application by using the console, see Deploying on WebSphere Application Server.

Feedback