<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR"
content="Mozilla/4.79 [en] (X11; U; Linux 2.4.9-34smp i686) [Netscape]">
<title>ifpServerStats User's Guide</title>
</head>
<body bgcolor="#ffffff">
<h1 class="1Heading">
ifpServerStats User's Guide</h1>
<div class="1Heading">May 13, 2004<br>
</div>
<h2 class="1Heading">
<a name="TableofContents"></a>Table of Contents</h2>
<h4 class="1Heading">
<a href="#Overview">Overview</a></h4>
<h4 class="1Heading">
<a href="#Running">Running the ifpServerStats Program</a></h4>
<h4 class="1Heading">
<a href="#ExampleData">Example Output</a></h4>
<div class="1Heading">
<hr width="100%"></div>
<h2 class="1Heading">
<a name="Overview"></a>Overview</h2>
<div class="1Heading">The ifpServerStats program is a utility to output
certain statistics about the ifpServer. The output includes
information
about the network transactions, database sizes, and BASE/SITE/USER
configurations.
The output is sent to stdout and may be rerouted to a file if desired.</div>
<div class="1Heading">
<hr width="100%"></div>
<div class="1Heading">
<hr width="100%"></div>
<h3 class="1Heading">
<a name="Running"></a>Running the ifpServerStats Program</h3>
<div class="1Heading"> </div>
<div class="1Heading">The command line syntax is:</div>
<div class="1Heading"><tt>ifpServerStats -h hostname -p rpcPortNumber
-t
-d -f -c -q</tt></div>
<div class="1Heading">A sample command line is:</div>
<div class="1Heading"><tt>ifpServerStats -h abc.fsl.noaa.gov -p
98000000
-q -c</tt></div>
<div class="1Heading"> </div>
<table nosave="" border="1" width="100%">
<tbody>
<tr>
<td><b>Option Syntax</b></td>
<td><b>Optional or Mandatory</b></td>
<td><b>Description</b></td>
</tr>
<tr>
<td>-h hostname</td>
<td>Mandatory (see note)</td>
<td>Specifies the host, upon which the ifpServer is running</td>
</tr>
<tr>
<td>-p port</td>
<td>Mandatory (see note)</td>
<td>Specifies the port, upon which the ifpServer is running</td>
</tr>
<tr>
<td>-t</td>
<td>Optional</td>
<td>If specified, outputs the transaction information.</td>
</tr>
<tr>
<td>-d</td>
<td>Optional</td>
<td>If specified, outputs the database sizing information.</td>
</tr>
<tr>
<td>-f</td>
<td>Optional</td>
<td>If specified, outputs the base/site/user configuration
information.</td>
</tr>
<tr>
<td>-c</td>
<td>Optional</td>
<td>If specified, outputs the client connection information</td>
</tr>
<tr>
<td>-q</td>
<td>Optional</td>
<td>If specified, outputs the client queue information</td>
</tr>
</tbody>
</table>
Note: If none of the -t, -d -f, -q, or -c switches are given, then all
information will be output.
<br>
<font color="#3366ff">Note: The -h and -p switches are predefined to
match your GFESuite installation, such that they will point to the
ifpServer
specified on installation. Thus the -h and -p switches are not
necessary
for normal running of this program. However, if you wish to
connect
to a different server, then you will need to specify the -h and
-p. </font><font color="#3366ff"> If environment variables
${CDSHOST} or
${CDSPORT} are defined, then the default server and port will be
determined from the environment variables, unless overridden with the
user specified -h and -p switches.</font><font color="#3366ff"></font>
<div class="1Heading">
<hr width="100%"></div>
<br>
<h3 class="1Heading"><a name="ExampleData"></a>Example Data</h3>
<div class="1Heading">The following shows some example output and how
it
is interpreted. The output is divided into four sections: network,
client,
database sizing, and base/site/user configuration.
<p><b><tt>ifpServerStats -h abc.fsl.noaa.gov -p 98000000</tt></b>
<br>
</p>
<h4>Network Information</h4>
The first section displays the network message types, the number of
calls
made since 0000Z, the average, minimum, and maximum time in seconds for
each call.
<p><tt>IFPSERVER STATISTICS INFORMATION as of Feb 08 01 20:53:08 GMT</tt>
<br>
<tt>--------------------------------------------------------</tt>
<br>
<tt>WsId: 389696393:mark:ifpServer:10342:0</tt>
<br>
<tt>Protocol Version: 20010105</tt>
<br>
<tt>Network Process Statistics</tt>
<br>
<tt>---Rpc Message Type---- NumCall AveTime
MinTime MaxTime</tt>
<br>
<tt>Register
Client
1 0.0005 0.0005 0.0005</tt>
<br>
<tt>Get Map
Projections
1 0.0155 0.0155 0.0155</tt>
<br>
<tt><br>
</tt><tt></tt></p>
<p><tt>Network Statistics</tt>
<br>
<tt>-------Network
Event-------
Number</tt>
<br>
<tt>RPC:
Success
2</tt>
</p>
<p><tt>Port Identifier: 98000044</tt>
<br>
</p>
<h4>Client Information</h4>
<p><br>
The Client Table displays information about each connection to the
server, how many notifications are queued, and the length of the queue
in messages and time.
</p>
<p><tt>Connection Statistics</tt>
<br>
<tt> FD NR ConnDurat QueueDur Workstation
Identifier</tt>
<br>
<tt> -- -- --------- --------
----------------------</tt>
<br>
<tt> 9 0 0.00:00:00 00:00:00
mark@camper.fsl.noaa.gov:ifpServerStats:14689:0</tt>
</p>
<p><tt>Client Table</tt>
<br>
<tt>______ _____</tt>
<br>
<tt>[** Connection ** wsid= 389696393:mark:ifpServerStats:10361:0</tt>
<br>
<tt> fd= 5 notifyRequested=0</tt>
<br>
<tt> connDuration=0 queueDuration=0</tt>
</p>
<p><tt>Previous Queue Statistics:</tt>
<br>
<tt>QueueName TotalQueued MaxOnQueue
MaxTimeQueued
MinTimeQueued AveTimeQueued</tt>
<br>
<tt>
Lock
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
Grid
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
DbInv
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
Sample
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt> Reference
0
0
0.0000
0.0000 0.0000</tt>
<br>
<tt>
Color
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt> TextFile
0
0
0.0000
0.0000
0.0000</tt>
</p>
<p><tt>Current Queue Statistics:</tt>
<br>
<tt>QueueName TotalQueued MaxOnQueue
MaxTimeQueued
MinTimeQueued AveTimeQueued</tt>
<br>
<tt>
Lock
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
Grid
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
DbInv
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt>
Sample
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt> Reference
0
0
0.0000
0.0000 0.0000</tt>
<br>
<tt>
Color
0
0
0.0000
0.0000
0.0000</tt>
<br>
<tt> TextFile
0
0
0.0000
0.0000
0.0000</tt>
</p>
<p><tt>Queue Contents:</tt>
<br>
<tt>LOCK Queue: [ ]</tt>
<br>
<tt>GRID Queue: [ ]</tt>
<br>
<tt>DBINV Queue: [ ]</tt>
<br>
<tt>SAMPLE Queue: [ ]</tt>
<br>
<tt>REFERENCE Queue: [ ]</tt>
<br>
<tt>COLOR Queue: [ ]</tt>
<br>
<tt>TEXTFILE Queue: [ ]</tt>
</p>
<p><tt> ]</tt>
<br>
</p>
<h4>Client Queue Information</h4>
The client queue information displays information about each connected
client that has notifications enabled. It shows the current, and
the total number of notifications processed for the client, as well as
the length of time that queue entries have been available.
<p><tt>Client Queue Statistics</tt>
<br>
<tt>-----------------------</tt>
<br>
<tt>Client #:0</tt>
<br>
<tt> wsid= mark@camper.fsl.noaa.gov:gfe:7482:0</tt>
<br>
<tt> fd= 7 protocolVer= 20030223 notifyReq=1 connDur=0.00:31:03
queueDur=00:00:00</tt><tt></tt>
</p>
<p><tt>Previous Queue Statistics:</tt>
<br>
<tt>QueueName TotalQueued MaxOnQueue
MaxTimeQueued
MinTimeQueued AveTimeQueued</tt>
<br>
<tt>
Lock
57
6
2.9953
0.0769
1.5776</tt>
<br>
<tt>
Grid
327
112
2.8861
0.0008
0.9391</tt>
<br>
<tt>
DbInv
1
1
0.0224
0.0224
0.0224</tt>
<br>
<tt>
UserMsg
4
1
2.8678
1.8457
2.3077</tt><tt></tt>
</p>
<p><tt>Current Queue Statistics:</tt>
<br>
<tt>QueueName TotalQueued MaxOnQueue
MaxTimeQueued
MinTimeQueued AveTimeQueued</tt>
<br>
<tt> ----- No Current Queue -----</tt>
<br>
<tt></tt>
<br>
<br>
</p>
<h4>Database Sizing Information</h4>
<p><br>
The database sizing statistics display information about each GRID
database, the size of the grids for the storage araas, the number of
grid
slots in the database, number used, and the percent full of each
database.
Databases will automatically increase in size. The D2D-style
databases
will show the number of inventory slots vs. the number of grids in the
database.
</p>
<p><tt>Database Sizing Statistics</tt>
<br>
<tt> Database
Identifier
Storage Area Name Total Used %Full</tt>
<br>
<tt> -------------------
----------------- ----- ---- -----</tt>
<br>
<tt>BOU_GRID_D2D_AVN_20030307_0600
D2D netCDF
1242 1214 97.7%</tt>
<br>
<tt>BOU_GRID_D2D_AVN_20030307_1200
D2D netCDF
1242 992 79.9%</tt>
<br>
<tt>BOU_GRID_D2D_ETA12_20030307_1200
D2D
netCDF
318 209 65.7%</tt>
<br>
<tt>BOU_GRID_D2D_ETA_20030307_0000
D2D netCDF
1968 1431 72.7%</tt>
<br>
<tt>BOU_GRID_D2D_ETA_20030307_1200
D2D netCDF
1968 1431 72.7%</tt>
<tt></tt><br>
<tt>BOU_GRID__Fcst_00000000_0000
byte37x37
17 7 41.2%</tt>
<br>
<tt>BOU_GRID__Fcst_00000000_0000
float37x37
227 61 26.9%</tt>
<br>
<tt>BOU_GRID__Fcst_00000000_0000
byte37x37
0 0 0.0%</tt>
<br>
<tt>BOU_GRID__Fcst_00000000_0000
float37x37
0 0 0.0%</tt>
<br>
<tt>BOU_GRID__Fcst_00000000_0000
HistoryUse
214 62 29.0%</tt>
<br>
<tt>BOU_GRID__Fcst_00000000_0000
WxUse
17 7 41.2%</tt>
<br>
<br>
</p>
<h4>Base/Site/User Configuration</h4>
<p><br>
The Base/Site/User configuration details goes through each data
type in the server and displays the user name (e.g., BASE, SITE, mark),
the name of the file, the coded filename, and whether the file
overrides
the BASE or SITE configuration.
</p>
<p><tt>BASE/SITE/USER Configuration Details</tt>
<br>
<tt>**** Configuration Files for [TEXT/SELECTTR] ****</tt>
</p>
<p><tt> Files in [BASE]</tt>
<br>
<tt>
BASE SITE</tt>
<br>
<tt>
name
coded
filename
Override</tt>
<br>
<tt> ------------------
---------------
---- ----</tt>
<br>
<tt> Day
3
Day_CA3.SELECTTR</tt>
<br>
<tt> Day
4
Day_CA4.SELECTTR</tt>
<br>
<tt> Day
5
Day_CA5.SELECTTR</tt>
<br>
<tt>
Today
Today.SELECTTR</tt>
<br>
<tt>
Tomorrow
Tomorrow.SELECTTR</tt>
<br>
<tt> Tomorrow
Night
Tomorrow_CANight.SELECTTR</tt>
<br>
<tt>
Tonight
Tonight.SELECTTR</tt>
</p>
<p><tt>**** Configuration Files for [TEXT/BUNDLE] ****</tt>
</p>
<p><tt> Files in [BASE]</tt>
<br>
<tt>
BASE SITE</tt>
<br>
<tt>
name
coded
filename
Override</tt>
<br>
<tt> ------------------
---------------
---- ----</tt>
<br>
<tt>
FireWx
FireWx.BUNDLE</tt>
<br>
<tt>
Gweight
Gweight.BUNDLE</tt>
<br>
<tt>
Public
Public.BUNDLE</tt>
</p>
<br>
<p><br>
<br>
</p>
</div>
</body>
</html>