How to configure the Java Agent with Oracle Application Server 10g

Document ID : KB000015449
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

How to configure the Java Agent with Oracle Application Server 10g

Answer:

1. Open the ORACLE_HOME/inst/apps/<server-app>/appl/admin/<serverapp>.trc


2. Add the below jvm entries to the "oacore_jvm_starts_options" section. 

-javaagent:<wily_home>/Agent.jar -Dcom.wily.introscope.agentProfile=<wily_home>/core/config/IntroscopeAgent.profile 


3. In case you have multiple Oracle instances, open the <wily_home>/core/config/IntroscopeAgent.profile set introscope.agent.agentNameSystemPropertyKey=oracle.ons.indexid

This will allow each appsever instance to have a relevant and unique agent name

NOTE: oracle.ons.indexid is a system property that is available on each oracle instance and contains a combination of the OC4J instance name, the group it belongs to, and the JVM executing it, in the following format: oc4j_instance_name.oc4j_groupname.jvm_number 

Here is an example of the output of 2 oracle apps instances running in a Solaris system:


$ /usr/ucb/ps -auxww | grep 21815

app 21815  0.1  0.313873601343256 ?        S   Jul 17 53:44 /appsutil/jdk/bin/java -DCLIENT_PROCESSID=21815 -javaagent:/wily/Agent.jar -Dcom.wily.introscope.agentProfile=/wily/core/config/IntroscopeAgent.profile -server -verbose:gc -Xmx3072M -Xms1024M -XX:MaxPermSize=160M -XX:NewRatio=2 -XX:+PrintGCTimeStamps -XX:+UseTLAB -XX:+UseParallelGC -XX:ParallelGCThreads=2 -Dcom.sun.management.jmxremote -Djava.security.policy=/j2ee/oacore/config/java2.policy -Djava.awt.headless=true -Dhttp.webdir.enable=false -Doracle.security.jazn.config=/apps/ora/10.1.3/j2ee/oacore/config/jazn.xml -Dhttp.cookie.ignoreCommaInCookiesNamed=X_NoMatchingCookies -Doracle.ons.oraclehome= -Doracle.home= -Doracle.ons.oracleconfighome=/apps/ora/10.1.3 -Doracle.ons.clustername=default -Doracle.ons.instancename=x1556test.dvnat.local -Dopmn.compatible=904 -Doracle.ons.indexid=oacore.default_group.1 -Doracle.ons.numprocs=10 -Doracle.ons.uid=1613188717 -Doracle.oc4j.groupname=default_group -Doracle.oc4j.instancename=oacore -Doracle.oc4j.islandname=default_group -Doracle.opmn.routingid=g_rt_id -DOPMN=true -jar oc4j.jar -config /apps/ora/10.1.3/j2ee/oacore/config/server.xml -properties -out /apps/logs/ora/10.1.3/opmn/oacorestd.out -err /apps/logs/ora/10.1.3/opmn/oacorestd.err -ports default-web-site:ajp:21800,rmi:20300,jms:23300

$ /usr/ucb/ps -auxww | grep 16750

app 16750  0.1  0.313449921202584 ?        S 09:08:31  7:58 /appsutil/jdk/bin/java -DCLIENT_PROCESSID=16750 -javaagent:/wily/Agent.jar -Dcom.wily.introscope.agentProfile=/wily/core/config/IntroscopeAgent.profile -server -verbose:gc -Xmx3072M -Xms1024M -XX:MaxPermSize=160M -XX:NewRatio=2 -XX:+PrintGCTimeStamps -XX:+UseTLAB -XX:+UseParallelGC -XX:ParallelGCThreads=2 -Dcom.sun.management.jmxremote -Djava.security.policy=/j2ee/oacore/config/java2.policy -Djava.awt.headless=true -Dhttp.webdir.enable=false -Doracle.security.jazn.config=/apps/ora/10.1.3/j2ee/oacore/config/jazn.xml -Dhttp.cookie.ignoreCommaInCookiesNamed=X_NoMatchingCookies -Doracle.ons.oraclehome= -Doracle.home= -Doracle.ons.oracleconfighome=/apps/ora/10.1.3 -Doracle.ons.clustername=default -Doracle.ons.instancename=x1556test.dvnat.local -Dopmn.compatible=904 -Doracle.ons.indexid=oacore.default_group.5 -Doracle.ons.numprocs=10 -Doracle.ons.uid=1613188738 -Doracle.oc4j.groupname=default_group -Doracle.oc4j.instancename=oacore -Doracle.oc4j.islandname=default_group -Doracle.opmn.routingid=g_rt_id -DOPMN=true -jar oc4j.jar -config /apps/ora/10.1.3/j2ee/oacore/config/server.xml -properties -out /apps/logs/ora/10.1.3/opmn/oacorestd.out -err /apps/logs/ora/10.1.3/opmn/oacorestd.err -ports default-web-site:ajp:21804,rmi:20304,jms:23303


4. (Optional) Enable custom pbds for Oracle Forms:

- Copy attached pbds: orcl_ebs.pbd and oafm_client.pbd to the <wily_home>/core/config

- Append the pbd filenames to the introscope.autoprobe.directivesFile in the IntroscopeAgent.profile

Please note that these custom pbds are not supported by CA Support.


5. Restart the JVM or application server.

Additional Information:

Oracle® Application Server Release Notes

10g Release 3 (10.1.3.2) for Microsoft Windows (64-Bit) on Intel Itanium

Part Number B32417-04

Determining JVM, OC4J Instance, or Application Server Instance

http://docs.oracle.com/cd/B32110_01/relnotes.1013/b32417/oc4j.htm#CHDIBFGJ

 

File Attachments:
TEC1539299.zip