Backup Storage


Overview

A backup storage is a storage server used to store image templates including ISO.

  • A backup storage must be attached to a zone before the resources on the zone can access it. Note that you can share images across multiple zones by using the backup storage, as shown in Backup Storage.
    Figure 1. Backup Storage


  • To better manage backup storages and zones, the UI specifies that one backup storage can only correspond to one zone. In the UI, when you add a backup storage, the backup storage will be attached to the current zone by default. When you delete a zone, the backup storage attached to the zone will also be deleted.

Backup Storage Type

A backup storage supports the following types:
  1. ImageStore
    • Image files are stored by means of image segmentation. Incremental storage is supported.
    • Snapshots and images can be created when VM instances are running or stopped.
    • When VM instances are cloned without data volumes, the VM instances that are running, paused, or stopped can be cloned.
    • When VM instances are cloned with data volumes, the VM instances that are running, paused, or stopped, and with storage types of LocalStorage, NFS, Shared Mount Point, Ceph, or Shared Block can be cloned.
    • Images can be synchronized across ImageStore backup storages within the same management network.
    • The existing images can be obtained. In addition, you can obtain the existing image files under the URL path in the backup storage.
  2. SFTP
    • Only the SFTP Community edition is supported.
    • Image files are stored by means of files.
    • Snapshots and images can be created when VM instances are stopped.
    • On the backup storage, the images that you created can be accessed according to the corresponding backup storage path, and can be copied to other cloud environments for direct use.
  3. Ceph
    • Image files are stored by means of Ceph distributed block storages.
    • Snapshots and images can be created when VM instances are running or stopped.
    • When VM instances are cloned without data volumes, the VM instances that are running, paused, or stopped can be cloned.
    • VM instances cannot be cloned with data volumes.
    • Images can only be exported on backup storages.

      Assume that the image path you use is ceph://bak-t-c9923f9821bf45498fdf9cdfa1749943/61ece0adc7244b0cbd12dafbc5494f0c.

      Then, run the following commands on the backup storage:
      rbd export -p bak-t-c9923f9821bf45498fdf9cdfa1749943 --image 61ece0adc7244b0cbd12dafbc5494f0c --path /root/export-test.image  # bak-t-c9923f9821bf45498fdf9cdfa1749943 is the name of the pool where the image resides. # 61ece0adc7244b0cbd12dafbc5494f0c is the image name. # /root/export-test.image is the name of the exported target file.

Backup Storage | Primary Storage

The types of both primary storage and backup storage are strongly associated, as shown in Relations Between Backup Storage and Primary Storage.
Table 1. Relations Between Primary Storage and Backup Storage
PS/BS ImageStore SFTP Ceph
LocalStorage ×
NFS ×
Shared Mount Point ×
Ceph ×
Shared Block × ×
  • When primary storages are LocalStorage, NFS, or Shared Mount Point, the default type for backup storages is ImageStore, or SFTP.
  • When primary storages are NFS or Shared Mount Point, the corresponding shared directories can be manually attached to the local directories of the corresponding backup storages. In this regard, both primary storages and backup storages can use the network shared storage.
  • When primary storages are Ceph, backup storages can use the primary storages in the same Ceph cluster as backup storages. In addition, backup storages can use the primary storages with the ImageStore type as backup storages.
  • When primary storages are Shared Block, the default type for backup storages is ImageStore.

Inventory

Backup Storage Inventory

Name Description Optional Optional Value Starting Version
uuid The UUID. For more information, see Resource Property. 0.6
name The name. For more information, see Resource Property. 0.6
description The description. For more information, see Resource Property. Yes 0.6
url The URL. For more information, see URL. 0.6
totalCapacity The total disk capacity. Unit: byte. For more information, see Capacity. 0.6
availableCapacity The available disk capacity. Unit: byte. For more information, see Capacity. 0.6
type The backup dotage type.
  • Ceph
  • ImageStoreBackupStorage
  • VCenter
  • SftpBackupStorage
0.6
state The state. For more information, see State.
  • Enabled
  • Disabled
0.6
status The status. For more information, see Status.
  • Connecting
  • Connected
  • Disconnected
0.6
attachedZoneUuids The UUIDs of zones to which the backup storage is attached. 0.6
createDate The creation date. For more information, see Resource Property. 0.6
lastOpDate The last operation date. For more information, see Resource Property. 0.6

Sample

