c2fdbb197d
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>
111 lines
4.3 KiB
ReStructuredText
111 lines
4.3 KiB
ReStructuredText
..
|
||
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-3C
|
||
=======================
|
||
|
||
Missing device in non-replicated configuration
|
||
----------------------------------------------
|
||
|
||
+-------------------------+--------------------------------------------------+
|
||
| **Type:** | Error |
|
||
+-------------------------+--------------------------------------------------+
|
||
| **Severity:** | Critical |
|
||
+-------------------------+--------------------------------------------------+
|
||
| **Description:** | A device could not be opened and no replicas are |
|
||
| | available. |
|
||
+-------------------------+--------------------------------------------------+
|
||
| **Automated Response:** | No automated response will be taken. |
|
||
+-------------------------+--------------------------------------------------+
|
||
| **Impact:** | The pool is no longer available. |
|
||
+-------------------------+--------------------------------------------------+
|
||
|
||
.. rubric:: Suggested Action for System Administrator
|
||
|
||
.. rubric:: 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 opened. There are insufficient
|
||
replicas for the pool to continue functioning.
|
||
action: Attach the missing device and online it using 'zpool online'.
|
||
see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-3C
|
||
scrub: none requested
|
||
config:
|
||
|
||
NAME STATE READ WRITE CKSUM
|
||
test FAULTED 0 0 0 insufficient replicas
|
||
c0t0d0 ONLINE 0 0 0
|
||
c0t0d1 FAULTED 0 0 0 cannot open
|
||
|
||
errors: No known data errors
|
||
|
||
If the device has been temporarily detached from the system, attach
|
||
the device to the system and run ``zpool status`` again. The pool
|
||
should automatically detect the newly attached device and resume
|
||
functioning. You may have to mount the filesystems in the pool
|
||
explicitly using ``zfs mount -a``.
|
||
|
||
If the device is no longer available and cannot be reattached to the
|
||
system, then the pool must be destroyed and re-created from a backup
|
||
source.
|
||
|
||
.. rubric:: For an exported pool:
|
||
|
||
If this error is encountered during a ``zpool import``, it means that
|
||
one of the devices is not attached to the system:
|
||
|
||
::
|
||
|
||
# zpool import
|
||
pool: test
|
||
id: 10121266328238932306
|
||
state: FAULTED
|
||
status: One or more devices are missing from the system.
|
||
action: The pool cannot be imported. Attach the missing devices and try again.
|
||
see: https://openzfs.github.io/openzfs-docs/msg/ZFS-8000-3C
|
||
config:
|
||
|
||
test FAULTED insufficient replicas
|
||
c0t0d0 ONLINE
|
||
c0t0d1 FAULTED cannot open
|
||
|
||
The pool cannot be imported until the missing device is attached to
|
||
the system. If the device has been made available in an alternate
|
||
location, use the ``-d`` option to ``zpool import`` to search for devices
|
||
in a different directory. If the missing device is unavailable, then
|
||
the pool cannot be imported.
|
||
|
||
.. rubric:: Details
|
||
|
||
The Message ID: ``ZFS-8000-3C`` indicates a device which was unable
|
||
to be opened by the ZFS subsystem.
|