Man Linux: Main Page and Category List


       drbdlinks - manages links into a shared DRBD partition


       drbdlinks [OPTION]... [start|stop|auto|status|monitor]


       drbdlinks  is a program which manages links into a DRBD partition which
       is  shared  among  several  machines.   It  is  meant  to  be  used  in
       conjunction  with  the  heartbeat  system for simplifying management of
       high   availability   clusters.    A   simple    configuration    file,
       "/etc/drbdlinks.conf", specifies the links.  This can be used to manage
       links for "/etc/apache", "/var/lib/pgsql", and other system  files  and
       directories that need to appear as if they are local to the system when
       running applications after a DRBD shared partition has been mounted.

       A sample  configuration  file  with  annotations  is  included  in  the
       drbdlinks distribution.

       When  run  with "start" as the mode, drbdlinks will rename the existing
       files/directories,  and  then  make  symbolic  links  into   the   DRBD
       partition.  "stop" does the reverse.

       The "monitor" and "status" modes will check the file-system against the
       configuration file and will report "running"  (monitor  mode)  or  "OK"
       (status  mode)  if  all  links  appear to be up.  Otherwise they report
       "down" or "stopped" (respectively).

       By default, the rename appends .drbdlinks to the name, but this can  be
       overridden in the configuration file.

       The "list" mode just show the list of links, with each line showing the
       link, destination, and a 0/1 flag for bindMount status.   This  may  be
       useful for user scripts without having to parse the configuration.

       An  init  script is included which runs "stop" before heartbeat starts,
       and after heartbeat stops.  This is done to try to ensure that when the
       shared partition isn’t mounted, the links are in their normal state.


       drbdlinks has several options, using either short or long variants.

       -h, --help
              Print  a short help message describing the available options and

       -c, --config-file=CONFIGFILE
              Specify an alternate config file.  The default  config  file  is
              /etc/drbdlinks.conf.   Alternate  config  files  should  have  a
              "drbdlinks-" prefix, e.g. "drbdlinks-httpd.conf".

       -s, --suffix=SUFFIX
              Name to append to the local file-system name when the link is in
              place.   The  default  is  "drbdlinks",  which would result in a
              renamed file like "/etc/httpd.drbdlinks".

       -v, --verbose
              Increase verbosity level by  1  for  every  occurrence  of  this


       Here are a few examples of how drbdlinks can be used.

       The most straight-forward, and default, method for starting drbdlinks:

              drbdlinks start

       To  use  a  suffix different from the default when linking to a file or
       directory, the -s option can be used, specifying the desired string:

              drbdlinks -s orig start

       would rename the file-system name to "name.orig".

       Increase the verbosity to assist in debugging:

              drbdlinks -v -v start

       Use an alternate configuration file, possibly from with a DRBD  mounted

              drbdlinks -c /shared1/drbdlinks-httpd.conf start

       This  would  use  the  specified  configuration file, found on our DRBD
       device mounted on  /shared1.   This  would  allow  us  to  easily  keep
       drbdlinks  configurations tied to a specific set of data on a DRBD disk
       in an active/active sort of HA configuration.


       DRBD(8), drbdadm(8), drbdsetup(8), heartbeat(8).


       drbdlinks was written by Sean Reifschneider <>.

       This manual page was written by  Cyril  Bouthors  <>,
       for the Debian project (but may be used by others).  Sean Reifschneider
       modified it for status and monitor arguments, and included  it  in  the
       base   drbdlinks  release.   Mike  Loseke  <>  added  the
       sections on options and examples.

                              September  3, 2008