# 安装说明

## 1. 简介

部分虚拟化资源需要安装ceph librbd客户端以访问ceph块存储

*虚拟化资源*

* **CNware**

## 2. 安装步骤

### 2.1 安装环境检查

确认备份主机未安装相关包

* ***Debian系***
  
  ```shell
  sudo dpkg -l | grep librbd
  sudo dpkg -l | grep librados
  ```

* ***Centos系***
  
  ```shell
  sudo rpm -qa | grep librbd
  sudo rpm -qa | grep librados 
  ```

若是客户已安装且是业务自用，则跳过安装以避免影响客户业务。

### 2.2 获取并上传安装包

* 确认备份主机系统和架构

* 创建安装目录
  
  ```shell
  sudo mkdir -p librbd
  ```

* 将对应系统和架构下的安装包上传至备份主机安装目录下。
  
  例如，Debian x86环境可以选择`deb/x86-64` 下的安装包

### 2.3 安装

1. 进入安装包所在目录

```shell
sudo cd librbd
```

2. 执行安装命令
* ***Debian系***

```shell
sudo dpkg -i *.deb
```

* ***Centos系***

```shell
sudo rpm -i *.rpm
```

3. 创建软链接
   
   部分情况下，librados、librbd 安装后是 `librados.so.2.xxx`、`librbd.so.1.xxx`，但需要的是 `librados.so` 和 `librbd.so`，因此需要手动创建软链接。

```shell
# /path/to/actual/librados.so 是 librados.so 实际存在的路径。/usr/lib/librados.so 是希望创建的软链接路径
sudo ln -s /path/to/actual/librados.so.2 /usr/lib/librados.so
sudo ln -s /path/to/actual/librbd.so.1 /usr/lib/librbd.so
```

## 3. 支持版本

当前客户端安装包版本:

- `12.2.13`

ceph有良好的前后向兼容性，因此可以支持连接到最新的ceph存储