medstat(1M)

NAME

     medstat - check the status of mediator  hosts  for  a  given
     diskset

SYNOPSIS

     /usr/sbin/medstat [-q] -s setname

DESCRIPTION

     If a specified diskset has been  configured  for  mediators,
     medstat  attempts  to contact these hosts to see if they are
     accessible and returns the results of the communication.

OPTIONS

     -q    This optional argument disables the printing of infor-
           mative  text.  When used with -q, medstat still prints
           error messages and returns a result code.

     -s setname
           Specifies the name of a diskset on which medstat  will
           work.

EXAMPLES

     Example 1:  Checking diskset

     This example checks the  mediator  hosts  for  the  selected
     diskset.

     # medstat -s relo-red

     The name of the diskset is  relo-red.  The  medstat  command
     prints  the  status for each mediator host. Additionally, if
     the mediator quorum is  met,  either  through  a  ``golden''
     mediator  host  or  because  half+1  of  the  mediator hosts
     respond, the exit code is 0. If the quorum is not met,  then
     the  exit  code is 1. If no mediator hosts have been config-
     ured for the named diskset, the exit code is 2.  The  status
     field will contain one of the following values: Unreachable,
     Bad,  Fatal,  or  Ok,   where   Unreachable   indicates   an
     RPC/communication  problem,  Bad  indicates  an error in the
     mediator data, Fatal indicates any  other  error  condition,
     and Ok indicates no error conditions.

FILES

     /etc/lvm/meddb
           Contains the mediator data for a host  that  has  been
           selected as a mediator host.

EXIT STATUS

     The following exit values are returned:

          0     Successful completion.

          >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWmdu                     |
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|

SEE ALSO

     metaclear(1M),   metadb(1M),   metadetach(1M),   metahs(1M),
     metainit(1M),        metaoffline(1M),        metaonline(1M),
     metaparam(1M), metareplace(1M),  metaroot(1M),  metaset(1M),
     metastat(1M),    metasync(1M),    metattach(1M),   md.cf(4),
     md.tab(4), mddb.cf(4), meddb(4), mediator(7D)

     Sun Cluster documentation, Solaris Volume  Manager  Adminis-
     tration Guide

NOTES

     This command is designed for use in  the  high  availability
     product.