[jboss-cvs] JBossAS SVN: r111412 - projects/jboss-jca/trunk/doc/developerguide/en-US/modules.

[jboss-cvs-commits at lists.jboss.org]

Author: jesper.pedersen
Date: 2011-05-20 11:21:55 -0400 (Fri, 20 May 2011)
New Revision: 111412

Modified:
   projects/jboss-jca/trunk/doc/developerguide/en-US/modules/testing.xml
Log:
Initial oprofile information

Modified: projects/jboss-jca/trunk/doc/developerguide/en-US/modules/testing.xml
===================================================================
--- projects/jboss-jca/trunk/doc/developerguide/en-US/modules/testing.xml	2011-05-20 09:54:30 UTC (rev 111411)
+++ projects/jboss-jca/trunk/doc/developerguide/en-US/modules/testing.xml	2011-05-20 15:21:55 UTC (rev 111412)
@@ -368,6 +368,85 @@
       <para>The home of JProfiler is located here: <ulink url="http://www.ej-technologies.com/products/jprofiler/overview.html"/>.</para>
 
     </section>
+
+    <section id="oprofile">
+      <title>OProfile</title>
+
+      <para>OProfile can give a detailed overview of applications running on the machine, including
+        Java program running with OpenJDK.</para>
+
+      <para>The home of OProfile is located here: <ulink url="http://oprofile.sourceforge.net"/>.</para>
+
+      <section id="oprofile_install">
+        <title>Installation</title>
+        <para>Enable the Fedora debug repo:</para>
+        <programlisting>
+/etc/yum.repos.d/fedora.repo
+
+[fedora-debuginfo]
+name=Fedora $releasever - $basearch - Debug
+failovermethod=priority
+mirrorlist=https://mirrors.fedoraproject.org/metalink?repo=fedora-debug-$releasever&amp;arch=$basearch
+enabled=1
+gpgcheck=1
+gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-fedora-$basearch
+        </programlisting>
+
+        <para>Install:</para>
+        <programlisting>
+yum install -y oprofile oprofile-jit
+yum install -y yum-plugin-auto-update-debug-info
+yum install -y java-1.6.0-openjdk-debuginfo
+        </programlisting>
+      </section>
+
+      <section id="oprofile_running">
+        <title>Running</title>
+        <para>Insert the following line in <code>run.sh</code> or <code>run.bat</code>:</para>
+
+        <programlisting>
+-agentpath:/usr/lib64/oprofile/libjvmti_oprofile.so
+        </programlisting>
+
+        <para>for 64bit JVMs or </para>
+
+        <programlisting>
+-agentpath:/usr/lib/oprofile/libjvmti_oprofile.so
+        </programlisting>
+
+        <para>for 32 bit JVMs where the Java command is executed.</para>
+
+        <para>Now execute:</para>
+        <programlisting>
+opcontrol --no-vmlinux
+opcontrol --start-daemon
+        </programlisting>
+
+        <para>and use the following commands:</para>
+        <programlisting>
+opcontrol --start # Starts profiling
+opcontrol --dump  # Dumps the profiling data out to the default file
+opcontrol --stop  # Stops profiling
+        </programlisting>
+
+        <para>Once you are done execute:</para>
+        <programlisting>
+opcontrol --shutdown  # Shuts the daemon down
+        </programlisting>
+
+        <para>A report can be generated by:</para>
+        <programlisting>
+opreport -l --output-file=&lt;filename&gt;
+        </programlisting>
+
+        <para>Remember that this is system wide profiling, so make sure that only the services
+          that you want included are running.</para>
+
+        <para>More information is available at <ulink url="http://oprofile.sourceforge.net/doc/index.html"/>.</para>
+
+      </section>
+
+    </section>
   </section>
 
 </chapter>