Skip to content

How to Create a Multi Boot SD card out of 2 existing OSes using PINN

Jump to bottom
procount edited this page Sep 10, 2017 · 47 revisions

How to Create a Multi-Boot SD card out of 2 existing OSes using PINN

Introduction

These instructions explain how to create a multi-boot SD card for the Raspberry Pi that will enable you to select which OS will be used on boot. The 2 OSes are ones that you have previously installed to 2 separate SD cards and customised to an extent that you don't want to lose those customisations.

These instructions can be used to multi-boot more than 2 OSes, or different OSes than the example ones given here. Just adapt the instructions as necessary.

In any of the following instructions, any line beginning with a $ indicates a line that shoudl be typed in by the user (not including the $ symbol, whcih represents the command line prompt)

Pre-Requisites

  • 2 existing uSD cards containing 2 OSes (e.g. Raspbian and Retropie)
  • 1 blank uSD card large enough to hold both OSes as a multi-boot SD card
  • 1 USB memory stick (or uSD card with USB card reader)
  • a USB uSD card reader
  • a PC running a version of desktop Linux (Ubuntu assumed)

Overall Process

The overall process that I will cover will have the following general outline. Each step will be documented along the way.

  • Backup the existing OSes
  • Make the backups suitable for installation by PINN
  • Copy the custom OSes to a new SD card.
  • Make a PINN bootable uSD card
  • Use PINN to install the OS backups to the multi-boot card.

Step 1 - Backup existing OSes

The SD cards containing the existing customised OSes need to be backed up in a particluar way in order for PINN to install them. PINN prefers a backup file per partition, which could be a compressed image file, or a compressed tar file.

An image file is a bit-by-bit backup of the whole of a partition, including any unused space, so it can be a lot bigger than is necessary. Compressing the image afterwards can remove a lot of this unused space to make the file smaller, but it nevertheless requires an SD card at least as big as the original partition size to restore the files to. To avoid this, a common practice is to first resize the partition and its file system to be as small as possible before taking the image. In this way, less of the unused space is recorded in the iage file and it can be restored to a smaller SD card. However, it also requires that after restoration, the file system should be expanded to fill the remaining space of the partition, otherwise it will not be possible to add much more data or install anymore programs to the partition. Because of these complications of first reducing and then expanding the file systems, this method will not be considered here.

An alternative approach is to create an archive of the files on each partition as a tar file and then compress it. Using this method, only the existing files will be backed up, and not any empty space, so it should be smaller than a corresponding image file. On restoration, the tar files can be decompressed to a preformatted partition of any size at least as large as the files themselves. No file system expansion would be necessary because the partition would have already been formatted to its full capacity.

Backup Raspbian

First we will backup the Raspbian OS.

We will start on our PC and fire up Linux. We will be doing a lot of this procedure by the command line, so if you have booted into a desktop environment, launch your normal terminal program (Terminal, LXTerminal or similar). This should drop you into your home directory (/home/<username> or just '~' for short)

  1. Create a folder called os/raspbian in your home folder to store your backup in.
    $ mkdir -p ~/os/Raspbian
  2. Insert your uSD card that has your customised Raspbian OS on it into the USB reader and insert it into a free USB slot of the PC. You need to note what device Linux has assigned it (e.g. /dev/sdb) and where it has been mounted (e.g. /media/<username>/boot or /root etc).
    Some Linux OSes may automount the partitions on this SD card, so in this case you can type mount to identify the device and where it's partitions have been mounted and skip the next step. For this tutorial, we will assume the SD card is referenced as /dev/sdb with /dev/sdb1 mounted at /media/<username>/boot and /dev/sdb2 mounted at /media/<username>/root. If yours is mounted at a different location, please replace appropriately in the following steps.
  3. If it has not been auto-mounted, you will need to manually mount the partitions on the device.
    $ dmesg
    Look for the recent logs at the end of the dmesg output to identify the name of the most recently added device. You then need to create a mountpoint for each partition on the device. We will assume the device has been assigned /dev/sdb and has 2 partitions (/dev/sdb1 and /dev/sdb2) named boot and root
    $ sudo mkdir /media/<username>/boot
    $ sudo mkdir /media/<username>/root
    $ sudo mount /dev/sdb1 /media/<username>/boot
    $ sudo mount /dev/sdb2 /media/<username>/root
  4. Now we will take a copy of our SD card and store it in 2 archive files.
    $ cd /media/<username>/boot
    $ sudo bsdtar --numeric-owner --format gnutar -cpvf ~/os/Raspbian/boot.tar . $ cd /media/<username>/root
    $ sudo bsdtar --numeric-owner --format gnutar --one-file-system -cpf ~/os/Raspbian/root.tar . $ cd ~/os/Raspbian
    $ xz -9 -e boot.tar
    $ xz -9 -e root.tar
    You should now have 2 files in ~/os/Raspbian called boot.tar.xz and root.tar.xz
  5. We need to make a note of how much space the OS takes up.
    $ sudo du -BK -s /media/<username>/boot | cut -d"K" -f1 >boot.size
    $ sudo du -BK -s /media/<username>/root | cut -d"K" -f1 >root.size
  6. Finally we will unmount the Raspbian OS SD card
    $ umount /media/<username>boot
    $ umount /media/<username>root
    and then you may eject and remove the Raspbian OS SD card.

