My Oracle Support Banner

Troubleshooting Solaris ZFS Boot Failure "Cannot mount root on rpool/XX fstype zfs" (Doc ID 2321329.1)

Last updated on JULY 11, 2019

Applies to:

Solaris Operating System - Version 10 6/06 U2 and later
Information 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

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.