Reversing an Offline Replication (CLI)

Language:

Follow this procedure to move an offline replication package to a new local project, configured to replicate back to a source appliance.

Before You Begin

Import the offline replication stream from an NFS server to the replication target, as described in Importing a Replication Stream from the NFS Server (CLI).

From the replication target, navigate to the replicated package and locate the project:

target:> shares replication packages
target: shares replication packages> select package-000
target:shares replication package-000> ls
Properties:

                            id = 1c0457eb-45bd-4f91-8e08-bc0dbacd40b7
                   source_name = bigfish78
                    source_asn = d1fce51d-b8a9-6cf8-d71e-fcd4fe42cd0e
                     source_ip = 10.000.000.000:216
                   target_pool = poolA
                    replica_of = proj1
                       enabled = true
                         state = idle
             state_description = Idle (no update in progress)
                       offline = false
                   import_path =
                data_timestamp = Thu Feb 16 2017 19:10:59 GMT+0000 (UTC)
                     last_sync = Fri Feb 17 2017 03:10:11 GMT+0000 (UTC)
                      last_try = Fri Feb 17 2017 03:10:11 GMT+0000 (UTC)
                   last_result = success


Projects:
                         proj1

Enter pkgreverse.

target:shares replication package-000> pkgreverse

(Optional) Set a new project name and enable the action using the following commands:
```
target:shares replication package-000 pkgreverse> set new_project_name=new-kmm3
              new_project_name = new-kmm3
target:shares replication package-000 pkgreverse> set enable_action_upon_reversal=true
   enable_action_upon_reversal = true
```
Note - The project name must be unique on the appliance where the reverse operation is performed. If a project with the same name exists on the appliance at the production site, the reverse operation will fail.

Enter show to confirm the properties, and then enter commit:

target:shares replication package-000 pkgreverse> show
Properties:
              new_project_name = new-kmm3
   enable_action_upon_reversal = true

host-prod:shares replication package-000 pkgreverse> commit
This action will move the contents of this package to a new local project
configured to replicate back to the source. Any data or metadata changes made
on the source since the last successful update will be lost when the new
project is replicated back to the source. If replication actions on the source
are not disabled, future updates to this package will fail.

Navigate to shares replication actions.

target:shares replication packages> cd /
target:> shares replication actions

Select the newly created action using the package ID from the previous steps.

Use the package ID as origin_pkg_id to select the action.

target:shares replication actions> select origin_pkg_id=
1c0457eb-45bd-4f91-8e08-bc0dbacd40b7
target:shares replication action-000> ls
Properties:
                            id = 6a10ce61-cc87-4850-89dd-8673f7734d03
                 origin_pkg_id = 1c0457eb-45bd-4f91-8e08-bc0dbacd40b7
                        target = new_target
                   target_pool = p
                   source_pool = p
                replication_of = dataset1
                       enabled = true
                    continuous = false
                 include_snaps = false
   retain_user_snaps_on_target = false
                         dedup = false
  include_clone_origin_as_data = false
                 max_bandwidth = unlimited
                    bytes_sent = 0
                estimated_size = 0
           estimated_time_left = 00:00:00
            average_throughput = 0B/s
                       use_ssl = false
                   compression = on
                   export_path = 
                         state = idle
             state_description = Idle (no update in progress)
                export_pending = false
                       offline = false
                   next_update = Sync now
        replica_data_timestamp = Thu Feb 09 2017 16:17:25 GMT+0000 (UTC)
                     last_sync = <unknown>
                      last_try = <unknown>
                   last_result = <unknown>
                   replica_lag = 461:55:40
      recovery_point_objective =
     replica_lag_warning_alert =
       replica_lag_error_alert =
replica_lag_over_warning_limit = false
  replica_lag_over_error_limit = false

To export the first replication update after reversal to an NFS server, enter export_path and the pathname of the NFS server. Enter commit and then enter sendupdate:

target:shares replication action-000> set export_path=nfs://nfs_server/export/init_repl
                   export_path = nfs://nfs_server/export/init_repl (uncommitted)
target:shares replication action-000> commit
target:shares replication action-000> sendupdate
target:shares replication action-000> ls
Properties:
                            id = 6a10ce61-cc87-4850-89dd-8673f7734d03
                 origin_pkg_id = 1c0457eb-45bd-4f91-8e08-bc0dbacd40b7
                        target = new_target
                   target_pool = p
                   source_pool = p
                replication_of = dataset1
                       enabled = true
                    continuous = false
                 include_snaps = false
   retain_user_snaps_on_target = false
                         dedup = false
  include_clone_origin_as_data = false
                 max_bandwidth = unlimited
                    bytes_sent = 0
                estimated_size = 0
           estimated_time_left = 00:00:00
            average_throughput = 0B/s
                       use_ssl = false
                   compression = on
                   export_path = nfs://nfs_server/export/init_repl
                         state = idle
             state_description = Idle (no update in progress)
                export_pending = false
                       offline = false
                   next_update = Sync now
        replica_data_timestamp = Thu Feb 09 2017 16:17:25 GMT+0000 (UTC)
                     last_sync = <unknown>
                      last_try = <unknown>
                   last_result = <unknown>
                   replica_lag = 461:55:40
      recovery_point_objective =
     replica_lag_warning_alert =
       replica_lag_error_alert =
replica_lag_over_warning_limit = false
  replica_lag_over_error_limit = false

After the replication update is complete, navigate to the newly reversed package on the new target. The state description should be Idle, as shown in the example:
```
new_target:shares replication packages> ls
Packages:

ID          STATE DATA_TIMESTAMP      SOURCE     DATASET
package-000 idle  unknown             target     <unknown>
```

Select the package and enter ls to list its properties.

new_target:shares replication packages> select package-000
new_target:shares replication package-000> ls

Properties:
                            id = 6a10ce61-cc87-4850-89dd-8673f7734d03
                   source_name = target
                    source_asn = ddbd5d4e-daff-4f52-9417-cd6e893c694a
                     source_ip = 00.000.00.000:216
                   source_pool = poolA
                   target_pool = poolA
                    replica_of = <unknown>
                       enabled = true
                         state = idle
             state_description = Idle (no update in progress)
                       offline = true
                   import_path =
                data_timestamp = unknown
                     last_sync = unknown
                      last_try = unknown
                   last_result = unknown

Import the update from the NFS server.

new_target:shares replication package-000> set import_path=nfs://nfs_server/export/init_repl
                   import_path = nfs://nfs_server/export/init_repl (uncommitted)

Enter commit and then list the package properties to confirm the update has completed.

The property last_result displays success.

new_target:shares replication package-000> commit
new_target:shares replication package-000> ls
Properties:
                            id = 6a10ce61-cc87-4850-89dd-8673f7734d03
                   source_name = target
                    source_asn = ddbd5d4e-daff-4f52-9417-cd6e893c694a
                     source_ip = 00.000.00.000:216
                   source_pool = poolA
                   target_pool = poolA
                    replica_of = <unknown>
                       enabled = true
                         state = idle
             state_description = Idle (no update in progress)
                       offline = false
                   import_path =
                data_timestamp = unknown
                     last_sync = Fri Jul 31 2015 22:11:32 GMT+0000 (UTC)
                      last_try = Fri Jul 31 2015 22:11:32 GMT+0000 (UTC)
                   last_result = success

Related Topics