NAME
qping - check application status of Grid Engine daemons.
SYNTAX
qping [-help] [-noalias] [ [ [-i <interval>] [-info] [-f] ]
| [ [-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 implementa-
tion allows one to query the SGE_QMASTER daemon and any run-
ning SGE_EXECD daemon. The qping 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 con-
tains status information about the consulted daemon.
The qping -dump option allows an administrator to observe
the communication protocol data flow of a Grid Engine ser-
vice daemon. The qping -dump instruction must be started
with root account and on the same host where the observed
daemon is running.
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: Nr. of buffered messages in com-
munication buffer. The messages are buffered for the appli-
cation (daemon). When this number grows too large the daemon
is not able to handle all messages sent to it.
messages in write buffer: Nr. of buffered messages in the
communication write buffer. The messages are sent from the
application (daemon) to the connected clients, but the com-
munication 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.
nr. of connected clients: This is the number of actual con-
nected clients to this daemon. This also implies the current
qping connection.
status: The status value of the daemon. This value depends
on the application which reply 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 his time stamp for a not usual 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 incre-
mented his 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 his time
stamp for a unusual long time. A possible reason for
this is a high workload.
2 Dispatcher has reached error timeout. This may hap-
pen when the dispatcher has not incremented his 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 reply to the qping request. If the
application does not provide any information the info mes-
sage is "not available". Here are the possible status
information values for the Grid Engine daemons:
qmaster:
The info message contains information about the qmas-
ter threads followed by a thread state and time infor-
mation. Each time when one of the known threads pass
through their 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:
EDT: Event Delivery Thread
TET: Timed Event Thread
MT: Message Thread(s)
SIGT: SIGnal Thread
THREAD_STATE:
R: Running
W: Warning
E: Error
THREAD_TIME:
Time since last timestamp updating.
After the dispatcher information follows an additional
information string which describes the complete appli-
cation 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 follows an additional infor-
mation string which describes the application status.
-help
Prints a list of all options.
-i interval
Set qping interval time.
The default interval time is one second. Qping will send a
SIM (Status Information Message) on each interval time.
-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.
-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 communi-
cation protocol data flow of a Grid Engine service daemon.
The qping -dump instruction must be started as root and on
the same host where the observed daemon is running.
The output is written to stdout. The enviroment 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 combina-
tion of the following specifiers separated by a space char-
acter:
"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"
Start qping -help to see which columns are available.
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
nr. 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
nr. of connected clients: 2
status: 0
info: ok
ENVIRONMENTAL VARIABLES
SGE_ROOT Specifies the location of the Grid Engine
standard configuration files.
SGE_CELL If set, specifies the default Grid Engine
cell.
SEE ALSO
sge_intro(1), SGE_H_ALIASES(5), sge_qmaster(8),
sge_execd(8).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permis-
sions.
Man(1) output converted with
man2html