All Products
Search
Document Center

Cloud Storage Gateway:Manage iSCSI volumes

Last Updated:Dec 19, 2024

This topic describes how to manage iSCSI volumes in the Cloud Storage Gateway (CSG) console, including how to create, modify, delete, and view iSCSI volumes.

Prerequisites

  • An Internet Small Computer System Interface (iSCSI) gateway is created. For more information, see Create an iSCSI gateway.

  • If you need to create an iSCSI volume that has the Cache mode enabled, make sure that a cache disk is added to the iSCSI gateway. For more information, see Add a cache disk.

Note

If you want to create an iSCSI volume that has the Write-through mode enabled, you do not need to add a cache disk to the gateway.

Create an iSCSI volume

  1. On the Gateways page, click the ID of the iSCSI gateway. On the page that appears, click Volumes > Create.

  2. In the wizard, configure the parameters described in the following table.

    Configuration example

    Step

    Parameter

    Description

    Bucket Settings

    OSS Endpoint

    Select an endpoint for the region in which the bucket is located.

    Bucket Name

    Specify the name of the bucket. An iSCSI gateway does not support a bucket in the Archive storage class or with a back-to-origin routing configuration.

    Use SSL to Connect Bucket

    If you select Yes, the bucket is connected over SSL.

    Basic Information

    Volume Name

    Specify a name for the volume. The name must be 1 to 32 characters in length, and can contain lowercase letters and digits. The name must start with a lowercase letter.

    Recover

    Select whether to recover a volume that uses the specified OSS bucket as backend storage. Valid values:

    • Yes: When the OSS bucket is used as a volume, the system attempts to recover the volume based on the metadata of the volume, such as the size of the volume.

    • No: The system uses the associated OSS bucket to create a volume.

    Capacity

    If you set Recover to No, you must set the Capacity parameter. The capacity must be greater than or equal to 1 GB and less than or equal to 256 TB.

    Mode

    The mode that the gateway uses to read and write files. Valid values:

    • Write Through Mode: In Write Through mode, data reads and writes are performed on the OSS bucket.

    • Cache Mode: In Cache mode, data reads and writes are preferentially performed in the on-premises cache disk. Generally, iSCSI gateways have better read and write performance in Cache mode.

    Cache

    If you set Mode to Cache Mode, you must select a cache disk.

    Note

    Make sure that you have added a cache disk to the iSCSI gateway. Otherwise, no cache disk is available.

    Storage Allocation Unit

    If you set Recover to No, you must set the Storage Allocation Unit parameter. The supported units are 8K, 16K, 32K, 64K, and 128K. The default unit is 32K.

    Authorization

    The one-way Challenge-Handshake Authentication Protocol (CHAP) authentication.

    If you select CHAP from the Authorization drop-down list, you must set the following parameters:

    • CHAP Username of Initiator: Enter a CHAP username.

    • CHAP Password of Initiator: Enter a CHAP password. The password must be 12 to 16 characters in length.

Related operations

On the Volumes page, you can also perform the following operations.

Operation

Description

Modify an iSCSI volume

Find the target iSCSI volume and click Edit in the Actions column.

Delete an iSCSI volume

Find the target iSCSI volume and click Delete in the Actions column.

When you delete an iSCSI volume, you can choose whether to delete the data stored in the associated OSS bucket at the same time.

Warning

If you select the Delete data in the OSS buckets at the same time check box, all data stored in the OSS bucket will be deleted after the iSCSI volume is deleted. Proceed with caution.

View iSCSI volume information

Find the target iSCSI volume and click the plus sign (+) to show the volume information. The volume information includes the operation status, total amount of downloaded data, IP address, capacity, port, whether CHAP is enabled, total amount of uploaded data, whether OSS bucket SSL is used, LUN ID, volume status, and whether the volume is enabled.

What to do next