Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2007 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
zpool upgrade -V
1.2. Name of Document Author/Supplier:
Author: Lin Ling
1.3 Date of This Document:
22 August, 2007
4. Technical Description
A. DESCRIPTION
Currently, zpool version can be upgraded to the latest version using:
zpool upgrade <-a | pool ...>
Or to an intermediate version (which has to be between the current
version and the latest) by using:
zpool set version=N <pool>
(as introduced in PSARC/2007/342, but not yet integrated)
This case proposes to add a flag to "zpool upgrade" to allow the version
number to be specified. The '-V' flag will be used, which is consistent
with the 'zfs upgrade -V' syntax (see PSARC/2007/328).
B. PROPOSED CHANGES
A new flag '-V' will be added to zpool(1M), 'zpool upgrade'.
The upgrade subcommand has the following syntax:
zpool upgrade
zpool upgrade -v
zpool upgrade [-V version] <-a | pool ...>
When [-V version] is specified, zpool upgrade will upgrade the pool
version to the number 'version' (which has to be between the current
version and the latest)
Note: "zpool upgrade -V <version> <pool>" is equivalent to
"zpool set version=<version> <pool>".
C. MANPAGE CHANGES
(1)
zpool upgrade -v
! zpool upgrade [-a | pool]
--- 87,93 ----
zpool upgrade -v
! zpool upgrade [-V version] [-a | pool ...]
(2)
! zpool upgrade [-a | pool]
Upgrades the given pool to the latest on-disk version.
Once this is done, the pool will no longer be accessible
-------
! zpool upgrade [-V version] [-a | pool ...]
Upgrades the given pool to the latest on-disk version.
Once this is done, the pool will no longer be accessible
(3)
-a Upgrades all pools.
+ -V <version> Upgrade to the specified version. If the -V
+ flag is not specified, upgrade to the most
+ recent version. Can only be used to increase
+ the version number, and only up to the most
+ recent version supported by this software.
6. Resources and Schedule
6.4. Steering Committee requested information
6.4.1. Consolidation C-team Name:
ON
6.5. ARC review type: FastTrack
6.6. ARC Exposure: open
