561 lines
20 KiB
HTML
561 lines
20 KiB
HTML
|
<!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>
|