Files
openzfs-docs/docs/msg/ZFS-8000-JQ/index.rst
Ryan Moeller c2fdbb197d Migrate ZFS-* message descriptions (#49)
Prerequisite for changing the URLs in the command outputs from
zfsonlinux.org to openzfs.github.io/openzfs-docs/

Signed-off-by: Ryan Moeller <ryan@iXsystems.com>
2020-08-26 20:39:04 +03:00

87 lines
3.2 KiB
ReStructuredText
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

..
CDDL HEADER START
The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]
CDDL HEADER END
Portions Copyright 2007 Sun Microsystems, Inc.
.. highlight:: none
Message ID: ZFS-8000-JQ
=======================
ZFS pool I/O failures
---------------------
+-------------------------+----------------------------------------+
| **Type:** | Error |
+-------------------------+----------------------------------------+
| **Severity:** | Major |
+-------------------------+----------------------------------------+
| **Description:** | The ZFS pool has experienced currently |
| | unrecoverable I/O failures. |
+-------------------------+----------------------------------------+
| **Automated Response:** | No automated response will be taken. |
+-------------------------+----------------------------------------+
| **Impact:** | Write I/Os cannot be serviced. |
+-------------------------+----------------------------------------+
.. rubric:: Suggested Action for System Administrator
The pool has experienced I/O failures. Since the ZFS pool property
``failmode`` is set to 'continue', read I/Os will continue to be
serviced, but write I/Os are blocked. See the zpoolprops(8) manpage for
more information on the ``failmode`` property. Manual intervention is
required for write 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: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-HC
scrub: none requested
config:
NAME STATE READ WRITE CKSUM
test FAULTED 0 13 0 insufficient replicas
sda9 FAULTED 0 7 0 experienced I/O failures
sdb9 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 write 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.
.. rubric:: Details
The Message ID: ``ZFS-8000-JQ`` indicates that the pool has
experienced I/O failures. Take the documented action to resolve the
problem.