这是本节的多页打印视图。 点击此处打印.

返回本页常规视图.

配置存储后端

  1. 使用oceanctl创建存储后端时，输入的账号和秘钥信息保存在 Secret 对象中，建议客户容器平台根据供应商或者K8s社区的建议自行对Secret进行加密。K8s社区对Secret加密可参考 静态加密机密数据 。
  2. 通过json文件创建后端时，旧版本的backend名称中可能存在大写字母或"_“字符。如果出现这种情况，旧的名称将会被重映射为一个新的名称，映射过程自动发生，不会影响原有功能。例如“ABC_123”将会被映射为“abc-123-fd68e”，具体映射规则如下：
  • 大写字母转换成小写字母。
  • “_“字符转换成“-”字符。
  • 末尾追加5位Hash码。
  1. 当存储后端对接租户时，在存储后端创建完成后，不允许修改租户名称。

1 - 闪存存储(OceanStor Dorado/OceanStor V5/OceanStor V6及以后)

1.1 - 文件系统

1.1.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

指定存储服务类型。

是

-

固定填写：oceanstor-nas

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

vstoreName

存储侧的租户名称。当对接后端是OceanStor V5存储时，需要在指定租户下发放资源时，需要指定该参数。

否

-

仅对接后端是OceanStor V5且需要支持租户时，需要指定该参数。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 需要在指定租户下发放资源时，该参数配置为指定租户的逻辑管理端口URL
  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

固定填写：nfs

  • 请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 使用租户对接后端时，此时portals必须配置为租户所拥有的逻辑端口信息。
  • 支持填写为域名地址。
  • 支持IPv6。
  • 仅支持配置一个端口

metrovStorePairID

双活租户Pair ID。

当需要创建PV在存储侧支持NAS双活特性时，该字段必填。此时需要填入待创建的PV所归属的存储侧双活租户Pair ID。

否

-

双活租户Pair ID请到DeviceManager界面查询。

metroBackend

双活对端的后端名称。参数格式为字符串。

当需要创建PV在存储侧支持NAS双活特性时，该字段必填。此时需要填入准备和当前后端组成双活的另一个后端名称。

否

-

组对的两个后端都必须将对方名称填入。这两个后端组成双活关系后，不允许再和其他后端组成双活关系。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。

创建本地类型存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "nfs"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   oceanstor-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

创建双活类型存储后端

  • 配置NAS双活前，需要在两台存储设备之间配置双活关系，包含远端设备、双活域等，仅支持文件系统双活域工作模式为双活AA模式，配置操作请参考对应存储型号的产品文档。
  • 对接NAS双活后端的账号必须为存储租户的租户管理员账号。
  • 除NAS双活后端外，其他后端的管理URL不能配置为在已建立双活关系的租户的逻辑管理端口的URL。
  • 使用双活类型的存储后端时，请勿发放普通文件系统。否则，在逻辑端口漂移场景下，有业务中断的风险。

  1. 准备存储后端配置文件，如backend.yaml。

    storage: "oceanstor-nas"
name: "backend-active"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.155:8088"
pools:
  - "StoragePool001"
metrovStorePairID: "2100xxxxxxxxxx0000000000600000000"
metroBackend: "backend-standby"
parameters:
  protocol: "nfs"
  portals:
    - "192.168.129.156"
maxClientThreads: "30"
---
storage: "oceanstor-nas"
name: "backend-standby"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
metrovStorePairID: "2100xxxxxxxxxx0000000000600000000"
metroBackend: "backend-active"
parameters:
  protocol: "nfs"
  portals:
    - "192.168.129.158"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME              STORAGE              URLS                
1       false         backend-active    oceanstor-nas        https://192.168.129.155:8088 
2       false         backend-standby   oceanstor-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 分别输入待创建后端序号，并输入账号密码。

    Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: user1
Please enter this backend password:

Backend backend-standby is configured
NUMBER  CONFIGURED    NAME              STORAGE              URLS               
1       true          backend-active    oceanstor-nas        https://192.168.129.155:8088 
2       true          backend-standby   oceanstor-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为"Bound" 则创建成功。

    NAMESPACE     NAME              PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-active    nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.155:8088   
huawei-csi    backend-standby   nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

1.1.2 - NFS+

本章节介绍创建NFS+协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-nas

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 需要在指定租户下发放资源时，该参数配置为指定租户的逻辑管理端口URL
  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs+
  • 请确保对接的计算节点已安装NFS+客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 使用租户对接后端时，此时portals必须配置为租户所拥有的逻辑端口信息。
  • 支持填写为域名地址。
  • 支持IPv6。
  • 支持配置多个端口。

metrovStorePairID

双活租户Pair ID。

当需要创建PV在存储侧支持NAS双活特性时，该字段必填。此时需要填入待创建的PV所归属的存储侧双活租户Pair ID。

