Proxmox VE has a killer feature: the ability to set up a bootable ZFS zpool for the Debian-based hypervisor solution. That means one can, from the initial installer, configure a ZFS mirror to boot from using Proxmox VE which is a feature very few Linux distributions have at this point. The installer makes this exceedingly easy, but sometimes one can find a screen where it fails to boot. In this article, we are going to show how to fix this issue.
The Proxmox VE Cannot Import rpool ZFS Boot Issue
When this issue occurs here is what the text generally looks like:
Command: /sbin/zpool import -N "rpool"
Message: cannot import 'rpool' : no such pool available
Failed to import pool 'rpool'.
Manually import the pool and exit.
Here is a screenshot:
The problem often occurs when you have fast SSDs, but we have seen it on a few machines, some with LSI/ Avago/ Broadcom HBAs, some using Intel PCH SATA and with different types of SSDs. Luckily the fix is easy.
The basic steps to fix this are:
- Import the rpool manually to continue booting as a temporary fix
- Add a delay to your GRUB configuration
- Update GRUB
- Reboot to test and ensure that it works.
For those who want the full directions, here is a video we made on a Proxmox VE 5 node that was exhibiting this issue.
As you can see, it is an easy fix but one that can drive you crazy if it is not done.
On our last dozen or so Proxmox VE machines we have hit this one twice. Booting to a ZFS mirror is a great feature of the platform, so we still advise trying it. At the same time, since we hit this issue with different SSDs on different platforms (one Intel one Supermicro) we felt it was worth posting a fix. It may not help you today, but bookmark this fix in the event it does strike you in the future.
Note: with Proxmox VE 5.1 we have seen a docker installation change that can cause an error when booting from the ZFS root zpool. If you instead see a bunch of strings that look like Docker container IDs that is a different issue, and we have a video coming on how to properly install Docker on Proxmox VE 5.1 with a ZFS rpool. Stay tuned.