Oracle ZFS Storage Appliance: ZFS Data Zpool Version Matrix

Asset ID:	1-71-2051599.1
Update Date:	2018-03-28
Keywords:

Solution Type Technical Instruction Sure

Solution 2051599.1 : Oracle ZFS Storage Appliance: ZFS Data Zpool Version Matrix

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]
Oracle ZFS Storage ZS3-4 - Version All Versions to All Versions [Release All Releases]
Oracle ZFS Storage ZS3-2 - Version All Versions to All Versions [Release All Releases]
7000 Appliance OS (Fishworks)

Goal

How to upgrade the data zpool version and what zpool version is included with what version of AK code.

Solution

On the array, the zpool version for the data zpool is controlled by deferred updates.

Zpool data pool versions are usually changed to include fixes or to include enhancements to ZFS functionality.

By applying a deferred update for a new AK code version the data zpool version gets updated.

A deferred update will show up on the maintenance system updates page if it is available for that ak code version.

Please see this document on how to apply deferred updates:

Sun Storage 7000 Unified Storage System: How to Apply Deferred Updates (Doc ID 1333116.1)

NOTE: If a pool is being shown at a lower version for that code revision CHECK to make sure all deferred updates have been applied.

The data zpool version can be found in the support bundles under cifs/cifs.out or in the zfs/mdb.out files.

The command zpool get version <poolname> can be run at the shell on the array to directly get the pool version:

s7120-a# zpool get version PuffDaddy
NAME PROPERTY VALUE SOURCE
PuffDaddy version 32 local

To see the zpool version features for a ak code version type this:

s7120-a# zpool upgrade -v

For reference, below is the zpool version vs. AK code version matrix:

ZFS Pool Version	AK Code Version
43	2013.1.7
35	2013.1.2
32	2013.1.1
31	2011.1
28	2010Q3
22	2010Q1
18	2009Q3
14	2009Q2
13	2008

ZFS Pool Version Features

ZFS Pool Version	Significant Changes
1	First release
2	Ditto Blocks
3	Hot spares, double-parity RAID-Z (raidz2), improved RAID-Z accounting
4	zpool history
5	gzip compression for ZFS datasets
6	"bootfs" pool property
7	ZIL: adds the capability to specify a separate Intent Log device or devices
8	ability to delegate zfs(1M) administrative tasks to ordinary users
9	CIFS server support, dataset quotas
10	Devices can be added to a storage pool as "cache devices"
11	Improved zpool scrub / resilver performance
12	Snapshot properties
13	Properties: usedbysnapshots, usedbychildren, usedbyrefreservation, and usedbydataset
14	passthrough-x aclinherit property support
15	Properties: userquota, groupquota, usuerused and groupused; also required FS v4
16	STMF property support
17	triple-parity RAID-Z
18	ZFS snapshot holds
19	ZFS log device removal
20	zle compression algorithm needed to support deduplication properties in pool version 21
21	Deduplication
22	zfs receive properties
23	slim ZIL
24	System attributes. Symlinks now their own object type. Also requires FS v5.
25	Improved pool scrubbing and resilvering statistics
26	Improved snapshot deletion performance
27	Improved snapshot creation performance (particularly recursive snapshots)
28	Multiple virtual device replacements
29	RAID-Z/mirror hybrid allocator
30	ZFS encryption
31	Improved 'zfs list' performance
32	One MB block support
33	Improved share support
34	Sharing with inheritance
35	Sequential resilver
36	Efficient log block allocation
37	lz4 compression
38	xcopy with encryption
39	reduce resilver restart
40	Deduplication 2
41	Asynchronous dataset destroy
42	Reguid: ability to change the pool guid
43	RAID-Z improvements and cloud device support

NOTE: The array system zpool version for ak code versions up to 8.6.X is 13 and is NOT changed.

NOTE: Appliance Kit code version 8.7.0 upgrades the system zpool version to 33.

Any manual attempt to change the system pool version will render the node unbootable.

Please see: Oracle ZFS Storage Appliance: ZFS System Zpool Version - DO NOT UPGRADE (Doc ID 2055037.1)

References

<NOTE:2055037.1> - Oracle ZFS Storage Appliance: ZFS System Zpool Version - DO NOT UPGRADE
<NOTE:1333116.1> - Sun Storage 7000 Unified Storage System: How to Apply Deferred Updates

Attachments

This solution has no attachment