否

-

双活租户Pair ID请到DeviceManager界面查询。

metroBackend

双活对端的后端名称。参数格式为字符串。

当需要创建PV在存储侧支持NAS双活特性时，该字段必填。此时需要填入准备和当前后端组成双活的另一个后端名称。

否

-

组对的两个后端都必须将对方名称填入。这两个后端组成双活关系后，不允许再和其他后端组成双活关系。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

-

创建本地类型存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "nfs+"
  portals:
    - "10.10.30.20"
    - "10.10.30.30"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   oceanstor-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL     STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs+         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

创建双活类型存储后端

  • 配置NAS双活前，需要在两台存储设备之间配置双活关系，包含远端设备、双活域等，仅支持文件系统双活域工作模式为双活AA模式，配置操作请参考对应存储型号的产品文档。
  • 对接NAS双活后端的账号必须为存储租户的租户管理员账号。
  • 除NAS双活后端外，其他后端的管理URL不能配置为在已建立双活关系的租户的逻辑管理端口的URL。
  • 使用双活类型的存储后端时，请勿发放普通文件系统。否则，在逻辑端口漂移场景下，有业务中断的风险。

操作步骤

  1. 准备存储后端配置文件，如backend.yaml。

    storage: "oceanstor-nas"
name: "backend-active"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.155:8088"
pools:
  - "StoragePool001"
metrovStorePairID: "2100xxxxxxxxxx0000000000600000000"
metroBackend: "backend-standby"
parameters:
  protocol: "nfs+"
  portals:
    - "192.168.129.156"
    - "192.168.129.157"
maxClientThreads: "30"
---
storage: "oceanstor-nas"
name: "backend-standby"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.158:8088"
pools:
  - "StoragePool001"
metrovStorePairID: "2100xxxxxxxxxx0000000000600000000"
metroBackend: "backend-active"
parameters:
  protocol: "nfs+"
  portals:
    - "192.168.129.159"
    - "192.168.129.160"   
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME              STORAGE              URLS                
1       false         backend-active    oceanstor-nas        https://192.168.129.155:8088 
2       false         backend-standby   oceanstor-nas        https://192.168.129.158:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 分别输入待创建后端序号，并输入账号密码。

    Please enter the backend number to configure (Enter 'exit' to exit):1
Please enter this backend user name: user1
Please enter this backend password:

Backend backend-standby is configured
NUMBER  CONFIGURED    NAME              STORAGE              URLS               
1       true          backend-active    oceanstor-nas        https://192.168.129.155:8088 
2       true          backend-standby   oceanstor-nas        https://192.168.129.158:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为"Bound" 则创建成功。

    NAMESPACE     NAME              PROTOCOL     STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-active    nfs+         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.155:8088   
huawei-csi    backend-standby   nfs+         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.158:8088

1.2 - Dtree

1.2.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-dtree

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 需要在指定租户下发放资源时，该参数配置为指定租户的逻辑管理端口URL
  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs
  • 请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 使用租户对接后端时，此时portals必须配置为租户所拥有的逻辑端口信息。
  • 支持填写为域名地址。
  • 支持IPv6。
  • 仅支持配置一个端口

parameters.parentname

当前存储上的某一个文件系统名称，在此文件系统下创建Dtree。

否

-

  • 请到DeviceManager文件系统界面查询。
  • 可选择在StorageClass中配置

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

-

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
parameters:
  protocol: "nfs"
  parentname: "parent-filesystem"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   oceanstor-dtree      https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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-dtree      https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         oceanstor-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

1.2.2 - NFS+

本章节介绍创建NFS+协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-dtree

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 需要在指定租户下发放资源时，该参数配置为指定租户的逻辑管理端口URL
  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs+
  • 请确保对接的计算节点已安装NFS+客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 使用租户对接后端时，此时portals必须配置为租户所拥有的逻辑端口信息。
  • 支持填写为域名地址。
  • 支持IPv6。
  • 支持配置多个端口。

parameters.parentname

当前存储上的某一个文件系统名称，在此文件系统下创建Dtree。

否

-

  • 请到DeviceManager文件系统界面查询。
  • 可选择在StorageClass中配置

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

-

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
parameters:
  protocol: "nfs+"
  parentname: "parent-filesystem"
  portals:
    - "10.10.30.20"
    - "10.10.30.30"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   oceanstor-dtree      https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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-dtree      https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL     STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs+         oceanstor-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

1.3 - 块业务

1.3.1 - iSCSI

本章节介绍创建iSCSI协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：iscsi
  • 请确保对接的计算节点已安装iSCSI客户端。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 支持IPv6。
  • 支持配置多个端口。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "iscsi"
  portals:
    - "10.10.30.20"
    - "10.10.30.21"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    iscsi       oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

1.3.2 - FC

