Ubuntu Manpage: qping - check application status of Grid Engine daemons.

Provided by: gridengine-client_8.1.9+dfsg-9build2_amd64

NAME

       qping - check application status of Grid Engine daemons.

SYNTAX

       qping  [-help]  [-noalias]  [-ssl|-tcp] [[[-i interval] [-info] [-f]] | [[ -dump_tag tag [param]] [-dump]
       [-nonewline]]] host port name id

DESCRIPTION

       Qping is used to validate the runtime status of a Grid Engine service daemon.  The  current  Grid  Engine
       implementation  allows  one to query the SGE_QMASTER daemon and any running SGE_EXECD daemon. The command
       is used to send a SIM (Status Information Message) to the destination daemon. The communication layer  of
       the specified daemon will respond with a SIRM (Status Information Response Message) which contains status
       information about that daemon.  It also has options allow an administrator to observe  the  communication
       protocol data flow of a Grid Engine service daemon.

OPTIONS

-f
Show full status information on each ping interval.

First output line: The first output line shows the date and time of the request.

SIRM version: Internal version number of the SIRM (Status Information Response Message)

SIRM message id: Current message id for this connection

start time: Start time of daemon. The format is as follows:

MM/DD/YYYY HH:MM:SS (seconds since 01.01.1970)

run time [s]: Run time in seconds since start time

messages in read buffer: Number of buffered messages in the communication read buffer. The messages are
buffered for the application (daemon). When this number grows too large the daemon is not able to handle
all messages sent to it.

messages in write buffer: Number of buffered messages in the communication write buffer. The messages are
sent from the application (daemon) to the connected clients, but the communication layer wasn't able to
send the messages yet. If this number grows too large, the communication layer isn't able to send them as
fast as the application (daemon) wants the messages to be sent.

number of connected clients: This is the number of clients actually connected to this daemon, including
the current qping connection.

status: The status value of the daemon. This value depends on the application which replies to the qping
request. If the application does not provide any information, the status is 99999. Here are the
possible status information values for the Grid Engine daemons:

qmaster:

0 There is no unusual timing situation.

1 One or more threads has reached warning timeout. This may happen when at least one thread does
not increment its time stamp for an usually long time. A possible reason for this is a high
workload for this thread.

2 One or more threads has reached error timeout. This may happen when at least one thread has not
incremented its time stamp for longer than 10 minutes.

3 The time measurement is not initialized.

execd:

0 There is no unusual timing situation.

1 Dispatcher has reached warning timeout. This may happen when the dispatcher does not increment
its time stamp for an unusually long time. A possible reason for this is a high workload.

2 Dispatcher has reached error timeout. This may happen when the dispatcher has not incremented its
time stamp for longer than 10 minutes.

3 The time measurement is not initialized.

info: Status message of the daemon. This value depends on the application which replies to the qping
request. If the application does not provide any information the info message is "not available". Here
are the possible status information values for the Grid Engine daemons:

qmaster:

The info message contains information about the qmaster threads, followed by a thread state and
time information. Each time one of the known threads passes through its main loop the time
information is updated. Since the qmaster has two message threads, every message thread updates the
time. This means the timeout for the message thread (MT) can only occur when no message thread is
active anymore:

THREAD_NAME: THREAD_STATE (THREAD_TIME)

THREAD_NAME:
MAIN: Main thread
signaler: Signal thread
event_master: Event master thread
timer: Timer thread
worker: Worker thread
listener: Listener thread
scheduler: Scheduler thread
jvm: Java thread
The thread names above (other than MAIN) will be followed by a 3 digit number.

THREAD_STATE:
R: Running
W: Warning
E: Error

THREAD_TIME:
Time since last timestamp updating.

After the dispatcher information comes an additional information string which describes the
complete application status.

execd:

The info message contains information for the execd job dispatcher:
dispatcher: STATE (TIME)

STATE:
R: Running
W: Warning
E: Error

TIME:
Time since last timestamp updating.

After the thread information comes statistics on the malloc(3) state, if available, e.g. using
mallinfo(3). If Grid Engine is built with the jemalloc(3) allocator, the statistics are not printed
by default because they are in a different, verbose format. See print_malloc_info in sge_conf(5).

Monitor: If available (see MONITOR_TIME In qmaster_params in sge_conf(5)), displays statistics on threads.
The data for each thread are displayed in one line. The format of this line can be changed at any time. Only
the master implements monitoring.

