Zpool - Revision history

Zfsfan: /* Creating a pool */ bugfix

2023-03-21T01:37:30Z

‎Creating a pool: bugfix

Ckotwn: Re-arranged paragraphs for easier comprehension, as pointed in discussion.

2021-07-01T06:11:24Z

Re-arranged paragraphs for easier comprehension, as pointed in discussion.

24.22.22.251: Added note explaining what effect '-o ashift=12' has on zpool creation.

2016-03-04T02:34:27Z

Added note explaining what effect '-o ashift=12' has on zpool creation.

Ilovezfs at 06:25, 17 November 2015

2015-11-17T06:25:02Z

Torarnv at 13:53, 18 March 2015

2015-03-18T13:53:13Z

Ilovezfs: /* Creating a pool */

2014-09-24T19:00:20Z

‎Creating a pool

Ilovezfs: /* Creating a pool */

2014-09-24T18:51:33Z

‎Creating a pool

Ilovezfs: /* Creating a pool */

2014-09-24T18:48:30Z

‎Creating a pool

Ilovezfs: /* Feature flags */

2014-08-01T07:27:31Z

‎Feature flags

Ilovezfs: /* Feature flags */

2014-08-01T07:24:05Z

‎Feature flags

@@ Line 21: / Line 21: @@
 * ''If you want to use the entire disk for ZFS'', replace diskX and diskY with the available disks. For example, disk1 and disk2.
 * If you have already partitioned the disk, and wish to only use a slice, use diskXsN. For example, disk1s2.
