This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Mass Storage (OceanDisk Series)

1: File System

1.1: NFS

2: Block Service

2.1: iSCSI
2.2: FC
2.3: NVMe over RoCE

1 - File System

1.1 - NFS

This section describes how to create a storage backend of the NFS protocol type.

Configuration Item Description

Table 1 backend parameters

Parameter	Description	Mandatory	Default Value	Remarks
storage	Storage service type.	Yes	-	The value is fixed to oceanstor-nas.
name	Storage backend name. The value can contain a maximum of 63 characters, including lowercase letters, digits, and hyphens (-). It must start with a letter or digit.	Yes	-	Ensure that the storage backend name is unique.
namespace	Namespace.	No	huawei-csi	The storage backend must be in the same namespace as Huawei CSI.
urls	Management URLs of storage device. The value format is a list. The value can be a domain name or an IP address + port number.	Yes	-	If resources need to be provisioned to a specified vStore, set this parameter to the logical management port URL of the specified vStore.
pools	Storage pools of storage devices. The value format is a list.	Yes	-	Enter the storage pool names.
parameters.protocol	Storage protocol. The value is a character string.	Yes	-	The value is fixed to nfs. Ensure that an NFS client tool has been installed on the connected compute node.
parameters.portals	Service access port. Nodes will use this port to read and write storage resources. The value format is a list.	Yes	-	If a vStore is used to connect to a backend, portals must be set to the logical port information of the vStore. You can enter a domain name address. Only one port can be configured.
supportedTopologies	Storage topology awareness configuration. The parameter format is JSON of the list type.	No	-	This parameter is mandatory if storage topology awareness is enabled. For details, see Configuring Storage Topology Awareness.
maxClientThreads	Maximum number of concurrent connections to a storage backend.	No	30	The value ranges from 1 to 30. If this parameter is not set or the value is not in the specified range, the default value 30 is used.

Creating Storage Backends of the Local Type

Prepare a backend configuration file, for example, 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"

Run the following command to create a storage backend.

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

The following is an example of the command output.

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

Enter the serial number of the backend to be created and enter the account and password.

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

Check the storage backend creation result.

oceanctl get backend

The following is an example of the command output. If the backend status is Bound, the creation is successful.

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

2 - Block Service

2.1 - iSCSI

This section describes how to create a storage backend of the iSCSI protocol type.

Configuration Item Description

Table 1 backend parameters

Parameter	Description	Mandatory	Default Value	Remarks
storage	Storage service type.	Yes	-	The value is fixed to oceandisk-san.
name	Storage backend name. The value can contain a maximum of 63 characters, including lowercase letters, digits, and hyphens (-). It must start with a letter or digit.	Yes	-	Ensure that the storage backend name is unique.
namespace	Namespace.	No	huawei-csi	The storage backend must be in the same namespace as Huawei CSI.
urls	Management URLs of storage device. The value format is a list.	Yes	-	The value can be a domain name or an IP address + port number.
pools	Storage pools of storage devices. The value format is a list.	Yes	-	Enter the storage pool names.
parameters.protocol	Storage protocol. The value is a character string.	Yes	-	The value is fixed to iscsi. Ensure that an iSCSI client has been installed on the connected compute node.
parameters.portals	Service access port. Nodes will use this port to read and write storage resources. The value format is a list.	Yes	-	Multiple ports can be configured.
supportedTopologies	Storage topology awareness configuration. The parameter format is JSON of the list type.	No	-	This parameter is mandatory if storage topology awareness is enabled. For details, see Configuring Storage Topology Awareness.
maxClientThreads	Maximum number of concurrent connections to a storage backend.	No	30	The value ranges from 1 to 30. If this parameter is not set or the value is not in the specified range, the default value 30 is used.

Creating a Storage Backend

Prepare a backend configuration file, for example, 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"

Run the following command to create a storage backend.

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

The following is an example of the command output.

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

Enter the serial number of the backend to be created and enter the account and password.

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

Check the storage backend creation result.

oceanctl get backend

The following is an example of the command output. If the backend status is Bound, the creation is successful.

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

2.2 - FC

This section describes how to create a storage backend of the FC protocol type.

Configuration Item Description

Table 1 backend parameters

Parameter	Description	Mandatory	Default Value	Remarks
storage	Storage service type.	Yes	-	The value is fixed to oceandisk-san.
name	Storage backend name. The value can contain a maximum of 63 characters, including lowercase letters, digits, and hyphens (-). It must start with a letter or digit.	Yes	-	Ensure that the storage backend name is unique.
namespace	Namespace.	No	huawei-csi	The storage backend must be in the same namespace as Huawei CSI.
urls	Management URLs of storage device. The value format is a list.	Yes	-	The value can be a domain name or an IP address + port number.
pools	Storage pools of storage devices. The value format is a list.	Yes	-	Enter the storage pool names.
parameters.protocol	Storage protocol. The value is a character string.	Yes	-	The value is fixed to fc.
supportedTopologies	Storage topology awareness configuration. The parameter format is JSON of the list type.	No	-	This parameter is mandatory if storage topology awareness is enabled. For details, see Configuring Storage Topology Awareness.
maxClientThreads	Maximum number of concurrent connections to a storage backend.	No	30	The value ranges from 1 to 30. If this parameter is not set or the value is not in the specified range, the default value 30 is used.

Creating a Storage Backend

Prepare a backend configuration file, for example, 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"

Run the following command to create a storage backend.

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

The following is an example of the command output.

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

Enter the serial number of the backend to be created and enter the account and password.

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

Check the storage backend creation result.

oceanctl get backend

The following is an example of the command output. If the backend status is Bound, the creation is successful.

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

2.3 - NVMe over RoCE

This section describes how to create a storage backend of the NVMe over RoCE protocol type.

Configuration Item Description

Table 1 backend parameters

Parameter	Description	Mandatory	Default Value	Remarks
storage	Storage service type.	Yes	-	The value is fixed to oceandisk-san.
name	Storage backend name. The value can contain a maximum of 63 characters, including lowercase letters, digits, and hyphens (-). It must start with a letter or digit.	Yes	-	Ensure that the storage backend name is unique.
namespace	Namespace.	No	huawei-csi	The storage backend must be in the same namespace as Huawei CSI.
urls	Management URLs of storage device. The value format is a list.	Yes	-	The value can be a domain name or an IP address + port number.
pools	Storage pools of storage devices. The value format is a list.	Yes	-	Enter the storage pool names.
parameters.protocol	Storage protocol. The value is a character string.	Yes	-	The value is fixed to roce. Ensure that the nvme-cli tool has been installed on the compute node to be connected. The supported nvme-cli tool version is 1.9 and later.
parameters.portals	Service access port. Nodes will use this port to read and write storage resources. The value format is a list.	Yes	-	Multiple ports can be configured.
supportedTopologies	Storage topology awareness configuration. The parameter format is JSON of the list type.	No	-	This parameter is mandatory if storage topology awareness is enabled. For details, see Configuring Storage Topology Awareness.
maxClientThreads	Maximum number of concurrent connections to a storage backend.	No	30	The value ranges from 1 to 30. If this parameter is not set or the value is not in the specified range, the default value 30 is used.

Creating a Storage Backend

Prepare a backend configuration file, for example, 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"

Run the following command to create a storage backend.

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

The following is an example of the command output.

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

Enter the serial number of the backend to be created and enter the account and password.

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

Check the storage backend creation result.

oceanctl get backend

The following is an example of the command output. If the backend status is Bound, the creation is successful.

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