rsbackup - 云端在线

程序：

您的姓名

rsbackup - 基于 rsync 的备份实用程序

概要

备份 [配置[--[选择器...]
备份 --退休 [配置[--[选择器...]
备份 --退休设备 [配置[--] 支持装置...

商品描述

将文件从一个或多个（远程）目标备份到单个备份存储
目录，保留其内容、布局、所有权、权限、时间戳和
硬链接结构。

增量备份是通过在连续备份中硬链接相同的文件来实现的
相同的文件。

配置

操作 附加选项
必须至少指定这些选项之一。 当指定多个动作时，
它们按如下所示的顺序执行。

--备份, -b
备份选定的卷。 给定卷的最多一个备份将
每天制作。

--退休设备
停用指定的设备。 停用设备仅意味着删除其记录。
设备本身上的文件不会被触及。

如果该设备仍列在配置文件中，则会询问您
你是否真的想退休； 你可以用 - 力量
选项。

--退休
停用指定的主机和卷。 停用卷意味着删除任何可用的
卷的备份和它们的记录。 与备份对应的记录
在不可用的设备上不会被删除。

如果您只想删除已停用卷的备份记录但想保留
备份，您应该手动删除记录（请参阅 架构 下面），或
在卷中重命名它。

如果该卷仍列在配置文件中，则会询问您
你是否真的想退休； 你可以用 - 力量
选项。

- 修剪, -p
修剪选定卷的旧备份。 看 修剪 联络一位教师

--修剪不完整，-P
修剪所选卷的不完整备份。 之前失败的任何备份
完成将被删除。

--html PATH, -H PATH
写一份 HTML 报告给 PATH. 报告涵盖所有卷，而不仅仅是选定的
的。 PATH 可 - 写入标准输出。

- 文本 PATH, -T PATH
写一份纯文本报告给 PATH. 该报告涵盖所有卷，而不仅仅是
选定的。 PATH 可 - 写入标准输出。

- 电子邮件 地址, -e 地址
通过电子邮件将报告发送至 地址. 内容等价于输出 - 文本 和
--html.

--转储配置
将解析的配置文件写入标准输出。 不得与
任何其他操作选项。

通过 --详细，配置文件用描述性注释进行注释。

一般用途总体评估 附加选项
--配置 PATH, -c PATH
配置文件的路径。 默认是 /etc/rsbackup/配置.

- 店铺 PATH, -s PATH
指定要备份到的目标目录。 使用此选项（可能更多
不止一次）相当于删除 商店 来自配置的指令
文件并用给出的路径替换它们 - 店铺 选项​​。

此选项隐式启用 --警告商店 选项。

--详细, -v
启用详细模式。 将显示各种消息以报告进度和
rsync的 - 安静的 选项被抑制。

--试运行, -n
启用试运行模式。 将显示命令，但实际上不会执行任何操作。

- 力量, -f
禁止在停用设备和卷时进行检查。

- 等待, -w
等待而不是放弃，如果另一个副本 备份 在跑。

- 数据库, -D PATH
覆盖备份数据库的路径。

- 帮帮我, -h
显示使用消息。

- 版, -V
显示版本号。

报告 冗长
--日志 冗长
控制给定卷/设备对的哪些日志文件包含在报告中。
可能的值 冗长 是：

所有 包括所有非空日志文件，即使备份成功。

错误 包括所有错误日志文件。

最近 仅包括最近的错误日志文件。

最新 仅包括最新的日志文件，即使备份成功。

失败 仅包括最近的日志文件，但仅当该尝试失败时。 这个
是默认值。

警告 附加选项
--警告-未知
显示未知设备、主机和卷的警告。 （警告永远是
包含在报告中，这是指运行时错误输出。）

--警告商店
显示不合适的存储目录和不可用设备的警告。

--警告无法访问
为无法访问的主机显示警告。

--无警告部分
禁止 rsync“部分传输”诊断的警告（由
默认）。

--警告所有, -W
启用全部 - 警告- 选项​​。

--无错误
禁止显示来自 rsync 的错误。

音量 选择
命令行上的选择器列表决定了已知卷的子集
备份、修剪或停用。 以下选择器是可能的：

主办方 选择主机的所有卷。

主办方:音量 选择音量。

-主办方 取消选择主机的所有卷。

-主办方:音量 取消选择音量。

* 选择所有卷。

如果在命令行上未指定主机或卷，则选择所有卷作为
备份或修剪。 要停用，您必须明确选择要使用的主机或卷
退休，只有积极的选择是可能的。

配置 文件

配置文件包含全局指令和一系列主机节。 每个主机节
依次包含主机指令和卷节。 虽然没有强制执行
建议主机节和卷节缩进。

注释由首字母“#”引入。

可以使用“双引号”来引用命令参数。 内的引号和反斜杠
带引号的字符串用反斜杠转义。

全球 指令
全局指令控制程序的一些一般方面。

颜色 好 差
用于表示良好状态（最近的备份）和不良状态（无
足够最近的备份）。

好 和 差 是表示 RGB 三元组的整数值。 最方便的是
用十六进制写它们，例如 0xRRGGBB. 例如，黑色是 0x000000，红色是
0xFF0000，等等。

设备 支持装置
命名设备。 这可以多次使用。 商店必须有文件
被称为 在线商城/设备编号 其中包含已知的设备名称。 备份只会是
为已知设备制造。

当设备丢失或损坏时，删除其设备条目并使用
--prune-unknown 选项以删除其上的备份记录。

设备名称可能包含字母、数字、点和下划线。

包括 PATH
包括另一个文件作为配置的一部分。 如果 PATH 是一个目录然后
包括其中的文件（不包括点文件、备份和恢复文件）。

保持修剪日志 天
保留修剪备份记录的天数。 默认值为 31。

锁 PATH
启用锁定。 如果存在此指令，则 PATH 将用作锁文件
用于更改任何内容的操作（--backup、--prune 等）。

锁是由打开制成的 PATH 并打电话 羊群(2) 在它上面 锁定EX.

日志 PATH
存储日志文件和备份记录的目录。 默认是
/var/日志/备份.

后访问挂钩 指挥...
在所有备份和修剪操作之后执行的命令。 这只执行
每次调用一次 备份. 备份仍被认为已成功
即使访问后挂钩失败（即退出非零）。 看 挂钩 联络一位教师

预访问挂钩 指挥...
在访问任何备份设备（即备份
和修剪操作）。 每次调用只执行一次 备份 和
如果失败（即退出非零）然后 备份 立即终止。 看 挂钩
联络一位教师

国家 true|false
如果为 true，则备份是公开的。 通常备份只能由
呼叫用户。 此选项禁止检查。

报告修剪日志 天
要放入 hte 报告的修剪日志的天数。 默认值为 3。

发邮件 PATH
用于发送电子邮件的可执行文件的路径。 默认为平台-
依赖但通常 /usr/sbin/发送邮件. 可执行文件应该支持 -t,
-oee, -oi 和 -odb 选项​​。

商店 PATH
可以安装备份设备的路径。 这可以多次使用。

商店模式 模式
A 水珠(7) 可以安装备份设备的模式匹配路径。 这个可以
多次使用。

样式表 PATH
要在 HTML 报告中使用的样式表的路径。 如果这不存在，那么
使用内置的默认样式表。

可继承的 指令
可继承指令控制一个或多个备份的一个方面。 它们可以在
全球层面或 主持人 or 体积 节（见下文）。 如果一个出现在多个
放置然后音量设置覆盖主机设置和主机设置覆盖全局
设置。

挂机超时 SECONDS
在结束钩子挂起之前等待多长时间，以秒为单位。 默认为 0，
这意味着无限期地等待。

最大年龄 天
在您感到不舒服之前，最近一次备份的最长期限。 这
默认为 3，这意味着如果一个卷在过去 3 天内没有被备份
HTML 报告中会有红色墨水。

最小备份 COUNT个
修剪时每个卷要保留在每个存储上的最小备份数。
默认值为1。

（这是一个别名 修剪参数 最小备份 并且将来会被移除
版本。）

后备挂 指挥...
完成备份后或失败后要执行的命令。 备份是
即使后备份挂钩失败（退出
非零）。 看 挂钩 联络一位教师

预备份挂钩 指挥...
在开始备份之前要执行的命令。 如果这个钩子失败（即退出
非零）则不进行备份并且不会运行备份后挂钩。 看
挂钩 联络一位教师

这个钩子可以通过写一个新的源路径来覆盖备份的源路径
到标准输出。

修剪 天
可以修剪备份的年龄。 默认值为 366，这意味着备份将
永远不要修剪，直到它至少整整一岁。

（这是一个别名 修剪参数 修剪 并且将来会被移除
版本。）

修剪参数 您的姓名 VALUE
设置修剪策略的参数。 看 修剪 联络一位教师

修剪参数 - 消除 您的姓名
删除修剪策略的参数。

修剪策略 您的姓名
要使用的修剪策略。 看 修剪 联络一位教师

rsync 超时 SECONDS
在结束 rsync 挂起之前等待多长时间，以秒为单位。 默认为 0，
这意味着无限期地等待。

ssh 超时 SECONDS
在确定主机关闭之前等待多长时间，以秒为单位。 默认值为 60。

主办方 指令
主机节由一个 主持人 指令。

主持人 主办方
介绍一个主机节。 该名称用于此主机的备份目录。

以下指令，以及 体积 节（见下文），可以出现在主机节中：

永远在线 true|false
如果为 true，则主机应始终可用。 如果不是，则警告
如果不是，将在进行备份时发出。 尝试进行备份失败
对于永远在线的主机（通常是不能
被悄悄地跳过）。

设备 模式
A 水珠(3) 限制该主机将备份到的设备的模式。

请注意，只有备份创建遵守此限制。 修剪和退休做
不是。

主机 主机名
此主机的 SSH 主机名。 默认值是来自主机节的名称。

主机名 本地 被特殊对待：假定总是相同的
到本地系统，因此将从本地文件系统读取文件。

优先 INTEGER
此主机的优先级。 主机按优先级降序备份。 这
默认优先级为 0。

用户 USERNAME
此主机的 SSH 用户名。 默认不提供用户名。

此外，可继承指令可以出现在主机节中，并覆盖任何
它们在全球范围内的出现。

按照惯例，主机节的内容是缩进的。

远程主机通过 SSH 访问。 用户 备份 运行必须能够连接到
远程主机（如果要从 cron 作业运行，则无需输入密码）
或类似）。

音量 指令
一个卷节由一个 体积 指令。

体积 音量 PATH
介绍一个音量节。 该名称用于此备份目录
体积。 路径是主机上的绝对路径。

以下指令可以出现在卷节中：

检查文件 PATH
检查 PATH 在备份卷之前存在。 PATH 可能是
绝对路径或相对路径（到卷的根）。 不必如此
在卷内，虽然通常的用途是检查一个始终存在的文件
在那儿。

此检查在执行之前完成 预备份挂钩，所以它适用于真正的
卷的路径，而不是重写的路径。

检查安装 true|false
如果为 true，则在备份之前检查卷的路径是否是安装点
卷。

此检查在执行之前完成 预备份挂钩，所以它适用于真正的
卷的路径，而不是重写的路径。

注意，如果多个 查看- 使用选项，必须通过卷的所有检查
要备份。

排除 模式
此卷的排除项。 模式被传递给 rsync - 排除 选项。
该指令可能在每个卷中出现多次。

有关完整详细信息，请参阅 rsync 手册页。

横过 true|false
如果为 true，则遍历挂载点。 这会抑制 rsync --一个文件系统
选项。

此外，可继承指令可以出现在卷节中，并覆盖任何
它们在主机或全球层面的出现。

通常，卷节的内容是缩进的。

修剪

这是删除旧备份的过程（使用 - 修剪 选项）。 修剪政策
用于确定要删除的备份是使用可继承的 修剪策略
指令，以及通过策略集的参数 修剪参数 指令。

下面列出了可用的策略。 默认策略是 年龄.

年龄
此策略删除早于最小年龄的备份，前提是备份数量最少
在设备上保持可用。 支持以下修剪参数：

最小备份
要在设备上维护的卷的最小​​备份数。 修剪
永远不会导致备份数量低于此值。 默认（和
最小值）为 1。

修剪
备份有资格进行修剪后的时间，以天为单位。 仅备份超过
这多天的旧将被修剪。 默认值为 366，最小值为 1。

为了向后兼容，也可以使用相同的指令设置这些值
姓名。 这将在未来版本中禁用。

衰变
此策略使用可配置的衰减模式将超过最小时间的备份稀疏化
这会安排随着时间的推移保持不断减少的备份数量。 下面的修剪
支持参数：

衰减开始
备份有资格进行修剪后的时间，以天为单位。 仅备份超过
这多天的旧将被修剪。 默认值为 1，最小值为 1。

衰减极限
备份总是被修剪的时间，以天为单位。 比这更旧的备份
将始终被修剪，除非这根本不会留下任何备份。 默认是
366，最小值为 1。

衰减尺度
衰减窗口扩展的比例。 默认值为 2，最小值为
是2。

衰减窗口
衰减窗口的大小。 默认值为 1，最小值为 1。

EXEC
此策略执行带有参数和附加信息的子程序
环境。

支持以下参数：

径 要执行的子程序的路径。

任何附加参数都通过环境变量提供给子程序，
前缀为 修剪_. 此外，还设置了以下环境变量：

修剪设备
包含备份的设备的名称。

修剪主机
主机名。

PRUNE_ONDEVICE
设备上的备份列表，按天数排列。 此列表不包括任何
已经安排修剪，并包括下的备份
对价（即 备份年龄 将出现在此列表中）。

PRUNE_TOTAL
此卷在任何设备上的备份总数。 请注意，它不
包括刚刚选择修剪的其他设备上的备份
对子程序的另一个调用。

修剪体积
卷的名称。

这些环境变量都覆盖了名称冲突的任何参数。

输出应该是要修剪的备份列表，每行一个（以任何顺序）。 每行
应该包含要修剪的备份的天数（即与出现在
PRUNE_ONDEVICE)，后跟一个冒号，后跟要备份的原因
修剪。

为方便起见，如果参数为 修剪策略 以。。开始 / 那么 EXEC 政策是
选择策略名称作为 径 参数。

决不要
此策略从不删除任何备份。

挂钩

钩子是由执行的命令 备份 就在某些动作之前或之后。 这
命令直接传递给 执行副总裁(3); 使用shell命令，因此，要么包装它
在脚本中或使用 -c 选项。

所有钩子都运行 --试运行 模式。 钩子脚本必须遵守 RSBACKUP_ACT 这将是
设置 false 在这种模式和 true 除此以外。

使用权 钩
访问挂钩在执行任何访问备份设备的操作之前执行（一次）
（甚至只是为了阅读它们）。

执行访问挂钩时会设置以下环境变量：

RSBACKUP_ACT
设置 false in --试运行 模式和 true 除此以外。

RSBACKUP_DEVICES
已知设备名称的空格分隔列表。

RSBACKUP_HOOK
钩子的名称（即 预访问挂钩， 等等）。 这允许单个钩子脚本
作为多个钩子的实现。

备份工具 钩
备份钩子在备份之前或之后执行。

执行备份挂钩时会设置以下环境变量：

RSBACKUP_ACT
设置 false in --试运行 模式和 true 除此以外。

RSBACKUP_DEVICE
备份的目标设备名称。

请注意，这可能会在未来版本中删除。

RSBACKUP_HOOK
钩子的名称（即 预备份挂钩， 等等）。 这允许单个钩子脚本
作为多个钩子的实现。

RSBACKUP_HOST
主机名。

RSBACKUP_SSH_HOSTNAME
主机的 SSH 主机名。

回想起那个 备份 处理主机名 本地 特别。 如果钩也
需要这样做，那么它必须复制这个逻辑。

RSBACKUP_SSH_TARGET
SSH 主机名和用户名组合以传递给 SSH（1）。

这将会 用户名@主机 或者只是 主机 取决于是否是 SSH 用户名
被设定。

RSBACKUP_SSH_USERNAME
主机的 SSH 用户名。 如果未设置 SSH 用户名，则此变量不会
被设置。

RSBACKUP_STATUS
（仅适用于 后备挂）。 任何一个 ok or 失败.

RS备份存储
挂载设备的存储目录的路径。

RSBACKUP_VOLUME
卷的名称。

RSBACKUP_VOLUME_PATH
卷的路径。

备份钩子的错误输出存储在与输出相同的备份记录中
rsync的.

注意：当前的行为是前/后备份钩子为每个单独运行
备份。 在未来的版本中，对于给定卷的所有备份，它们可能只运行一次，
在这种情况下 RSBACKUP_DEVICE 将不再设置。

参见 rsbackup-快照挂钩(1) 一个可以用来从Linux备份的hook程序
LVM 快照。

备份 生命周期

添加 A 全新 主办方
要添加新主机，请创建一个 主持人 它在配置文件中的条目。

要备份本地主机，请指定 主机 本地. 否则你通常可以省略
主机.

您可能希望为以下各项设置主机范围的值 修剪, 最大年龄 和 最小备份.

没有卷的主机不起作用。

添加 A 全新 音量
要添加新卷，请创建一个 体积 在相关的条目中 主持人 条的规定，
配置文件。

添加 排除 跳过不想备份的文件的选项。 这可能包括临时
文件和“垃圾”目录的内容。

如果卷包含挂载点，并且您想要备份其中的内容
子文件系统，然后确保包括 横过 选项。

您可能希望为每个卷设置值 修剪, 最大年龄 和 最小备份.

添加 A 全新 设备
要添加新设备，对其进行格式化和挂载并创建一个 设备编号 文件在其顶级
目录。 添加一个 设备 它在配置文件中的条目和 商店 条目
提到它通常的挂载点。

在正常情况下，您应该确保备份文件系统归
根和模式 0700。

制作 备份
将所有可用卷备份到所有可用设备：

rsbackup --备份

您可能希望自动执行此操作。 要仅备份一组有限的卷，请指定
命令行上的选择参数。

修剪 备份
修剪旧备份：

rsbackup --prune --prune-不完整

您可能希望自动执行此操作。

当卷的备份失败或之前中断时会发生“不完整备份”
完成。 它们不会立即被删除，因为 rsync的 也许可以使用这些文件
已转移以节省当天后续备份的工作量，或（如果有
没有用于此目的的完整备份）以后的日子。

退休的 A 主办方
停用主机意味着删除它的所有备份。 建议的方法是删除
为其配置然后使用 备份 --退休 主办方 也删除其备份。 你
可以反过来执行此操作，但系统会提示您检查您是否真的打算这样做
删除仍列在配置文件中的主机的备份。

如果主机的任何备份位于已停用的设备上，您应该停用该设备
第一。

退休的 A 音量
停用卷意味着删除它的所有备份。 这几乎和退休一样
整个主机，但命令是 备份 --退休 主办方:音量.

您可以在单个命令中停用多个主机和卷。

退休的 A 设备
停用设备仅意味着删除它的记录。 用 备份 --退休设备
支持装置 去做这个。 设备的内容不被修改； 如果你想要，你必须
手动进行。

您可以在单个命令中停用多个设备。

还原

恢复费用额外 l-)

用户手册 恢复
备份的布局、权限等与原系统相同，完美
可以简单地将文件从备份目录复制到适当的位置。

小心获得文件所有权。 备份以相同的数字用户存储
和组 ID 作为使用的原始系统。

直到备份完成，或者在修剪一个备份时，一个相应的 .不完整
文件将存在。 在恢复任何给定的备份之前检查这样的文件。

恢复 通过 rsync的
假设那个主机 肉糜 有一个叫 用户 用户主目录在哪个位置
备份，和用户 j 希望恢复他们的整个主目录，一个例子
恢复命令可能是：

rsync -aSHz --numeric-ids /store/chymax/users/2010-04-01/rjk/。 chymax:~rjk/.

你可以添加 - 删除 如果您想完全恢复到原状，则可以选择
或者在相反的极端 - 现存的 如果您只想恢复已被删除的文件
删除。

您可能更喜欢 rsync 回暂存区，然后手动挑选文件。

恢复 - 焦油
您可以将备份目录（或其子集）压缩，然后在目标上解压缩。
请记住使用 --数字所有者 tar 的选项。

在线商城 有效期

商店可能处于以下状态：

可使用
该存储可用于备份。

不可预订
该存储不能用于备份。 通常这不会产生错误
但是 --警告商店 可用于报告所有不可用商店的警告，如果
没有商店可用，然后描述不可用商店的问题。

坏 该存储不能用于备份。 这总是会生成错误消息，但是
不会阻止备份到其他存储的发生。

致命 破
该存储不能用于备份。 该计划将被终止。

使用以下测试（按此顺序）识别状态：

· 如果 store 路径不存在，则 store 是坏的。

· 如果商店没有 设备编号 文件然后它不可用。 如果它有一个
但阅读它会引发错误，那就不好了。

·如果商店的 设备编号 文件包含未知的设备名称，则它是错误的。

·如果商店的 设备编号 文件将设备命名为与其他商店相同的设备，然后它是
致命地破碎。

· 如果商店不属于 根 那么就不好了。 此检查可以被覆盖
与 国家 指令。

· 如果 store 可以被 group 或 world 读取或写入，那就不好了。 这个检查
可以用 国家 指令。

使用 onworks.net 服务在线使用 rsbackup