diff --git a/faq.html b/faq.html index 60227e720..bb9cfd983 100644 --- a/faq.html +++ b/faq.html @@ -96,9 +96,9 @@
If you are using an Ubuntu distribution the easiest way to install ZFS is -with Darik Horn's +with the ZFS PPA. Simply add the PPA to your list of repositories and install -the ZFS packages with your favorite package manager. The ZFS source will +the ubuntu-zfs packages with your favorite package manager. The ZFS source will be downloaded to your system and compiled with dkms. In addition, the ZFS source will be automatically recompiled when a new version is available or when you update your kernel.
@@ -582,21 +582,9 @@-$ cat /etc/default/zfs -# Automatically run `zfs mount -a` at system startup if set non-empty. -ZFS_MOUNT='yes' - -# Automatically run `zfs unmount -a` at system shutdown if set non-empty. -ZFS_UNMOUNT='yes' -+Auto mounting is provided by the enhanced mountall package from the +ZFS PPA. +Install the ubuntu-zfs package to get this feature.
-Sorry, the documentation for ZFS-8000-5E is missing because -www.sun.com is offline. - - +
title | Corrupted device label in non-replicated configuration |
description | A device could not be opened due to a missing or invalid + device label and no replicas are available. |
severity | critical |
type | error |
keys | ereport.fs.zfs.device.corrupt_label_nr |
details | The Message ID: ZFS-8000-5E indicates a + device which was unable to be opened by the ZFS subsystem. |
impact | The pool is no longer available |
response | No automated response will be taken. |
action |
+For an active pool+ +If this error was encountered while running 'zpool import', please see +the section below. Otherwise, run 'zpool status -x' to determine which pool +has experienced a failure: + ++# zpool status -x + pool: test + state: FAULTED +status: One or more devices could not be used because the the label is missing + or invalid. There are insufficient replicas for the pool to continue + functioning. +action: Destroy and re-create the pool from a backup source. + see: http://zfsonlinux.org/msg/ZFS-8000-5E + scrub: none requested +config: + + NAME STATE READ WRITE CKSUM + test FAULTED 0 0 0 insufficient replicas + c0t0d0 FAULTED 0 0 0 corrupted data + c0t0d1 ONLINE 0 0 0 + +errors: No known data errors ++ + The device listed as FAULTED with 'corrupted data' cannot be opened due +to a corrupt label. ZFS will be unable to use the pool, and all data within the +pool is irrevocably lost. The pool must be destroyed and recreated from an +appropriate backup source. Using replicated configurations will prevent this +from happening in the future. + +For an exported pool+ +If this error is encountered during 'zpool import', the action is the +same. The pool cannot be imported - all data is lost and must be restored from +an appropriate backup source. + |
title | ZFS pool I/O failures |
description | The ZFS pool has experienced currently unrecoverable I/O failures. |
severity | major |
type | error |
keys | fault.fs.zfs.io_failure_wait |
details | The Message ID: ZFS-8000-HC indicates that + the pool has experienced I/O failures. Take the documented + action to resolve the problem. |
impact | Read and write I/Os cannot be serviced. |
response | No automated response will be taken. |
action |
-Sorry, the documentation for ZFS-8000-HC is missing because -www.sun.com is offline. - - +The pool has experienced I/O failures. Since the ZFS pool property 'failmode' +is set to 'wait', all I/Os (reads and writes) are blocked. See the zpool(1M) +manpage for more information on the 'failmode' property. Manual intervention +is required for I/Os to be serviced. You can see which devices are +affected by running 'zpool status -x': + ++# zpool status -x + pool: test + state: FAULTED +status: There are I/O failures. +action: Make sure the affected devices are connected, then run 'zpool clear'. + see: http://zfsonlinux.org/msg/ZFS-8000-HC + scrub: none requested +config: + + NAME STATE READ WRITE CKSUM + test FAULTED 0 13 0 insufficient replicas + c0t0d0 FAULTED 0 7 0 experienced I/O failures + c0t1d0 ONLINE 0 0 0 + +errors: 1 data errors, use '-v' for a list ++ + +After you have made sure the affected devices are connected, run 'zpool clear' +to allow I/O to the pool again: + + ++# zpool clear test ++ + +If I/O failures continue to happen, then applications and commands for the +pool may hang. At this point, a reboot may be necessary to allow I/O to the +pool again. + + + |