Oracle® Fusion Middleware Enterprise Deployment Guide for Oracle WebCenter Interaction 10g Release 4 (10.3.3.0.0) Part Number E26810-01 |
|
|
View PDF |
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
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.
This section describes how to configure your application server. Refer to the section that applies to your type of application server.
To update Java options for Tomcat 6.x on Windows:
Run TOMCAT_HOME\tomcat6w.exe
Click the Java tab.
Update the Java memory switches in the Java Options: box.
Click OK. Restart the Tomcat service.
To update Java options for Oracle WebLogic Portal 10.3.0:
Edit setDomainEnv.cmd in BEA_HOME/user/projects/domains/domain_name.
Add arguments to the line:
set MEM_ARGS=-Xms256m -Xmx512m
Run setDomainEnv.cmd.
Note:
The MEM_ARGS
parameter can also be updated in the startup script for the WebLogic domain.
The following sections describe how to configure Oracle WebCenter standalone components.
To update Java options for the Oracle WebCenter Analytics JVM:
Edit wrapper.conf in PT_HOME/ptanalytics/version/settings/config.
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.
To update Java options for the Automation Service JVM:
Edit wrapper.conf in PT_HOME/ptportal/version/settings/config.
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.
To update Java options for the Oracle WebCenter Collaboration JVM:
Edit wrapper.conf in PT_HOME/ptcollab/version/bin/ptcollaborationserverd.bat.
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 Collaboration service.
To update Java options for the Document Repository JVM:
Edit wrapper.conf in PT_HOME/ptdr/version/settings/config.
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.
To update Java options for the Notification JVM:
Edit wrapper.conf in PT_HOME/ptnotification/version/settings/config.
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 Notification service.
To update Java options for the PTUpload JVM:
Edit wrapper.conf in PT_HOME/ptupload/version/settings/config.
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 PTUpload service.
To update Java options for the Publisher JVM:
Edit service.conf in PT_HOME/ptcs/version/settings/config.
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
Restart the Publisher service.
To update Java options for the Tagging Service JVM:
Edit wrapper.conf in PT_HOME/pathways/version/settings/config.
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 Tagging Service.