From do-not-reply at jboss.org Mon Jun 18 21:10:52 2012
Content-Type: multipart/mixed; boundary="===============2995202580851605897=="
MIME-Version: 1.0
From: do-not-reply at jboss.org
To: gatein-commits at lists.jboss.org
Subject: [gatein-commits] gatein SVN: r8727 - in
 epp/docs/branches/5.2/Admin_Guide/en-US: images and 1 other directory.
Date: Mon, 18 Jun 2012 21:10:52 -0400
Message-ID: <201206190110.q5J1AqbM007890@svn01.web.mwc.hst.phx2.redhat.com>

--===============2995202580851605897==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: jaredmorgs
Date: 2012-06-18 21:10:51 -0400 (Mon, 18 Jun 2012)
New Revision: 8727

Added:
   epp/docs/branches/5.2/Admin_Guide/en-US/chapter-5-Administration_and_Mon=
itoring.xml
   epp/docs/branches/5.2/Admin_Guide/en-US/images/GateIn-RHQ-Plugin.png
Log:
https://bugzilla.redhat.com/show_bug.cgi?id=3D803567 - Added GateIn JON Doc=
umentation as Chapter 5. Referred back to JON docs for more information abo=
ut JON usage

Added: epp/docs/branches/5.2/Admin_Guide/en-US/chapter-5-Administration_and=
_Monitoring.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- epp/docs/branches/5.2/Admin_Guide/en-US/chapter-5-Administration_and_Mo=
nitoring.xml	                        (rev 0)
+++ epp/docs/branches/5.2/Admin_Guide/en-US/chapter-5-Administration_and_Mo=
nitoring.xml	2012-06-19 01:10:51 UTC (rev 8727)
@@ -0,0 +1,98 @@
+<?xml version=3D'1.0' encoding=3D'UTF-8'?>
+<!-- This document was created with Syntext Serna Free. -->
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.=
oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
+<chapter id=3D"Administration_and_Monitoring">
+  <title>Administration and Monitoring</title>
+  <para>JBoss Enterprise Portal Platform provides a JBoss Operations Netwo=
rk plug-in (<firstterm>GateIn JON Plug-in</firstterm>) to assist with monit=
oring the platform.</para>
+  <para>The plug-in captures portlet and site statistics. A different set =
of statistics are collected depending on the context of each portlet.  <xre=
f linkend=3D"fig-GateIn_JON_Plug-in_Interface"/> shows the basic JON interf=
ace.</para>
+  <figure id=3D"fig-GateIn_JON_Plug-in_Interface">
+    <title>GateIn JON Plug-in Interface</title>
+    <mediaobject>
+      <imageobject>
+        <imagedata contentwidth=3D"660px" fileref=3D"images/GateIn-RHQ-Plu=
gin.png"/>
+      </imageobject>
+      <textobject>
+        <para>Screenshot of the JON console view, with the Portlets and Si=
tes views expanded.</para>
+      </textobject>
+    </mediaobject>
+  </figure>
+  <section id=3D"AdministrationandMonitoring-Metrics">
+    <title>Metrics</title>
+    <para>The metrics collected by the GateIn JON Plug-in include Site and=
 Portlet statistics. Each portlet contains statistics relevant to the indiv=
idual portlet, and one additional Throughput statistic for site portlets. R=
efer to <xref linkend=3D"table-Site_and_Portlet_Statistics"/> for a descrip=
tion of the available metrics.</para>
+    <table id=3D"table-Site_and_Portlet_Statistics">
+      <title>Site and Portlet Statistics</title>
+      <tgroup cols=3D"2">
+        <thead>
+          <colspec colname=3D"c1"/>
+          <colspec colname=3D"c2"/>
+          <row>
+            <entry>
+              <para>Metric</para>
+            </entry>
+            <entry>
+              <para>Description</para>
+            </entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>
+              <para>Average Execution Time</para>
+            </entry>
+            <entry>
+              <para>The average execution time in seconds for a page or po=
rtlet to render within a site.</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
+              <para>Execution Count</para>
+            </entry>
+            <entry>
+              <para>The amount of times the portlet or site has been acces=
sed.</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
+              <para>Maximum Execution Time</para>
+            </entry>
+            <entry>
+              <para>The maximum execution time in seconds for a page or po=
rtlet to render within a site.</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
+              <para>Minimum Execution Time</para>
+            </entry>
+            <entry>
+              <para>The minimum execution time in seconds for a page or po=
rtlet to render within a site.</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
+              <para>Throughput (only for site portlets)</para>
+            </entry>
+            <entry>
+              <para>The number of requests per second for a site.</para>
+            </entry>
+          </row>
+        </tbody>
+      </tgroup>
+    </table>
+  </section>
+  <section id=3D"Administration_and_Monitoring-Operations">
+    <title>Operations</title>
+    <para>The GateIn JON Plug-in itself does not provide any operations; i=
t&apos;s sole purpose is reporting and statistics relating to portlets and =
sites. The JBoss Operations Network AS plug-in does support many management=
 operations, and is included in JBoss Enterprise Portal Platform binaries. =
With the AS plug-in, the following non-exhaustive list of actions are possi=
ble:</para>
+    <itemizedlist>
+      <listitem>
+        <para>Server control: start, stop, restart.</para>
+      </listitem>
+      <listitem>
+        <para>Application control: deploy, and remove EAR and WAR applicat=
ions.</para>
+      </listitem>
+      <listitem>
+        <para>Resource control: manage other components of the platform, s=
uch as datasources.</para>
+      </listitem>
+    </itemizedlist>
+    <para>For detailed information about JBoss Operations Network, and how=
 it can be used to manage platforms, refer to the JBoss Operations Network =
<citetitle>How to Manage JBoss Servers</citetitle> guide available from <ul=
ink url=3D"http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/index=
.html"/>.</para>
+  </section>
+</chapter>

Added: epp/docs/branches/5.2/Admin_Guide/en-US/images/GateIn-RHQ-Plugin.png
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
(Binary files differ)


Property changes on: epp/docs/branches/5.2/Admin_Guide/en-US/images/GateIn-=
RHQ-Plugin.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream


--===============2995202580851605897==--