GFS_CONTROLD(8)

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)