- Oracle ZFS Storage Appliance Administration Guide, Release OS8.8.x
- Remote Replication
- Configuring Remote Replication
- Configuring Offline Replication (CLI)
- Reversing an Offline Replication (CLI)
Reversing an Offline Replication (CLI)
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 entercommit
: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 Nov 21 2019 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. Entercommit
and then entersendupdate
: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 Nov 21 2019 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
displayssuccess
.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 Nov 22 2019 22:11:32 GMT+0000 (UTC) last_try = Fri Nov 22 2019 22:11:32 GMT+0000 (UTC) last_result = success
Related Topics