Filewatcher File Search File Search
Catalog
Content Search
» » » » » » drbd-8.0.16-5.el5.centos.i386.rpm » Content »
pkg://drbd-8.0.16-5.el5.centos.i386.rpm:149757/usr/share/man/man5/  info  HEADER  downloads

drbd - Distributed Redundant Block Device driver for Linux…  more info»

drbd.conf.5.gz

DRBD.CONF(5)                                            DRBD.CONF(5)



NAME
       drbd.conf - Configuration file for DRBD's devices


INTRODUCTION
       The file /etc/drbd.conf is read by drbdadm.

       The  file  format was designed as to allow to have a verbatim
       copy of the file on both nodes of the cluster.  It is  highly
       recommended to do so in order to keep your configuration man‐
       ageable. The file /etc/drbd.conf should be the same  on  both
       nodes  of the cluster. Changes to /etc/drbd.conf do not apply
       immediately.

   A SMALL DRBD.CONF FILE
       global { usage-count yes; }
       common { syncer { rate 10M; } }
       resource r0 {
            protocol C;
            net {
                 cram-hmac-alg sha1;
                 shared-secret "FooFunFactory";
            }
            on alice {
                 device    /dev/drbd1;
                 disk      /dev/sda7;
                 address   10.1.1.31:7789;
                 meta-disk internal;
            }
            on bob {
                 device    /dev/drbd1;
                 disk      /dev/sda7;
                 address   10.1.1.32:7789;
                 meta-disk internal;
            }
       }
       In this example, there is a single DRBD resource (called  r0)
       which uses protocol C for the connection between its devices.
       The device which  runs  on  host  alice  uses  /dev/drbd1  as
       devices for its application, and /dev/sda7 as low-level stor‐
       age for the data.  The IP addresses are used to  specify  the
       networking  interfaces  to  be  used.   An eventually running
       resync process should use about 10MByte/second  of  IO  band‐
       width.

       There may be multiple resource sections in a single drbd.conf
       file.  For more examples, please have  a  look  at  the  DRBD
       User's Guide <URL:http://www.drbd.org/users-guide/>.

