toshi 2004/06/24 19:05:17
Modified: targets/axis/java soapmonitor-user-guide.pdf
soapmonitor-user-guide.html
Log:
Comments from tomj.
Revision Changes Path
1.3 +1945 -158 ws-site/targets/axis/java/soapmonitor-user-guide.pdf
<<Binary file>>
1.3 +29 -13 ws-site/targets/axis/java/soapmonitor-user-guide.html
Index: soapmonitor-user-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/java/soapmonitor-user-guide.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- soapmonitor-user-guide.html 24 Jun 2004 13:19:35 -0000 1.2
+++ soapmonitor-user-guide.html 25 Jun 2004 02:05:17 -0000 1.3
@@ -341,8 +341,7 @@
</div>
<dl>
<dd>It's a good opportunity for using this utility that you hope to monitor the
SOAP messages for debugging. You can see all SOAP messages of what you want to monitor
without any additional developments, special configurations or restarting of the
application server.<p>
-<strong>Please note that it doesn't display any protocol specific data such as HTTP
protocol headers. In case of the usage, you have to use the TCP Monitor (tcpmon).
Please see the <a href="user-guide.html">Axis User's Guide also.</a></strong>
-</p>
+<strong>Please note that it doesn't display any protocol specific data such as HTTP
protocol headers. If you need to do this, you should use the TCP Monitor (tcpmon).
Please see the <a href="user-guide.html">Axis User's Guide</a> for details on
tcpmon</strong>.</p>
</dd>
</dl>
<p>
@@ -361,7 +360,7 @@
<dl>
<dd>
<strong>step 1:</strong> Create an account for the administrator <dl>
-<dd>Please open and edit the "webapps/axis/WEB-INF/users.lst".<br> The default
account for administrator is "admin", so please set a password to anything you
want.<p>ex.) Like as follows; - i.e. "admin password".</p>
+<dd>Open and edit the "webapps/axis/WEB-INF/users.lst".<br> The default account for
administrator is "admin", set a password to anything you want.<p>ex.) Like as follows;
- i.e. "admin password".</p>
<p></p>
<dl>
<dd>user1 pass1<br> user2<br> user3 pass3<br> admin password<br>
@@ -369,6 +368,21 @@
</dl>
</dd>
</dl>
+<p>
+<strong>step 2:</strong> Setting CLASSPATH</p>
+<dl>
+<dd>Before running this utility, you'll need to make sure that your CLASSPATH
includes: <ul>
+<li>axis.jar</li>
+<li>jaxrpc.jar</li>
+<li>saaj.jar</li>
+<li>commons-logging.jar</li>
+<li>commons-discovery.jar</li>
+<li>activation.jar</li>
+<li>mail.jar</li>
+<li>A JAXP-1.1 compliant XML parser such as Xerces or Crimson</li>
+</ul>
+</dd>
+</dl>
<strong>That's all.</strong>
</dd>
</dl>
@@ -380,9 +394,9 @@
</div>
<dl>
<dd>
-<strong>step 0:</strong> Make sure <a href="#prepare">the preparation phase</a>
+<strong>step 0:</strong> Make sure you have completed <a href="#prepare">the
preparation phase.</a>
<p>
-<strong>step 1:</strong> Start the SOAPMonitor application</p>
+<strong>step 1:</strong> Start the SOAPMonitor application.</p>
<dl>
<dd>% java org.apache.axis.utils.SOAPMonitor [-u admin] [-w password] [-l axisURL]
<dl>
<dd>or</dd>
@@ -391,11 +405,13 @@
<p>
<strong>step 2:</strong> Login</p>
<dl>
-<dd>Please login with the account which you specified as an administrator. <img
alt="" src="images/LoginDialog.jpg"><br>
+<dd>Try login with the account which you specified as an administrator.<br>
+<img alt="" src="images/LoginDialog.jpg"><br>
</dd>
</dl>
<p>
-<strong>step 3:</strong> Please wait for a while</p>
+<strong>step 3:</strong> Please wait for a while.<br>
+</p>
<dl>
<dd>
<img alt="" src="images/DataLoading.jpg"><br>
@@ -411,7 +427,7 @@
<p>
<strong>step 5-a:</strong> To enable monitoring</p>
<dl>
-<dd>Please click services to enable monitoring, then push "Turn On" button.<br>
+<dd>Click services to enable monitoring, then push "Turn On" button.<br>
<img alt="" src="images/ToEnableMonitoring.jpg"><p>The following screen should be
displayed.<br>
<img alt="" src="images/AfterTurnOn.jpg"><br>
</p>
@@ -420,7 +436,7 @@
<p>
<strong>step 5-b:</strong> To disable monitoring</p>
<dl>
-<dd>Please click services to disable monitoring, then push "Turn Off" button.<br>
+<dd>Click services to disable monitoring, then push "Turn Off" button.<br>
<img alt="" src="images/ToDisableMonitoring.jpg"><p>The following screen should be
displayed.<br>
<img alt="" src="images/AfterTurnOff.jpg"><br>
</p>
@@ -429,14 +445,14 @@
<p>
<strong>step 6:</strong> Save changes</p>
<dl>
-<dd>Please push "Save changes" button to save the current state.<br> The following
screen should be displayed.<br>
+<dd>Push "Save changes" button to save the current state.<br> The following screen
should be displayed.<br>
<img alt="" src="images/DeployStatus.jpg"><br>
</dd>
</dl>
<p>
<strong>step 7:</strong> Monitoring</p>
<dl>
-<dd>Please push "Monitoring" tab to start monitoring with the current settings.<br>
The following screen should be displayed.<br>
+<dd>Push "Monitoring" tab to start monitoring with the current settings.<br> The
following screen should be displayed.<br>
<img alt="" src="images/MonitoringScreen.jpg"><br>
</dd>
</dl>
@@ -462,7 +478,7 @@
<td bgcolor="#cccccc">App Type</td><td>Applet</td><td>Swing application</td>
</tr>
<tr class="b">
-<td bgcolor="#cccccc">Security</td><td>NG (No authentication)</td><td>OK
(Authentication added)</td>
+<td bgcolor="#cccccc">Security</td><td>N/A (No authentication)</td><td>OK
(Authentication added)</td>
</tr>
<tr class="a">
<td bgcolor="#cccccc">Install & Use</td><td>1. Compile the component, at
first<br> 2. Deploy the soapmonitor handler to "server-config.wsdd"<br> 3. Deploy a
service which to be monitored with the soapmonitor handler<br> 4. Have an access to
"http://localhost:8080/axis/SOAPMonitor";<br> 5. Redeploy the service with no
soapmonitor to disable monitoring<p>*) More detail is <a
href="http://www.sosnoski.com/presents/java-xml/axis/axis-monitor.html";>here</a>.<br>
*) All of steps are the non-GUI based operations and these process are complicated for
users</p>
@@ -496,7 +512,7 @@
</dd>
</dl>
<div id="pdf" align="right">
-<a href="user-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
+<a href="soapmonitor-user-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
PDF</a>
</div>
</div>
