Setting up WebSphere Application Server

Before you can deploy the adapter web application war file, set up your WebSphere® Application Server using the console.

Before you begin

Ensure you have completed the following tasks:

About this task

You set up the application server with specific properties for the Rational® Adapter for HP ALM web application that you are about to deploy:

Procedure

  1. Open the Admin console for the WebSphere Application Server.
  2. To start the application server profile that you created, in the WebSphere Integrated Solutions 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 machine combined to prevent paging or swapping. Paging reduces the performance of the system and affects the performance of the Java memory management system.

    When increasing the Java heap size, ensure that enough unused physical memory is available on the machine to cover the increase. If sufficient physical memory is not available, either install additional 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 the following setting, replacing {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, -Xmn should be set 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. 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