Inspur AS5300G2-F ユーザーマニュアル

浪潮存储系统

Cinder 主机插件用户手册

文档版本 1.9

发布日期 2020-09-28

适用版本 Cinder_V4.0.0 及以上

Cinder主机插件用户手册

ii

浪潮专有和保密信息

尊敬的用户：

衷心感谢您选用浪潮存储系统！浪潮存储秉承“云存智用运筹新数据”的新存储之道，致

力于为您提供符合新数据时代需求的存储产品和解决方案。

本手册用于帮助您更详细地了解和便捷地使用存储系统，涉及的截图仅为示例，最终界面

请以实际设备显示的界面为准。

由于产品版本升级或其他原因，本手册内容会不定期进行更新，如有变动恕不另行通知。

除非另有约定，本手册仅作为使用指导，本手册中的所有陈述、信息和建议不构成任何明

示或暗示的担保。

浪潮拥有本手册的版权，保留随时修改本手册的权利。未经浪潮许可，任何单位和个人不

得以任何形式复制本手册的内容。

如果您对本手册有任何疑问或建议，请向浪潮电子信息产业股份有限公司垂询。

技术服务电话：

4008600011

地址：

中国济南市浪潮路 1036 号

浪潮电子信息产业股份有限公司

邮编：

250101

Cinder主机插件用户手册

iii

浪潮专有和保密信息

使用声明

在您正式使用本存储系统之前，请先阅读以下声明。只有您阅读并且同意以下声明后，方

可正式开始使用本存储系统。如果您对以下声明有任何疑问，请和您的供货商联系或直接

与我们联系。如您在开始使用本系统前未就以下声明向我们提出疑问，则默认您已经同意

了以下声明。

1. 请不要自行拆卸本存储系统机箱及机箱内任何硬件设备。在本存储系统出现任何硬件

故障或您希望对硬件进行任何升级时，请您将机器的详细硬件配置反映给我们的客户

服务中心。

2. 请不要将本存储系统的设备与任何其他型号的相应设备混用。本存储系统的内存、

CPU、CPU 散热片、风扇、硬盘托架、硬盘等都是特殊规格的。

3. 在使用本存储系统时遇到任何软件问题，请您首先和相应软件的提供商联系。由提供

商和我们联系，以方便我们共同沟通和解决您遇到的问题。对于数据库、网络管理软

件或其他网络产品的安装、运行问题，我们尤其希望您能够这样处理。

4. 上架安装本存储系统前，请先仔细阅读相关产品手册中的快速安装指南。我们致力于

产品功能和性能的持续提升，部分功能及操作与手册描述可能会有所差异，但不会影

响使用。如果您有任何疑难问题，请与我们的客户服务中心联系。

5. 我们特别提醒您：在使用过程中，注意对您的数据进行必要的备份。

6. 本存储系统为 A级产品，在生活环境中可能会造成无线电干扰，需要您对其干扰采取

切实可行的措施。

7. 请仔细阅读并遵守本手册的安全声明和安全细则。

8. 本手册中涉及的各软、硬件产品的标识、名称版权归产品的相应公司拥有。

以上声明中，“我们”指代浪潮电子信息产业股份有限公司；浪潮电子信息产业股份有限公

司拥有对以上声明的最终解释权。

Cinder主机插件用户手册

iv

浪潮专有和保密信息

安全声明

我们非常重视数据安全和隐私，且一如既往地严密关注产品和解决方案的安全性，为您提

供更满意的服务。在您正式使用本存储系统之前，请先阅读以下安全声明。

1. 为了保护您的数据隐私，在调整存储产品用途或淘汰存储设备时，请您将存储系统软件

恢复固件出厂设置、删除信息、清除日志。同时，建议采用第三方安全擦除工具对存

储系统软件所在的系统盘进行全面安全擦除。

2. 您购买的存储产品业务运营或故障定位的过程中可能会获取或使用用户的某些个人数

据（如告警邮件接收地址、IP 地址）。因此，您有义务根据所适用国家或地区的法律法

