31f97de261
mirror.starlingx.cengn.ca no longer exists. CENGN is kindly forwarding requests to the new location mirror.starlingx.windriver.com for now, but that will only last a few months. We need to replace all the references with the new URL. I will also remove as many 'cengn' references as possible, replacing them with 'stx_mirror' Partial-Bug: 2033555 Change-Id: I7573f2d1b6cffa749c983492bae536bf13ba05cb Signed-off-by: Scott Little <scott.little@windriver.com>
137 lines
3.8 KiB
ReStructuredText
137 lines
3.8 KiB
ReStructuredText
|
||
.. _bootable_usb:
|
||
|
||
===================
|
||
Create Bootable USB
|
||
===================
|
||
|
||
Follow the instructions for your system to create a bootable USB with the
|
||
StarlingX ISO:
|
||
|
||
* :ref:`bootable-usb-linux`
|
||
* :ref:`bootable-usb-mac`
|
||
* :ref:`bootable-usb-windows`
|
||
|
||
|
||
.. _bootable-usb-linux:
|
||
|
||
--------------------------------------
|
||
Create a bootable USB drive on Linux\*
|
||
--------------------------------------
|
||
|
||
#. Open a terminal and get root privilege:
|
||
|
||
::
|
||
|
||
sudo -s
|
||
|
||
#. Get the latest StarlingX ISO from the
|
||
`StarlingX mirror <https://mirror.starlingx.windriver.com/mirror/starlingx/release/latest_release/debian/monolithic/outputs/iso/>`_.
|
||
Alternately, you can get an older release ISO from `here <https://mirror.starlingx.windriver.com/mirror/starlingx/release/>`_.
|
||
|
||
#. Navigate to the directory with the `StarlingX ISO <https://mirror.starlingx.windriver.com/mirror/starlingx/release/latest_release/centos/flock/outputs/iso/>`_.
|
||
|
||
#. Plug in the USB drive and get its identifier:
|
||
|
||
::
|
||
|
||
lsblk
|
||
|
||
This will list available disks and their partitions.
|
||
|
||
#. 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
|
||
|
||
#. 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.
|
||
|
||
|
||
.. _bootable-usb-mac:
|
||
|
||
--------------------------------------
|
||
Create a bootable USB drive on macOS\*
|
||
--------------------------------------
|
||
|
||
#. Launch the Terminal app.
|
||
|
||
#. Get the latest StarlingX ISO from the
|
||
`StarlingX mirror <https://mirror.starlingx.windriver.com/mirror/starlingx/release/latest_release/debian/monolithic/outputs/iso/>`_.
|
||
Alternately, you can get an older release ISO from `here <https://mirror.starlingx.windriver.com/mirror/starlingx/release/>`_.
|
||
|
||
#. Navigate to the directory with the ISO.
|
||
|
||
#. Plug in a USB drive and get its identifier:
|
||
|
||
::
|
||
|
||
diskutil list
|
||
|
||
This will list available disks and their partitions.
|
||
|
||
#. Unmount the USB drive identified in the previous step. For example:
|
||
|
||
::
|
||
|
||
diskutil umountDisk /dev/disk2
|
||
|
||
#. Burn the StarlingX bootimage.iso onto the USB drive.
|
||
The example below burns an ISO onto `<your USB device>`:
|
||
|
||
.. code-block:: bash
|
||
|
||
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.
|
||
|
||
#. Eject the USB drive.
|
||
|
||
.. code-block:: bash
|
||
|
||
diskutil eject /dev/disk2
|
||
|
||
.. _bootable-usb-windows:
|
||
|
||
----------------------------------------
|
||
Create a bootable USB drive on Windows\*
|
||
----------------------------------------
|
||
|
||
#. Get the latest StarlingX ISO from the
|
||
`StarlingX mirror <https://mirror.starlingx.windriver.com/mirror/starlingx/release/latest_release/debian/monolithic/outputs/iso/>`_.
|
||
Alternately, you can get an older release ISO from `here <https://mirror.starlingx.windriver.com/mirror/starlingx/release/>`_.
|
||
|
||
#. Download the `Rufus`_ utility to burn the image onto a USB drive.
|
||
**Only use the latest version of Rufus**.
|
||
|
||
#. Plug in the USB drive and open Rufus.
|
||
|
||
#. Under `Boot selection`, click the :guilabel:`SELECT` button.
|
||
|
||
#. Find and select the StarlingX ISO.
|
||
|
||
#. Click the :guilabel:`START` button.
|
||
|
||
#. When the dialogue appears, select
|
||
:guilabel:`Write in ISO image mode (Recommended)`.
|
||
|
||
#. Select the Windows taskbar menu for USB and select eject.
|
||
|
||
.. _Rufus: https://rufus.ie/
|
||
|