gfservice-agent is an agent of gfservice. It must be installed on all hosts you want to operate using gfservice. Unlike gfservice, it doesn't read a configuration file.
gfservice-agent is not designed to be executed directly by an user. In daily use, it is executed only by gfservice via SSH and Sudo.
Host-id argument is the same as that of gfservice, but gfservice-agent uses host-id for recognizing type of host ("gfmd", "gfsd" or "client") and debug messages only.
Sub-command names of gfservice-agent are similar to
those of gfservice, but their arguments are different.
For example, "unmount" sub-command of
gfservice-agent takes
"directory=
argument:
directory
"
gfservice-agent client3 unmount directory=/somewhere
while "unmount" sub-command of gfservice
takes "directory"
argument:
gfservice unmount client3 /somewhere
Almost all arguments of gfservice-agent have "key=value" form. When two or more arguments are given, gfservice-agent doesn't care about the order of arguments. gfservice-agent ignores arguments with unknown keys.
gfservice-agent currently recognizes the following sub-commands.
param
=name
config-gfarm-options
=options
Execute config-gfarm -T command and output a value of
the parameter name
to standard out.
If the "param
=name
"
argument is not specified, it outputs entire
config-gfarm -T results.
param
=name
config-gfsd-options
=options
Execute config-gfsd -T command and output a value of
the parameter name
to standard out.
If the "param
=name
"
argument is not specified, it outputs entire
config-gfsd -T results.
config-gfarm-options
=options
Exit with an exit code 0, if a backend database is currently running. Otherwise exits with 1.
config-gfarm-options
=options
Exit with an exit code 0, if gfmd is currently running. Otherwise exits with 1.
config-gfsd-options
=options
Exit with an exit code 0, if gfsd is currently running. Otherwise exits with 1.
config-gfarm-options
=options
timeout
=time
Start a backend database if it is not running currently.
config-gfarm-options
=options
timeout
=time
Start gfmd if it is not running currently.
config-gfsd-options
=options
timeout
=time
Start gfsd if it is not running currently.
config-gfarm-options
=options
Execute config-gfarm command.
config-gfarm-options
=options
Execute config-gfarm -r
command.
config-gfsd-options
=options
Execute config-gfsd command.
config-gfarm-options
=options
Execute stop-gfarm sub-command and then delete all files and directories created by gfmd and a backend database.
config-gfsd-options
=options
Execute stop-gfsd sub-command and then delete all files and directories created by gfsd.
config-gfsd-options
=options
Delete gfarm2.conf
file.
config-gfarm-options
=options
Promote gfmd from a slave to a master.
config-gfarm-options
=options
An alias of promote sub-command.
directory
=directory
options
=options
Mount a Gfarm2 filesystem on directory
.
directory
=directory
Unmount a Gfarm2 filesystem currently mounted on
directory
.
directory
=directory
An alias of unmount sub-command.
directive
=name
value
=value
Add
directive
value
line to gfmd.conf
file.
directive
=name
value
=value
Add
directive
value
line to gfarm2.conf
file.
directive
=name
value
=value
Add
directive
value
line to gfsd.conf
file.
directive
=name
Delete a directive
line in
gfmd.conf
file.
directive
=name
Delete a directive
line in
gfarm2.conf
file.
directive
=name
Delete a directive
line in
gfsd.conf
file.
Backup a backend database and output the backup data to standard out.
Output gfmd.conf
file to standard out.
Output gfarm2.conf
file to standard out.
Output gfsd.conf
file to standard out.
Output usermap
file to standard out.
Output $HOME/.gfarm_shared_key
file to standard out.
Restore a backend database. The backup data are read from standard in.
Restore gfmd.conf
file.
The backup data are read from standard in.
Restore gfarm2.conf
file.
The backup data are read from standard in.
Restore gfsd.conf
file.
The backup data are read from standard in.
Restore usermap
file.
The backup data are read from standard in.
Restore $HOME/.gfarm_shared_key
file.
The backup data are read from standard in.
cmd
=command-name
args
="command-argument ...
"
Execute a Gfarm command.
args
="command-argument ...
"
Execute grid-proxy-init command.