From bb0a37c973de10fc5eeef72d8cf676481d4aa627 Mon Sep 17 00:00:00 2001
From: Richard Laager <rlaager@wiktel.com>
Date: Tue, 4 Oct 2016 01:02:38 -0500
Subject: [PATCH] Ubuntu: Add some troubleshooting instructions

---
 Ubuntu-16.04-Root-on-ZFS.md | 32 ++++++++++++++++++++++++++++++++
 Ubuntu-16.10-Root-on-ZFS.md | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 64 insertions(+)

diff --git a/Ubuntu-16.04-Root-on-ZFS.md b/Ubuntu-16.04-Root-on-ZFS.md
index 5d50380..29086ba 100644
--- a/Ubuntu-16.04-Root-on-ZFS.md
+++ b/Ubuntu-16.04-Root-on-ZFS.md
@@ -418,6 +418,38 @@ If you prefer the graphical boot process, you can re-enable it now. It will make
 
 ## Troubleshooting
 
+### Rescuing using a Live CD
+
+Boot the Live CD and open a terminal.
+
+Become root and install the ZFS utilities:
+
+    $ sudo -i
+    # apt update
+    # apt install --yes zfsutils-linux
+
+This will automatically import your pool. Export it and re-import it to get the mounts right:
+
+    # zpool export -a
+    # zpool import -N -R /mnt rpool
+    # zfs mount rpool/ROOT/ubuntu
+    # zfs mount -a
+
+If needed, you can chroot into your installed environment:
+
+    # mount --rbind /dev  /mnt/dev
+    # mount --rbind /proc /mnt/proc
+    # mount --rbind /sys  /mnt/sys
+    # chroot /mnt /bin/bash --login
+
+Do whatever you need to do to fix your system.
+
+When done, cleanup:
+
+    # mount | grep -v zfs | tac | awk '/\/mnt/ {print $3}' | xargs -i{} umount -lf {}
+    # zpool export rpool
+    # reboot
+
 ### MPT2SAS
 
 Most problem reports for this tutorial involve `mpt2sas` hardware that does slow asynchronous drive initialization, like some IBM M1015 or OEM-branded cards that have been flashed to the reference LSI firmware.
diff --git a/Ubuntu-16.10-Root-on-ZFS.md b/Ubuntu-16.10-Root-on-ZFS.md
index ab5dceb..4932e20 100644
--- a/Ubuntu-16.10-Root-on-ZFS.md
+++ b/Ubuntu-16.10-Root-on-ZFS.md
@@ -430,6 +430,38 @@ If you prefer the graphical boot process, you can re-enable it now. It will make
 
 ## Troubleshooting
 
+### Rescuing using a Live CD
+
+Boot the Live CD and open a terminal.
+
+Become root and install the ZFS utilities:
+
+    $ sudo -i
+    # apt update
+    # apt install --yes zfsutils-linux
+
+This will automatically import your pool. Export it and re-import it to get the mounts right:
+
+    # zpool export -a
+    # zpool import -N -R /mnt rpool
+    # zfs mount rpool/ROOT/ubuntu
+    # zfs mount -a
+
+If needed, you can chroot into your installed environment:
+
+    # mount --rbind /dev  /mnt/dev
+    # mount --rbind /proc /mnt/proc
+    # mount --rbind /sys  /mnt/sys
+    # chroot /mnt /bin/bash --login
+
+Do whatever you need to do to fix your system.
+
+When done, cleanup:
+
+    # mount | grep -v zfs | tac | awk '/\/mnt/ {print $3}' | xargs -i{} umount -lf {}
+    # zpool export rpool
+    # reboot
+
 ### MPT2SAS
 
 Most problem reports for this tutorial involve `mpt2sas` hardware that does slow asynchronous drive initialization, like some IBM M1015 or OEM-branded cards that have been flashed to the reference LSI firmware.