Restructures Getting Started guide.

Removes outdated files and re-arrages doc-tree to clearly
display 3 means of installation: VM, BM, and Live image.
This commit is contained in:
ihutchin
2017-06-22 20:21:31 -05:00
parent fccbdfd06c
commit 0eea7ed061
4 changed files with 7 additions and 116 deletions
@@ -1,76 +0,0 @@
.. _bootable-usb:
Creating a bootable USB to install the OS
##########################################
Here's how to create a USB drive that initiates the process for
:ref:`clear-host`. Alternatively, you can test the
OS by :ref:`kvm`.
What you need
=============
* 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 Clear Linux* OS for Intel® Architecture image; the most current
release versions can be found at the following link:
`https://download.clearlinux.org/image <https://download.clearlinux.org/image>`_
* Older versions can be found on our `downloads page`_.
Download and checksum
=====================
::
$ wget https://download.clearlinux.org/image/clear-[release_number]-installer.img.xz
$ sha512sum clear-[release_number]-installer.img.xz
Confirm the mount point on the USB drive
========================================
Using ``$ lsblk`` is helpful to show the block-level devices;
a USB drive usually shows up under ``/sdb`` or ``/sdc`` (almost never
under ``/sda``), and should indicate disk space approximately the
size of the USB drive::
$ 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
Make sure the drive isn't already mounted. The easiest way is with
``umount`` or
::
# df
Flash the image to the USB
==========================
Flash the image with the following command. This may need to be done as root or with sudo::
# xzcat clear-[release_number]-installer.img.xz | dd of=/dev/sdb
Wait for the final confirmation
===============================
This example shows ``clear-9130-installer.img.xz`` flashed to a 16GB
USB drive mounted on ``/sdb``.
.. image:: ./figures/confirmation-screen.png
:align: center
:alt: confirmation
Success! Your USB stick is now ready to boot and initiate the process for
:ref:`clear-host`.
.. _downloads page: https://download.clearlinux.org
@@ -1,32 +0,0 @@
.. _clear-host:
Installing the OS as host
#########################
Running Clear Linux\* OS for Intel® Architecture natively on a system is
easy with the installer image. To get started you'll need the following:
* A USB stick flashed with the `installer image`_. For instructions on how
to do this, see :ref:`bootable-usb`.
* A host machine running :ref:`supported-hardware`.
* Network access via DHCP.
Installing Clear Linux OS for Intel Architecture to a target system
===================================================================
#. Configure the BIOS; this may involve changing the priority of the boot
device to boot from USB port first.
#. Insert the USB device that is flashed with the
`installer image`_ into the target system, then reboot.
#. The installer user interface will appear. Once all appropriate
configuration options have been chosen, the installer will install the OS.
The entire installation should take no more than a few minutes.
For feedback on installation or other topics, please feel free to write in to
our `mailing list`_.
Note: You can also try :ref:`kvm`.
.. _installer image: http://download.clearlinux.org/image
.. _mailing list: https://lists.clearlinux.org/mailman/listinfo/dev
@@ -1,13 +1,13 @@
Getting started
###############
There are a number of options available for downloading and running Clear
Linux\* OS for Intel® Architecture. You can install |CL| under Virtual
Machines or containers, on Bare metal, or by way of Live image.
.. toctree::
:maxdepth: 2
installation-options
supported-hardware
bootable-usb
clear-host
kernels
supported-hardware
installation-options
@@ -3,8 +3,7 @@
Installation options
####################
There are a number of options available for downloading and running Clear
Linux\* OS for Intel® Architecture. You can check your system hardware
You can check your system hardware
capabilities against the list of
:ref:`supported processors <supported-hardware>`; alternatively,
download and run the `clear-linux-check-config`_ script to check the hardware