Storage Backend Management

• 1: Configuring the Storage Backend
• 1.1: Flash Storage (OceanStor Dorado/OceanStor V5/OceanStor V6 and Later)
• 1.1.1: File System
• 1.1.1.1: NFS
• 1.1.1.2: NFS+
• 1.1.2: Dtree
• 1.1.2.1: NFS
• 1.1.2.2: NFS+
• 1.1.3: Block Service
• 1.1.3.1: iSCSI
• 1.1.3.2: FC
• 1.1.3.3: NVMe over RoCE
• 1.1.3.4: FC-NVMe
• 1.2: Flash Storage (OceanStor A600/A800)
• 1.2.1: Local File System
• 1.2.1.1: NFS
• 1.2.1.2: DataTurbo
• 1.3: Mass Storage (OceanStor Pacific Series)
• 1.3.1: Namespace
• 1.3.1.1: NFS
• 1.3.1.2: DPC
• 1.3.2: Dtree
• 1.3.2.1: NFS
• 1.3.2.2: DPC
• 1.3.3: Block Service
• 1.3.3.1: iSCSI
• 1.3.3.2: SCSI
• 1.4: Mass Storage (OceanDisk Series)
• 1.4.1: File System
• 1.4.1.1: NFS
• 1.4.2: Block Service
• 1.4.2.1: iSCSI
• 1.4.2.2: FC
• 1.4.2.3: NVMe over RoCE
• 2: Managing Storage Backends
• 2.1: Querying a Storage Backend
• 2.2: Updating a Storage Backend
• 2.2.1: Updating the Password of a Storage Backend Using oceanctl
• 2.2.2: Updating the Login Authentication Mode of a Storage Backend
• 2.2.3: Updating a Storage Backend
• 2.3: Deleting a Storage Backend
• 2.4: Adding a Storage Backend Certificate
• 2.5: Deleting a Storage Backend Certificate

1 - Configuring the Storage Backend

1. When oceanctl is used to create a storage backend, the entered account and key information is stored in the Secret object. It is recommended that the customer container platform encrypt the Secret object based on the suggestions of the supplier or K8s community. For details about how to encrypt the Secret object in the K8s community, see Encrypting Confidential Data at Rest .
2. When a backend is created using a .json file, the backend name of an earlier version may contain uppercase letters or underscores (_). In this case, the old name is remapped to a new name. The mapping process automatically occurs and does not affect the original functions. For example, ABC_123 is mapped to abc-123-fd68e. The mapping rules are as follows:

• Uppercase letters are converted to lowercase letters.
• An underscore (_) is converted to a hyphen (-).
• A 5-digit hash code is added to the end.

3. If a storage backend is connected to a vStore, the vStore name cannot be changed after the storage backend is created.

1.1 - Flash Storage (OceanStor Dorado/OceanStor V5/OceanStor V6 and Later)

1.1.1 - File System

1.1.1.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

Creating Storage Backends of the Local Type

1. 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"
   

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-nas        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    oceanstor-nas        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    nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

Creating Storage Backends of the HyperMetro Type

• Before configuring NAS HyperMetro, you need to configure the HyperMetro relationship between two storage devices, including the remote device and HyperMetro domain. The HyperMetro domain of the file system can only work in HyperMetro active-active (AA) mode. For details about the configuration operation, see the product documentation of the corresponding storage model.
• The accounts for connecting to NAS HyperMetro backends must be the administrator accounts of the storage vStores.
• Except NAS HyperMetro backends, the management URLs of other backends cannot be the URL of a logical management port of a vStore that has established the HyperMetro relationship.
• When a HyperMetro storage backend is used, do not provision common file systems. Otherwise, services may be interrupted in logical port failover scenarios.

1. Prepare a storage backend configuration file, for example, 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. 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-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. 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: 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. 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-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.1.2 - NFS+

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

Configuration Item Description

Table 1 backend parameters

Creating Storage Backends of the Local Type

1. 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"
       - "10.10.30.30"
   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-nas        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    oceanstor-nas        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    nfs+         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

Creating Storage Backends of the HyperMetro Type

• Before configuring NAS HyperMetro, you need to configure the HyperMetro relationship between two storage devices, including the remote device and HyperMetro domain. The HyperMetro domain of the file system can only work in HyperMetro active-active (AA) mode. For details about the configuration operation, see the product documentation of the corresponding storage model.
• The accounts for connecting to NAS HyperMetro backends must be the administrator accounts of the storage vStores.
• Except NAS HyperMetro backends, the management URLs of other backends cannot be the URL of a logical management port of a vStore that has established the HyperMetro relationship.
• When a HyperMetro storage backend is used, do not provision common file systems. Otherwise, services may be interrupted in logical port failover scenarios.

Procedure

1. Prepare a storage backend configuration file, for example, 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. 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-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. 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: 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. 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-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.1.2 - Dtree

1.1.2.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-dtree      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    oceanstor-dtree      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    nfs         oceanstor-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.1.2.2 - NFS+

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-dtree      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    oceanstor-dtree      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    nfs+         oceanstor-dtree  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.1.3 - Block Service

