ubuntu: add section about version upgradeubuntu-qcom-snapdragon-14.12

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>

2 files changed, 43 insertions, 0 deletions

diff --git a/ubuntu/boards/snapdragon/README.textile.in b/ubuntu/boards/snapdragon/README.textile.in
index 8f68096..bfb887f 100644
--- a/ubuntu/boards/snapdragon/README.textile.in
+++ b/ubuntu/boards/snapdragon/README.textile.in
@@ -70,6 +70,48 @@ All images downloaded from Linaro are compressed files and need to be uncompress
 
 bc. gunzip *.img.gz
 
+h4. Upgrading an already installed version of Linaro Linux release for Snapdragon 600 processor
+
+If you are already running on your board a previous version of the Linaro Linux release for Snapdragon 600 processor, you can upgrade your current installation by following the instructions in this section.
+
+In order to upgrade an existing release, you must ensure that you are running a previous release that is based on Ubuntu ##UBUNTU_REL## (aka ##UBUNTU_REL_NICK##), e.g. the same Ubuntu version that this release supports. If you are unsure about which version of Ubuntu you are running, you can check the corresponding Linaro Linux release notes, or you can run the following command on your board:
+
+bc. lsb_release -a
+
+For now the Linaro Linux release do not support Ubuntu distro version upgrade, when that happens you need to re-install the release completely, using the instructions in the rest of these release notes. If you are running the proper version of Ubuntu, you can proceed with the upgrade.
+
+To upgrade your current installation, three main components need to be updated:
+* the boot partition (e.g. kernel)
+* the root file system partition (e.g. user space)
+* the firmware partition
+
+In this release (e.g. Linaro ##RELEASE##), there are no firmware changes. If you have already installed the firmware partition on your board (for example if you have flashed the image into the _cache_ partition) then you do not have anything else to do. You can ignore the section below called _Managing the proprietary firmware_. We will simply reuse the _cache_ partition as it is.
+
+To upgrade the root file system, on the board running the Linaro Linux release, please run the following commands:
+
+bc. sudo apt-get update
+sudo apt-get dist-upgrade
+
+These commands will check for all possible updates, and install them all.
+
+We now need to install the new kernel modules. You need to download on the board, the kernel debian package file from the release. This file is called:
+
+bc. linux-image-##KERNEL_VER##-linaro-qcom_##KERNEL_VER##-linaro-qcom-1_armhf.deb
+
+On the board running the Linaro Linux release, you now need to install this debian package with:
+
+bc. sudo dpkg -i linux-image-##KERNEL_VER##-linaro-qcom_##KERNEL_VER##-linaro-qcom-1_armhf.deb
+
+The final step until to complete the upgrade is to boot the new kernel. That requires to reboot the board into fastboot mode. You can use the standard instructions from next sections, which you have used when you installed the Linaro Linux release on your board. Of course you need to make sure to connect your board to the development host (USB for fastboot, UART for the serial console), and ensure that it is booted in fastboot mode, waiting for commands, then you can flash the images on Inforce IFC6410 with:
+
+bc. sudo fastboot flash boot boot-qcom-apq8064-ifc6410-qcom-snapdragon-##VERSION##.img
+
+or on Compulab QS 600:
+
+bc. sudo fastboot flash boot boot-qcom-apq8064-cm-qs600-qcom-snapdragon-##VERSION##.img
+
+Your system is now up-to-date, and you are running Linaro ##RELEASE## on your development board. If you have followed all the instructions above, and you are getting any error, please report them as bugs (see Support section below).
+
 h4. Managing the proprietary firmware
 
 To properly use this release, a set of proprietary firmware blobs must be acquired separately from "Inforce Techweb website":http://www.inforcecomputing.com/techweb/ as Linaro is not redistributing them in this release.
diff --git a/vars.mk b/vars.mk
index 742f8b1..d18461d 100644
--- a/vars.mk
+++ b/vars.mk
@@ -1,6 +1,7 @@
 export RELEASE:=14.12
 export VERSION:=20141215-64
 export UBUNTU_REL:=14.10
+export KERNEL_VER:=3.18.0
 export UBUNTU_REL_NICK:=utopic
 export INFORCE_VERSION:=Inforce IFC6410 Android BSP Rel v1.5
 export INFORCE_FILE:=Inforce-IFC6410_AndroidBSP_880160_Rel_Beta_V1.5.zip