规制定必要的用户隐私政策，并采取足够的措施以确保用户的个人数据受到充分的保护。

3. 如需获取存储系统开源软件声明，请直接联系浪潮客户服务人员。

4. 存储系统的某些安全特性需要您自行配置，如认证、传输加密、存储数据加密等，这些

配置操作可能会对存储系统的性能和使用方便性造成一定影响。您可以根据应用环境，

权衡是否进行安全特性配置。

5. 存储系统自带了部分用于生产、装备、返厂检测维修的接口、命令及定位故障的高级命

令，如使用不当，可能会导致设备异常或者业务中断，不建议您自行使用。如需使用，

请联系我们的客户服务人员。

6. 我们已全面建立产品安全漏洞应急和处理机制，确保第一时间处理产品安全问题。若您

在存储产品使用过程中发现任何安全问题，或者寻求有关产品安全漏洞的必要支持，请

直接联系我们的客户服务人员。

以上声明中，“我们”指代浪潮电子信息产业股份有限公司；浪潮电子信息产业股份有限公

司拥有对以上声明的最终解释权。

Cinder主机插件用户手册

v

浪潮专有和保密信息

安全细则

在使用本存储系统时，若操作不当，可能会危及您的人身安全。为避免发生意外，在正式

使用本存储系统之前，请务必认真阅读以下安全细则，严格按照要求进行操作。

1. 本存储系统中的电源设备可能会产生高电压和危险电能，从而导致人身伤害。请勿自

行卸下主机盖以拆装、更换系统内部的任何组件。除非另外得到我们的通知，否则只

有经过我们培训的维修技术人员才有权拆开主机盖及拆装、更换内部组件。

2. 请将设备连接到适当的电源，仅可使用额定输入标签上指明的外部电源为设备供电。

为保护您的设备免受电压瞬间升高或降低所导致的损坏，请使用相关的稳压设备或不

间断电源设备。

3. 如果必须使用延长线缆，请使用配有正确接地插头的三芯线缆，并查看延长线缆的额

定值，确保插入延长线缆的所有产品的额定电流总和不超过延长线缆额定电流限制的

百分之八十。

4. 请务必使用随机配备的供电组件，如电源线、电源插座（如果随机配备）等。为了本

存储系统及使用者的安全，切勿随意更换电源线缆或插头。

5. 为防止因系统漏电而造成电击危险，请务必将本存储系统和外围设备的电源电缆插入

已正确接地的电源插座。在未安装接地导线及不确定是否已有适当接地保护的情况

下，请勿操作和使用本存储系统，并及时与电工联系。

6. 切勿将任何物体塞入本存储系统的开孔处，否则，可能会导致内部组件短路而引起火

灾或电击。

7. 请将本存储系统置于远离散热片和有热源的地方，切勿堵塞通风孔。

8. 切勿在高潮湿、高灰尘的环境中使用本存储系统，切勿让食物或液体散落在系统内部

或其它组件上。

9. 使用错误型号的电池会有爆炸的危险，需要更换电池时，请先向制造商咨询并使用与

制造商推荐型号相同或相近的电池。切勿拆开、挤压、刺戳电池或使其外部接点短

路。不要将其丢入火中或水中，也不要暴露在温度超过 60 摄氏度的环境中。请勿尝

试打开或维修电池，务必合理处置用完的电池，不要将用完的电池及可能包含电池的

电路板及其它组件与其它废品放在一起。有关电池回收政策请与当地废品回收处理机

构联系。

Cinder主机插件用户手册

vi

浪潮专有和保密信息

以上内容中，“我们”指代浪潮电子信息产业股份有限公司；浪潮电子信息产业股份有限公

司拥有对以上内容的最终解释权。

                         Cinder主机插件用户手册 
