描述

drbdadm - DRBD 高级管理工具

指令

drbdadm [-d] [-c {_file_}] [-t {_file_}] [-s {_cmd_}] [-m {_cmd_}] [-S] [-h {_host_}] [-- {_backend-options_}] {_command_} [{all} | {_resource__[/volume>]_...}]

说明

drbdadm是 DRBD 程序中的高级管理工具。 drbdadm是drbdsetup和drbdmeta的较高级接口。 这类似于ifconfig与ifup/ifdown命令的关系。 drbdadm读取配置文件，然后调用drbdsetup或drbdmeta以运行命令。

drbdadm可以对所有资源和资源中的卷执行操作。 子命令包括： attach, detach, primary, secondary, invalidate, invalidate-remote, outdate, resize, verify, pause-sync, resume-sync, role, csytate, dstate, create-md, show-gi, get-gi, dump-md, wipe-md等，它们适用于所有资源和卷。

仅资源级命令如下所示： connect, disconnect, up, down, wait-connect 和 dump.

选项

-d， --dry-run

将执行的drbdsetup命令写入标准输出，但不实际运行该命令。

-c， --config-file file

指定 drbdadm 使用的配置文件。 如果省略此参数，则引用 /etc/drbd-84.conf、/etc/drbd-83.conf、/etc/drbd-08.conf、/etc/drbd.conf。

-t， --config-to-test file

指定要检查的配置文件。 仅在与转储或 sh-nop 命令一起使用时有效。

-s， --drbdsetup file

指定drbdsetup程序的完整路径。 如果省略，则引用自己的命令位置和$PATH。

-m， --drbdmeta file

指定drbdmeta程序的完整路径。 如果省略，则引用自己的命令位置和$PATH。

-S， --stacked

指定指示对堆叠的父资源的操作。

-P， --peer

指定要连接到的相反节点。 仅当为资源定义指定了三个或更多主机时，才需要它。

--backend-options

双连字符后面的所有选项都被视为后端选项。 它们传递给后端命令。 换句话说，它传递给drbdsetup、drbdmeta、drbd-proxy-ctl等。

指令

• attach

连接与 DRBD 资源对应的低级本地块设备。

• detach

将从属存储设备与 DRBD 资源设备分离。

• connect

为资源设备启用网络设置。 如果已配置相应的目标，则两个 DRBD 设备将相互连接。 如果在资源定义期间指定了三个或更多主机，则还必须指定--peer来指定要连接到的主机。

• disconnect

禁用资源的网络设置。 当然，设备将处于独立状态。

• syncer

加载设备重新同步的参数。

• up

同时执行attach 和connect的快捷方式。

• down

同时执行disconnect和detach的快捷方式。

• primary

将资源设备提升为主(primary)状态。 在 DRBD 管理的设备中创建文件系统或装载文件系统之前，应始终运行此命令。

• secondary

将设备切换到辅助（secondary）状态。 此命令是必需的，因为只有一个连接的 DRBD 设备对可以处于主（primary）状态（除非在配置文件中显式指定了allow-two-primaries）。

• invalidate

强制 DRBD 将本地备份存储设备上的数据视为不同步（out-of-sync）。因此，DRBD 将复制其对等方的每个块，以将本地存储设备恢复同步。 为了避免竞争，您需要建立复制链接，或断开次要连接。

• invalidate-remote

此命令类似于invalidate命令，但是，对等方的后备存储无效，因此用本地节点的数据重写。 为了避免竞态，您需要已建立的复制链接或者已断开主连接。

• resize

让 DRBD 重新评估与磁盘大小限制，并在必要时调整相应设备的大小。 例如，如果两个节点上扩展从属设备的大小，则在其中一个节点上运行此命令后，DRBD 将接受新大小。 由于新的存储区域需要同步，因此仅当至少有一个主节点时，此命令才有效。

--size选项用于在线减小 DRBD 设备可用的大小。 用户有责任确保文件系统不会因此操作而损坏。 示例：

# drbdadm -- --size=10G resize r0

--assume-peer-has-space选项允许您调整当前未连接到目标节点的设备的大小。 请注意，如果不以同样的方式更改对应节点的磁盘大小，则后续连接将失败。

--assume-clean选项允许您调整现有设备的大小，并避免同步新设备空间。 将额外的空白存储添加到设备时，这很有用则非常有用。 示例：

