Troubleshooting Solaris ZFS Boot Failure "Cannot mount root on rpool/XX fstype zfs"
(Doc ID 2321329.1)
Last updated on MARCH 19, 2024
Applies to:
Solaris Operating System - Version 10 6/06 U2 and laterInformation in this document applies to any platform.
Purpose
This document helps to troubleshoot and fix Solaris boot problems due to failures to mount ZFS root pool
Typical error message seen on system console for such a problem:
Troubleshooting Steps
To view full details, sign in with your My Oracle Support account. |
|
Don't have a My Oracle Support account? Click to get started! |
In this Document
Purpose |
Troubleshooting Steps |
Basic information |
Troubleshooting steps |
Boot verbose mode |
Check the given Error Number from boot messages |
Compare given error code with info in /usr/include/sys/errno.h |
Boot from alternate device and try to import the ZFS root pool |
Check ZFS and ZPOOL versions on system |
How to identify the given rpool dataset |
Check the active bootfs for ZFS root pool |
Items to check in case of error "zfs_parse_bootfs: error 48" |
Items to check in case of error "spa_import_rootpool: error XX" |
How to check the labels of a ZFS root pool |
Try to find another Solaris boot environment on boot disk |
Some helpful (mdb) commands to troubleshoot ZFS please see examples below |
Check/repair the ZFS root pool |
Update boot archive and install boot-loader |
Boot from disk device into kmdb and check rpool and logfiles using kmdb commands |
List of ZFS internal Error Codes |
References |