这是本节的多页打印视图。
点击此处打印.
返回本页常规视图.
存储后端管理
后端是华为存储资源的抽象概念，每台华为存储设备可以通过租户/存储池/协议等特性抽象出多个后端资源，每个后端独立存在，其中定义了为Kubernetes集群供应持久卷时所需要的华为存储信息。存储后端，存储设备，存储池的关系是1:1:n。
本章节用于描述使用oceanctl工具配置管理存储后端。
oceanctl工具说明
- 获取oceanctl工具，将oceanctl工具拷贝到环境目录下,例如（/usr/local/bin），且赋予可执行权限，oceanctl工具位于软件包/bin/oceanctl。
- 使用oceanctl工具前请确保oceanctl工具版本与CSI版本相同。查看oceanctl版本命令参考
帮助说明
。当前版本号应为：V4.11.0。
- oceanctl工具依赖kubectl（Kubernetes平台）或oc（OpenShift平台）命令，因此需要在可执行kubectl或oc命令的节点运行。
- 默认情况下，执行oceanctl命令的用户需要有/var/log目录的读写权限。如果没有该目录权限，可通过“–log-dir=/path/to/custom”指定有权限目录作为日志文件目录。
- oceanctl创建后端的命名空间默认为huawei-csi。
- oceanctl命令详细说明请参考
oceanctl命令说明
。
1.1.3.3 - NVMe over RoCE
本章节介绍创建NVMe over RoCE协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceanstor-san。 |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。 | 是 | - | - 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。
|
pools | 存储设备的存储池。参数格式为列表。 | 是 | - | 填写存储池名称。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：roce-nvme, 或roce(已弃用)
- 请确保对接的计算节点已安装nvme-cli工具，并且nvme-cli工具版本在1.9及以上。
|
parameters.portals | 业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表 | 是 | - | |
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
authenticationMode | 登录存储后端的认证模式。 支持两种模式： | 否 | local | 当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。 |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:8088"
pools:
- "StoragePool001"
parameters:
protocol: "roce-nvme"
portals:
- "10.10.30.20"
- "10.10.30.21"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceanstor-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceanstor-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo roce-nvme oceanstor-san xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
1.1.3.4 - NVMe over TCP
本章节介绍创建NVMe over TCP协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceanstor-san。 |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。 | 是 | - | - 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。
|
pools | 存储设备的存储池。参数格式为列表。 | 是 | - | 填写存储池名称。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：tcp-nvme
- 请确保对接的计算节点已安装nvme-cli工具，并且nvme-cli工具版本在2.0及以上。
|
parameters.portals | 业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表 | 是 | - | |
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
authenticationMode | 登录存储后端的认证模式。 支持两种模式： | 否 | local | - |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:8088"
pools:
- "StoragePool001"
parameters:
protocol: "tcp-nvme"
portals:
- "10.10.30.20"
- "10.10.30.21"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceanstor-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceanstor-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo tcp-nvme oceanstor-san xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
1.2.1.2 - DataTurbo
本章节介绍创建DataTurbo协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceanstor-a-series-nas |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。 | 是 | - | 支持按照域名或者IP+端口的方式进行配置。 |
pools | 存储设备的存储池。参数格式为列表。 | 是 | - | 填写存储池名称。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：dtfs
- 请确保对接的计算节点已安装DataTurbo客户端，并已配置好存储逻辑端口的连通性。
|
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
authenticationMode | 登录存储后端的认证模式。 支持两种模式： | 否 | local | - |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceanstor-a-series-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:8088"
pools:
- "StoragePool001"
parameters:
protocol: "dtfs"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceanstor-a-series-nas https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceanstor-a-series-nas https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo dtfs oceanstor-a-series-nas xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
1.2.2.2 - DataTurbo
本章节介绍创建DataTurbo协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceanstor-a-series-dtree |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。 | 是 | - | 支持按照域名或者IP+端口的方式进行配置。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：dtfs
- 请确保对接的计算节点已安装DataTurbo客户端，并已配置好存储逻辑端口的连通性。
|
parameters.parentname | 当前存储上的某一个文件系统名称，在此文件系统下创建Dtree。 | 否 | - | - 请到DeviceManager文件系统界面查询。
- 可选择在StorageClass中配置
|
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
authenticationMode | 登录存储后端的认证模式。 支持两种模式： | 否 | local | - |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceanstor-a-series-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:8088"
parameters:
parentname: "fs-demo"
protocol: "dtfs"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceanstor-a-series-dtree https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceanstor-a-series-dtree https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo dtfs oceanstor-a-series-dtree xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
1.3.1.2 - DataTurbo
本章节介绍创建DataTurbo协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceanstor-a-series-nas |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。 | 是 | - | 支持按照域名或者IP+端口的方式进行配置。 |
storageDeviceSN | 存储设备序列号。 | 是 | | 在DME管理界面，选择"基础设施 > 存储设备 >序列号"，获取存储设备序列号。 |
pools | 存储设备的存储池。参数格式为列表。 | 是 | - | 填写存储池名称。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：dtfs
- 请确保对接的计算节点已安装DataTurbo客户端，并已配置好存储逻辑端口的连通性。
|
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceanstor-a-series-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:26335"
storageDeviceSN: 21000000000000000000
pools:
- "StoragePool001"
parameters:
protocol: "dtfs"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceanstor-a-series-nas https://192.168.129.157:26335
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceanstor-a-series-nas https://192.168.129.157:26335
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo dtfs oceanstor-a-series-nas xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:26335
1.5.2.3 - NVMe over RoCE
本章节介绍创建NVMe over RoCE协议类型的存储后端
配置项说明
表 1 backend配置项说明
参数 | 描述 | 必选参数 | 默认值 | 备注 |
|---|
storage | 存储服务类型。 | 是 | - | 固定填写：oceandisk-san |
name | 存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。 | 是 | - | 请保证存储后端名称唯一。 |
namespace | 命名空间。 | 否 | huawei-csi | 存储后端必须与华为CSI在相同的命名空间中。 |
urls | 存储设备的管理URL。参数格式为列表。 | 是 | - | 支持按照域名或者IP+端口的方式进行配置。 |
pools | 存储设备的存储池。参数格式为列表。 | 是 | - | 填写存储池名称。 |
parameters.protocol | 存储协议。参数格式为字符串。 | 是 | - | - 固定填写：roce-nvme, 或roce(已弃用)
- 请确保对接的计算节点已安装nvme-cli工具，并且nvme-cli工具版本在1.9及以上。
|
parameters.portals | 业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表 | 是 | - | 支持配置多个端口。 |
supportedTopologies | 存储拓扑感知配置。参数格式为列表类型的JSON。 | 否 | - | 如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。 |
maxClientThreads | 同时连接到存储后端的最大连接数。 | 否 | 30 | 范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。 |
创建存储后端
准备后端配置文件，如backend.yaml。
storage: "oceandisk-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
- "https://192.168.129.157:8088"
pools:
- "StoragePool001"
parameters:
protocol: "roce-nvme"
portals:
- "10.10.30.20"
- "10.10.30.21"
maxClientThreads: "30"
执行以下命令创建存储后端。
oceanctl create backend -f /path/to/backend.yaml -i yaml
命令结果示例如下：
NUMBER CONFIGURED NAME STORAGE URLS
1 false backend-demo oceandisk-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
输入待创建后端序号，并输入账号密码。
Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: admin
Please enter this backend password:
Backend backend-demo is configured
NUMBER CONFIGURED NAME STORAGE URLS
1 true backend-demo oceandisk-san https://192.168.129.157:8088
Please enter the backend number to configure (Enter 'exit' to exit):
检查存储后端创建结果。
命令结果示例如下，后端状态为Bound，则创建成功。
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-demo roce-nvme oceandisk-san xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
2.4 - 添加存储后端证书
CSI支持通过添加存储证书的方式，使用TLS/SSL协议加密数据传输通道，提高与存储通信的安全性。
前提条件
完成证书制作。以OceanStor Dorado为例，证书制作过程请参考：
点此前往
。
创建证书示例
提前准备好证书文件，如cert.crt。
执行以下命令获取存储后端。
命令结果示例如下：
NAMESPACE NAME PROTOCOL STORAGETYPE SN STATUS ONLINE URL
huawei-csi backend-1 roce-nvme oceanstor-san xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.157:8088
huawei-csi backend-2 roce-nvme oceanstor-san xxxxxxxxxxxxxxxxxxxx Bound true https://192.168.129.158:8088
执行以下命令为指定存储后端创建证书。
oceanctl create cert cert-1 -b backend-1 -f /path/to/cert.crt
检查证书创建结果。
oceanctl get cert -b backend-1
命令结果示例如下：
NAMESPACE NAME BOUNDBACKEND
huawei-csi cert-1 backend-1