1.1.3.1 - iSCSI

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-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    oceanstor-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    iscsi       oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.1.3.2 - FC

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-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    oceanstor-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    fc          oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.1.3.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

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-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    oceanstor-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    roce        oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.1.3.4 - FC-NVMe

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-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    oceanstor-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    fc-nvme     oceanstor-san    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.2 - Flash Storage (OceanStor A600/A800)

1.2.1 - Local File System

1.2.1.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

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:8088"
   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: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    oceanstor-a-series-nas    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    nfs         oceanstor-a-series-nas  xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.2.1.2 - DataTurbo

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

Configuration Item Description

Table 1 backend parameters

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

1.3 - Mass Storage (OceanStor Pacific Series)

1.3.1 - Namespace

1.3.1.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-nas    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-nas    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    nfs         fusionstorage-nas                 Bound   true    https://192.168.129.157:8088   
   

1.3.1.2 - DPC

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-nas    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-nas    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    dpc         fusionstorage-nas                   Bound   true    https://192.168.129.157:8088   
   

1.3.2 - Dtree

1.3.2.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-dtree  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-dtree  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    nfs         fusionstorage-dtree                 Bound   true    https://192.168.129.157:8088   
   

1.3.2.2 - DPC

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. Prepare a backend configuration file, for example, 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. 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-dtree    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-dtree    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    dpc         fusionstorage-dtree              Bound   true    https://192.168.129.157:8088   
   

1.3.3 - Block Service

1.3.3.1 - iSCSI

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

Configuration Item Description

Table 1 backend parameters

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: "iscsi"
     portals:
       - "10.10.30.20"
       - "10.10.30.21"
   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    iscsi       fusionstorage-san           Bound   true    https://192.168.129.157:8088   
   

1.3.3.2 - SCSI

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

Configuration Item Description

Table 1 backend parameters

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   
   

1.4 - Mass Storage (OceanDisk Series)

1.4.1 - File System

1.4.1.1 - NFS

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

Configuration Item Description

Table 1 backend parameters

Creating Storage Backends of the Local Type

1. 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"
   

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-nas        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    oceanstor-nas        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    nfs         oceanstor-nas    xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.4.2 - Block Service

1.4.2.1 - iSCSI

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. 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"
   

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   oceandisk-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    oceandisk-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    iscsi       oceandisk-san   xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.4.2.2 - FC

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

Configuration Item Description

Table 1 backend parameters

Creating a Storage Backend

1. 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"
   

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   oceandisk-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    oceandisk-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    fc          oceandisk-san      xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

1.4.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

Creating a Storage Backend

1. 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"
   

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   oceandisk-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    oceandisk-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    roce        oceandisk-san      xxxxxxxxxxxxxxxxxxxx  Bound   true    https://192.168.129.157:8088   
   

2 - Managing Storage Backends

2.1 - Querying a Storage Backend

• Run the following command to obtain the help information about querying a backend.

  oceanctl get backend -h
  

• Run the following command to query a single storage backend in the default namespace.

  oceanctl get backend <backend-name>
  

• Run the following command to query all storage backends in the specified namespace.

  oceanctl get backend -n <namespace>
  

• Run the following command to format the output. Currently, json, yaml, and wide are supported.

  oceanctl get backend <backend-name> -o json
  

2.2 - Updating a Storage Backend

• When you use oceanctl to update the storage backend information, only the storage backend password and authentication mode for logging in to the storage backend can be updated.
• If the backend account password is updated on the storage device, the CSI plug-in will retry due to login failures. As a result, the account may be locked. If the account is locked, change the password by referring to An Account Is Locked After the Password Is Updated on the Storage Device .

2.2.1 - Updating the Password of a Storage Backend Using oceanctl

Obtaining the Help Information About Updating a Backend

1. Run the following command to obtain the help information about updating a storage backend.

   oceanctl update backend -h
   

   The following is an example of the command output.

   Update a backend for Ocean Storage in Kubernetes
   
   Usage:
     oceanctl update backend <name> [flags]
   
   Examples:
     # Update backend account information in default(huawei-csi) namespace
     oceanctl update backend <name>  --password
   
     # Update backend account information in specified namespace
     oceanctl update backend <name> -n namespace --password
   
     # Update backend account information with ldap authentication mode in default(huawei-csi) namespace
     oceanctl update backend <name> --password --authenticationMode=ldap
   
     # Update backend account information with local authentication mode in default(huawei-csi) namespace
     oceanctl update backend <name> --password --authenticationMode=local
   
     # Update backend account information with ldap authentication mode in specified namespace
     oceanctl update backend <name> -n namespace --password --authenticationMode=ldap
   
   Flags:
         --authenticationMode string   Specify authentication mode
     -h, --help                        help for backend
     -n, --namespace string            namespace of resources
         --password                    Update account password
   
   Global Flags:
         --log-dir string   Specify the directory for printing log files. (default "/var/log/huawei")