Backup Retropie

Now we will backup the other OS of Retropie, which is just a repeat of the operation to backup our Raspbian OS.

  1. Create a folder called os/Retropie2 in your home folder to store your backup in.
    $ mkdir -p ~/os/Retropie2
  2. Insert your uSD card that has your customised Retropie OS on it into the USB reader and insert it into a free USB slot of the PC. You need to note what device Linux has assigned it (e.g. /dev/sdb) and where it has been mounted (e.g. /media/<username>/boot or /root etc). Some Linux OSes may automount the partitions on this SD card, so in this case you can type mount to identify the device and where it's partitions have been mounted and skip the next step. For this tutorial, we will assume the SD card is referenced as /dev/sdb with /dev/sdb1 mounted at /media/<username>/boot and /dev/sdb2 mounted at /media/<username>/root. If yours is mounted at a different location, please replace appropriately in the following steps.
  3. If it has not been auto-mounted, you will need to manually mount the partitions on the device.
    $ dmesg
    Look for the recent logs at the end of the dmesg output to identify the name of the most recently added device. You then need to create a mountpoint for each partition on the device. We will assume the device has been assigned /dev/sdb and has 2 partitions (/dev/sdb1 and /dev/sdb2) named boot and root
    (we will assume the /media/<username>/boot and/media/<username>/root folders still exist from backing up Raspbian)
    $ sudo mount /dev/sdb1 /media/<username>/boot
    $ sudo mount /dev/sdb2 /media/<username>/root
  4. Now we will take a copy of our SD card and store it in 2 archive files.
    $ cd /media/<username>/boot
    $ sudo bsdtar --numeric-owner --format gnutar -cpvf ~/os/Retropie2/boot.tar . $ cd /media/<username>/root
    $ sudo bsdtar --numeric-owner --format gnutar --one-file-system -cpf ~/os/Retropie2/root.tar . $ cd ~/os/Retropie2
    $ xz -9 -e boot.tar
    $ xz -9 -e root.tar
    You should now have 2 files in ~/os/Retropie2 called boot.tar.xz and root.tar.xz
  5. We need to make a note of how much space the OS takes up.
    $ sudo du -BK -s /media/<username>/boot | cut -d"K" -f1 >boot.size
    $ sudo du -BK -s /media/<username>/root | cut -d"K" -f1 >root.size
  6. Finally we will unmount the retropie OS SD card
    $ umount /media/<username>boot
    $ umount /media/<username>root
    and then you may eject and remove the retropie OS SD card.

Step 2 - Add OS Meta Data

Now we need to add some meta data files that describe these OSes to PINN so it knows how to install them. We shall download some existing meta files for these OSes and then adapt them if necessary.

First, Raspbian:
$ cd ~/os/Raspbian
$ wget -N "http://downloads.raspberrypi.org/raspbian/os.json"
$ wget -N "http://downloads.raspberrypi.org/raspbian/Raspbian.png"
$ wget -N "http://downloads.raspberrypi.org/raspbian/partitions.json"
$ wget -N "http://downloads.raspberrypi.org/raspbian/marketing.tar"
$ wget -N "http://downloads.raspberrypi.org/raspbian/partition_setup.sh"

