From 28f6ec1d7efdb6a70654bbfe87bdbb0f644e43b4 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 13 Sep 2023 16:41:49 +0530 Subject: [PATCH 01/11] snapshot: copy, multi-zone replica Feature PR: https://github.com/apache/cloudstack/pull/7873 Signed-off-by: Abhishek Kumar --- source/adminguide/storage.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index dfeb5b8814..5076d6bfe0 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -798,6 +798,9 @@ to a VM. A completed snapshot is copied from primary storage to secondary storage, where it is stored until deleted or purged by newer snapshot. +Users can also select the desired zones at the time of taking manual snapshots or while creating a snapshot policy. +When additional zone(s) are selected and snapshot backup is allowed, the snapshot will be first copied to the secondary storage of the native zone and then copied to the additional zone(s) from there. + How to Snapshot a Volume ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -924,6 +927,14 @@ a snapshot request will wait in the queue. If this limit is reached, the snapshot request fails and returns an error message. +Snapshot Copy +------------- + +CloudStack allows copying an exisiting backed-up snapshot to multiple zones. +Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). +Snapshot copies can be used for disastser recovery and creating volumes and templates in the specific zone. + + VMware Volume Snapshot Performance ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From a234aee2f4ef80d54d946e26888fd65609b4ce15 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 13 Sep 2023 16:46:33 +0530 Subject: [PATCH 02/11] add Signed-off-by: Abhishek Kumar --- source/adminguide/storage.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 5076d6bfe0..d03edbb8d6 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -933,6 +933,7 @@ Snapshot Copy CloudStack allows copying an exisiting backed-up snapshot to multiple zones. Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). Snapshot copies can be used for disastser recovery and creating volumes and templates in the specific zone. +Later if not needed, these copies or replicas can be individually deleted without affecting other replicas. VMware Volume Snapshot Performance From 773ae20536a29ddc0db1421683154c45107fb36d Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Fri, 15 Sep 2023 15:02:34 +0530 Subject: [PATCH 03/11] Update source/adminguide/storage.rst Co-authored-by: Harikrishna --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index d03edbb8d6..dd15961df7 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -928,7 +928,7 @@ snapshot request fails and returns an error message. Snapshot Copy -------------- +~~~~~~~~~~~~~``` CloudStack allows copying an exisiting backed-up snapshot to multiple zones. Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). From e73316fd20ec9e3d67ddc13a30125b4e7d1b3539 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Fri, 15 Sep 2023 15:03:05 +0530 Subject: [PATCH 04/11] Update source/adminguide/storage.rst --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index dd15961df7..dfa9c90c4d 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -928,7 +928,7 @@ snapshot request fails and returns an error message. Snapshot Copy -~~~~~~~~~~~~~``` +~~~~~~~~~~~~ CloudStack allows copying an exisiting backed-up snapshot to multiple zones. Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). From 8b87f19bfb46b513667b38705638ce763dc40ac4 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Fri, 15 Sep 2023 15:03:27 +0530 Subject: [PATCH 05/11] Update source/adminguide/storage.rst --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index dfa9c90c4d..6c5ffb771a 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -928,7 +928,7 @@ snapshot request fails and returns an error message. Snapshot Copy -~~~~~~~~~~~~ +~~~~~~~~~~~~~ CloudStack allows copying an exisiting backed-up snapshot to multiple zones. Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). From b99c3e4f674600743eda04db13723e057abac280 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Thu, 12 Oct 2023 18:05:01 +0530 Subject: [PATCH 06/11] note for snapshot revert and volume creation Signed-off-by: Abhishek Kumar --- source/adminguide/storage.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 6c5ffb771a..e5074d0ead 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -896,6 +896,12 @@ recovered as needed. Alternatively, a template may be created from the snapshot of a root disk. The user can then boot a VM from this template to effect recovery of the root disk. +Some hypervisor and storage combinations also allow revert snapshot operation. In such cases **Revert to snapshot** action for a snapshot in the UI or `revertSnapshot` API can be used to revert the volume of the snapshot to the particular snapshot. It should be noted that, when supported by hypervisor and storage combination, snapshot must be available in the same zone in which volume is present. + +.. note:: + When creating a volume from a snapshot of a DATA disk, it should be noted that the volume's disk offering must be accessible in the target zone. In case the disk offering is using storage tags then such tagged storage resources must be available in the target zone. + + Snapshot Job Throttling ~~~~~~~~~~~~~~~~~~~~~~~ From 85f5a43e8eacf3d264a4447aedb3e4bb69255040 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Fri, 13 Oct 2023 11:19:39 +0530 Subject: [PATCH 07/11] refactor Signed-off-by: Abhishek Kumar --- source/adminguide/storage.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index e5074d0ead..473f344d25 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -896,7 +896,7 @@ recovered as needed. Alternatively, a template may be created from the snapshot of a root disk. The user can then boot a VM from this template to effect recovery of the root disk. -Some hypervisor and storage combinations also allow revert snapshot operation. In such cases **Revert to snapshot** action for a snapshot in the UI or `revertSnapshot` API can be used to revert the volume of the snapshot to the particular snapshot. It should be noted that, when supported by hypervisor and storage combination, snapshot must be available in the same zone in which volume is present. +Some hypervisor and storage combinations also allow for Instances and volumes to be reverted from snapshots. In such cases the **Revert to snapshot** action for a snapshot in the UI or the `revertSnapshot` API can be used to restore the volume to a particular snapshot. It should be noted that, when supported by the combination of hypervisor and storage, the snapshot must be available in the zone in which volume to be restored is present. .. note:: When creating a volume from a snapshot of a DATA disk, it should be noted that the volume's disk offering must be accessible in the target zone. In case the disk offering is using storage tags then such tagged storage resources must be available in the target zone. From a09f56c927ed4cd95f667c7e1f16faf84d83f30d Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 23 Oct 2023 13:16:27 +0530 Subject: [PATCH 08/11] Update source/adminguide/storage.rst Co-authored-by: dahn --- source/adminguide/storage.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 473f344d25..accf536a9f 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -798,8 +798,10 @@ to a VM. A completed snapshot is copied from primary storage to secondary storage, where it is stored until deleted or purged by newer snapshot. -Users can also select the desired zones at the time of taking manual snapshots or while creating a snapshot policy. -When additional zone(s) are selected and snapshot backup is allowed, the snapshot will be first copied to the secondary storage of the native zone and then copied to the additional zone(s) from there. +Users can also select the desired zones at the time of taking manual snapshots +or while creating a snapshot policy. When additional zone(s) are selected and +snapshot backup is allowed, the snapshot will be first copied to the secondary +storage of the native zone and then copied to the additional zone(s) from there. How to Snapshot a Volume ~~~~~~~~~~~~~~~~~~~~~~~~ From 875243ea08fbda6ea6f271ed2ecf9da66007210b Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 23 Oct 2023 13:16:52 +0530 Subject: [PATCH 09/11] Update source/adminguide/storage.rst Co-authored-by: dahn --- source/adminguide/storage.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index accf536a9f..c48ca7c1bb 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -901,7 +901,10 @@ to effect recovery of the root disk. Some hypervisor and storage combinations also allow for Instances and volumes to be reverted from snapshots. In such cases the **Revert to snapshot** action for a snapshot in the UI or the `revertSnapshot` API can be used to restore the volume to a particular snapshot. It should be noted that, when supported by the combination of hypervisor and storage, the snapshot must be available in the zone in which volume to be restored is present. .. note:: - When creating a volume from a snapshot of a DATA disk, it should be noted that the volume's disk offering must be accessible in the target zone. In case the disk offering is using storage tags then such tagged storage resources must be available in the target zone. + When creating a volume from a snapshot of a DATA disk, it should be noted that + the volume's disk offering must be accessible in the target zone. In case the disk + offering is using storage tags then such tagged storage resources must be available + in the target zone. From e57b2f55ac5e4f3194e06970c0cf7bc76ea6a907 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 23 Oct 2023 13:17:03 +0530 Subject: [PATCH 10/11] Update source/adminguide/storage.rst Co-authored-by: dahn --- source/adminguide/storage.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index c48ca7c1bb..39e5e47e43 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -898,7 +898,12 @@ recovered as needed. Alternatively, a template may be created from the snapshot of a root disk. The user can then boot a VM from this template to effect recovery of the root disk. -Some hypervisor and storage combinations also allow for Instances and volumes to be reverted from snapshots. In such cases the **Revert to snapshot** action for a snapshot in the UI or the `revertSnapshot` API can be used to restore the volume to a particular snapshot. It should be noted that, when supported by the combination of hypervisor and storage, the snapshot must be available in the zone in which volume to be restored is present. +Some hypervisor and storage combinations also allow for Instances and volumes +to be reverted from snapshots. In such cases the **Revert to snapshot** action for +a snapshot in the UI or the `revertSnapshot` API can be used to restore the volume +to a particular snapshot. It should be noted that, when supported by the combination +of hypervisor and storage, the snapshot must be available in the zone in which volume +to be restored is present. .. note:: When creating a volume from a snapshot of a DATA disk, it should be noted that From a09bd959a2e57778a39e047feef99f5b7517a5a9 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 23 Oct 2023 13:17:10 +0530 Subject: [PATCH 11/11] Update source/adminguide/storage.rst Co-authored-by: dahn --- source/adminguide/storage.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/source/adminguide/storage.rst b/source/adminguide/storage.rst index 39e5e47e43..a148e90f97 100644 --- a/source/adminguide/storage.rst +++ b/source/adminguide/storage.rst @@ -947,9 +947,11 @@ Snapshot Copy ~~~~~~~~~~~~~ CloudStack allows copying an exisiting backed-up snapshot to multiple zones. -Users can either use the UI in the snapshot details view or the `copySnapshot` API to copy a snapshot from one zone to other zone(s). -Snapshot copies can be used for disastser recovery and creating volumes and templates in the specific zone. -Later if not needed, these copies or replicas can be individually deleted without affecting other replicas. +Users can either use the UI in the snapshot details view or the `copySnapshot` +API to copy a snapshot from one zone to other zone(s). Snapshot copies can +be used for disastser recovery and creating volumes and templates in the +specific zone. Later if not needed, these copies or replicas can be individually +deleted without affecting other replicas. VMware Volume Snapshot Performance