本章节介绍创建FC协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-san。

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：fc

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "fc"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    fc          oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

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-cli工具，并且nvme-cli工具版本在1.9及以上。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 支持IPv6。
  • 支持配置多个端口

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "roce"
  portals:
    - "10.10.30.20"
    - "10.10.30.21"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    roce        oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

1.3.4 - FC-NVMe

本章节介绍创建FC-NVMe协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

  • 当管理URL为IPv6类型时，URL格式为：https://[IPv6地址]:端口号。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：fc-nvme。
  • 请确保对接的计算节点已安装nvme-cli工具，并且nvme-cli工具版本在1.9及以上。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

当华为企业存储为OceanStor V5时，LDAP域认证服务器ID必须为0。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "fc-nvme"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    fc-nvme     oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

2 - 闪存存储（OceanStor A600/A800）

2.1 - 本地文件系统

2.1.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：oceanstor-a-series-nas

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs
  • 请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

仅支持配置一个端口

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

authenticationMode

登录存储后端的认证模式。

支持两种模式：

  • local：本地认证
  • ldap：LDAP认证

否

local

-

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-a-series-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "nfs"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE             SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         oceanstor-a-series-nas  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

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：本地认证
  • ldap：LDAP认证

否

local

-

创建存储后端

  1. 准备后端配置文件，如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"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为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

3 - 海量存储（OceanStor Pacific系列）

3.1 - 命名空间

3.1.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-nas

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

accountName

存储侧的账户名称。

否

-

需要在指定账户下发放NAS资源时，需要指定该参数。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs
  • 请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表。

是

-

  • 使用账户对接后端时，此时portals必须配置为账户所拥有的逻辑端口信息。
  • 支持填写为域名地址。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "nfs"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   fusionstorage-nas    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-nas    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN             STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         fusionstorage-nas                 Bound   true    https://192.168.129.157:8088

3.1.2 - DPC

本章节介绍创建DPC协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-nas

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

accountName

存储侧的账户名称。

否

-

需要在指定账户下发放NAS资源时，需要指定该参数。

urls

存储设备的管理URL，参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：dpc
  • 请确保对接的计算节点已安装DPC客户端，并已在待接入存储上添加为DPC计算节点。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "dpc"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   fusionstorage-nas    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-nas    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN               STATUS  ONLINE  URL                 
huawei-csi    backend-demo    dpc         fusionstorage-nas                   Bound   true    https://192.168.129.157:8088

3.2 - Dtree

3.2.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-dtree

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

accountName

存储侧的账户名称。

否

-

需要在指定账户下发放NAS资源时，需要指定该参数。

urls

存储设备的管理URL，参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：nfs
  • 请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表。

是

-

  • 使用账户对接后端时，此时portals必须配置为账户所拥有的逻辑端口信息。
  • 支持填写为域名地址。

parameters.parentname

当前存储上的某一个文件系统名称，在此文件系统下创建Dtree。

否

-

  • 请到DeviceManager文件系统界面查询。
  • 可选择在StorageClass中配置

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
parameters:
  protocol: "nfs"
  parentname: "parent-filesystem"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   fusionstorage-dtree  https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-dtree  https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE           SN            STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         fusionstorage-dtree                 Bound   true    https://192.168.129.157:8088

3.2.2 - DPC

本章节介绍创建DPC协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-dtree

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

accountName

存储侧的账户名称。

否

-

需要在指定账户下发放NAS资源时，需要指定该参数。

urls

存储设备的管理URL，参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

parameters.protocol

存储协议。参数格式为字符串。

  • dpc

是

-

  • 固定填写：dpc
  • 请确保对接的计算节点已安装DPC客户端，并已在待接入存储上添加为DPC计算节点。

parameters.parentname

当前存储上的某一个文件系统名称，在此文件系统下创建Dtree。

否

-

  • 请到DeviceManager文件系统界面查询。
  • 可选择在StorageClass中配置

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
parameters:
  protocol: "dpc"
  parentname: "parent-filesystem"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE                URLS                
1       false         backend-demo   fusionstorage-dtree    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-dtree    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE          SN          STATUS  ONLINE  URL                 
huawei-csi    backend-demo    dpc         fusionstorage-dtree              Bound   true    https://192.168.129.157:8088

3.3 - 块业务

3.3.1 - iSCSI

本章节介绍创建iSCSI协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：iscsi
  • 请确保对接的计算节点已安装iSCSI客户端。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

条件必选

-

  • 支持配置多个端口。
  • iscsiLinks与portals参数必须配置其中一项。

parameters.iscsiLinks

动态访问链接数，仅支持Pacific 8.1.5及以上版本。

条件必选

  

iscsiLinks与portals参数必须配置其中一项。

