Provided by: cman_3.0.12-2ubuntu5_i386 bug

NAME

       gfs_controld - daemon that coordinates gfs mounts and recovery

SYNOPSIS

       gfs_controld [OPTIONS]

DESCRIPTION

       GFS  lives  in  the  kernel,  and  the cluster infrastructure (corosync
       membership and group management) lives  in  user  space.   GFS  in  the
       kernel  needs  to  adjust/recover for certain cluster events.  It's the
       job of gfs_controld to receive these  events  and  reconfigure  gfs  as
       needed.   gfs_controld  controls and configures gfs through sysfs files
       that are considered gfs-internal interfaces.

       Mounting and node failure are the main cluster events that gfs_controld
       controls.   It  also  manages  the  assignment of journals to different
       nodes.  mount.gfs2(8) communicates with gfs_controld to join the  mount
       group and receive the necessary options for the kernel mount.

       The cman init script usually starts the gfs_controld daemon.

OPTIONS

       Command line options override a corresponding setting in cluster.conf.

       -D     Enable debugging to stderr and don't fork.
              See also gfs_control dump in gfs_control(8).

       -L     Enable debugging to log file.
              See also logging in cluster.conf(5).

       -g num groupd compatibility mode, 0 off, 1 on.
              Default 0.

       -w num Enable (1) or disable (0) withdraw.
              Default 1.

       -h     Print a help message describing available options, then exit.

       -V     Print program version information, then exit.

   Cluster Upgrading
       When  performing  a  rolling  upgrade  from  cluster2  to cluster3, the
       gfs_controld daemon runs in cluster2 compatibility mode  and  processes
       posix  lock  (plock)  requests  from  the dlm to remain compatible with
       cluster2 nodes.  Otherwise, dlm_controld(8) handles plocks.

       -p num Enable (1) or disable (0) plock code for cluster fs.
              Default 1.

       -l num Limit the rate of plock operations, 0 for no limit.
              Default 0.

       -o num Enable (1) or disable (0) plock ownership.
              Default 1.

       -t ms  Plock ownership drop resources time (milliseconds).
              Default 10000.

       -c num Plock ownership drop resources count.
              Default 10.

       -a ms  Plock ownership drop resources age (milliseconds).
              Default 10000.

       -P     Enable plock debugging messages (can produce excessive output).

FILES

       cluster.conf(5) is usually located at /etc/cluster/cluster.conf.  It is
       not  read  directly.   Other  cluster components load the contents into
       memory, and the values are accessed through the libccs library.

       Configuration options are added to  the  <gfs_controld  />  section  of
       cluster.conf, within the top level <cluster> section.

       enable_withdraw
              Set to 1/0 to enable/disable a response to a withdraw.

              <gfs_controld enable_withdraw="1"/>

   Cluster Upgrading
       See  note  above  about  compatibility  plock handling during a rolling
       upgrade.  The following options are deprecated, see dlm_controld(8) for
       the new equivalent options.

       enable_plock
              See command line description.

              <gfs_controld enable_plock="1"/>

       plock_rate_limit
              See command line description.

              <gfs_controld plock_rate_limit="0"/>

       plock_ownership
              See command line description.

              <gfs_controld plock_ownership="1"/>

       drop_resources_time
              See command line description.

              <gfs_controld drop_resources_time="10000"/>

       drop_resources_count
              See command line description.

              <gfs_controld drop_resources_count="10"/>

       drop_resources_age
              See command line description.

              <gfs_controld drop_resources_age="10000"/>

       plock_debug
              Enable  (1) or disable (0) plock debugging messages (can produce
              excessive output). Default 0.

              <gfs_controld plock_debug="0"/>

SEE ALSO

       mount.gfs2(8),      gfs_control(8),      dlm_controld(8),      cman(5),
       cluster.conf(5)