repo: sbhk
action: commit
revision: 
path_from: 
revision_from: 416d3a247c6948781e521cfdfdbf4b39b0201f5d:
path_to: 
revision_to: 

commit 416d3a247c6948781e521cfdfdbf4b39b0201f5d
Author: nytpu 
Date:   Wed Aug 11 15:05:16 2021 -0600

    add tips about upgrading

diff --git a/fs_overlay/root/doc/upgrading.txt b/fs_overlay/root/doc/upgrading.txt
new file mode 100644
index 0000000000000000000000000000000000000000..371147297174d30a01dabcde3b8fed80a4b30cf4
--- /dev/null
+++ b/fs_overlay/root/doc/upgrading.txt
@@ -0,0 +1,26 @@
+########################## Upgrading SBHK ############################
+
+Upgrading SBHK is a bit of a pain due to the way SBHK is built.  You
+cannot write an upgraded ISO to the flash drive without wiping out the
+partition table which destroys the valuable keystores.
+
+The basic premise is that you create a new SBHK drive following the
+device setup guide.  Once that's set up, boot into it and create the
+partitions like normal.
+
+Once you have the new drive set up, boot back into the old one, and
+mount the old partitions like you ordinarily would.  Then, plug in the
+new drive and mount those partitions using `mount-parts`, but use
+the `-u` flag to mount the new partitions to alternate mount points.
+
+Now run something like
+
+    cp -r /keystore/. /keystore new
+    cp -r /public/. /public-new
+
+to copy all the files to the new partition.
+
+You should now run `unmount-parts -u` to unmount and close both the
+old and new partitions.  Once you have confirmed that the new drive
+boots and verified ALL OF THE DATA, you can securely erase the
+old drive.

-----END OF PAGE-----