diff --git a/source/gs_creating_bootable_usb.rst b/source/gs_creating_bootable_usb.rst index e838e609..ba379d20 100644 --- a/source/gs_creating_bootable_usb.rst +++ b/source/gs_creating_bootable_usb.rst @@ -1,58 +1,71 @@ -Creating a bootable USB stick to install the OS -############################################################ +.. _bootable_usb: + +Creating a bootable USB to install the OS +========================================= +Here's how to create a USB drive that initiates the process for +:ref:`clr_as_host`. Alternatively, you can test the OS by :ref:`clr_in_virtual_env`. -This article explains how to create a bootable USB stick to `install Clear Linux* OS for IntelĀ® Architecture as host `_ on a target computer. You can also `run the OS in a virtualized environment `_. What you need -------------------- -To create a bootable USB stick to install the OS, you need the following: +------------- +* A USB stick, formatted as ``ext4``. Remember that the process of flashing + data to a USB completely deletes the contents of the drive; as always, run + ``dd`` with caution. +* A ClearLinux OS image; the most current version can be found here: + `https://download.clearlinux.org/image `_ + .. tip:: -* A USB stick, formatted as ext4. Remember that the process of flashing to a USB completely deletes the contents of the drive; as always, run ``dd`` with caution. -* An OS image; the most current version can be found here: `https://download.clearlinux.org/image `_. For older versions, see our `downloads page `_. + For older versions, see our `downloads page `_. -Grab the installer image ------------------------- -.. code:: text - $ wget https://download.clearlinux.org/image/clear-[release_number]-installer.img.xz +Download and checksum +--------------------- -Check the SHA512 ----------------- -.. code:: text +:: + +$ wget https://download.clearlinux.org/image/clear-[release_number]-installer.img.xz +$ sha512sum clear-[release_number]-installer.img.xz` - $ sha512sum clear-[release_number]-installer.img.xz -The above command outputs the checksum of the image you just downloaded; it will, of course, vary depending on the version you're testing. Confirm the mount point on the USB drive ---------------------------------------- -Using the ``lsblk`` command is helpful to show the block-level devices; a USB drive usually shows up under ``/sdb`` or ``/sdc`` (not ``/sda``) and should indicate disk space < the size of the USB drive. +Using :command:`$ lsblk` is helpful to show the block-level devices; a USB drive +usually shows up under ``/sdb`` or ``/sdc`` (almost never ``/sda``), and should +indicate disk space approximately the size of the USB drive: -.. code:: text +:: - $ lsblk /dev/sdb NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT sdb 8:16 1 14.9G 0 disk ?? sdb1 8:17 1 14.9G 0 part + $ lsblk /dev/sdb + NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT + ?? sdb 8:16 1 14.9G 0 + ?? sdb1 8:17 1 14.9G 0 part + +and make sure the drive isn't already mounted. The easiest way is with +:command:`# df`. -Make sure that the USB is not mounted -------------------------------------- -The easiest way is with ``# df``. Flash the image to the USB -------------------------- -Flash the image with the following command, adding the -v option for verbose mode (recommended), as the image file may be large, and the process can take a while. This will likely need to be done as root. +Flash the image with the following command, adding the ``-v`` option for verbose mode +(recommended), as the image file may be large, and the process can take a while. This +may need to be done as root. + +:: + + $ xzcat -v clear-[release_number]-installer.img.xz | dd of=/dev/sdb bs=4M -.. code:: text - # xzcat -v clear-[release_number]-installer.img.xz | dd of=/dev/sdb bs=4M Wait for the final confirmation ------------------------------- -This example shows ``clear-2190-installer.img.xz`` flashed to a 16GB USB stick mounted on ``/sdc``. +This example shows ``clear-2190-installer.img.xz`` flashed to a 16GB USB drive +mounted on ``/sdc``. -.. image:: images\gs_confirmation_screen.png - :align: center - :alt: confirmation +.. image:: images/gs_confirmation_screen.png + :align: center + :alt: confirmation -Success! -++++++++ -Your USB stick is now ready to `boot and install the Clear Linux OS for Intel Architecture `_. +Success! Your USB stick is now ready to boot and initiate the process for +:ref:`clr_as_host`. \ No newline at end of file