FILE FORMAT
       The  file  consists  of  sections  and parameters.  A section
       begins with a keyword, sometimes an additional name,  and  an
       opening  brace  (``{'').  A section ends with a closing brace
       (``}''.  The braces enclose the parameters.

       section [name] { parameter value; [...] }

       A parameter starts with the identifier of the parameter  fol‐
       lowed by whitespace. Every subsequent character is considered
       as part of the parameter's value. A special case are  Boolean
       parameters  which only consist of the identifier.  Parameters
       are terminated by a semicolon (``;'').

       Some parameter values have default units which might be over‐
       ruled  by K, M or G. These units are defined in the usual way
       (K = 2^10 = 1024, M =  1024 K, G = 1024 M).

       Comments may be placed into the configuration file  and  must
       begin  with  a  hash  sign (``#''). Subsequent characters are
       ignored until the end of the line.

   SECTIONS
       skip

              Comments out chunks of text, even spanning  more  than
              one line.  Characters between the keyword skip and the
              opening brace (``{'') are ignored. Everything enclosed
              by the braces is skipped.  This comes in handy, if you
              just want to comment out some 'resource [name]  {...}'
              section: just precede it with 'skip'.

       global

              Configures  some  global  parameters.  Currently  only
              minor-count,  dialog-refresh,  disable-ip-verification
              and  usage-count  are  allowed here. You may only have
              one global section, preferably as the first section.

       common

              All resources inherit the options set in this section.
              The  common  section might have a startup, a syncer, a
              handlers, a net and a disk section.

       resource name

              Configures a DRBD  resource.   Each  resource  section
              needs  to  have  two  on  host sections and may have a
              startup, a syncer, a handlers, a net and a  disk  sec‐
              tion.  Required parameter in this section: protocol.

       on host-name

              Carries  the  necessary configuration parameters for a
              DRBD device of the enclosing resource.   host-name  is
              mandatory  and  must  match the Linux host name (uname
              -n) of one of the nodes.  Required parameters in  this
              section:  device,  disk, address, meta-disk, flexible-
              meta-disk.

       disk

              This section is used to fine tune DRBD's properties in
              respect  to  the  low  level  storage. Please refer to
              drbdsetup(8) for detailed description of  the  parame‐
              ters.  Optional parameter: on-io-error, size, fencing,
              use-bmbv, no-disk-flushes, no-md-flushes.

       net

              This section is used to fine tune  DRBD's  properties.
              Please  refer  to drbdsetup(8) for a detailed descrip‐
              tion of this section's parameters.   Optional  parame‐
              ters:  sndbuf-size,  timeout,  connect-int,  ping-int,
              ping-timeout, max-buffers,  max-epoch-size,  ko-count,
              allow-two-primaries,   cram-hmac-alg,   shared-secret,
              after-sb-0pri, after-sb-1pri, after-sb-2pri

       startup

              This section is used to fine tune  DRBD's  properties.
              Please  refer  to drbdsetup(8) for a detailed descrip‐
              tion of this section's parameters.   Optional  parame‐
              ters: wfc-timeout, degr-wfc-timeout, wait-after-sb and
              become-primary-on.

       syncer

              This section is used to fine tune the  synchronization
              daemon  for  the  device. Please refer to drbdsetup(8)
              for a detailed description of this  section's  parame‐
              ters.  Optional parameters: rate, after, al-extents.

       handlers

              In  this section you can define handlers (executables)
              that are executed by the DRBD system  in  response  to
              certain  events.   Optional  parameters: pri-on-incon-
              degr,   pri-lost-after-sb,   pri-lost,   outdate-peer,
              local-io-error, split-brain.

   PARAMETERS
       minor-count count

              count may be a number from 1 to 255.

              Use  minor-count  if you want to define massively more
              resources later without reloading the DRBD kernel mod‐
              ule.  Per  default  the  module  loads  with  11  more
              resources than you have currently in your  config  but
              at least 32.

       dialog-refresh time

              time may be 0 or a positive number.

              The  user  dialog  redraws the second count every time
              seconds (or does no redraws if time is 0). The default
              value is 1.

       disable-ip-verification

              Use  disable-ip-verification if, for some obscure rea‐
              sons, drbdadm can/might not use ip or ifconfig to do a
              sanity  check  for the IP address. You can disable the
              IP verification  with this option.

       usage-count val

              Please participate  in  DRBD's  online  usage  counter
              <URL:http://usage.drbd.org>.   The most convenient way
              to do so is to set this option to yes.  Valid  options
              are: yes, no and ask.

       protocol prot-id

              On  the  TCP/IP  link  the specified protocol is used.
              Valid protocol specifiers are A, B, and C.

              Protocol A: write IO is reported as completed,  if  it
              has reached local disk and local TCP send buffer.

              Protocol  B:  write IO is reported as completed, if it
              has reached local disk and remote buffer cache.

              Protocol C: write IO is reported as completed,  if  it
              has reached both local and remote disk.

       pri-on-incon-degr-cmd command

              In  case  a node starts up in degraded mode (degr-wfc-
              timeout is set) and its local replica of the  data  is
              inconsistent,  it executes the command. If the command
              exits without error, drbddisk expects the DRBD  device
              to be in primary state.

       device name

              The  name  of  the  block  device node of the resource
              being described.  You must use this device  with  your
              application (file system) and you must not use the low
              level block device which is specified  with  the  disk
              parameter.

              The  device  nodes  must have the same major number as
              the DRBD driver. With the current implementation major
              147  is  used  and  the corresponding device nodes are
              usually named  /dev/drbd0,  /dev/drbd1,  etc.   (  All
              releases  before  drbd-0.7.1  used  major  43  and the
              device files /dev/nb*. )

              Installation scripts of the DRBD package require  that
              /dev/drbd0  to  /dev/drbd8 are predefined in your sys‐
              tem. To be sure, issue something like ls /dev/drbd*.

       disk name

              DRBD uses this block  device  to  actually  store  and
              retrieve  the  data.  Never access such a device while
              DRBD is running on top of it. This holds also true for
              dumpe2fs(8) and similar commands.

       address IP:port

              A  resource  needs one IP address per device, which is
              used to wait for incoming connections from the partner
              device respectively to reach the partner device.

              Each  DRBD  resource needs a TCP port which is used to
              connect to the node's partner device.   Two  different
              DRBD  resources  may not use the same IP:port combina‐
              tion on the same node.

       meta-disk internal

       flexible-meta-disk internal

       meta-disk device [index]

       flexible-meta-disk device


              Internal means that  the  last  part  of  the  backing
              device  is  used  to store the meta-data. You must not
              use [index] with internal. Note: Regardless of whether
              you  use  the meta-disk or the flexible-meta-disk key‐
              word, it will always be of the  size  needed  for  the
              remaining storage size.

              You  can  use a single block device to store meta-data
              of  multiple  DRBD  devices.    E.g.   use   meta-disk
              /dev/sde6[0]; and meta-disk /dev/sde6[1]; for two dif‐
              ferent resources. In this  case  the  meta-disk  would
              need to be at least 256 MB in size.

              With  the  flexible-meta-disk  keyword  you  specify a
              block device as meta-data  storage.  You  usually  use
              this  with LVM, which allows you to have many variable
              sized block devices.  The required size of  the  meta-
              disk  block  device  is  36kB + Backing-Storage-size /
              32k. Round this number to the next 4kb boundary up and
              you  have  the exact size.  Rule of the thumb: 32kByte
              per 1GByte of storage, round up to the next MB.

       on-io-error handler

              handler is taken, if the lower  level  device  reports
              io-error to the upper layers.

              handler may be pass_on, call-local-io-error or detach.

              pass_on:  Report  the io-error to the upper layers. On
              Primary report it to the mounted file system. On  Sec‐
              ondary ignore it.

              call-local-io-error: Call the handler script local-io-
              error.

              detach: The node drops its low level device, and  con‐
              tinues in diskless mode.

       fencing fencing_policy

              Under  fencing  we  understand  preventive measures to
              avoid situations where both nodes are primary and dis‐
              connected (AKA split brain).

              Valid fencing policies are:

              dont-care
                     This  is the default policy. No fencing actions
                     are undertaken.

              resource-only
                     If a node becomes a  disconnected  primary,  it
                     tries  to outdate the peer's disk. This is done
                     by calling the outdate-peer handler.  The  han‐
                     dler  is  supposed to reach the other node over
                     alternative communication paths and call  'drb‐
                     dadm outdate res' there.

              resource-and-stonith
                     If  a  node  becomes a disconnected primary, it
                     freezes all its IO  operations  and  calls  its
                     outdate-peer  handler. The outdate-peer handler
                     is supposed to reach the peer over  alternative
                     communication  paths  and call 'drbdadm outdate
                     res' there. In case it cannot reach the peer it
                     should  stonith the peer. IO is resumed as soon
                     as the situation is resolved. In case your han‐
                     dler  fails, you can resume IO with the resume-
                     io command.

       use-bmbv

              In  case  the   backing   storage's   driver   has   a
              merge_bvec_fn()  function, DRBD has to pretend that it
              can only process IO requests in units not  lager  than
              4kByte.  (At  time  of  writing the only known drivers
              which have such a  function  are:  md  (software  raid
              driver), dm (device mapper - LVM) and DRBD itself)

              To get best performance out of DRBD on top of software
              RAID (or any other driver with a merge_bvec_fn() func‐
              tion)  you might enable this function, if you know for
              sure that the merge_bvec_fn()  function  will  deliver
              the  same  results  on all nodes of your cluster. I.e.
              the physical disks of the software RAID are of exactly
              the  same  type. Use this option only if you know what
              you are doing.

       no-disk-flushes

              In case you are sure that your storage  subsystem  has
              battery-backed write cache, and you know from measure‐
              ments that it  really  honors  flush  instructions  by
              flushing data out from its non-volatile write cache to
              disk, you have double security. You might then  reduce
              this  to  single  security  by  disabling  forced disk
              flushes with this option. It might improve performance
              in this case.

              If  you  use  this  option on plain disk drives, which
              have volatile write caches (enabled by  default),  you
              are  at  risk to lose your data with every power loss.
              Only use this option of you understand each and  every
              statement in these two paragraphs.

       no-md-flushes

              Disables the use of disk flushes and barrier BIOs when
              accessing the meta data device. See the notes  on  no-
              disk-flushes.

       sndbuf-size size

              size  is  the size of the TCP socket send buffer.  The
              default value is 128K.  You  can  specify  smaller  or
              larger  values. Larger values are appropriate for rea‐
              sonable write throughput with  protocol  A  over  high
              latency  networks. Very large values like 1M may cause
              problems. Also values  below  32K  do  not  make  much
              sense.  Since 8.0.13 setting the size value to 0 means
              that the kernel should autotune this.

       timeout time

              If the partner node fails to send an expected response
              packet within time 10ths of a second, the partner node
              is considered dead and therefore the TCP/IP connection
              is  abandoned. This must be lower than connect-int and
              ping-int.  The default value is 60 =  6  seconds,  the
              unit 0.1 seconds.

       connect-int time

              In  case  it  is not possible to connect to the remote
              DRBD device immediately, DRBD keeps on trying to  con‐
              nect.  With  this  option you can set the time between
              two tries. The default value is 10 seconds,  the  unit
              is 1 second.

       ping-int time

              If the TCP/IP connection linking a DRBD device pair is
              idle for more than time seconds, DRBD will generate  a
              keep-alive  packet  to  check  if its partner is still
              alive. The default is 10 seconds, the unit is  1  sec‐
              ond.

       ping-timeout time

              The  time  the peer has time to answer to a keep-alive
              packet. In case  the  peer's  reply  is  not  received
              within this time period, it is considered as dead. The
              default value is 500ms, the default unit is 100ms.

       max-buffers number

              Maximum number of requests to be  allocated  by  DRBD.
              Unit is PAGE_SIZE, which is 4 KB on most systems.  The
              minimum is hard coded to 32 (=128 KB).  For  high-per‐
              formance  installations it might help, if you increase
              that number. These  buffers  are  used  to  hold  data
              blocks while they are written to disk.

       ko-count number

              In  case the secondary node fails to complete a single
              write request for  count  times  the  timeout,  it  is
              expelled from the cluster. (I.e. the primary node goes
              into StandAlone mode.)  The default value is 0,  which
              disables this feature.

       max-epoch-size number

              The  highest  number  of data blocks between two write
              barriers.  If you set this smaller than 10, you  might
              decrease your performance.

       allow-two-primaries

              With  this  option  set you may assign primary role to
              both nodes. You only should use this option if you use
              a  shared  storage  file system on top of DRBD. At the
              time of writing the only ones are: OCFS2 and  GFS.  If
              you  use  this  option with any other file system, you
              are going to crash your  nodes  and  to  corrupt  your
              data!

       unplug-watermark number

              When  the  number  of  pending  write  requests on the
              standby (secondary) node exceeds the unplug-watermark,
              we trigger the request processing of our backing stor‐
              age device.  Some storage controllers  deliver  better
              performance  with  small  values,  others deliver best
              performance when the value is set to the same value as
              max-buffers. Minimum 16, default 128, maximum 131072.

       cram-hmac-alg

              You  need to specify the HMAC algorithm to enable peer
              authentication at all. You are strongly encouraged  to
              use  peer  authentication.  The HMAC algorithm will be
              used for the challenge response authentication of  the
              peer.  You  may  specify  any digest algorithm that is
              named in /proc/crypto.

       shared-secret

              The shared secret used in peer authentication. May  be
              up to 64 characters.  Note that peer authentication is
              disabled as long as no cram-hmac-alg  (see  above)  is
              specified.

       after-sb-0pri policy

              possible policies are:

              disconnect
                     No  automatic resynchronization, simply discon‐
                     nect.

              discard-younger-primary
                     Auto sync from the node that was primary before
                     the split-brain situation happened.

              discard-older-primary
                     Auto  sync from the node that became primary as
                     second during the split-brain situation.

              discard-zero-changes
                     In case one node did not write  anything  since
                     the  split  brain became evident, sync from the
                     node that wrote something to the node that  did
                     not write anything. In case none wrote anything
                     this policy uses a random decision to perform a
                     "resync" of 0 blocks. In case both have written
                     something this policy disconnects the nodes.

              discard-least-changes
                     Auto sync  from  the  node  that  touched  more
                     blocks during the split brain situation.

              discard-node-NODENAME
                     Auto sync to the named node.

       after-sb-1pri policy

              possible policies are:

              disconnect
                     No  automatic resynchronization, simply discon‐
                     nect.

              consensus
                     Discard the version of  the  secondary  if  the
                     outcome  of  the  after-sb-0pri algorithm would
                     also destroy the current secondary's data. Oth‐
                     erwise disconnect.

              violently-as0p
                     Always  take  the decision of the after-sb-0pri
                     algorithm.  Even  if  that  causes  an  erratic
                     change of the primary's view of the data.  This
                     is only useful if you use a 1node FS (i.e.  not
                     OCFS2  or  GFS)  with  the  allow-two-primaries
                     flag, _AND_ if you really  know  what  you  are
                     doing.   This  is  DANGEROUS and MAY CRASH YOUR
                     MACHINE if you have an FS mounted on  the  pri‐
                     mary node.

              discard-secondary
                     Discard the secondary's version.

              call-pri-lost-after-sb
                     Always honor the outcome of the after-sb-0pri
                      algorithm. In case it decides the current sec‐
                     ondary has the right data, it calls  the  "pri-
                     lost-after-sb" handler on the current primary.

       after-sb-2pri policy

              possible policies are:

              disconnect
                     No  automatic resynchronization, simply discon‐
                     nect.

              violently-as0p
                     Always take the decision of  the  after-sb-0pri
                     algorithm.  Even  if  that  causes  an  erratic
                     change of the primary's view of the data.  This
                     is only useful if you use a 1node FS (i.e.  not
                     OCFS2  or  GFS)  with  the  allow-two-primaries
                     flag,  _AND_  if  you  really know what you are
                     doing.  This is DANGEROUS and  MAY  CRASH  YOUR
                     MACHINE  if  you have an FS mounted on the pri‐
                     mary node.

              call-pri-lost-after-sb
                     Call the "pri-lost-after-sb" helper program  on
                     one  of  the machines. This program is expected
                     to reboot the machine, i.e. make it secondary.

       always-asbp
              Normally the automatic after-split-brain policies  are
              only  used if current states of the UUIDs do not indi‐
              cate the presence of a third node.

              With this option you request that the automatic after-
              split-brain policies are used as long as the data sets
              of the nodes are somehow related. This might  cause  a
              full  sync,  if  the  UUIDs indicate the presence of a
              third node. (Or double  faults  led  to  strange  UUID
              sets.)

       rr-conflict policy

              To  solve  the  cases  when  the outcome of the resync
              decision is incompatible with the current role assign‐
              ment in the cluster.

              disconnect
                     No  automatic resynchronization, simply discon‐
                     nect.

              violently
                     Sync to the primary node is allowed,  violating
                     the  assumption that data on a block device are
                     stable for one of the nodes. Dangerous, do  not
                     use.

              call-pri-lost
                     Call  the  "pri-lost"  helper program on one of
                     the  machines.  This  program  is  expected  to
                     reboot the machine, i.e. make it secondary.

       wfc-timeout time
              Wait for connection timeout.

              The  init script drbd(8) blocks the boot process until
              the DRBD resources are connected.   When  the  cluster
              manager  starts later, it does not see a resource with
              internal split-brain.  In case you want to  limit  the
              wait  time,  do  it  here.   Default is 0, which means
              unlimited. The unit is seconds.

       degr-wfc-timeout time

              Wait for  connection  timeout,  if  this  node  was  a
              degraded cluster.  In case a degraded cluster (= clus‐
              ter with only one node left) is rebooted, this timeout
              value is used instead of wfc-timeout, because the peer
              is less likely to show up in time, if it had been dead
              before.  The default value is 60, the unit is seconds.
              Value 0 means unlimited.

       wait-after-sb
              By setting this option you can make the init script to
              continue  to  wait even if the device pair had a split
              brain situation and therefore refuses to connect.

       become-primary-on node-name
              Sets on which node the device should  be  promoted  to
              primary  role  by the init script. The node-name might
              either be a host name or the key word both. When  this
              option  is  not set the devices stay in secondary role
              on both nodes. Usually one delegates the role  assign‐
              ment to a cluster manager (e.g. heartbeat).

       rate rate

              To ensure a smooth operation of the application on top
              of DRBD, it is possible to limit the  bandwidth  which
              may   be  used  by  background  synchronizations.  The
              default is 250 KB/sec, the  default  unit  is  KB/sec.
              Optional suffixes K, M, G are allowed.

       after res-name

              By default, resynchronization of all devices would run
              in parallel.  By defining a sync-after dependency, the
              resynchronization  of this resource will start only if
              the resource res-name is already in connected state (=
              finished its resynchronization).

       al-extents extents
              DRBD  automatically  performs hot area detection. With
              this

              parameter you control how big the hot area  (=  active
              set)  can  get.  Each  extent  marks 4M of the backing
              storage (= low-level device).  In case a primary  node
              leaves  the cluster unexpectedly, the areas covered by
              the active set must be resynced upon rejoining of  the
              failed node. The data structure is stored in the meta-
              data area, therefore each change of the active set  is
              a  write  operation  to the meta-data device. A higher
              number of extents gives longer resync times  but  less
              updates  to  the  meta-data.  The  default  number  of
              extents is 127. (Minimum: 7, Maximum: 3843)

       pri-on-incon-degr cmd
              This  handler  is  called  if  the  node  is  primary,
              degraded

              and if the local copy of the data is inconsistent.

       pri-lost-after-sb cmd
              The  node  is  currently  primary,  but lost the after
              split

              brain auto recovery procedure. As as  consequence,  it
              should be abandoned.

       pri-lost cmd
              The node is currently primary, but DRBD's algorithm

              thinks  that it should become sync target. As a conse‐
              quence it should give up its primary role.

       outdate-peer cmd
              The handler is part of the fencing

              mechanism.  This handler is called in  case  the  node
              needs  to outdate the peer's disk. It should use other
              communication paths than DRBD's network link.

       local-io-error cmd
              DRBD got an IO error from the local IO subsystem.


       split-brain cmd
              DRBD detected a split brain situation. Manual recovery
              is  necessary.   This  handler should alert someone on
              duty.


VERSION
       This document was revised for version 8.0.14 of the DRBD dis‐
       tribution.

AUTHOR
       Written  by  Philipp Reisner <philipp.reisner@linbit.com> and
       Lars Ellenberg <lars.ellenberg@linbit.com>.

REPORTING BUGS
       Report bugs to <drbd-user@lists.linbit.com>.

COPYRIGHT
       Copyright 2001-2008 LINBIT Information Technologies,  Philipp
       Reisner,  Lars  Ellenberg.  This   is  free software; see the
       source for copying conditions.  There  is  NO  warranty;  not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
       drbd(8),  drbddisk(8),  drbdsetup(8), drbdadm(8), DRBD User's
       Guide <URL:http://www.drbd.org/users-guide/>, DRBD  web  site
       <URL:http://www.drbd.org/>



                            27 March 2009               DRBD.CONF(5)
Results 1 - 1 of 1
Help - FTP Sites List - Software Dir.
Search over 15 billion files
© 1997-2017 FileWatcher.com