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
       GE_QMASTER daemon and any running GE_EXECD daemon. The qping command is
       used to send a SIM (Status Information Message) to the destination dae-
       mon.  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 hap-
             pen 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  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 happen when  the
             dispatcher  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
             followed 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:
                   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 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 follows an additional informa-
             tion string which describes the complete application status.

          execd:

             The info message contains information  for  the  execd  job  dis-
             patcher:
                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  _<_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 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


   --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   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 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 possible debug messages (APP+MSG)  for  the
             debug  levels,  ERROR, WARNING, INFO, DEBUG and DPRINTF. The con-
             tacted 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.


   hhoosstt
       Host where daemon is running.


   ppoorrtt
       Port which daemon has bound (used ge_qmaster/ge_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
       GGEE__RROOOOTT        Specifies the location of the Grid Engine standard  con-
                      figuration files.

       GGEE__CCEELLLL        If set, specifies the default Grid Engine cell.

SSEEEE AALLSSOO
       _g_e___i_n_t_r_o(1), _G_E___H___A_L_I_A_S_E_S(5), _g_e___q_m_a_s_t_e_r(8), _g_e___e_x_e_c_d(8).

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



GE 6.2u2                 $Date: 2008/04/30 09:11:03 $                 QPING(1)
