drbdadm 中文手册

文章目录

描述

drbdadm - DRBD 高级管理工具

指令

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

说明

drbdadm是 DRBD 程序中的高级管理工具。 drbdadmdrbdsetupdrbdmeta的较高级接口。 这类似于ifconfigifup/ifdown命令的关系。 drbdadm读取配置文件,然后调用drbdsetupdrbdmeta以运行命令。

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-connectdump.

选项

-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

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

指令

  • attach

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

  • detach

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

  • connect

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

  • disconnect

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

  • syncer

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

  • up

同时执行attachconnect的快捷方式。

  • down

同时执行disconnectdetach的快捷方式。

  • 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 .