说明：
  1. 仅当portals参数为空时，iscsiLinks参数生效。
  2. 实际生效的链路数为以下三者的最大值：
    • iscsiLinks参数值
    • 存储动态分配最小链路数
    • 主机上已建连的链接数

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "iscsi"
  portals:
    - "10.10.30.20"
    - "10.10.30.21"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   fusionstorage-san    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-san    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN       STATUS  ONLINE  URL                 
huawei-csi    backend-demo    iscsi       fusionstorage-san           Bound   true    https://192.168.129.157:8088

3.3.2 - SCSI

本章节介绍创建SCSI协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写：fusionstorage-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：scsi
  • 请确保对接的计算节点已安装分布式存储VBS客户端。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

scsi协议的端口形式为字典格式，key为部署VBS客户端的主机名称，value为部署VBS客户端的主机IP地址。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "fusionstorage-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "scsi"
  portals:
    - {"hostname01": "192.168.125.21","hostname02": "192.168.125.22"}
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   fusionstorage-san    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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    fusionstorage-san    https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN      STATUS  ONLINE  URL                 
huawei-csi    backend-demo    scsi        fusionstorage-san          Bound   true    https://192.168.129.157:8088

4 - 海量存储（OceanDisk系列）

4.1 - 文件系统

4.1.1 - NFS

本章节介绍创建NFS协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

指定存储服务类型。

是

-

固定填写：oceanstor-nas。

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。支持按照域名或者IP+端口的方式进行配置。

是

-

需要在指定租户下发放资源时，该参数配置为指定租户的逻辑管理端口URL。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

固定填写：nfs。请确保对接的计算节点已安装NFS客户端工具。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

  • 使用租户对接后端时，此时portals必须配置为租户所拥有的逻辑端口信息；
  • 支持填写为域名地址；
  • 仅支持配置一个端口。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建本地类型存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceanstor-nas"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "nfs"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    oceanctl create backend -f /path/to/backend.yaml -i yaml

    命令结果示例如下：

    NUMBER  CONFIGURED    NAME           STORAGE              URLS                
1       false         backend-demo   oceanstor-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  3. 输入待创建后端序号，并输入账号密码。

    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-nas        https://192.168.129.157:8088 
Please enter the backend number to configure (Enter 'exit' to exit):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE      SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

4.2 - 块业务

4.2.1 - iSCSI

本章节介绍创建iSCSI协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写oceandisk-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：iscsi
  • 请确保对接的计算节点已安装iSCSI客户端。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

支持配置多个端口。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceandisk-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "iscsi"
  portals:
    - "10.10.30.20"
    - "10.10.30.21"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE     SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    iscsi       oceandisk-san   xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

4.2.2 - FC

本章节介绍创建FC协议类型的存储后端

配置项说明

表 1 backend配置项说明

参数

描述

必选参数

默认值

备注

storage

存储服务类型。

是

-

固定填写oceandisk-san

name

存储后端名称。支持小写字母、数字和特殊字符"-"，且需要以字母或数字开头，最多63个字符。

是

-

请保证存储后端名称唯一。

namespace

命名空间。

否

huawei-csi

存储后端必须与华为CSI在相同的命名空间中。

urls

存储设备的管理URL。参数格式为列表。

是

-

支持按照域名或者IP+端口的方式进行配置。

pools

存储设备的存储池。参数格式为列表。

是

-

填写存储池名称。

parameters.protocol

存储协议。参数格式为字符串。

是

-

  • 固定填写：fc

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceandisk-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "fc"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    fc          oceandisk-san      xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088

4.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-cli工具，并且nvme-cli工具版本在1.9及以上。

parameters.portals

业务访问端口。节点会使用该端口对存储资源进行读写访问。参数格式为一个列表

是

-

支持配置多个端口。

supportedTopologies

存储拓扑感知配置。参数格式为列表类型的JSON。

否

-

如果启用存储拓扑感知，需要配置该参数。具体请参考配置存储拓扑感知。

maxClientThreads

同时连接到存储后端的最大连接数。

否

30

范围1~30，如果不配置该参数，或参数值不在规定范围内，则取用默认值30。

创建存储后端

  1. 准备后端配置文件，如backend.yaml。

    storage: "oceandisk-san"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:8088"
pools:
  - "StoragePool001"
parameters:
  protocol: "roce"
  portals:
    - "10.10.30.20"
    - "10.10.30.21"
maxClientThreads: "30"

  2. 执行以下命令创建存储后端。

    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):

  3. 输入待创建后端序号，并输入账号密码。

    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):

  4. 检查存储后端创建结果。

    oceanctl get backend

    命令结果示例如下，后端状态为Bound，则创建成功。

    NAMESPACE     NAME            PROTOCOL    STORAGETYPE        SN                    STATUS  ONLINE  URL                 
huawei-csi    backend-demo    roce        oceandisk-san      xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088