14.06: unmount USB paritions before writing disk image

Signed-off-by: Ryan Harkin <ryan.harkin@linaro.org>

3 files changed, 99 insertions, 2 deletions

diff --git a/android/images/armv8-android-juno-lsk/HOWTO_install.txt b/android/images/armv8-android-juno-lsk/HOWTO_install.txt
index 5a4e327..d773b07 100644
--- a/android/images/armv8-android-juno-lsk/HOWTO_install.txt
+++ b/android/images/armv8-android-juno-lsk/HOWTO_install.txt
@@ -43,10 +43,32 @@ h3. Installation Steps
 
 bc. dmesg
 DRIVE=/dev/sdX # USB drive found from dmesg above
+
+* Unmount all partitions on the drive
+** If you do not unmount all of the USB drive's partitions, you run the risk that the image will not be created successfully.
+* Write the image to the driver
 bzcat juno.img.bz2 | sudo dd of=$DRIVE
 
+
 When the image is created, skip down to the section "Booting the image".
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+You should also ensure that you have written the image to the USB drive correctly.  To do this, after running the eject command, physically remove the USB drive from the system and re-connect the USB drive again.  You must unmount all partitions on the USB drive at this point.  Note, due to disconnecting and reconnecting the drive, the device path /dev/sdX may have changed.  You should check the @dmesg@ output again to ensure that you know the correct path of your USB drive.
+
+Once you are ready, run the following commands:
+
+bc. $sudo cmp /dev/sdX *minimal*.img.gz
+
+Replace *minimal*.img.gz with the full filename of the prebuilt image you are attempting to write to the disk.
+
 *Note:* Windows users may use the "Image Writer for Windows":https://launchpad.net/win32-image-writer/+download
 
 <hr>
@@ -91,13 +113,23 @@ Or, if your machine uses @'/dev/mmcblkX'@, you may see a line line this:
 
 bc. linaro-android-media-create --mmc /dev/sdX --dev vexpress --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+
 h2. Booting the image
 
 After the media create tool has finished executing, remove the USB drive from your PC and insert it into the board.
 
 Before you can boot the image you will need to install the latest firmware on the board. The "instructions below":#firmware provide information on how to do this.
 
-Once you have the latest firmware installed, you will need to configure UEFI to boot the kernel from the "boot" partition of the USB stick.
+Once you have the latest firmware installed, you will need to configure UEFI to boot the kernel from the "boot" partition of the USB stick.  See the steps directly below for instructions on how to configure UEFI.
 
 
 h2. UEFI Configuration
diff --git a/android/images/armv8-juice-juno-lsk/HOWTO_install.txt b/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
index b8fbad1..8e01b62 100644
--- a/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
+++ b/android/images/armv8-juice-juno-lsk/HOWTO_install.txt
@@ -43,10 +43,32 @@ h3. Installation Steps
 
 bc. dmesg
 DRIVE=/dev/sdX # USB drive found from dmesg above
+
+* Unmount all partitions on the drive
+** If you do not unmount all of the USB drive's partitions, you run the risk that the image will not be created successfully.
+* Write the image to the driver
 bzcat juno.img.bz2 | sudo dd of=$DRIVE
 
+
 When the image is created, skip down to the section "Booting the image".
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+You should also ensure that you have written the image to the USB drive correctly.  To do this, after running the eject command, physically remove the USB drive from the system and re-connect the USB drive again.  You must unmount all partitions on the USB drive at this point.  Note, due to disconnecting and reconnecting the drive, the device path /dev/sdX may have changed.  You should check the @dmesg@ output again to ensure that you know the correct path of your USB drive.
+
+Once you are ready, run the following commands:
+
+bc. $sudo cmp /dev/sdX *minimal*.img.gz
+
+Replace *minimal*.img.gz with the full filename of the prebuilt image you are attempting to write to the disk.
+
 *Note:* Windows users may use the "Image Writer for Windows":https://launchpad.net/win32-image-writer/+download
 
 <hr>
@@ -91,13 +113,23 @@ Or, if your machine uses @'/dev/mmcblkX'@, you may see a line line this:
 
 bc. linaro-android-media-create --mmc /dev/sdX --dev vexpress --boot boot.tar.bz2 --system system.tar.bz2 --userdata userdata.tar.bz2
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+
 h2. Booting the image
 
 After the media create tool has finished executing, remove the USB drive from your PC and insert it into the board.
 
 Before you can boot the image you will need to install the latest firmware on the board. The "instructions below":#firmware provide information on how to do this.
 
-Once you have the latest firmware installed, you will need to configure UEFI to boot the kernel from the "boot" partition of the USB stick.
+Once you have the latest firmware installed, you will need to configure UEFI to boot the kernel from the "boot" partition of the USB stick.  See the steps directly below for instructions on how to configure UEFI.
 
 
 h2. UEFI Configuration
diff --git a/openembedded/juno-lsk/INSTALL.textile b/openembedded/juno-lsk/INSTALL.textile
index 1ddf048..acdbc2b 100644
--- a/openembedded/juno-lsk/INSTALL.textile
+++ b/openembedded/juno-lsk/INSTALL.textile
@@ -44,10 +44,33 @@ h3. Installation Steps
 
 bc. dmesg
 DRIVE=/dev/sdX # USB drive found from dmesg above
+
+* Unmount all partitions on the drive
+** If you do not unmount all of the USB drive's partitions, you run the risk that the image will not be created successfully.
+* Write the image to the driver
 zcat *minimal*.img.gz | sudo dd of=$DRIVE
 
+Replace *minimal*.img.gz with the full filename of the prebuilt image you are attempting to write to the disk.
+
 When the image is created, skip down to the section "Booting the image".
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+You should also ensure that you have written the image to the USB drive correctly.  To do this, after running the eject command, physically remove the USB drive from the system and re-connect the USB drive again.  You must unmount all partitions on the USB drive at this point.  Note, due to disconnecting and reconnecting the drive, the device path /dev/sdX may have changed.  You should check the @dmesg@ output again to ensure that you know the correct path of your USB drive.
+
+Once you are ready, run the following commands:
+
+bc. $sudo cmp /dev/sdX *minimal*.img.gz
+
+Replace *minimal*.img.gz with the full filename of the prebuilt image you are attempting to write to the disk.
+
 *Note:* Windows users may use the "Image Writer for Windows":https://launchpad.net/win32-image-writer/+download
 
 <hr>
@@ -92,6 +115,16 @@ Or, if your machine uses @'/dev/mmcblkX'@, you may see a line line this:
 
 bc. sudo linaro-media-create --mmc /dev/sdX --dev juno --hwpack <hwpack filename> --binary <rootfs filename>
 
+After you have created the disk image and before you remove the USB drive from your system, you should make sure you wait for all writes to the USB drive to complete.
+
+The following commands may help with this:
+
+bc. $ sync
+$ sudo eject /dev/sdX
+
+Where /dev/sdX is the device node for the USB drive as discovered in the instructions above.
+
+
 h2. Booting the image
 
 After the media create tool has finished executing, remove the USB drive from your PC and insert it into the board.