A Java Virtual Machine Configuration

This appendix describes how to adjust JVM memory parameters and turn garbage collection logging on and off. Instructions below cover applications supported by Oracle WebCenter and those standalone Oracle WebCenter components.

The standalone Oracle WebCenter components are:

• Oracle WebCenter Analytics

• Automation Server

• Oracle WebCenter Collaboration

• Document Repository

• Notification

• PTUpload

• Oracle BPM Suite

• Tagging Service

Java Memory Switches

The following are Java memory switches used to tune JVM garbage collection. Use these switches in conjunction with the instructions specific to your application server or Oracle WebCenter product.

• -Xloggc:path/filename

  This switch turns on garbage collection logging for the JVM. Replace path/filename with the location where the garbage collection log should be generated.

• -Xms and -Xmx

  These switches set the minimum (-Xms) and maximum (-Xmx) heap size for the JVM. The JVM adjusts heap size based on object usage and bounded by these two switches. Setting these switches to the same value increases predictability by removing the ability of the JVM to adjust the heap size.

  Caution:

  Fixing the heap size to a specific value requires special attention to memory tuning.

• -XX:NewRatio

  This switch sets the ratio of the young generation to the tenured generation. For example

  -XX:NewRatio=3
  

  would mean that the tenured generation is 3x the size of the young generation, or, in other words, the young generation is one quarter of the heap and the tenured generation is three-quarters of the heap.

Application Servers

This section describes how to configure your application server. Refer to the section that applies to your type of application server.

Tomcat 6.x

To update Java options for Tomcat 6.x on Windows:

1. Run TOMCAT_HOME\tomcat6w.exe

2. Click the Java tab.

3. Update the Java memory switches in the Java Options: box.

4. Click OK. Restart the Tomcat service.

Oracle WebLogic Portal 10.3.0

To update Java options for Oracle WebLogic Portal 10.3.0:

1. Edit setDomainEnv.cmd in BEA_HOME/user/projects/domains/domain_name.

2. Add arguments to the line:

   set MEM_ARGS=-Xms256m -Xmx512m
   

3. Run setDomainEnv.cmd.

   Note:

   The MEM_ARGS parameter can also be updated in the startup script for the WebLogic domain.

IBM Websphere

To update Java options for IBM Websphere, use the IBM Websphere Admin Console. For instructions, refer to your IBM Websphere documentation.

Oracle WebCenter Standalone Components

The following sections describe how to configure Oracle WebCenter standalone components.

Oracle WebCenter Analytics

To update Java options for the Oracle WebCenter Analytics JVM:

1. Edit wrapper.conf in PT_HOME/ptanalytics/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

Restart the Analytics service.

Automation Service

To update Java options for the Automation Service JVM:

1. Edit wrapper.conf in PT_HOME/ptportal/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

Restart the Automation service.

Oracle WebCenter Collaboration

To update Java options for the Oracle WebCenter Collaboration JVM:

1. Edit wrapper.conf in PT_HOME/ptcollab/version/bin/ptcollaborationserverd.bat.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

3. Restart the Collaboration service.

Document Repository

To update Java options for the Document Repository JVM:

1. Edit wrapper.conf in PT_HOME/ptdr/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

Restart the Document Repository service.

Notification

To update Java options for the Notification JVM:

1. Edit wrapper.conf in PT_HOME/ptnotification/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

3. Restart the Notification service.

PTUpload

To update Java options for the PTUpload JVM:

1. Edit wrapper.conf in PT_HOME/ptupload/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

3. Restart the PTUpload service.

Oracle BPM Suite

To update Java options for the Publisher JVM:

1. Edit service.conf in PT_HOME/ptcs/version/settings/config.

2. Add a new parameter or modify existing parameters in the section Java Additional Parameters.

   For example, locate

   # Java Additional Parameters
   wrapper.java.additional.1=-Dprogram.name=cswfserver
   wrapper.java.additional.2=-Djava.awt.headless=true
   wrapper.java.additional.3=-Dplumtree.container.home=./../../../../../ptcs/6.2/container
   wrapper.java.additional.4=-Dplumtree.container.logs=./../../../../../ptcs/6.2/logs
   wrapper.java.additional.5=-Dorg.jboss.net.protocol.file.decodeFilePaths=true
   

   and add the garbage collection logging parameter

   # Java Additional Parameters
   wrapper.java.additional.1=-Dprogram.name=cswfserver
   wrapper.java.additional.2=-Djava.awt.headless=true
   wrapper.java.additional.3=-Dplumtree.container.home=./../../../../../ptcs/6.2/container
   wrapper.java.additional.4=-Dplumtree.container.logs=./../../../../../ptcs/6.2/logs
   wrapper.java.additional.5=-Dorg.jboss.net.protocol.file.decodeFilePaths=true
   wrapper.java.additional.6=-Xloggc:c:\publishergclog
   

3. Restart the Publisher service.

Tagging Service

To update Java options for the Tagging Service JVM:

1. Edit wrapper.conf in PT_HOME/pathways/version/settings/config.

2. Add or modify parameters in the section Additional -D Java Properties.

   Note:

   Java parameter numbers must be continuous and incremental, and are set in both wrapper_base.conf and wrapper.conf. Check both files to ensure added parameters use the next number in sequence.

3. Restart the Tagging Service.