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)