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

Return to the regular view of this page.

iMaster DME (Interconnected with an OceanStor A800 Cluster)

1 - Global 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-a-series-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 the storage device. The value format is a list.

Yes

-

The value can be a domain name or an IP address + port number.

storageDeviceSN

Serial number of the storage device.

Yes

  

On the iMaster DME, choose Infrastructure > Storage Devices > ESN to obtain the serial number of the storage device.

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 at 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

-

  • 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

5

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 5 is used.

Creating a Storage Backend

  1. Prepare a backend configuration file, for example, 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: "nfs"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

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

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

  4. 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-a-series-nas  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:26335

1.2 - DataTurbo

This section describes how to create a storage backend of the DataTurbo 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-a-series-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 the storage device. The value format is a list.

Yes

-

The value can be a domain name or an IP address + port number.

storageDeviceSN

Serial number of the storage device.

Yes

  

On the iMaster DME, choose Infrastructure > Storage Devices > ESN to obtain the serial number of the storage device.

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 dtfs.
  • Ensure that a DataTurbo client has been installed on the connected compute node and the connectivity of the storage logical port has been 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

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

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

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

  4. 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    dtfs       oceanstor-a-series-nas  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:26335

2 - Local File System


In the current version, only local file systems with KV cache resources can be provisioned. Local file systems cannot be directly provisioned.

2.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-a-series-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 the storage device. The value format is a list.

Yes

-

The value can be a domain name or an IP address + port number.

storageDeviceSN

Serial number of the storage device.

Yes

  

On the iMaster DME, choose Infrastructure > Storage Devices > ESN to obtain the serial number of the storage device.

zoneSN

Serial number of the storage zone.

Conditionally mandatory

  

This parameter is mandatory if a local file system is used to create KV cache. On iMaster DME, choose Infrastructure > Storage Devices > Hardware > Storage Zones. On the menu bar, select ESN to obtain the serial number of the storage zone.

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 at 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

-

  • 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

5

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 5 is used.

Creating a Storage Backend

  1. Prepare a backend configuration file, for example, backend.yaml.

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

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

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

  4. 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-a-series-nas  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:26335

3 - Dtree

3.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-a-series-dtree.

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 the storage device. The value format is a list.

Yes

-

The value can be a domain name or an IP address + port number.

storageDeviceSN

Serial number of the storage device.

Yes

-

On the iMaster DME, choose Infrastructure > Storage Devices > ESN to obtain the serial number of the storage device.

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

-

Only one port can be configured.

parameters.parentname

Name of a file system on the current storage device. Dtree is created in the file system.

No

-

  • Obtain the value on the iMaster DME.
  • You can configure the parameter in StorageClass.

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

  1. Prepare a backend configuration file, for example, backend.yaml.

    storage: "oceanstor-a-series-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:26335"
storageDeviceSN: 21000000000000000000
parameters:
  protocol: "nfs"
  parentname: "fs-demo"
  portals:
    - "10.10.30.20"
maxClientThreads: "30"

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

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

  4. 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-a-series-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:26335

3.2 - DataTurbo

This section describes how to create a storage backend of the DataTurbo 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-a-series-dtree.

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 the storage device. The value format is a list.

Yes

-

The value can be a domain name or an IP address + port number.

storageDeviceSN

Serial number of the storage device.

Yes

-

On the iMaster DME, choose Infrastructure > Storage Devices > ESN to obtain the serial number of the storage device.

parameters.protocol

Storage protocol. The value is a character string.

Yes

-

  • The value is fixed to dtfs.
  • Ensure that a DataTurbo client has been installed on the connected compute node and the connectivity of the storage logical port has been configured.

parameters.parentname

Name of a file system on the current storage device. Dtree is created in the file system.

No

-

  • Obtain the value on the iMaster DME.
  • You can configure the parameter in StorageClass.

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

  1. Prepare a backend configuration file, for example, backend.yaml.

    storage: "oceanstor-a-series-dtree"
name: "backend-demo"
namespace: "huawei-csi"
urls:
  - "https://192.168.129.157:26335"
storageDeviceSN: 21000000000000000000
parameters:
  parentname: "fs-demo"
  protocol: "dtfs"
maxClientThreads: "30"

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

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

  4. 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    dtfs       oceanstor-a-series-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:26335