For some NexentaStor releases, new versions of the ZFS software are available for data volumes (or ZFS pools). This happens for upgrades to:
- NexentaStor 3.x from NexentaStor 2.x
- NexentaStor 3.1 from NexentaStor 3.0.x
It is not required that a volume version be upgraded in order to continue to function using its versioned features. However, new functionality can be useful for some use cases.
Caveat Emptor: Once a volume is upgraded, it can no longer be accessed by older versions of NexentaStor that do not support the same version. There is no method for downgrading volume versions.
The list of volume versions and their features is available from NMC:
nmc@myhost:/$ show volume version -h
The following versions are supported:
VER DESCRIPTION
--- --------------------------------------------------------
1 Initial ZFS version
2 Ditto blocks (replicated metadata)
3 Hot spares and double parity RAID-Z
4 zpool history
5 Compression using the gzip algorithm
6 bootfs pool property
7 Separate intent log devices
8 Delegated administration
9 refquota and refreservation properties
10 Cache devices
11 Improved scrub performance
12 Snapshot properties
13 snapused property
14 passthrough-x aclinherit
15 user/group space accounting
16 stmf property support
17 Triple-parity RAID-Z
18 Snapshot user holds
19 Log device removal
20 Compression using zle (zero-length encoding)
21 Deduplication
22 Received properties
23 Slim ZIL
24 System attributes
25 Improved scrub stats
26 Improved snapshot deletion performance
27 Improved snapshot creation performance
28 Multiple vdev replacements
For more information on a particular version, including supported releases,
see the ZFS Administration Guide.
|
NexentaStor releases have volume version support as follows
| NexentaStor Release |
Volume Version |
| 2.2 |
14 |
| 3.0 |
22 |
| 3.0.3 |
26 |
| 3.1 |
28 |
The current volume versions are visible from NMC:
nmc@myhost:/$ show volume mydata version
System volumes' ZFS version: 28.
VOLUME VER COMMENT
mydata 28 Version is up to date
|
In some cases, the volume-check runner will report that a volume can be upgraded. The notification of upgrade is also available from the volume status (or zpool status) commands in NMC.
The volume (pool) status will show a report similar to:
nmc@myhost:/$ show volume status mydata
volume: mydata
state: ONLINE
status: The pool is formatted using an older on-disk format. The pool can
still be used, but some features are unavailable.
action: Upgrade the pool using 'zpool upgrade'. Once this is done, the
pool will no longer be accessible on older software versions.
scan: none requested
config:
NAME STATE READ WRITE CKSUM
mydata ONLINE 0 0 0
c11t0d0 ONLINE 0 0 0
errors: No known data errors
|
To upgrade a volume, use the NMC setup command:
Caveat Emptor: Once a volume is upgraded, it can no longer be accessed by older versions of NexentaStor that do not support the same version. There is no method for downgrading volume versions.
nmc@myhost:/$ show volume mydata version
System volumes' ZFS version: 28.
VOLUME VER COMMENT
mydata 26 The volume is out of date, and can be upgraded. After
upgrade, the volume will no longer be accessible by
older software versions. See usage (-h) for details
nmc@myhost:/$ setup volume mydata upgrade-version
Unexpected option 'upgrade-version'
nmc@myhost:/$ setup volume mydata version-upgrade
Upgrade volume 'mydata' from version '26' to system version '28'? Yes
Volume 'mydata' upgraded to version 28.
|
See also the NMC commands:
- setup volume version version-upgrade
- setup folder version-upgrade
- show volume version
- show appliance syspool
