QPING(1)                   Grid Engine User Commands                  QPING(1)



NNAAMMEE
       qping - check application status of Grid Engine daemons.


SSYYNNTTAAXX
       qqppiinngg [[--hheellpp]] [[--nnooaalliiaass]] [[--ssssll||--ttccpp]] [[ [[ [[--ii <<iinntteerrvvaall>>]] [[--iinnffoo]] [[--ff]] ]]
       || [[ [[--dduummpp__ttaagg ttaagg [[ppaarraamm]] ]] [[--dduummpp]] [[--nnoonneewwlliinnee]]  ]]  ]]  <<hhoosstt>>  <<ppoorrtt>>
       <<nnaammee>> <<iidd>>


DDEESSCCRRIIPPTTIIOONN
       _Q_p_i_n_g  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 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 contains status
       information about the consulted daemon.

       The  qping  -dump  and  -dump_tag  options allowing an administrator to
       observe the communication protocol data flow of a Grid  Engine  service
       daemon.  The  qping -dump instruction must be started with root account
       and on the same host where the observed daemon is running.


OOPPTTIIOONNSS
   --ff
       Show full status information on each ping interval.

       _F_i_r_s_t _o_u_t_p_u_t _L_i_n_e_: The first output line shows the date and time of the
       request.

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

       _S_I_R_M _m_e_s_s_a_g_e _i_d_: Current message id for this connection

       _s_t_a_r_t _t_i_m_e_: Start time of daemon. The format is as follows:

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

       _r_u_n _t_i_m_e _[_s_]_: Run time in seconds since start time

       _m_e_s_s_a_g_e_s _i_n _r_e_a_d _b_u_f_f_e_r_: Nr.  of  buffered  messages  in  communication
       buffer.  The  messages  are buffered for the application (daemon). When
       this number grows too large the daemon is not able to handle  all  mes-
       sages sent to it.

       _m_e_s_s_a_g_e_s _i_n _w_r_i_t_e _b_u_f_f_e_r_: Nr. 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.

       _n_r_. _o_f _c_o_n_n_e_c_t_e_d _c_l_i_e_n_t_s_:  This  is  the  number  of  actual  connected
       clients to this daemon. This also implies the current qping connection.

       _s_t_a_t_u_s_: 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 incremented 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 dis-
       patcher  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 happen when  the  dis-
       patcher  has not incremented his time stamp for longer than 10 minutes.

       _3 The time measurement is not initialized.


       _i_n_f_o_: Status message of the daemon. This value depends on the  applica-
       tion  which  reply  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 fol-
       lowed by a thread state and time information. 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

       In addition to these thread names, the name can contain a thread number (for example:
       MT(1)), when multiple instances of this thread are running.

       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 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 follows an additional  information  string
       which describes the application status.

       _M_o_n_i_t_o_r_:  If  available,  displays statistics on a thread. The data for
       each thread is displayed in one line. The format of this  line  can  be
       changed at any time. Only the master implements the monitoring.


   --hheellpp
       Prints a list of all options.


   --ii iinntteerrvvaall
       Set qping interval time.

       The  default interval time is one second. Qping will send a SIM (Status
       Information Message) on each interval time.


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


   --nnooaalliiaass
       Ignore  host_aliases  file,  which is located at _<_s_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_-
       _m_o_n_/_h_o_s_t___a_l_i_a_s_e_s_.  If this option is used it is not  necessary  to  set
       any Grid Engine environment variable.


   --ssssll
       This option can be used to specify an SSL (Secure Socket Layer) config-
       uration. The qping will use the configuration to  connect  to  services
       running  SSL.  If the SGE 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 specifiy
       your certificates:
         SSL_CA_CERT_FILE - CA certificate file
         SSL_CERT_FILE    - certificates file
         SSL_KEY_FILE     - key file
         SSL_RAND_FILE    - rand file


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


   --nnoonneewwlliinnee
       Dump  output will not have a linebreak within a message and binary mes-
       sages are not unpacked.


   --dduummpp
       This option allows an administrator to observe the communication proto-
       col data flow of a Grid Engine service daemon. The qping -dump instruc-
       tion 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 envi-
       ronment variable can be set to any combination of the following  speci-
       fiers 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"

       Start qping -help to see which columns are available.



   --dduummpp__ttaagg ttaagg [[ppaarraamm]]
       This  option  has  the  same 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 possi-
       ble 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 cur-
       rently implemented.  -dump_tag MSG This option has the  same  behaviour
       as the -dump option.


   hhoosstt
       Host where daemon is running.


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


   nnaammee
       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).


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



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



EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies  the location of the Grid Engine standard con-
                      figuration files.

       SSGGEE__CCEELLLL       If set, specifies the default Grid Engine cell.

SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _S_G_E___H___A_L_I_A_S_E_S(5), _s_g_e___q_m_a_s_t_e_r(8), _s_g_e___e_x_e_c_d(8).

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



GE 6.0                   $Date: 2005/11/09 18:13:30 $                 QPING(1)
