Man Linux: Main Page and Category List

NAME

       gfhost - Gfarm host maintenance command

SYNOPSIS

       gfhost  [  -H | -l | -M ] [ -iLprUv ] [ -P path ] [ -a architecture ] [
       -D domain-name ] [ -j concurrency ] [ hostname ... ]

       gfhost -c [ -P path ] -a architecture -p port-number  [  -n  number-of-
       CPUs ] hostname [ host-alias ... ]

       gfhost  -m  [  -P  path  ]  [ -a architecture ] [ -p port-number ] [ -n
       number-of-CPUs ] [ -A ] hostname [ host-alias ... ]

       gfhost -d [ -P path ] hostname ...

       gfhost -R [ -P path ]

DESCRIPTION

       gfhost is used to display and  maintain  information  about  filesystem
       nodes.  The  function  that gfhost performs is determined by an option,
       -c, -d, -H, -l, -M, -m, -R.  These functions  are  mutually  exclusive,
       and  only  one  option among them can be specified.  If none of them is
       specified, host name will be  displayed  as  the  default  function  of
       gfhost.

FUNCTIONS

       Metadata  in  the  metadata server will be accessed by function -c, -d,
       -M, -m or -R. These  functions  add/delete/display/modify/restore  host
       information in the metadata.

       If  -H,  -l or -M is specified, or none of the functions are specified,
       gfhost displays filesystem node  information.   The  -M  function  only
       accesses  information  in the metadata server.  Display functions other
       than -M also access gfsd, which is running  on  filesystem  nodes.  For
       functions  which  access  gfhost, the access option can be specified by
       options -i, -j, -U and -v.

       You don’t have to specify hostnames for  display  functions.   In  that
       case, all hosts which are registered in metadata will be displayed, but
       you can limit the type of hosts displayed by the -a or -D  option.   By
       default,  hosts are displayed in alphabetical order, but you can change
       this by the -L, -p, or -r options. Although the -L option is ignored in
       the -M function  and in the default function.

       The  following  is  a  list of the functions of the gfhost command. You
       shouldn’t specify more than one functions at a time.

       <none> If you don’t specify any of the functions, gfhost accesses gfsd,
              and displays the names of hosts which are currently available as
              its default function.  Hostnames are displayed  in  alphabetical
              order, by default.

       -c     Creates  the metadata information for the host that is specified
              in the argument.  Option -a is mandatory for this function, this
              option  specifies  the  architecture  of the host.  Option -p is
              mandatory in this function too, this option specifies  the  port
              number  of  gfsd  on the host.  Option -n may be used to specify
              the number of CPUs of the host, and 1 CPU is assumed, if  -n  is
              omitted.

              You  can  specifiy multiple hostnames in this function.  In that
              case, the first hostname is treated as  the  identifier  of  the
              host,   and   the   host  identifier  is  used  for  replication
              information management. The rest of the hostnames  are  used  as
              aliases of the host.

              If  a  host  has multiple network interfaces, and each interface
              has a unique hostname, all of the hostnames must  be  registered
              as either host identifiers or host aliases.

              If  /etc/hosts  or  the NIS hosts database doesn’t contain a DNS
              domain name part in its hostnames (i.e. these hostnames are  not
              Fully  Qualified  Domain Names), you must register a host alias.
              In that case, you must register FQDN (a hostname which contain a
              domain  name  part)  as  the host identifier, and register names
              without the domain part as the host alias.

       -d     Deletes host information from metadata.  Currently,  even  hosts
              which  are  referred  by  replica catalog can be deleted. But be
              careful,  because  such  deletions  cause   inconsistencies   of
              metadata.   Only  a host identifier can be used as a hostname in
              this function.

       -H     Displays load average  and  authentication  method.   With  this
              function,  the  exact  hostname  passed  by  the  gfhost command
              arguments will  be  displayed  instead  of  the  canonical  host
              identifier.  Also, this function displays the IP address used to
              access gfsd in parentheses just after the hostname.

              If the host cannot be accessed due to a machine down or  network
              problem,  etc.,  x.xx/x.xx/x.xx  will  be  displayed in the load
              average field.  If the host is up, but gfsd on the  host  cannot
              be accessed, -.--/-.--/-.-- will be displayed.

              The  next field is the authentication method used with the host.
              ‘G’ in this field means GSI authentication and  encryption,  ‘g’
              means  only  authentication  is  performed  by  GSI  and  actual
              communication is unprotected plain data  (gsi_auth),  ‘s’  means
              gfarm   sharedsecret   authentication,   ‘x’   means   that  the
              authentication failed, and ‘-’  means  that  the  authentication
              wasn’t  actually  tried.   If  the  -U option is specified, this
              authentication method field won’t be provided.

              Hostnames are displayed in alphabetical order, by default.

       -l     Displays in  the  long  format.   This  function  displays  both
              information  retrieved  from  gfsd and the metadata server.  The
              types of information retrieved from gfsd are  load  average  and
              authentication  method.   And the types of information retrieved
              from the metadata server are architecture name, number of  CPUs,
              host  identifier, and host aliases (if any).  IP address will be
              displayed in parentheses just after the hostname  used  for  the
              access to gfsd.

              If  the host cannot be accessed due to a machine down or network
              problem, etc., x.xx/x.xx/x.xx will  be  displayed  in  the  load
              average  field.   If the host is up, but gfsd on the host cannot
              be accessed , -.--/-.--/-.-- will be displayed.

              The next field is the authentication method used with the  host.
              ‘G’  in  this field means GSI authentication and encryption, ‘g’
              means  only  authentication  is  performed  by  GSI  and  actual
              communication  is  unprotected  plain data (gsi_auth), ‘s’ means
              gfarm  sharedsecret   authentication,   ‘x’   means   that   the
              authentication  failed,  and  ‘-’  means that the authentication
              wasn’t actually tried.  If that -U  option  is  specified,  this
              authentication method field won’t be provided.

              Hostnames are displayed in alphabetical order, by default.

       -M     The  metadata  information  of  the  hosts  will  be  displayed.
              Hostnames are displayed in alphabetical order, by default.

       -m     Modifies metadata information of the  host,  by  specifying  the
              host  identifier.   The  -a and -n options overwrite the current
              value of each option.  By contrast, host aliases will  be  added
              in  this  function by default.  If you want to replace or delete
              host aliases, please specify the -A option with  this  function.
              In  that  case,  all  host aliases will be replaced by specified
              aliases (if any).

       -R     Restores metadata information read  from  standard  input.   The
              format  of  the  metadata  is  same  as  the  format that the -M
              function displays.

       -?     Prints usage.