We need to modify partitions.json and edit the values for "partition_size_nominal" and "uncompressed_tarball_size" for each of the boot and root partitions, so 4 values in total.

First in the boot partition, replace the value of "uncompressed_tarball_size" with the value produced from:
$ expr `cat boot.size` / 1024 + 1
Whatever this value is, add 100 to it and use it to replace the value of "partition_size_nominal"

Next for the root partition, replace the value of "uncompressed_tarball_size" with the value produced from:
$ expr `cat root.size` / 1024 + 1
Whatever this value is, add 100 to it and use it to replace the value of "partition_size_nominal"

Note the spaces and punctuation of backticks in the above expressions which are not quotes or apostrophes.

Then Retropie:
$ cd ~/os/Retropie2
$ wget -N "http://downloads.sourceforge.net/project/pinn/os/Retropie2/os.json"
$ wget -N "http://downloads.sourceforge.net/project/pinn/os/Retropie2/partitions.json"
$ wget -N "http://downloads.sourceforge.net/project/pinn/os/Retropie2/Retropie2.png"
$ wget -N "http://downloads.sourceforge.net/project/pinn/os/Retropie2/marketing.tar"
$ wget -N "http://downloads.sourceforge.net/project/pinn/os/Retropie2/partition_setup.sh"

Similarly, we need to modify partitions.json and edit the values for "partition_size_nominal" and "uncompressed_tarball_size" for each of the boot and root partitions, so 4 values in total.

First in the boot partition, replace the value of "uncompressed_tarball_size" with the value produced from:
$ expr `cat boot.size` / 1024 + 1
Whatever this value is, add 100 to it and use it to replace the value of "partition_size_nominal"

Next for the root partition, replace the value of "uncompressed_tarball_size" with the value produced from:
$ expr `cat root.size` / 1024 + 1
Whatever this value is, add 100 to it and use it to replace the value of "partition_size_nominal"

Note the spaces and punctuation of backticks in the above expressions which are not quotes or apostrophes.

Step 3 - Copy the custom OSes to a new SD card.

Having prepared the custom OSes, they now need to be put on a USB stick, or an SD card that can be inserted into a USB SD Card reader. If any of the files in the ~/os/<osname> are greater than 4GB in size (the root.tar.xz file is likely to be the largest), then this memory device must be formatted as ext4 and you must use PINN v2.4.2i which has been adapted to support ext4 formatted installation devices. If the installation files are all smaller than 4GB, then the memory device may be formatted as FAT32 and any version of PINN can be used.

So, format your memory device to the appropriate above format and make sure it is large enough to hold all of the files in the ~/os/ folder.

Now copy the ~/os/ folder and all sub folders to your memory device. Assuming your memory device is mounted at /media/<username>/usb you can use the following command to copy them. $ cp -r ~/os/ /media/<username>/usb

Step 4 - Make a PINN Bootable SD card

Format your SD card as FAT32

For Windows users, we recommend formatting your SD card using the SD Association's Formatting Tool, which can be downloaded from https://www.sdcard.org/downloads/formatter_4/ You will need to set "FORMAT SIZE ADJUSTMENT" option to "ON" in the "Options" menu to ensure that the entire SD card volume is formatted - not just a single partition. For more detailed and beginner-friendly formatting instructions, please refer to http://www.raspberrypi.org/quick-start-guide

The SD Association's Formatting Tool is also available for Mac users although the default OSX Disk Utility is also capable of formatting the entire disk (select the SD card volume and choose "Erase" with "MS-DOS" format).

For Linux users we recommend gparted (or the command line version parted). (Update: Norman Dunbar has written up the following formatting instructions for Linux users: http://qdosmsq.dunbar-it.co.uk/blog/2013/06/NOOBS-for-raspberry-pi/ )

Copy the pinn files to your SD card.

  • Download pinn-242i.zip from sourceforge
  • Extract the files from this zip file onto the SD card. (Windows built-in zip features may have trouble with this file. If so, use another program such as 7zip.) Please note that in some cases it may extract the files into a folder, if this is the case then please copy across the files from inside the folder rather than the folder itself.

(Ordinarily, you can use the standard pinn-lite.zip, but the v2.4.2i version will also install custom OSes from an ext4 formatted USB memory stick to avoid the 4GB FAT32 filesize limit.)

Step 5 - Install the custom backups

Clone this wiki locally