<!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>