OPTIONS

       -A     Alter. This option is used with  the  -m  function  to  replace,
              rather than add, host aliases.

       -a architecture
              This  option  specifies the CPU architecture using a format like
              sparc-sun-solaris8 or i386-redhat8.0-linux, etc.  If this option
              is  used with the -c or -m function, this means the architecture
              used to add/modify the metadata information.  If this option  is
              used  with  -H, -l, -M function or default function, this limits
              hosts to the specified architecture.

       -D domain-name
              This option is used with the -H, -l, -M function or the  default
              function to limit hosts to the specified domain.

       -i     There       is      an      "address_use"      directive      in
              %%SYSCONFDIR%%/gfarm2.conf   and   $HOME/.gfarm2rc    to    give
              priorities   of   network  addresses  for  gfarm  access.   This
              directive works with the gfhost command, but will be ignored, if
              you specified the -i option with gfhost.

       -j concurrency
              This  option  specifies the concurrency used for access to gfsd.
              The default value is 10.

       -L     Sorts by load average order. This option is effective only  with
              the -H and -l functions.

       -n number-of-CPUs
              This  option  is  used with the -c or -m function, and specifies
              the number of CPUs of the host.

       -p port-number
              This option is used with -c or -m function,  and  specifies  the
              port number of gfsd on the host.

       -P path
              This  option  specifies  a pathname or a Gfarm URL to identify a
              metadata server which will be accessed by this command.  If  not
              specified, "/" is used as the default value.

       -r     Reverses the order of sort.

       -u     Plain  order.  This  option  stops  sorting  on  the  -H, -l, -M
              function or the default function.  With the -M function, command
              argument  order  (if any), or the order that the metadata server
              answers is used for display.  With the -H, -l  function  or  the
              default function, the result is displayed in the order that each
              gfsd answers.

       -U     Suppresses authentication attempts by TCP, and only queries load
              average  by  UDP.  This option only makes sense if you specified
              the -H or -l function, or if you didn’t  specify  any  function.
              This  option  makes the gfhost command run faster.  If the -H or
              -l function is specified, this option makes  the  authentication
              method field disappear.

       -v     The -H, -l function and the default function don’t produce error
              reports on gfsd accesses; these error reports will  be  produced
              by this option.

SEE ALSO

       gfarm2.conf(5), gfsd(8)