💻 工作存储DRBD
DRBD, drbdadm, 存储
Source
Edit
History

drbdadm 中文手册

文章目录
  1. 1. 描述
  2. 2. 指令
  3. 3. 说明
  4. 4. 选项
  5. 5. 指令
  6. 6. 版本
  7. 7. 作者
  8. 8. 报告 BUGS
  9. 9. COPYRIGHT
  10. 10. 参见
  11. 11. 参考链接

描述

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）

  • 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? - Stack Overflow

  • 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 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), drbd(8), drbddisk(8), drbdsetup(8), drbdmeta(8) and the DRBD project web site[1]

参考链接

Ubuntu Manpage: drbdadm - Administration tool for DRBD .