vii 
浪潮专有和保密信息 
版权所有 ©  浪潮电子信息产业股份有限公司 
目 录 
使用声明 ........................................................................................................................................ iii 
安全声明 ......................................................................................................................................... iv 
安全细则 .......................................................................................................................................... v 
1 功能描述 ...................................................................................................................................... 1 
1.1 基本介绍................................................................................................................................... 1 
1.2 约束与限制............................................................................................................................... 2 
1.3 应用场景................................................................................................................................... 2 
2 安装与部署 .................................................................................................................................. 4 
2.1 浪潮 Cinder 驱动安装 .............................................................................................................. 4 
2.2 OpenStack 环境配置 ................................................................................................................ 6 
2.3 All-In-One 部署示例 ................................................................................................................ 7 
3 功能配置与管理......................................................................................................................... 10 
3.1 网络配置................................................................................................................................. 10 
3.2 配置存储池............................................................................................................................. 11 
3.3 配置驱动的用户身份验证信息 ............................................................................................. 13 
3.4 OpenStack 启用多路径 .......................................................................................................... 16 
3.5 启用浪潮存储驱动程序 ......................................................................................................... 19 
3.6 配置选项................................................................................................................................. 21 
4 故障分析与解决......................................................................................................................... 24 
5 术语&缩略语 ............................................................................................................................. 28 
附录一 ............................................................................................................................................ 29 
 

Cinder主机插件用户手册

1

浪潮专有和保密信息

1 功能描述

1.1 基本介绍

浪潮 Cinder 主机插件是 OpenStack 中Cinder 的驱动，能使 Cinder 有更优的性能。

Cinder 是OpenStack 的块存储服务。它的作用是向最终用户提供在 OpenStack 的计

算模块（Nova）中使用的存储资源。它通过使用逻辑卷管理（LVM）方式或者通过

配置其他存储的插件形式的驱动连接其他存储设备使用。简单地说，Cinder 将块存

储设备的管理进行了虚拟化，只对最终用户提供 REST API来请求和使用存储资源，

用户并不需要知道他们的存储实际上是什么类型或者是什么样的。浪潮开发了上述

中的插件形式的驱动，通过配置浪潮的驱动可连接浪潮的存储，让 Cinder 可以使

用我们的存储设备给用户提供所需的块存储服务。

通过配置浪潮的驱动，Cinder 可以使用浪潮存储给 OpenStack 提供块存储服务，并

且可将 Cinder 的卷、快照、一致性组的操作在浪潮存储中实现。详细功能如下：

表1-1 Cinder 实现的功能

序号

功能模块

操作

1

卷操作

创建卷

2

从已有卷创建卷（克隆）

3

扩展卷

4

删除卷

5

卷-虚机操作

挂载卷到虚拟机实例

6

从虚拟机实例分离卷

7

卷-快照操作

创建卷的快照

8

从已有卷快照创建卷

9

删除快照

10

卷-镜像操作

从镜像创建卷

Cinder主机插件用户手册

2

浪潮专有和保密信息

11

从卷创建镜像

12

卷-一致性组操作

创建/删除一致性组

13

一致性组快照操作

14

其他操作

Qos

15

卷迁移

16

存储接口协议

iSCSI

17

FC

1.2 约束与限制

浪潮 Cinder 主机插件，并没有集成在所有的 OpenStack 发布版本中。当所使用的

OpenStack 发布版本中未包含浪潮 Cinder 主机插件驱动时，需要手动安装随机光盘

中所带的 Cinder 插件，才可以与 OpenStack 环境进行集成。

随机光盘中所带的 Cinder 主机插件提供了对 OpenStack 平台的 Juno、Kilo、 Liberty、

Mitaka、Newton、Ocata、Pike、Queens 等版本的兼容性支持。

适用产品型号：

AS2150G2&AS2200G2&AS2600G2&AS5300G2&AS5500G2&AS5600G2&AS5800

G2&AS6800G2

HF5500

AS2600G2-F&AS5300G2-F&AS5500G2-F&AS5600G2-F&AS5800G2-F&AS6800G2

-F

AS5300G5&AS5500G5&AS5600G5&AS5800G5&HF5000G5&HF6000G5

AS5500G5-C

1.3 应用场景

浪潮 Cinder 主机插件是 OpenStack 中Cinder 的驱动，通过配置浪潮的驱动，能使

Cinder 有更优的性能。Cinder 可以使用浪潮存储给 OpenStack 提供块存储服务、并

