Sheepdog 技术文档

1. 安装指南

Sheepdog 是一款为 QEMU 设计的分布式存储系统。在安装之前，确保满足以下需求：

• 至少三台 x86-64 架构的机器
• Corosync 集群引擎

安装步骤如下：

1. 阅读随包提供的 INSTALL 文件，获取从源代码编译或安装的详细指导。

2. 根据操作系统的发行版，使用相应的包管理工具安装 Corosync。例如，在基于 Debian 的系统中，可以使用以下命令：

   sudo aptitude install corosync libcorosync-dev
   

   在基于 RPM 的系统中，可以使用以下命令：

   sudo yum install corosynclib-devel
   

2. 项目的使用说明

以下是 Sheepdog 的基本使用方法：

集群管理后端

Sheepdog 使用集群管理后端来管理成员关系并在集群节点间广播消息。

目前，Sheepdog 支持以下集群管理后端：

• 本地驱动（适用于单机开发）
• Corosync（默认）
• Zookeeper
• Accord

本地驱动

本地驱动使用 UNIX 进程间通信机制，在单台机器上管理成员关系。通过启动多个 'sheep' 进程来模拟集群。

使用本地驱动在一行命令中设置 3 节点集群的示例：

mkdir /path/to/store
for i in 0 1 2; do sheep -c local /path/to/store/$i -z $i -p 700$i; done

配置 Corosync

对于大多数现代 Linux 发行版，它们的仓库中已经提供了预编译的 x86_64 Corosync 二进制文件。建议使用这些包，如果它们在您的发行版上可用。

格式化集群

在所有集群机器上启动 Sheepdog：

sheep /store_dir

其中 /store_dir 是存储对象的目录，该目录必须在支持扩展属性（xattr）的文件系统上。对于 ext3 文件系统，需要在挂载选项中添加 user_xattr。

sudo mount -o remount,user_xattr /store_device

然后，格式化集群：

dog cluster format --copies=3

这里的 --copies 参数指定了默认的数据冗余副本数量。

检查集群状态

使用以下命令检查集群状态：

dog node list

3. 项目 API 使用文档

Sheepdog 的 API 使用方法在官方文档中有详细说明。以下是一些基础命令的例子：

创建虚拟机镜像

qemu-img create sheepdog:Alice 256G

查看虚拟机镜像

dog vdi list

启动虚拟机

qemu-system-x86_64 -hda sheepdog:Alice

虚拟机列表

dog vm list

创建快照

qemu-img snapshot -c name sheepdog:Alice

克隆快照

qemu-img create -b sheepdog:Alice:1 sheepdog:Charlie

4. 项目安装方式

项目的安装方式请参考安装指南中的步骤进行。确保按照 INSTALL 文件中提供的说明进行操作，以便成功安装 Sheepdog。