{     "inventories": {             "attachedClusterUuids": [                 "967a353c2893409dab9312cf3033a98c"             ],             "availableCapacity": 163634831360,             "availablePhysicalCapacity": 186066427904,             "createDate": "Oct 30, 2017 3:05:29 PM",             "description": "",             "lastOpDate": "Oct 31, 2017 10:41:26 AM",             "mountPath": "/zstack_ps",             "name": "LS-1",             "state": "Enabled",             "status": "Connected",             "systemUsedCapacity": 9330311168,             "totalCapacity": 205177397248,             "totalPhysicalCapacity": 205177397248,             "type": "LocalStorage",             "url": "/zstack_ps",             "uuid": "037bd212f7a1488da4f94360ccfaf6ab",             "zoneUuid": "e59b71e99d8a4ea1952b578388b8cd1d"         } }

Image Replication Group Inventory

Name Description Optional Optional Value Starting Version
uuid The UUID. For more information, see Resource Property. 3.5.0
name The name. For more information, see Resource Property. 3.5.0
description The description. For more information, see Resource Property. Yes 3.5.0
state The state.
  • Enabled
  • Disabled
3.5.0
backupStorageRefs The backup storage group list. 3.5.0
groupBy Groups rows into subgroups based on values of columns or expressions. This field is equivalent to the Group By clause in MySQL, such as groupBy=type. Yes 3.5.0
createDate The create date. For more information, see Resource Property. 3.5.0
lastOpDate The last operation date. For more information, see Resource Property. 3.5.0
userTags The user tags. For more information, see CreateUserTag. Yes 3.5.0
systemTags The system tags. For more information, see CreateSystemTag. Yes 3.5.0
Sample
{   "inventories": [     {       "uuid": "31cbc4dad8da3ca6a6e3df5c1d5f233e",       "name": "test"     }   ] }

URL

A URL is a string that contains information needed by backup storage to control storage systems. Although its name is URL, the exact format of the string is up to backup storage types and is not necessary to strictly follow the URL convention. This gives flexibilities to plugins to encode information that may not be able to fit in the URL format.

SFTP Backup Storage URL

For an SFTP back storage (also known as backup storage), the URL is an absolute path of a directory in a file system, such as /storage/sftp.

Capacity

ZStack monitors disk capacities of backup storages to select one suitable backup storage for creating volumes. Different backup storage plugins may report different disk capacities. The capacity of a backup storage is calculated according to the following formulas:
totalCapacity = backup storage's total capacity availableCapacity = totalCapacity - sum (images' actual sizes)

State

A backup storages has the following two states:
  • Enabled:

    Indicates that images can be registered, backed up, and downloaded.

  • Disabled:

    Indicates that images cannot be registered, backed up, or downloaded. Especially, if an image is only stored on a disabled backup storage, and if the image is not downloaded to image caches of primary storage, this image cannot be used to create VM instances.

Status

The status of a backup storage reflects the command channel status between a ZStack management node and a backup storage.
  • Connecting:

    Indicates that a ZStack management node is trying to establish a command channel between the node itself and a backup storage. At this stage, you cannot perform any operation on the backup storage.

  • Connected:

    Indicates that the command channel between a ZStack management node and a backup storage is established successfully. At this stage, you can perform related operations on the backup storage.

  • Disconnected:

    Indicates that the command channel between a ZStack management node and a backup storage is lost. At this stage, you cannot perform any operation on the backup storage.

When a ZStack management node starts, the management node will try to establish command channels to backup storages. When the management node is running, it will periodically send ping commands to the backup storages to check the health status of command channels. Once a backup storage fails to respond, or a ping command times out, the status of the backup storage will be changed to Disconnected.

The status transition diagram of a backup storage is shown in Status Transition Diagram of Backup Storage.

Figure 1. Status Transition Diagram of Backup Storage




























Back to Top

Download

Already filled the basic info?Click here.

Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

An email with a verification code will be sent to you. Make sure the address you provided is valid and correct.

Download

Not filled the basic info yet? Click here.

Invalid email address or mobile number.

Email Us

contact@zstack.io
ZStack Training and Certification
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io
Request Trial
Enter at least 2 characters.
Invalid mobile number.
Enter at least 4 characters.
Invalid email address.
Wrong code. Try again. Send Code Resend Code (60s)

Email Us

contact@zstack.io

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder. After receiving the email, click the URL to download the documentation.

The download link is sent to your email address.

If you don't see it, check your spam folder, subscription folder, or AD folder.
Or click on the URL below. (For Internet Explorer, right-click the URL and save it.)

Thank you for using ZStack products and services.

Submit successfully.

We'll connect soon.

Thank you for using ZStack products and services.