starlingx/docs
Code Issues Proposed changes
docs/doc/source/deploy_install_guides/bootable_usb.rst
Kristal Dale 5676e4fda4 Initial commit for guide reorg - upcoming release 
- Migrated reorged content from wiki
- Naming, title, and capitalization consistency, minor rewording in sections
- Set up includes to reuse common content across pages
- Introduction: remove 'openstack users' and 'kubernetes users'
- Consolidate term definition into Key concepts page
- Archive R1, move R2 to current releast, set up for R3
- Remove stub pages for duplicate content, or content deferred to R3
- Rework intro and contribute pages for better readability
- Split Key concepts into two pages: Terms and Deployment Options
- Pass for grammar, punctuation, licensing, etc.
- Pull streamlined intro content into R2 install guides (from prev version)
- Added R2 release note page
- Update links to projects/project names to remove the "stx-"
- Add instructions for creating a bootable USB

Story: 2006315
Task: 36046

Change-Id: I38656fd382d1d9cf2969812c548fb7b2dc9dd31e
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
2019-09-02 20:47:44 +00:00

3.6 KiB
Raw Blame History

Create Bootable USB

Follow the instructions for your system to create a bootable USB with the StarlingX ISO:

  • bootable-usb-linux
  • bootable-usb-mac
  • bootable-usb-windows

Create a bootable USB drive on Linux*

  1. Open a terminal and get root privilege:

    sudo -s

  2. Get the StarlingX ISO. This can be from a private StarlingX build or from the public Cengn StarlingX build off the 'master' branch as shown below:

    wget http://mirror.starlingx.cengn.ca/mirror/starlingx/release/2.0.0/centos/outputs/iso/bootimage.iso

  3. Navigate to the directory with the ISO.

  4. Plug in the USB drive and get its identifier:

    lsblk

    This will list available disks and their partitions.

  5. Unmount the USB drive before burning an image onto it. (Note that some Linux distros automatically mount a USB drive when it is plugged in.) For example:

    umount /dev/sdd2

  6. Burn the StarlingX bootimage.iso onto the USB drive:

    dd if=</path/to/bootimage.iso> of=<your USB device> bs=1M status=progress

Caution

Not fully unmounting the USB drive before burning an image can cause file system checksum errors. If this happens, burn the image again, ensuring all the USB drive partitions are unmounted first.

Create a bootable USB drive on macOS*

  1. Launch the Terminal app.

  2. Get the StarlingX ISO. This can be from a private StarlingX build or from the public Cengn StarlingX build off the 'master' branch as shown below:

    curl -O http://mirror.starlingx.cengn.ca/mirror/starlingx/release/2.0.0/centos/outputs/iso/bootimage.iso

  3. Navigate to the directory with the ISO.

  4. Plug in a USB drive and get its identifier:

    diskutil list

    This will list available disks and their partitions.

  5. Unmount the USB drive identified in the previous step. For example:

    diskutil umountDisk /dev/disk2

  6. Burn the StarlingX bootimage.iso onto the USB drive. The example below burns an ISO onto `<your USB device>`:

    sudo dd if=</path/to/bootimage.iso> of=<your USB device> bs=1m

    To speed up the imaging process, add an ‘r’ in front of the disk identifier. For example /dev/rdisk2.

    Press <CTL>-T to check imaging progress.

  7. Eject the USB drive.

    diskutil eject /dev/disk2

Create a bootable USB drive on Windows*

  1. Get the StarlingX ISO. This can be from a private StarlingX build or from the public Cengn StarlingX build off the 'master' branch:

    http://mirror.starlingx.cengn.ca/mirror/starlingx/release/2.0.0/centos/outputs/iso/bootimage.iso

  2. Download the Rufus utility to burn the image onto a USB drive. Only use the latest version of Rufus.

  3. Plug in the USB drive and open Rufus.

  4. Under Boot selection, click the SELECT button.

  5. Find and select the StarlingX ISO.

  6. Click the START button.

  7. When the dialogue appears, select Write in ISO image mode (Recommended).

  8. Select the Windows taskbar menu for USB and select eject.