且可将 Cinder 的卷、快照、一致性组的操作在浪潮存储中实现。拓扑图如图 1-1 所

Cinder主机插件用户手册

3

浪潮专有和保密信息

示。

图1-1 Cinder 主机插件应用拓扑图

FC/iSCSI

客户端

主机A主机B

OpenStack

应用服务器

Inspur

Cinder

(Nova)

KVM Host

Nova API

KVM Guest

Virtual

Device

Nova API

(Cinder)

Cinder Volume

Cinder API

Nova

DB Cinder

DB

Rabbit

MQ

FC/iSCSI

SSH SSH SSH

REST

Users

管理网络

Inspur storage

浪潮存储

虚拟机

Cinder主机插件用户手册

4

浪潮专有和保密信息

2 安装与部署

浪潮 Cinder 主机插件是 OpenStack 中Cinder 服务的驱动，浪潮的驱动程序集成于

OpenStack 的发布版本中，存在于 Cinder 服务模块的代码目录中，具体路径为

cinder/volume/drivers/inspur/instorage，包含 iSCSI 和FC 两种存储接口协议的驱动，

分别为 instorage_iscsi 模块中的 InStorageMCSISCSIDriver 类和 instorage_fc 模块中

的InStorageMCSFCDriver 类。浪潮 Cinder 驱动会跟随 OpenStack 版本发布，但并

非所有 OpenStack 版本均包含浪潮 Cinder 驱动，当 OpenStack 版本中未包含浪潮

Cinder 驱动或者所包含的浪潮 Cinder 驱动版本过低时，用户可以使用随机光盘中

的发布版本进行安装，并根据用户需要进行相关配置即可。

2.1 浪潮 Cinder 驱动安装

当所部署的 OpenStack Cinder 服务中未包含浪潮 Cinder 驱动时，或者所部属的

OpenStack Cinder 服务中包含的浪潮 Cinder 驱动版本过低时，可以通过手动方式安

装随机光盘中包含的 Cinder 驱动，过程如下。

1. 检查 Cinder 服务中是否包含浪潮 Cinder 驱动。

在Cinder 服务安装目录中检查是否存在 cinder/volume/drivers/inspur 目录，如

果存在，说明 Cinder 服务已经包含了浪潮 Cinder 驱动。

2. 打开浪潮存储随机光盘中所携带的 Cinder 驱动安装包。

浪潮 Cinder 驱动安装包中包含如下目录和文件：

Cinder主机插件用户手册

5

浪潮专有和保密信息

3. 进入驱动安装包目录，根据所部署 OpenStack 版本执行 mkpackage.sh 命令，生

成对应 OpenStack 版本的驱动包，新生成的驱动包与 mkpackage.sh 同级，目录

名为 InStorage_XXX_cinder。mkpackage.sh 工具通过-t 参数来指定 OpenStack

版本,参数值为具体 OpenStack 版本的代码首字母，当前支持 j/k/l/m/n/o/p/q 等

版本，以 Ocata 版本为例，具体过程如下：

4. 进入生成的 InStorage_XXX_cinder 目录，目录包含了对应版本的驱动文件，

其中 opts.py 文件从 OpenStack Mitaka 版本开始存在。

Cinder主机插件用户手册

6

浪潮专有和保密信息

5. 将该驱动包中的 inspur 目录拷贝到 Cinder 服务安装目录下的

cinder/volume/drivers 目录。

6. 用该驱动包中的 opts.py文件替换 Cinder服务安装目录中的 cinder/opts.py文件。

7. 至此，浪潮 Cinder 驱动安装完毕，后续可参考功能配置与管理部分对驱动进行

合理配置并重新启动服务，其中 README 文件中包含了简单的使用范例。

2.2 OpenStack 环境配置

由于 OpenStack 的开源性，所以目前市面上有许多不同的 OpenStack 发行版，以及

不同规模的部署方式：

 All-In-One 方式，使用 Devstack 将所需要的各个 OpenStack 组件安装在一台物