-* -f instructs ZFS to label the disk for you.
+* -f [https://openzfs.github.io/openzfs-docs/man/8/zpool-create.8.html Forces use of vdevs, '''even if''' they appear '''in use''' or specify a conflicting replication level. Not all devices can be overridden in this manner.] (not: "instructs ZFS to label the disk for you.")
 * -o ashift=12 instructs ZFS to use 4K sectors, as described here: http://wiki.illumos.org/display/illumos/ZFS+and+Advanced+Format+disks

@@ Line 1: / Line 1: @@
 == Creating a pool ==
-In the past, you would label (i.e., partition) disks yourself before using them with ZFS. This is no longer the case. Now, in most cases, you will instead want to have ZFS partition disks for you.
+Start using ZFS by first creating a storage pool with the command '''zpool'''. As mentioned above, the disk partition on which the pool will be created must be specified before creation.
-−
-On OS X you will want to use [http://en.wikipedia.org/wiki/Unicode_equivalence#Normal_forms NFD normalization], or quite a few applications won't work (e.g., iTunes).
-−
-The default for ashift is 9, but you will most likely want to create pools with an ashift of 12, which is appropriate for 4096 (4k) disks (i.e., Advanced Format disks), even if your disks are still the older 512. If you are using SSDs in your pool now, or anticipate replacing any of your pool's disks with SSDs in the future, then an ashift of 13 is a better choice. It is important to get this right now because a vdev's ashift cannot be changed after the vdev is created.
 '''Recommended pool creation command line'''
@@ Line 25: / Line 24: @@
 * -o ashift=12 instructs ZFS to use 4K sectors, as described here: http://wiki.illumos.org/display/illumos/ZFS+and+Advanced+Format+disks
-Use "diskutil list" to make sure you pick the correct disk before attempting to create your pool. Note that if you partition the disk yourself, and specify a slice for ZFS, you are responsible for making sure the partition table shows the partition type is ZFS. This can be done with OS X's built-in "gpt" command or the easier to use "gdisk" command, which can be downloaded [http://sourceforge.net/projects/gptfdisk/ here]. For detailed instructions, see [[Suppressing_the_annoying_pop-up|here]].
+The default for ashift is 9, but you will most likely want to create pools with an ashift of 12, which is appropriate for 4096 (4k) disks (i.e., Advanced Format disks), even if your disks are still the older 512. If you are using SSDs in your pool now, or anticipate replacing any of your pool's disks with SSDs in the future, then an ashift of 13 is a better choice. It is important to get this right now because a vdev's ashift cannot be changed after the vdev is created.
 You can also decide to disable '''access time''', enable '''compression,''' and all those nice things. But that can be done at any time in ZFS. For example
@@ Line 61: / Line 62: @@
   -O normalization=formD \
   tank mirror disk3 disk4
 == Unplugging a pool ==

@@ Line 23: / Line 23: @@
 * If you have already partitioned the disk, and wish to only use a slice, use diskXsN. For example, disk1s2.
 * -f instructs ZFS to label the disk for you.
 Use "diskutil list" to make sure you pick the correct disk before attempting to create your pool. Note that if you partition the disk yourself, and specify a slice for ZFS, you are responsible for making sure the partition table shows the partition type is ZFS. This can be done with OS X's built-in "gpt" command or the easier to use "gdisk" command, which can be downloaded [http://sourceforge.net/projects/gptfdisk/ here]. For detailed instructions, see [[Suppressing_the_annoying_pop-up|here]].

@@ Line 10: / Line 10: @@
 '''Recommended pool creation command line'''
-  sudo zpool create -f -o ashift=12 -O casesensitivity=insensitive -O normalization=formD $poolname mirror /dev/diskX /dev/diskY
+  sudo zpool create -f -o ashift=12 -O casesensitivity=insensitive -O normalization=formD $poolname mirror diskX diskY
 Or using "\" to show it broken up over multiple lines:
@@ Line 17: / Line 17: @@
   -O casesensitivity=insensitive \
   -O normalization=formD \
-  $poolname mirror /dev/diskX /dev/diskY
+  $poolname mirror diskX diskY
 * Replace $poolname with the name of the pool you want. For example, "tank."
-* ''If you want to use the entire disk for ZFS'', replace /dev/diskX and /dev/diskY with the available disks. For example, /dev/disk1 and /dev/disk2.
+* ''If you want to use the entire disk for ZFS'', replace diskX and diskY with the available disks. For example, disk1 and disk2.
-* If you have already partitioned the disk, and wish to only use a slice, use /dev/diskXsN. For example, /dev/disk1s2.
+* If you have already partitioned the disk, and wish to only use a slice, use diskXsN. For example, disk1s2.
 * -f instructs ZFS to label the disk for you.
@@ Line 38: / Line 38: @@
 For example, you may want to use something like this
-  sudo zpool create -f -o ashift=12 -O compression=lz4 -O casesensitivity=insensitive -O atime=off -O normalization=formD tank mirror /dev/disk3 /dev/disk4
+  sudo zpool create -f -o ashift=12 -O compression=lz4 -O casesensitivity=insensitive -O atime=off -O normalization=formD tank mirror disk3 disk4
 Or using "\" to show it broken up over multiple lines:
@@ Line 46: / Line 46: @@
   -O atime=off \
   -O normalization=formD \
-  tank mirror /dev/disk3 /dev/disk4
+  tank mirror disk3 disk4
 If you absolutely must be compatible with non-OpenZFS implementations of ZFS (e.g., Oracle Solaris), you'd need to do
-  sudo zpool create -f -o version=28 -o ashift=12 -O compression=on -O casesensitivity=insensitive -O atime=off -O normalization=formD tank mirror /dev/disk3 /dev/disk4
+  sudo zpool create -f -o version=28 -o ashift=12 -O compression=on -O casesensitivity=insensitive -O atime=off -O normalization=formD tank mirror disk3 disk4
 Or using "\" to show it broken up over multiple lines:
@@ Line 59: / Line 59: @@
   -O atime=off \
   -O normalization=formD \
-  tank mirror /dev/disk3 /dev/disk4
+  tank mirror disk3 disk4
 == Unplugging a pool ==

@@ Line 24: / Line 24: @@
 * -f instructs ZFS to label the disk for you.
-Use "diskutil list" to make sure you pick the correct disk before attempting to create your pool. Note that if you partition the disk yourself, and specify a slice for ZFS, you are responsible for making sure the partition table shows the partition type is ZFS. This can be done with OS X's built-in "gpt" command or the easier to use "gdisk" command, which can be downloaded [http://sourceforge.net/projects/gptfdisk/ here].
+Use "diskutil list" to make sure you pick the correct disk before attempting to create your pool. Note that if you partition the disk yourself, and specify a slice for ZFS, you are responsible for making sure the partition table shows the partition type is ZFS. This can be done with OS X's built-in "gpt" command or the easier to use "gdisk" command, which can be downloaded [http://sourceforge.net/projects/gptfdisk/ here]. For detailed instructions, see [[Suppressing_the_annoying_pop-up|here]].
 You can also decide to disable '''access time''', enable '''compression,''' and all those nice things. But that can be done at any time in ZFS. For example

@@ Line 2: / Line 2: @@
 == Creating a pool ==
-In the past, it was customary to label (i.e., partition) the disks before using them with ZFS. This is no longer the case. Now the preferred method is to have ZFS label the disks for you.
+In the past, it was customary to label (i.e., partition) the disks before using them with ZFS. This is no longer the case. Now the preferred method is to have ZFS "label" (i.e., partition) the disks for you.
 On OS X you will want to use [http://en.wikipedia.org/wiki/Unicode_equivalence#Normal_forms NFD normalization], or quite a few applications won't work (e.g., iTunes).

@@ Line 77: / Line 77: @@
 == Feature flags ==
-If you are creating a pool on another OpenZFS platform, and you want to make sure that pool is compatible with OpenZFS on OS X, you must not enable any feature flags not yet supported by OpenZFS on OS X.
+If you are creating a pool on another OpenZFS platform, and you want to make sure that pool is compatible with OpenZFS on OS X, you must not enable any [http://open-zfs.org/wiki/Features#Feature_Flags feature flags] not yet supported by OpenZFS on OS X.
 For instance, let's say you were creating a pool using OmniOS, which currently supports more feature flags than OpenZFS on OS X.

@@ Line 81: / Line 81: @@
 For instance, let's say you were creating a pool using OmniOS, which currently supports more feature flags than OpenZFS on OS X.
-To disable all feature flags, use the -d option when creating the pool:
+To start out with all feature flags disabled, use the -d option when creating the pool:
   sudo zpool create -d $poolname c2t1d0
-To selectively enable only the feature flags supported by OpenZFS on OS X as of 2014-08-01:
+To selectively enable only the feature flags supported by OpenZFS on OS X (as of 2014-08-01) use -d combined with -o feature@..., as follows:
   sudo zpool create -d -o feature@async_destroy=enabled -o feature@empty_bpobj=enabled -o feature@lz4_compress=enabled $poolname c2t1d0