Skip to content

Loading…

FAQ and MSG updates for the zfsonlinux.org web site #3

Merged
merged 2 commits into from

2 participants

@dajhorn
ZFS on Linux member

No description provided.

dajhorn added some commits
@dajhorn dajhorn FAQ update for Ubuntu PPA and mountall changes.
Delete instructions for editing the /etc/default/zfs file on Ubuntu.
Running `zfs mount -a` during system start is unreliable, especially
on recent releases like Oneiric and Precise.

The sysv /etc/init.d/zfs method of mounting ZFS at system start is
deprecated for PPA installations because faster hardware and better
upstart parallelism are causing more race errors.

Design choices in upstart make event dependencies unfulfillable by
by ZoL if it is separate from mountall, so using the enhanced
mountall package that recognizes ZFS should be encouraged.
69cdfd7
@dajhorn dajhorn Add ZFS-8000-5E and ZFS-8000-HC messages.
These two files were missing from the first Sun documentation scrape
but later recovered by Illumos:

  http://www.illumos.org/msg/ZFS-8000-5E
  http://www.illumos.org/msg/ZFS-8000-HC

Copy these files to the ZoL web site, but disable the style sheet and
change illumos.org to zfsonlinux.org in the URL.
954f436
@behlendorf behlendorf merged commit 954f436 into zfsonlinux:master
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on May 10, 2012
  1. @dajhorn

    FAQ update for Ubuntu PPA and mountall changes.

    dajhorn committed
    Delete instructions for editing the /etc/default/zfs file on Ubuntu.
    Running `zfs mount -a` during system start is unreliable, especially
    on recent releases like Oneiric and Precise.
    
    The sysv /etc/init.d/zfs method of mounting ZFS at system start is
    deprecated for PPA installations because faster hardware and better
    upstart parallelism are causing more race errors.
    
    Design choices in upstart make event dependencies unfulfillable by
    by ZoL if it is separate from mountall, so using the enhanced
    mountall package that recognizes ZFS should be encouraged.
  2. @dajhorn

    Add ZFS-8000-5E and ZFS-8000-HC messages.

    dajhorn committed
    These two files were missing from the first Sun documentation scrape
    but later recovered by Illumos:
    
      http://www.illumos.org/msg/ZFS-8000-5E
      http://www.illumos.org/msg/ZFS-8000-HC
    
    Copy these files to the ZoL web site, but disable the style sheet and
    change illumos.org to zfsonlinux.org in the URL.
Showing with 89 additions and 36 deletions.
  1. +5 −17 faq.html
  2. +41 −10 msg/ZFS-8000-5E/index.html
  3. +43 −9 msg/ZFS-8000-HC/index.html
View
22 faq.html
@@ -96,9 +96,9 @@
<tr>
<td>
<p>If you are using an Ubuntu distribution the easiest way to install ZFS is
-with Darik Horn's <a href="https://launchpad.net/~zfs-native/+archive/stable">
+with the <a href="https://launchpad.net/~zfs-native/+archive/stable">
ZFS PPA</a>. 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.</p>
@@ -582,21 +582,9 @@
<ul>
<li>
<b>Ubuntu PPA:</b>
-If you are using Darik Horn's
-<a href="https://launchpad.net/~zfs-native/+archive/stable">ZFS PPA</a>, auto
-mounting and auto unmounting features are configured in the /etc/default/zfs
-configuration file. Just edit the values of ZFS_MOUNT and ZFS_UNMOUNT in the
-file /etc/default/zfs to other than the default value (a blank string). Here is
-an example content of /etc/default/zfs configuration file:
-
-<pre>
-$ 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'
-</pre>
+Auto mounting is provided by the enhanced mountall package from the
+<a href="https://launchpad.net/~zfs-native/+archive/stable">ZFS PPA</a>.
+Install the ubuntu-zfs package to get this feature.
</li>
<li>
<b>Fedora, RHEL, Arch, Gentoo, Lunar:</b>
View
51 msg/ZFS-8000-5E/index.html
@@ -1,10 +1,41 @@
-<html>
-<head>
-<title>ZFS Message ID: ZFS-8000-5E</title>
-<html>
-<body>
-<p>
-Sorry, the documentation for ZFS-8000-5E is missing because
-www.sun.com is offline.
-</body>
-</html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>ZFS-8000-5E</title><!--<link rel="stylesheet" href="/stylesheets/style.css"/>--></head><body><h1>Message: ZFS-8000-5E</h1><table border="1" cellpadding="6"><tr><td><b>title</b></td><td>Corrupted device label in non-replicated configuration</td></tr><tr><td><b>description</b></td><td>A device could not be opened due to a missing or invalid
+ device label and no replicas are available.</td></tr><tr><td><b>severity</b></td><td>critical</td></tr><tr><td><b>type</b></td><td>error</td></tr><tr><td><b>keys</b></td><td>ereport.fs.zfs.device.corrupt_label_nr</td></tr><tr><td><b>details</b></td><td>The Message ID: <tt>ZFS-8000-5E</tt> indicates a
+ device which was unable to be opened by the ZFS subsystem.</td></tr><tr><td><b>impact</b></td><td>The pool is no longer available</td></tr><tr><td><b>response</b></td><td>No automated response will be taken.</td></tr><tr><td><b>action</b></td><td>
+<h4>For an active pool</h4>
+
+<p>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:</p>
+
+<pre>
+# 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
+<font color='red'> c0t0d0 FAULTED 0 0 0 corrupted data</font>
+ c0t0d1 ONLINE 0 0 0
+
+errors: No known data errors
+</pre>
+
+<p>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.</p>
+
+<h4>For an exported pool</h4>
+
+<p>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.</p>
+ </td></tr></table></body></html>
View
52 msg/ZFS-8000-HC/index.html
@@ -1,11 +1,45 @@
-<html>
-<head>
-<title>ZFS Message ID: ZFS-8000-HC</title>
-<html>
-<body>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>ZFS-8000-HC</title><!--<link rel="stylesheet" href="/stylesheets/style.css"/>--></head><body><h1>Message: ZFS-8000-HC</h1><table border="1" cellpadding="6"><tr><td><b>title</b></td><td>ZFS pool I/O failures</td></tr><tr><td><b>description</b></td><td>The ZFS pool has experienced currently unrecoverable I/O failures.</td></tr><tr><td><b>severity</b></td><td>major</td></tr><tr><td><b>type</b></td><td>error</td></tr><tr><td><b>keys</b></td><td>fault.fs.zfs.io_failure_wait</td></tr><tr><td><b>details</b></td><td>The Message ID: <tt>ZFS-8000-HC</tt> indicates that
+ the pool has experienced I/O failures. Take the documented
+ action to resolve the problem.</td></tr><tr><td><b>impact</b></td><td>Read and write I/Os cannot be serviced.</td></tr><tr><td><b>response</b></td><td>No automated response will be taken.</td></tr><tr><td><b>action</b></td><td>
<p>
-Sorry, the documentation for ZFS-8000-HC is missing because
-www.sun.com is offline.
-</body>
-</html>
+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':
+</p>
+<pre>
+# 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
+</pre>
+
+<p>
+After you have made sure the affected devices are connected, run 'zpool clear'
+to allow I/O to the pool again:
+</p>
+
+<pre>
+# zpool clear test
+</pre>
+
+<p>
+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.
+</p>
+
+ </td></tr></table></body></html>
Something went wrong with that request. Please try again.