理机或虚拟机上，一般用于开发测试；

 Mirantis Fuel 方式，通过相对直观的图形化界面，定制自己的 OpenStack环境，

可通过简单的配置各个节点的参数，一键部署 OpenStack 环境。

说明：相关信息请参考 https://wiki.openstack.org/wiki/Fuel 。

原生部署，OpenStack 官网有各个组件的部署教程，用户可根据自己的需求部署自

己的环境，根据自己的情况，可将各个服务部署在自己指定的节点，或者将所有服

务安装在单独的节点上，具体安装教程请参考： https://docs.openstack.org/project-

install-guide/newton/ 。

各个第三方 OpenStack 云平台服务提供商，目前市面上有不少公司提供 OpenStack

服务，包括云平台的部署、管理、维护等，他们通过对 OpenStack 的二次开发，为

Cinder主机插件用户手册

7

浪潮专有和保密信息

客户提供自己定制的 OpenStack 服务。

2.3 All-In-One 部署示例

注意

由于 OpenStack 环境的复杂性，本手册提供开发测试环境的搭建示例，仅供参考，实际生产环境

请按 OpenStack 环境运维人员要求部署。

本测试环境使用 Devstack 部署方式进行部署。采用虚拟机单节点安装，使用配置

4VCPU，8GB 内存，60GB 硬盘，需要虚拟机能够访问互联网，建议使用桥接模式。

 Ubuntu Server 16.04 最小化安装，并选择安装 openSSH server。

 创建 stack 用户，并给定 stack 用户 root 权限。

 echo "stack ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers；

或者直接编辑/etc/sudoers 找到 root ALL=(ALL:ALL) ALL 这一行，在下边添

加如下：stack ALL=(ALL:ALL) ALL

 配置固定 IP，修改/etc/network/interfaces

auto eth0

iface eth0 inet static（网卡 IP 地址为固定配置）

address 1.2.3.4（选择合适的 IP 地址）

netmask 255.255.255.0（选择合适的子网掩码）

gateway 1.2.3.254（选择合适的网关）

 配置可用的 DNS，修改 /etc/resolvconf/resolv.conf.d/base

nameserver 8.8.8.8（选择合适的 DNS）

 更新软件并安装 GIT，执行以下命令：

sudo apt-get update（更新软件列表）

sudo apt-get upgrade（更新软件）

apt-get install git -y （安装 git）

Cinder主机插件用户手册

8

浪潮专有和保密信息

 下载并安装 devstack

1. 执行命令：

git clone https://git.openstack.org/openstack-dev/devstack

说明：示例采用了最新的稳定版本 newton 并使用了国内的 trystack 镜像源。

2. 执行命令：

git clone http://git.trystack.cn/openstack-dev/devstack.git -b stable/newton

devstack 已经不支持使用 root 用户运行，需要创建 stack 用户运行。修改

devstack 目录权限，让 stack 用户可以运行以下命令：

chown -R stack /home/stack/devstack

chmod 777 /dev/pts/0

3. 打开 devstack 目录，创建 local.conf 文件并根据如下地址配置所需参数：

https://docs.openstack.org/developer/devstack/configuration.html

也可通过 wget 命令来获取本示例采用的配置文件，执行以下命令：

wget -O - https://raw.githubusercontent.com/inspur-

storage/devstack/master/local.conf > /home/stack/devstack/local.conf

4. 修改 HOST_IP 为虚拟机 IP ，Credentials 信息为 Neutron 中的

FLOATING_RANGE ，Q_FLOATING_ALLOCATION_POOL ，

PUBLIC_NETWORK_GATEWAY。

5. 执行 stack.sh 脚本以安装 devstack：

./stack.sh

安装过程中，可能会遇到错误，一般都是网络问题，执行 unstack.sh 脚本，

再执行 stack.sh 脚本即可。

安装完成后如图 2-1 所示。

Cinder主机插件用户手册

9

浪潮专有和保密信息

图2-1 devstack 安装成功

6. 这时可登陆虚拟机 IP 访问 OpenStack 的Dashboard 使用 OpenStack 了。

图2-2 OpenStack Dashboard 登录页面

