Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ZPOOL-UPGRADE(8)	    System Manager's Manual	      ZPOOL-UPGRADE(8)

NAME
       zpool-upgrade --	manage version and feature flags of ZFS	storage	pools

SYNOPSIS
       zpool upgrade
       zpool upgrade -v
       zpool upgrade [-V version] -a|pool

DESCRIPTION
       zpool upgrade
	       Displays	pools which do not have	all supported features enabled
	       and  pools  formatted using a legacy ZFS	version	number.	 These
	       pools can continue to be	used, but some	features  may  not  be
	       available.   Use	zpool upgrade -a to enable all features	on all
	       pools (subject to the -o	compatibility property).

       zpool upgrade -v
	       Displays	legacy ZFS versions supported by the this  version  of
	       ZFS.   See zpool-features(7) for	a description of feature flags
	       features	supported by this version of ZFS.

       zpool upgrade [-V version] -a|pool
	       Enables all supported features on the given pool.

	       If the pool has specified compatibility feature sets using  the
	       -o compatibility	property, only the features present in all re-
	       quested	compatibility  sets will be enabled.  If this property
	       is set to legacy	then no	upgrade	will take place.

	       Once this is done, the pool will	no  longer  be	accessible  on
	       systems	  that	  do   not   support   feature	 flags.	   See
	       zpool-features(7) for details  on  compatibility	 with  systems
	       that support feature flags, but do not support all features en-
	       abled on	the pool.

	       -a      Enables all supported features (from specified compati-
		       bility sets, if any) on all pools.

	       -V version
		       Upgrade to the specified	legacy version.	 If specified,
		       no  features  will be enabled on	the pool.  This	option
		       can only	be used	to increase the	version	number	up  to
		       the last	supported legacy version number.

EXAMPLES
   Example 1: Upgrading	All ZFS	Storage	Pools to the Current Version
       The  following  command	upgrades  all ZFS Storage pools	to the current
       version of the software:
	     # zpool upgrade -a
	     This system is currently running ZFS version 2.

SEE ALSO
       zpool-features(7), zpoolconcepts(7), zpoolprops(7), zpool-history(8)

FreeBSD	13.2			March 16, 2022		      ZPOOL-UPGRADE(8)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zpool-upgrade&sektion=8&manpath=FreeBSD+14.0-RELEASE+and+Ports>

home | help