Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Merged
merged 2 commits into from
May 10, 2012
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
69cdfd7
FAQ update for Ubuntu PPA and mountall changes.
dajhorn May 10, 2012
954f436
Add ZFS-8000-5E and ZFS-8000-HC messages.
dajhorn May 10, 2012
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 5 additions & 17 deletions faq.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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>
Expand Down
51 changes: 41 additions & 10 deletions msg/ZFS-8000-5E/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>
52 changes: 43 additions & 9 deletions msg/ZFS-8000-HC/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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>