Revision as of 17:12, 13 February 2016

1 Description

This page assumes you either have access to a USB drive image or you've finished following the instructions from the sibling page Creation Guide.

The objective here is to explain on how to deploy the image for a USB drive image, although it might also work with hybrid ISO (CD/DVD images).

2 Cloning the image to a new stick

1. Download the disk image from here: Download - Disk image for the USB-stick
2. Uncompress the compressed image file from 7zip format to the raw disk image format.
   • Either uncompress it interactively or run:

       7z x OFW11-2016_v3.7z

3. Follow the instructions for deploying the image on the USB-stick by following the information given on one of the following subsections:
   • If you are using a Linux Distribution (such as Ubuntu, Fedora, CentOS or openSUSE): On Linux

2.1 On Linux

If you haven't already, please first read the description given here: Reminders.

The steps are as follows:

1. Make sure you don't have the stick mounted! Example to umount:

   umount /dev/sdX1

2. As root (or with sudo), run:

   dd if=OFW11-2016_v3.img of=/dev/sdX bs=512

   1. In another terminal (also as root):

      ps -a

   2. In another terminal (also as root), run:

      while killall -USR1 dd; do sleep 30; done

   3. Then look at the previous terminal window and every 30 seconds it should update on the current write status. Given how this command works, if you have more than one dd running, it will update for all running dd applications.
3. When it's done cloning, make sure the file system is synced:

   sync

   wait until it returns control back to you.

4. Now you can mount the stick, if you want. Or simply eject it.

3 Cloning onto a Virtual Machine Appliance for VirtualBox

WARNING: These instructions are currently being written and under testing!

These instructions provide the details on how to create a Virtual Machine Appliance for VirtualBox based on the existing USB-stick image. This enables us to not depend on having a physical USB-stick and should work on any machine that has VirtualBox running (preferably a recent one).

3.1 Requirements

Very simple:

1. Install VirtualBox, according to the official instructions: https://www.virtualbox.org/wiki/Downloads
2. Have the image that was created for the USB drive.

3.2 Converting the USB-stick image to a VDI disk

The objective here is for people who cannot write the image to a USB drive, but that would still like to run the image in a VirtualBox. For these people, we can easily create a VDI disk like this:

VBoxManage convertdd --format VDI OFW11-2016_v3.img OFW11-2016_v3.vdi

Side note: Got the conversion idea from here, but the correct command is from here.