# drbdadm -- --assume-clean resize r0

--al-stripes 和 --al-stripe-size-kB 选项在线更改活动日志的布局。 对于内部元数据，需要同时缩小或扩展子设备的用户可见的大小（使用--size）。

• check-resize

调用 drbdmeta 移动内部元数据。 如果在 DRBD 停止期间调整从属设备的大小，则必须将元数据移动到设备的末尾，以便下一个attach命令成功执行。

• create-md

初始化元数据区域。 如果这是您第一次使用 DRBD 资源，则需要在联机之前运行此命令。 如果出现问题，请参阅以下文档：dbdmeta（8） (opens new window)

• get-gi

将数据生成标识符信息显示为简洁的文本信息。

• show-gi

将数据生成标识符信息与描述性文本一起显示为文本信息。

• dump-md

以纯文本形式转储元数据的全部内容。 转储还包括位图（ bit-map ）和活动日志（activity-log）。

• outdate

元数据设置 outdated 标志。

• adjust

根据配置文件的设置调整设备的设置状态。 在实际运行之前，应运行 dry-run 模式，以检查生成的输出。

• wait-connect

等待直到连接到其他节点上的设备。

• role

以"本机/节点"（local/peer）的形式显示设备在机器和对台节点上的当前角色。 示例，Primary/Secondary

• state

已弃用的"role"别名。 参见前款规定。

• cstate

显示两个节点上设备的连接状态。

• dump

分析配置文件并将其输出到标准输出。 可用于修改配置文件的语法。

另外：drbdadm dump-xml可以解析 drbd 配置并生成 xml 文件。python - Is the DRBD configuration-file format a standard one? - StackOverflow (opens new window)

• outdate

使节点的数据状态无效。 通常由其他节点的 fence-peer 处理程序设置。

• verify

开始联机匹配。 比较两个节点的数据，并检查是否存在不一致。 进度显示在 /proc/drbd 中。 如果找到异步块(out-of-sync)则不会自动重新同步。 要同步，请在检查完成后disconnect，然后connect资源。

另请参阅 drbd.conf 手册页的数据完整性说明。

• pause-sync

设置本地元数据的暂停标志以暂停正在进行的重新同步。 若要恢复，必须清除本地节点和其他节点的暂停标志。 例如，如果正在重新配置从属设备的 RAID，则可以暂时停止 DRBD 重新同步。

• resume-sync

清除机器的暂停标志。

• new-current-uuid

生成新的当前 UUID 并旋转（rotates ）所有其他 UUID。

此命令可用于缩短初始同步时间。 有关详细信息，请参阅 drbdsetup 手册页。

• dstate

显示从属（local/peer）设备的同步状态。

• hidden-commands

显示本文档中未列出的所有命令。

These additional commands might be useful for writing nifty shell scripts around drbdadm:

 sh-nop                             sh-resources                       
 sh-resource                        sh-mod-parms                       
 sh-dev                             sh-udev                            
 sh-minor                           sh-ll-dev                          
 sh-md-dev                          sh-md-idx                          
 sh-ip                              sh-lr-of                           
 sh-b-pri                           sh-status                          
 proxy-up                           proxy-down                         
 new-resource                       

These commands are used by the kernel part of DRBD to invoke user mode helper programs:

 before-resync-target               after-resync-target                
 before-resync-source               pri-on-incon-degr                  
 pri-lost-after-sb                  fence-peer                         
 unfence-peer                       local-io-error                     
 pri-lost                           initial-split-brain                
 split-brain                        out-of-sync                        

These commands ought to be used by experts and developers:

 sh-new-minor                       new-minor                          
 suspend-io                         resume-io                          
 set-gi                             new-current-uuid                   
 check-resize                       

版本

本文档已针对 DRBD 版本 8.4.0 进行了修订。

作者

philipp.Reisner philipp.reisner@linbit.com lars.ellenberg lars.ellenberg@linbit.com

报告 BUGS

报告 bugs 给 drbd-user@lists.linbit.com。

COPYRIGHT

Copyright 2001-2011 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.

参见

drbd.conf(5) (opens new window), drbd(8) (opens new window), drbddisk(8) (opens new window), drbdsetup(8) (opens new window), drbdmeta(8) (opens new window) and the DRBD project web site[1]

参考链接

Ubuntu Manpage: drbdadm - Administration tool for DRBD . (opens new window)