From 202a45a5482baf6300aecc044d011bcbc3c69ba7 Mon Sep 17 00:00:00 2001 From: Robert Nesius Date: Thu, 10 Dec 2015 16:33:38 -0800 Subject: [PATCH] Improved getting started and installation docs. --- source/gs_getting_started.rst | 39 ++++++++++++++++++++++++---- source/gs_installing_clr_as_host.rst | 17 ++++-------- 2 files changed, 39 insertions(+), 17 deletions(-) diff --git a/source/gs_getting_started.rst b/source/gs_getting_started.rst index b693fd7f..5c470450 100644 --- a/source/gs_getting_started.rst +++ b/source/gs_getting_started.rst @@ -3,9 +3,38 @@ Getting started with Clear Linux* OS for Intel® Architecture ############################################################ -The easiest way to give Clear Linux OS for Intel Architecture a spin is to download a -recent KVM image from the `image directory `_ -on our download page. This directory contains a current image, the UEFI firmware -helper and the KVM start helper script. See :ref:`gs_running_clr_virtual` for details. +There are a number of ways to download and run Clear Linux OS for Intel Architecture. +All of the images are in our `image directory `_. + +KVM Image +========= + +Download a recent KVM image along with the UEFI firmware +helper ``OVMF.fd`` and the KVM start helper script ``start_qemu.sh.`` +See :ref:`gs_running_clr_virtual` for details. + +Live Image +========== +With the live image you can boot right into Clear in a VM or, or lay the image down +on a USB drive with a tool like ``dd`` and boot from USB. This is a great +way to kick the tires with a minimal amount of effort. + +Installer Image +=============== +The installer image allows you to manipulate and target partitions, and set +other OS configuration features (hostname, administrative user) commonly found in +Linux Installers. See :ref:`gs_installing_clr_as_host` on a target computer for more information. + +**CAUTION** If you do not manually configure the install and +instead but instead use the auto-install, it will repartition ``/dev/sda``. + +Provisioning Image +================== +**CAUTION:** This image is intended to be used in a provioning environment - the installer will +repartition /dev/sda and install Clear Linux OS for Intel Architecture into the new +partition. Don't use this on a system where you care about the data on ``/dev/sda``. + +Container Evaluation +==================== + -You can also try :ref:`gs_installing_clr_as_host` on a target computer. \ No newline at end of file diff --git a/source/gs_installing_clr_as_host.rst b/source/gs_installing_clr_as_host.rst index ff457520..bda285b3 100644 --- a/source/gs_installing_clr_as_host.rst +++ b/source/gs_installing_clr_as_host.rst @@ -4,7 +4,7 @@ Installing the OS as host ########################################################## Running Clear Linux* OS for Intel® Architecture natively on a system is easy -with the simple installer image. To get started you'll need the following: +using 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:`gs_creating_bootable_usb`. @@ -18,18 +18,11 @@ Installing Clear Linux OS for Intel Architecture to a target system to boot first from the USB device. 2. Insert the USB device that is flashed with the `installer image `_ into the - target system, then reboot. As the system boots, you'll see:: + target system, then reboot. +3. The Installer user interface will appear. Once all appropriate configuration + options have been chosen the installer will install the OS. - Clear Linux OS for Intel Architecture installation in progress... Your - computer will power off once installation completes successfully. - -The entire installation should take no more than a few minutes. If you run into -any trouble, log in as root during the installation phase and check the status -of the install with:: - - $ systemctl status ister - -You might need to switch to another TTY. +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 `_.