SCSI

This section describes how to create a storage backend of the SCSI 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 fusionstorage-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 scsi.
  • Ensure that a distributed storage VBS 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

-

If the protocol is scsi, the port is in dictionary format where the key indicates the name of the host where the VBS client is deployed and the value indicates the IP address of the host where the VBS client is deployed.

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: "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. 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   fusionstorage-san    https://192.168.129.157:8088 
    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    fusionstorage-san    https://192.168.129.157:8088 
    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    scsi        fusionstorage-san          Bound   true    https://192.168.129.157:8088