ascheck - validate the array services configuration


SYNOPSIS

       ascheck [ -F ] [ -Kl key ] [ -Kr key ] [ -p port ] [ -q ]
            [ -s server [ -D ] ] [ -t value ]


DESCRIPTION

       ascheck  validates the configuration on all the array ser­
       vices daemons known to the local  array  services  daemon.
       Checks  are  made  to  ensure  that  the various array and
       machine definitions are consistent with each  other,  both
       on  the  individual servers and with corresponding defini­
       tions on the other servers.  If any  problems  are  found,
       they  are described in detail and suggestions are provided
       to correct the situation.

       It should be noted that ascheck is not  a  syntax  checker
       for  the  individual  array  services configuration files;
       that function is handled by the -c option  of  arrayd(1M).
       Instead,  ascheck is used to check the semantics of a syn­
       tactically correct array services configuration file.

       ascheck relies on information provided by array  services.
       Thus,  for  complete  coverage,  an  array services daemon
       should be running on every machine that  is  mentioned  in
       the local configuration file(s).

       The checks that ascheck makes include:

       *  Ensuring that the local array services daemon is acces­
          sible.

       *  Verifying that all of the array services daemons  known
          to the local daemon are also available.

       *  Ensuring  that  each array services daemon is using the
          correct version of the array services library.

       *  Ensuring that the LOCAL IDENT value used by a  particu­
          lar  array  services  daemon  is not different from the
          "machine ID" used by the OS on that daemon's machine.

       *  Suggesting that a "machine ID" be  set  in  the  OS  on
          those  systems  that  have an array services daemon but
          have not yet set a machine ID.

       *  Ensuring that no two arrays on a particular server have
          the same ARRAY IDENT value.

       *  Ensuring  that  the  SERVER  IDENT  value  which may be
          declared  for  a  particular  ARRAY/MACHINE  definition
          matches  the  LOCAL  IDENT  value  of the corresponding
          server.

          lar  array  does  not match the list of machines for an
          array with the same name on a different server.

       *  Warning about any server that has two  or  more  arrays
          defined but has not specified a default array.


OPTIONS

       ascheck  takes  several  options, primarily to control the
       selection of the "local" server, and to select the desired
       amount of output.  The valid options include:

       -D          When  used  with -s, indicates that array ser­
                   vices requests should  sent  directly  to  the
                   specified  server, rather than being forwarded
                   to that server by the  array  services  daemon
                   running  on  the current machine.  This is the
                   default behavior.

       -F          When used with -s, indicates that  array  ser­
                   vices  requests  should  be  forwarded  to the
                   specified server via the server on the current
                   machine rather than sent directly.

       -Kl key     Use  key for the local authentication key when
                   communicating directly  with  a  remote  array
                   services daemon.

       -Kr key     Use key for the remote authentication key when
                   communicating directly  with  a  remote  array
                   services daemon.

       -p port     Specifies  the  port  address  of  the "local"
                   arrayd server.  Defaults to the value  of  the
                   ARRAYD_PORT  environment  variable if present,
                   or 5434 otherwise.

       -q          Produce  less  verbose   ("quieter")   output.
                   Repeated  occurrences (either -q -q ... or -qq
                   ...)  may decrease the verbosity further.

       -s server   Specifies the hostname or IP  address  of  the
                   "local"  arrayd server.  Defaults to the value
                   of the ARRAYD environment variable if present,
                   or "localhost" otherwise.

       -t value    Specifies  the timeout value (in seconds) used
                   for waiting on individual responses  from  the
                   array daemon.


NOTES

       The  array services daemon (arrayd(1M)) must be running on
       all machines that are to be examined.  It does not  neces­
       sarily  have  to  be  running on the machine that executes



SEE ALSO

       arrayd(1M), arrayd.conf(4).


Man(1) output converted with man2html