Oracle ZFS Storage Appliance: Share Inheritance Replication Limitations can lead to Replication Failure under code older than 2013.x.

Asset ID:	1-72-1636213.1
Update Date:	2018-01-05
Keywords:

Solution Type Problem Resolution Sure

Solution 1636213.1 : Oracle ZFS Storage Appliance: Share Inheritance Replication Limitations can lead to Replication Failure under code older than 2013.x.

Applies to:

Sun ZFS Storage 7320 - Version All Versions to All Versions [Release All Releases]
Sun ZFS Storage 7420 - Version All Versions to All Versions [Release All Releases]
Sun Storage 7410 Unified Storage System - Version All Versions to All Versions [Release All Releases]
Sun Storage 7110 Unified Storage System - Version All Versions to All Versions [Release All Releases]
Sun Storage 7210 Unified Storage System - Version All Versions to All Versions [Release All Releases]
7000 Appliance OS (Fishworks)

Symptoms

From a replication action if a share is excluded, the subsequent updates will work fine.

If we then try to include the same share back into the old replication action by inheriting the replication property from the project , the entire project level replication fails.

Changes

Example of how to reproduce this issue under 2011.1 code:

test-appliance01:shares default> list filesystem

Filesystems:

NAME             SIZE    MOUNTPOINT
test01           92.0K   /export/test01
test02           92.0K   /export/test02

test-appliance01:shares default> select test02 replication

test-appliance01:shares default/test02 replication> set inherited=false

                     inherited = false (uncommitted)

test-appliance01:shares default/test02 replication> commit

Uninheriting the replication configuration from the project means that the
share will no longer be replicated with the parent project and other shares
inheriting the project's configuration, but rather it will be replicated
separately. The replication configuration of the project will no longer apply
to this share; you will need to create new replication actions in order to
replicate it to other appliances. All existing replicas of this share on all
targets will be unaffected by this operation. Such replicas will NOT be used
for subsequent incremental updates. The share will need to be replicated with a
full update for each new action that is created.

Are you sure? (Y/N)

test-appliance01:shares default/test02 replication> ls

Properties:
                     inherited = false

test-appliance01:shares default/test02 replication> cd ../..

test-appliance01:shares default> replication select action-000

test-appliance01:shares default action-000> sendupdate

test-appliance01:shares default action-000> ls

Properties:
                            id = cdc20858-5aa9-e19c-8ddb-c6398a3e45f2
                        target = 10.xxx.xx.xxx
                       enabled = true
                    continuous = false
                 include_snaps = true
                 max_bandwidth = unlimited
                       use_ssl = true
                         state = idle
             state_description = Idle (no update pending)
                   next_update = manual
                     last_sync = Fri May 02 2014 04:14:23 GMT+0000 (UTC)
                      last_try = Fri May 02 2014 04:14:23 GMT+0000 (UTC)
                   last_result = success

test-appliance01:shares default action-000> cd ..

test-appliance01:shares default replication> cd ..

test-appliance01:shares default> select test02 replication

test-appliance01:shares default/test02 replication> set inherited=true

                     inherited = true (uncommitted)

test-appliance01:shares default/test02 replication> commit

Inheriting the replication configuration from the project means that the share
will no longer be replicated on its own, but rather it will be replicated with
the project and all other shares inheriting this project's configuration. All
replication configuration previously associated with this share will be
destroyed. All existing replicas of this share on all targets will be
unaffected by this operation. Such replicas will NOT be used for future
replication updates. The share will be replicated with a full update for each
of the project's replication actions.

Are you sure? (Y/N)

test-appliance01:shares default/test02 replication> cd ../..

test-appliance01:shares default> replication select action-000

test-appliance01:shares default action-000> sendupdate

test-appliance01:shares default action-000> ls

Properties:
                            id = cdc20858-5aa9-e19c-8ddb-c6398a3e45f2
                        target = 10.xxx.xx.xxx
                       enabled = true
                    continuous = false
                 include_snaps = true
                 max_bandwidth = unlimited
                       use_ssl = true
                         state = idle
             state_description = Idle (no update pending)
                   next_update = manual
                     last_sync = Fri May 02 2014 04:14:23 GMT+0000 (UTC)
                      last_try = Fri May 02 2014 04:16:24 GMT+0000 (UTC)
                   last_result = The most recent replication update failed. No additional information is available. Check replication status on the target system. See the replication documentation for more details.

Cause

This is a known limitation within the Oracle ZFS Storage Appliance code versions from 2011.x and older.

This limitation is no longer present in 2013.x and higher Appliance Firmware Releases.

Solution

There is no workaround to resolve the replication failure once you hit this issue.

The only way to proceed is to re-create the replication action and ensure you do not re-inherit a previously un-inherited share if running 2011.1.x or earlier code.

If your particular appliance model supports 2013.x and higher Appliance Firmware Releases - and you require this feature - it is recommended that you upgrade to the latest 2013 release available.

References

<BUG:17557575> - SHARE UNINHERIT/INHERIT CAUSES REPLICATION FAILURE
<NOTE:1513423.1> - Sun Storage 7000 Unified Storage System: How To Upgrade the Appliance Kit Software and Service Processor BIOS/ILOM Firmware
<NOTE:1397959.1> - Sun Storage 7000 Unified Storage System: How to Troubleshoot Replication Issues

Attachments

This solution has no attachment