From 12a3e205078e6fb6a51baae5491c9f167274d823 Mon Sep 17 00:00:00 2001 From: Helen Walsh Date: Tue, 14 Sep 2021 17:14:14 +0100 Subject: [PATCH] PowerMax Docs - Clarify Replication Group Clarification on how to set up a replication group for the PowerMax driver. Change-Id: I50fc926275dec1360fc3880bbfb8780078e01bce --- .../drivers/dell-emc-powermax-driver.rst | 47 +++++++++++++++++-- 1 file changed, 43 insertions(+), 4 deletions(-) diff --git a/doc/source/configuration/block-storage/drivers/dell-emc-powermax-driver.rst b/doc/source/configuration/block-storage/drivers/dell-emc-powermax-driver.rst index 1dedd7ff5c5..232bd9dfea9 100644 --- a/doc/source/configuration/block-storage/drivers/dell-emc-powermax-driver.rst +++ b/doc/source/configuration/block-storage/drivers/dell-emc-powermax-driver.rst @@ -2676,30 +2676,69 @@ commands are not listed in the latest Cinder CLI documentation so will remain here until added to the latest Cinder CLI version or deprecated from Cinder. +This is how to create a replication group. +Please refer to the official OpenStack `block-storage groups`_ documentation +for the most up to date group operations. + +- Make sure there is a `replication_device` for Synchronous in `cinder.conf` + +.. code-block:: console + + replication_device = backend_id:backend_id_legacy_rep,target_device_id:0001234567890,remote_port_group:PG1,remote_pool:SRP_1,rdf_group_label:os-sync,mode:Synchronous + +- Create a volume type with property `replication_enabled=’ True’`. + +.. code-block:: console + + $ openstack volume type create --property replication_enabled=' True' SYNC_REP_VT + +- Create a Generic group type with extra specs + `consistent_group_snapshot_enabled=’ True’` and + `consistent_group_replication_enabled=’ True’`. + +.. code-block:: console + + $ cinder --os-volume-api-version 3.38 group-type-create GROUP_REP_VT + $ cinder --os-volume-api-version 3.38 group-type-key GROUP_REP_VT set \ + consistent_group_snapshot_enabled=' True' \ + consistent_group_replication_enabled=' True' + +- Create a Generic group with synchronous volume type SYNC_REP_VT + +.. code-block:: console + + $ cinder --os-volume-api-version 3.13 group-create --name GROUP_REP GROUP_REP_VT GROUP_REP_VT + +- Create a volume in the Generic group + +.. code-block:: console + + $ cinder --os-volume-api-version 3.38 create --volume-type SYNC_REP_VT --group-id GROUP_REP \ + --name VOL_REP_GROUP 1 - Enable group replication .. code-block:: console - cinder --os-volume-api-version 3.38 group-enable-replication GROUP + $ cinder --os-volume-api-version 3.38 group-enable-replication GROUP_REP - Disable group replication .. code-block:: console - cinder --os-volume-api-version 3.38 group-disable-replication GROUP + $ cinder --os-volume-api-version 3.38 group-disable-replication GROUP_REP - Failover group .. code-block:: console - cinder --os-volume-api-version 3.38 group-failover-replication GROUP + $ cinder --os-volume-api-version 3.38 group-failover-replication GROUP_REP - Failback group .. code-block:: console - cinder --os-volume-api-version 3.38 group-failover-replication GROUP / + $ cinder --os-volume-api-version 3.38 group-failover-replication GROUP_REP \ --secondary-backend-id default