aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorAlexander Motin <mav@FreeBSD.org>2018-07-31 18:49:07 +0000
committerAlexander Motin <mav@FreeBSD.org>2018-07-31 18:49:07 +0000
commit59ef839e67afaa3edf118b90605c9d59de1c6fe3 (patch)
treeb03fbee8807ac696fc51ed5826ae9e483b878bfc /man
parent86b3990c6e51d072a690a39f33e1b5b4d258aff2 (diff)
downloadsrc-59ef839e67afaa3edf118b90605c9d59de1c6fe3.tar.gz
src-59ef839e67afaa3edf118b90605c9d59de1c6fe3.zip
9102 zfs should be able to initialize storage devices
The first access to a disk block can incur a performance penalty on some platforms (e.g. AWS's EBS, VMware VMDKs). Therefore it is recommended that volumes be "thick provisioned", where supported by the platform (VMware). Thick provisioning is time consuming and often is ignored. If the thick provision step is omitted, customers will see suboptimal performance until we have written to all parts of the LUN. ZFS should be able to initialize any unused storage to remove any first-write penalty that exists. illumos/illumos-gate@094e47e980b0796b94b1b8f51f462a64d246e516 Reviewed by: John Wren Kennedy <john.kennedy@delphix.com> Reviewed by: Matthew Ahrens <mahrens@delphix.com> Reviewed by: Pavel Zakharov <pavel.zakharov@delphix.com> Reviewed by: Prakash Surya <prakash.surya@delphix.com> Approved by: Richard Lowe <richlowe@richlowe.net>
Notes
Notes: svn path=/vendor-sys/illumos/dist/; revision=336991
Diffstat (limited to 'man')
-rw-r--r--man/man1m/zpool.1m31
1 files changed, 31 insertions, 0 deletions
diff --git a/man/man1m/zpool.1m b/man/man1m/zpool.1m
index f1b7b579def4..4631fbf0462f 100644
--- a/man/man1m/zpool.1m
+++ b/man/man1m/zpool.1m
@@ -105,6 +105,11 @@
.Ar pool Ns | Ns Ar id
.Op Ar newpool
.Nm
+.Cm initialize
+.Op Fl cs
+.Ar pool
+.Op Ar device Ns ...
+.Nm
.Cm iostat
.Op Fl v
.Op Fl T Sy u Ns | Ns Sy d
@@ -1336,6 +1341,32 @@ to fully rewind.
.El
.It Xo
.Nm
+.Cm initialize
+.Op Fl cs
+.Ar pool
+.Op Ar device Ns ...
+.Xc
+Begins initializing by writing to all unallocated regions on the specified
+devices, or all eligible devices in the pool if no individual devices are
+specified.
+Only leaf data or log devices may be initialized.
+.Bl -tag -width Ds
+.It Fl c, -cancel
+Cancel initializing on the specified devices, or all eligible devices if none
+are specified.
+If one or more target devices are invalid or are not currently being
+initialized, the command will fail and no cancellation will occur on any device.
+.It Fl s -suspend
+Suspend initializing on the specified devices, or all eligible devices if none
+are specified.
+If one or more target devices are invalid or are not currently being
+initialized, the command will fail and no suspension will occur on any device.
+Initializing can then be resumed by running
+.Nm zpool Cm initialize
+with no flags on the relevant target devices.
+.El
+.It Xo
+.Nm
.Cm iostat
.Op Fl v
.Op Fl T Sy u Ns | Ns Sy d