-help
Prints a list of all options.

-i interval
Set qping interval. The default interval is one second. Qping will send a SIM (Status Information
Message) after each interval.

-info
Show full status information (see -f for more information) and exit. The exit value 0 indicates no error.
On errors qping returns with 1.

-noalias
Ignore host_aliases file, which is located at <sge_root>/<cell>/common/host_aliases. If this option is
used it is not necessary to set any Grid Engine environment variable.

-ssl
This option can be used to specify an SSL (Secure Socket Layer) configuration. qping will use the
configuration to connect to services running SSL. If the Grid Engine settings file is not sourced, you
have to use the -noalias option to bypass the need for the SGE_ROOT environment variable. The following
environment variables are used to specify your certificates:
SSL_CA_CERT_FILE - CA certificate file
SSL_CERT_FILE - certificates file
SSL_KEY_FILE - key file
SSL_RAND_FILE - rand file

-tcp
This option is used to select TCP/IP as the protocol used to connect to other services.

-nonewline
Dump output will not have a linebreak within a message, and binary messages are not unpacked.

-dump
This option allows an administrator to observe the communication protocol data flow of a Grid Engine
service daemon. The command must be started as root, and on the host where the daemon to be observed is
running.

The output is written to stdout. The environment variable "SGE_QPING_OUTPUT_FORMAT" can be set to hide
columns, set a default column width, or to set a hostname output format. The value of the environment
variable can be set to any combination of the following specifiers separated by a space character:
"h:X" -> hide column X
"s:X" -> show column X
"w:X:Y" -> set width of column X to Y
"hn:X" -> set hostname output parameter X.
X values are "long" or "short"
Run qping -help to see which columns are available.

-dump_tag tag [param]
This option has the same meaning as -dump, but can provide more information by specifying the debug level
and message types qping should print:
-dump_tag ALL debug level
This option shows all possible debug messages (APP+MSG) for the debug levels, ERROR, WARNING, INFO,
DEBUG and DPRINTF. The contacted service must support this kind of debugging. This option is not
currently implemented.
-dump_tag APP debug level
This option shows only application debug messages for the debug levels, ERROR, WARNING, INFO, DEBUG
and DPRINTF. The contacted service must support this kind of debugging. This option is not
currently implemented.
-dump_tag MSG
This option has the same behavior as the -dump option.

host
Host where daemon is running.

port
Port which daemon has bound (used sge_qmaster/sge_execd port number).

name
Name of communication endpoint ("qmaster" or "execd"). A communication endpoint is a triplet of
hostname/endpoint name/endpoint id (e.g. hostA/qmaster/1 or subhost/qstat/4).

id
Id of communication endpoint ("1" for daemons)

EXAMPLES

       >qping master_host 31116 qmaster
       08/24/2004 16:41:15 endpoint master_host/qmaster/1 at port 31116 is up since 365761 seconds
       08/24/2004 16:41:16 endpoint master_host/qmaster/1 at port 31116 is up since 365762 seconds
       08/24/2004 16:41:17 endpoint master_host/qmaster/1 at port 31116 is up since 365763 seconds

       > qping -info master_host 31116 qmaster 1
       08/24/2004 16:42:47:
       SIRM version:             0.1
       SIRM message id:          1
       start time:               08/20/2004 11:05:14 (1092992714)
       run time [s]:             365853
       messages in read buffer:  0
       messages in write buffer: 0
       no. of connected clients: 4
       status:                   0
       info:                     ok

       > qping -info execd_host 31117 execd 1
       08/24/2004 16:43:45:
       SIRM version:             0.1
       SIRM message id:          1
       start time:               08/20/2004 11:06:13 (1092992773)
       run time [s]:             365852
       messages in read buffer:  0
       messages in write buffer: 0
       no. of connected clients: 2
       status:                   0
       info:                     ok

ENVIRONMENT VARIABLES

       SGE_ROOT       Specifies the location of the Grid Engine standard configuration files.

       SGE_CELL       If set, specifies the default Grid Engine cell.

       SGE_QPING_OUTPUT_FORMAT
                      See -dump option above.

       The  following  apply  when  CSP  security is used and can override the values deduced from the bootstrap
       file.

       SSL_CA_CERT_FILE
                      CA certificate file

       SSL_CERT_FILE  Certificates file

       SSL_KEY_FILE   Key file

       SSL_RAND_FILE  Random seed file

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.