Cinder主机插件用户手册

10

浪潮专有和保密信息

3 功能配置与管理

为了在 Cinder 服务中使用浪潮存储，首先需要对 cinder-volume 服务进行配置，增

加浪潮存储的相关配置。

3.1 网络配置

管理 IP

驱动需要访问 Inspur 存储的管理接口，驱动使用 SSH 的方式与管理接口通信。驱

动需要配置浪潮存储系统的 IP、SSH 端口（默认为 22）、还可以设置辅助管理 IP。

上述三个信息通过在/etc/cinder/cinder.conf 中配置 san_ip、san_ssh_port、

instorage_san_secondary_ip。

注意

 确保运行 Cinde-volume 管理驱动程序 Cinder 节点具有到存储系统的 SSH 网络访问。

 Inspur 存储设备必须配置有 iSCSI、FC，两者至少有一种，或者两者兼有。

iSCSI 网络配置

如果使用 iSCSI，则需要每个浪潮存储节点至少有一个 iSCSI 的IP 地址。浪潮 Cinder

主机插件（驱动）会优先使用卷的优先节点（如果存在）的 iSCSI 的IP 来挂载卷

到实例，否则会使用系统的第一个可用的 iSCSI 的IP。驱动会直接从存储系统中获

取iSCSI IP，用户不需要给驱动单独提供 iSCSI IP。虽然不需要单独给驱动分配

iSCSI IP，但是要在存储管理系统中设定 iSCSI 端口的 IP，在“设置 > 网络 > 以

太网端口”中，选择已经连通的端口，单击鼠标右键，选择“修改 IP”，填写有效

的IP、子网掩码、网关。如图 3-1 所示。

Cinder主机插件用户手册

11

浪潮专有和保密信息

图3-1 添加 iSCSI 端口 IP

注意

如果使用 iSCSI，确保 compute 节点与存储系统有畅通的 iSCSI 网络可供访问。

FC 网络配置

如果使用 FC，则需要每个浪潮存储节点至少配置有一个 WWPN 端口。驱动会使

用所有可用的 WWPN 端口将卷挂载到虚拟机实例。驱动会直接从存储系统中获取

WWPN，用户不需要给驱动单独提供 WWPN。

注意

如果使用 FC，确保 compute 节点与存储系统有 FC 连接。

3.2 配置存储池

驱动可以在多个池中分配卷，通过在 cinder.conf 中instorage_mcs_volpool_name 后

配置，并且池和池用逗号分隔。详情参考配置表。驱动配置的存储池是应该事先创

建好的，存储池可以在浪潮存储的管理系统中创建并添加存储器，具体操作如图 3-2

图3-3、图 3-4、图 3-5 所示。

Cinder主机插件用户手册

12

浪潮专有和保密信息

图3-2 存储池操作

图3-3 创建存储池

图3-4 存储池列表

Cinder主机插件用户手册

13

浪潮专有和保密信息

图3-5 添加存储器到池

3.3 配置驱动的用户身份验证信息

为了让驱动能与浪潮存储设备进行通信，需要给驱动提供一个账户。驱动有两种验

证方式，一种是口令认证，一种是 SSH 密钥方式。建议用户通过管理员创建单独

的管理驱动程序的账户，并且确保账户属于管理员角色。

1. 如果使用口令认证，需要在/etc/cinder/cinder.conf 中san_login、san_password 配

置用户名和密码。

2. 如果使用 SSH 密钥方式，需要在主机侧创建密钥，可通过执行 ssh-keygen –t

rsa创建密钥。将 key文件内容配置到/etc/cinder/cinder.conf中的 san_private_key

中，将 key.pub 上传到 Inspur 存储的管理系统中去。

具体操作方法如下：

1) 首先在要配置 Cinder驱动的环境中生成 key文件，执行 ssh-keygen –t rsa。

ページを読み込んでいます...

Inspur AS5300G2-F, AS2600G2-F, AS5500G2-F, AS5600G2-F, AS5800G2-F, AS6800G2-F, HF5500 ユーザーマニュアル

その他の書類