Oracle ZFS Storage Appliance: Cannot Mount a Replicated Share on a OEL 7.x Client DB after upgrading to OS8.7.4

Asset ID:	1-72-2302139.1
Update Date:	2017-09-04
Keywords:

Solution Type Problem Resolution Sure

Solution 2302139.1 : Oracle ZFS Storage Appliance: Cannot Mount a Replicated Share on a OEL 7.x Client DB after upgrading to OS8.7.4

Applies to:

Oracle ZFS Storage ZS5-4 - Version All Versions and later
Oracle ZFS Storage ZS5-2 - Version All Versions and later
Oracle ZFS Storage Appliance Racked System ZS5-2 - Version All Versions and later
Oracle ZFS Storage ZS4-4 - Version All Versions and later
Oracle ZFS Storage Appliance Racked System ZS4-4 - Version All Versions and later
7000 Appliance OS (Fishworks)
Client DB can not mount replica shares after upgrading appliance to OS8.7.4.
Note: All DB clients Solaris & Linux will exhibit this issue because the exported=true change is done on the ZS3-2 appliance side.

Symptoms

Client DB can not mount replica shares

Changes

Just upgraded to OS8.7.4.

Cause

The reason users were able to mount the replica shares before was a bug.

Bug 22495784 - REPLICATED TARGETS CAN BE MOUNTED BY CLIENTS WITHOUT BEING EXPORTED

See also Doc ID 2138772.1 (Replication target shares can be mounted in read/write mode without having the exported flag set)

The above bug and document show the mount behavior on the old firmware which is fixed in OS8.7.0 (and later) versions.

That is the reason why - after customer upgraded to OS8.7.4 - they could not mount the replica shares.

Solution

Set export = true on the project.

Below are the steps to set export to true on the project and mount.

zs3-2-brm06-a:shares replication packages> select package-001
zs3-2-brm06-a:shares replication package-001> show

zs3-2-brm06-a:shares replication package-001> select backups
zs3-2-brm06-a:shares replication package-001 backups> show

zs3-2-brm06-a:shares replication package-001 backups> set exported=true
exported = true (uncommitted)

Once you have run the above commands to set export = true , on the DB client, run dfshares with the IP address of the appliance to display the exported shares:

# dfshares <IPaddress_of_ZFS_appliance>

Then proceed to mount the replica share:

# mount /mnt/zfs/replica_share_name

References

<BUG:22495784> - REPLICATED TARGETS CAN BE MOUNTED BY CLIENTS WITHOUT BEING EXPORTED
<NOTE:2138772.1> - Oracle ZFS Storage Appliance: Replication target shares can be mounted in read/write mode without having the exported flag set

Attachments

This solution has no attachment