diff options
author | Alexander Motin <mav@FreeBSD.org> | 2018-07-31 18:49:07 +0000 |
---|---|---|
committer | Alexander Motin <mav@FreeBSD.org> | 2018-07-31 18:49:07 +0000 |
commit | 59ef839e67afaa3edf118b90605c9d59de1c6fe3 (patch) | |
tree | b03fbee8807ac696fc51ed5826ae9e483b878bfc /man | |
parent | 86b3990c6e51d072a690a39f33e1b5b4d258aff2 (diff) | |
download | src-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.1m | 31 |
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 |