Edits installation instructions for accuracy; corrects grammatical errors.

- Corrects grammatical errors and simplifies instruction for various installation methods.
- Revises bare-metal-manual-install to correct errors and for readability.
- Revises cgdisk-manual-install; omits fig. 16, then directs user to bare-metal-manual-install.
- Revise virtualbox.rst, first two paragraphs for conciseness; omits prefixes to commands
- Revises instruction in Bundle Selector. Fixes Figure 15.
- Corrects erroneous link in first para to bare-metal-manual-install.

Signed-off-by: Michael Vincerra <michaelx.vincerra@intel.com>
This commit is contained in:
Michael Vincerra
2018-03-22 15:59:18 -07:00
parent 7e09fc02e6
commit 9e6833d1e0
8 changed files with 175 additions and 174 deletions
@@ -165,10 +165,8 @@ open a shell, or exit the |CL| installer. This menu is shown in figure 5:
installation process and the system will shut down.
#. You will be prompted to join the :guilabel:`Stability Enhancement Program`
as shown in figure 6. Press the :kbd:`Spacebar` or :kbd:`Enter` key while
the cursor is in the :guilabel:`[ ] Yes.` button to enable this
functionality and then select the :guilabel:`< Next >` button to advance to
the next menu item.
as shown in figure 6. Press the :kbd:`Spacebar` or :kbd:`Enter` key until
the cursor appears in the :guilabel:`[ ] Yes.` button. Press tab to highlight :guilabel:`< Next >`, and select Enter to advance.
.. figure:: figures/bare-metal-install-6.png
:scale: 50 %
@@ -221,57 +219,61 @@ process. Otherwise, you can follow the |CL| automatic installation steps.
Clear Linux automatic installation
**********************************
To install the minimum components for your |CL| implementation, select the
:guilabel:`< Automatic >` menu item shown in figure 7 and press the
:kbd:`Enter` key.
#. To install the minimum components for your |CL| implementation, select the
:guilabel:`< Automatic >` menu item shown in figure 7 and press the
:kbd:`Enter` key.
The :guilabel:`Choose target device for installation` screen shown in figure 8
appears. Move the cursor to the desired target and press the :kbd:`Enter`
key.
The :guilabel:`Choose target device for installation` screen shown in figure 8 appears.
.. figure:: figures/bare-metal-install-8.png
:scale: 50 %
:alt: Choose target device for installation
#. Move the cursor to the desired target and press the :kbd:`Enter`
key.
.. figure:: figures/bare-metal-install-8.png
:scale: 50 %
:alt: Choose target device for installation
Figure 8: :guilabel:`Choose target device for installation`
In this example we selected the single primary partition from our hard drive.
In this example, we selected the single primary partition from our hard drive.
With all the |CL| installer setup information gathered for the automatic
installation option, the |CL| Installer prompts you to begin the actual
installation as shown in figure 9.
With all the |CL| installer setup information gathered for the automatic
installation option, the |CL| Installer prompts you to begin the actual
installation as shown in figure 9.
.. figure:: figures/bare-metal-install-9.png
:scale: 50 %
:alt: Begin installation
.. figure:: figures/bare-metal-install-9.png
:scale: 50 %
:alt: Begin installation
Figure 9: :guilabel:`Begin installation`
When you are satisfied with the information you have entered, select the
:guilabel:`< Yes >` button and press :kbd:`Enter` to begin installing |CL|.
#. When you are satisfied with the information you have entered, select the
:guilabel:`< Yes >` button and press :kbd:`Enter` to begin installing |CL|.
|CL| Installation begins and each step shows its status as it progresses
through the automated installation process.
|CL| Installation begins and each step shows its status as it progresses
through the automated installation process.
Once all steps have completed, you will see the :guilabel:`Successful
installation` status message and the :guilabel:`< Ok >` button is highlighted
as shown in figure 10. Press the :kbd:`Enter` key to continue.
Once all steps have completed, you will see the :guilabel:`Successful
installation` status message and the :guilabel:`< Ok >` button is highlighted as shown in figure 10.
.. figure:: figures/bare-metal-install-10.png
:scale: 50 %
:alt: Installation complete
#. Press the :kbd:`Enter` key to continue.
Figure 10: :guilabel:`Installation complete`
.. figure:: figures/bare-metal-install-10.png
:scale: 50 %
:alt: Installation complete
Figure 11 shows the installer's final screen prompting you that the
installation completed successfully and the system will reboot. Press the
:kbd:`Enter` key and remove the USB media while the system restarts.
Figure 10: :guilabel:`Installation complete`
.. figure:: figures/bare-metal-install-11.png
:scale: 50 %
:alt: Successful installation
Figure 11 shows the final installer screen, showing that the
installation completed successfully and the system will reboot.
Figure 11: :guilabel:`Successful Installation`
#. Press the :kbd:`Enter` key and remove the USB media while the system
restarts.
.. figure:: figures/bare-metal-install-11.png
:scale: 50 %
:alt: Successful installation
Figure 11: :guilabel:`Successful Installation`
Set up your root account
========================
@@ -4,17 +4,17 @@ Bare metal manual installation guide
####################################
This section contains the steps for a |CL| manual installation. It picks up
where the :ref:`bare-metal-install` left off:
where the :ref:`bare-metal-install` left off.
Select the :guilabel:`< Manual(Advanced) >` menu option as seen in figure
1, to do the following additional tasks during the |CL| Installer setup:
To perform additional tasks during the |CL| Installer setup, select the
:guilabel:`< Manual(Advanced) >` menu option (figure 1).
* :ref:`Modify the disk layout using the cgdisk utility<cgdisk-manual-install>`
* Add additional command-line parameters to the kernel
* Create a hostname for your system
* Create an administrative user
* Add additional software bundles to enhance the functionality of your initial
|CL| installation
* Add additional software bundles to enhance the functionality of your
initial |CL| installation
* Optionally set up a static IP address for your system
Begin the manual installation process
@@ -29,7 +29,8 @@ Begin the manual installation process
Figure 1: :guilabel:`Choose installation Type`
#. The :guilabel:`Choose partitioning method` screen is shown in figure 2.
#. The screen :guilabel:`Choose partitioning method` will
appear (figure 2).
.. figure:: figures/bare-metal-manual-install-2.png
:scale: 50 %
@@ -37,10 +38,10 @@ Begin the manual installation process
Figure 2: :guilabel:`Choose partitioning method`
If your hard drive has already been partitioned for a Linux system, you can
select the :guilabel:`< Use default partition and mount scheme on target
device >` menu item and press :kbd:`Enter` to move to the next step of the
installer setup process.
If your hard drive has already been partitioned for a Linux system, you
can select the :guilabel:`< Use default partition and mount scheme on
target device >` menu item and press :kbd:`Enter` to move to the next
step of the installer setup process.
.. _cgdisk-manual-setup:
@@ -54,8 +55,8 @@ Begin the manual installation process
Choose target device for installation
=====================================
The :guilabel:`Choose target device for installation` menu, shown in figure 3,
displays the current device and partition information. In
The :guilabel:`Choose target device for installation` menu, shown in figure
3, displays the current device and partition information. In
this example, ``/dev/sda`` is the only drive on the system with three
partitions defined and assigned. The menu cursor highlights the partition
to install |CL| onto.
@@ -75,12 +76,12 @@ to install |CL| onto.
Figure 3: :guilabel:`Choose target device for installation`
#. After selecting the :guilabel:`< Partition /dev/sda >` button you will be
presented with a warning screen as shown in figure 4 with the
:guilabel:`< No >` button highlighted. If you are satisfied this is the
device that you want to install |CL| onto, use the :kbd:`Tab` key to
highlight the :guilabel:`< Yes >` button and press :kbd:`Enter` to proceed
to the next step.
#. Next, you will be presented with a warning screen (figure 4) with
:guilabel:`< No >` highlighted by default. If this is the device onto
which you wish to install |CL|, press :kbd:`Tab` to highlight
the :guilabel:`< Yes >` button.
#. Press :kbd:`Enter` to proceed.
.. figure:: figures/bare-metal-manual-install-4.png
:scale: 50 %
@@ -88,6 +89,8 @@ to install |CL| onto.
Figure 4: :guilabel:`Device installation warning`
.. _Additional_manual_installer_settings:
Additional manual installer settings
====================================
@@ -100,11 +103,11 @@ The next steps of the manual installer setup process allows you to:
* Optionally create a static IP address for your system.
#. The :guilabel:`Append to kernel cmdline` menu shown in figure 5 allows you
to add additional options to the kernel command-line to further customize
your installation. Normally this is not required but if there are
specific options that need to be set in the Linux kernel you can enter them
here. For a complete list of command-line parameters for the Linux kernel
you can visit the official documentation of the `latest kernel's
to add more options to the kernel command-line to further customize
your installation. Normally this is not required; however, if there are
specific options that need to be set in the Linux kernel, you can enter
them here. For a complete list of command-line parameters for the Linux
kernel you can visit the official documentation of the `latest kernel's
command-line parameters`_.
Add any additional command-line parameters in the :guilabel:`Append to
@@ -132,9 +135,10 @@ The next steps of the manual installer setup process allows you to:
check this `wiki page about hostnames`_.
#. The :guilabel:`User configuration` menu shown in figure 7 allows you to
create a userid with administrative privileges. If you do not want to create a
user at this time, select :guilabel:`< No user creation (login as root) >` to
skip this step and proceed to the :guilabel:`Bundle selector` menu.
create a userid with administrative privileges. If you do not want to
create a user at this time, select
:guilabel:`< No user creation (login as root) >` to skip this step and
proceed to the :guilabel:`Bundle selector` menu.
.. figure:: figures/bare-metal-manual-install-7.png
:scale: 50 %
@@ -142,18 +146,19 @@ The next steps of the manual installer setup process allows you to:
Figure 7: :guilabel:`User configuration`
#. To create a userid, select the :guilabel:`< Create an administrative user >`
field and press :kbd:`Enter` to go to the the next screen.
#. You will be presented with the second :guilabel:`User configuration` menu
shown in figure 8. You are only required to fill in the
:guilabel:`Username`, :guilabel:`Password`, and :guilabel:`Confirm password`
fields.
#. To give the user administrative privileges, select the
:guilabel:`Add user to the sudoers?` field to add the user to the ``wheel``
group. This enables using the :command:`sudo` command for the new user.
#. To create a userid, select the :guilabel:`< Create an administrative
user >` field and press :kbd:`Enter` to go to the the next screen.
#. You will be presented with the second :guilabel:`User configuration`
menu shown in figure 8. You are only required to fill in the
:guilabel:`Username`, :guilabel:`Password`, and :guilabel:`Confirm
password` fields.
#. To give a user administrative privileges, press :kbd:`Tab` until
cursor appears in the field :guilabel:`Add user to the sudoers?` and
select. This adds the user to the ``wheel`` group and allows entry of
the :command:`sudo` command.
Once you have entered all the data for this menu, press the :kbd:`Tab` key
to highlight the :guilabel:`< Next >` button and press :kbd:`Enter`.
After entering all data, press :kbd:`Tab` until :guilabel:`< Next >`
is highlighted. Then press :kbd:`Enter`.
.. figure:: figures/bare-metal-manual-install-8.png
:scale: 50 %
@@ -161,12 +166,11 @@ The next steps of the manual installer setup process allows you to:
Figure 8: :guilabel:`User configuration - create user`
#. The :guilabel:`Bundle selector` menu shown in figure 9 allows you to
add additional software bundles to your initial |CL| installation. In this
example we select all additional bundles offered by pressing the
:kbd:`Tab` key to go to each field and pressing the :kbd:`Spacebar` or the
:kbd:`Enter` key to select each bundle. This menu will also list the
additional :guilabel:` --- required ---` software bundles that will be
#. In the menu :guilabel:`Bundle selector` (figure 9), you can add
software bundles to your initial |CL| installation. Press the :kbd:`Tab`
key to highlight additional bundles, and then press :kbd:`Spacebar` or
:kbd:`Enter` to select each bundle. This menu will also list the
additional :guilabel:`--- required ---` software bundles that will be
installed during the |CL| installation.
.. figure:: figures/bare-metal-manual-install-9.png
@@ -245,11 +249,11 @@ key and remove the USB media while the system restarts.
Once the system boots, the Gnome Desktop sign-in screen shown in figure 15
appears:
.. figure:: figures/bare-metal-manual-install-15.png
:scale: 50 %
:alt: Gnome sign-in screen
.. figure:: figures/bare-metal-manual-install-15.png
:scale: 50 %
:alt: Gnome sign-in screen
Figure 15: :guilabel:`Gnome sign-in screen`
Figure 15: :guilabel:`Gnome sign-in screen`
Click on the :guilabel:`username` you created, enter the password, and you
will be logged into the system. The Gnome 3 desktop appears as shown in
@@ -1,13 +1,12 @@
.. _cgdisk-manual-install:
Clear Linux partitioning using CGDISK
#####################################
Create partitions for Clear Linux\* using CGDISK
###############################################
These instructions guide you through the initial setup of your hard drive
partitions using the :command:`cgdisk` utility as part of the |CL| manual
installation process. If you do not wish to continue creating your own
As part of the |CL| manual installation processThese instructions guide you through the initial setup of your hard drive
partitions using the :command:`cgdisk` utility . If you do not wish to continue creating your own
partitions, :ref:`return to the bare metal manual installation
<cgdisk-manual-setup>`.
<bare-metal-manual-install>`.
Prerequisites
*************
@@ -30,24 +29,24 @@ Partition using CGDISK
We use the :command:`cgdisk` application to create a
:abbr:`GPT (GUID Partition Table)` since |CL| only supports the
:abbr:`UEFI (Unified Extensible Firmware Interface)` specification. For a
complete description of the :command:`cgdisk` utility and how to use it, visit
Rod Smith's website for a `GPT fdisk tutorial`_.
complete description of the :command:`cgdisk` utility and how to use it,
visit Rod Smith's website for a `GPT fdisk tutorial`_.
In this guide, we intend to use an unpartitioned hard drive for the |CL|
installation.
#. On the :guilabel:`Choose partitioning method` menu, shown in figure 2,
select the :guilabel:`< Manually configure mounts and partitions >` menu
item to manually partition your hard drive.
#. To manually partition your hard drive, select
:guilabel:`< Manually configure mounts and partitions >` in the menu
:guilabel:`Choose partitioning method`, shown in figure 2.
.. figure:: figures/cgdisk-manual-install-2.png
:scale: 50 %
:alt: Choose partitioning method
Figure 2: :guilabel:`Choose partitioning method`
The screen then shows the current device on your system you can partition.
In this example, shown in figure 3, :file:`/dev/sda` is available but
Next, the current device available to partition is shown. In this
example, shown in figure 3, :file:`/dev/sda` is available but
does not have any partitions defined.
#. Select the :guilabel:`< Partition /dev/sda >` menu item and press
@@ -74,9 +73,9 @@ Linux Partition setup
In order to properly set up the |CL| partitioning scheme, we create three
partitions using the :command:`cgdisk` utility in the following order:
#. EFI boot partition
#. Linux swap partition
#. Linux root partition
#. EFI boot partition
#. Linux swap partition
#. Linux root partition
For a complete understanding of these partitions, you can review the
`Linux partitioning scheme`_ information.
@@ -225,7 +224,7 @@ Set the mount points
********************
The :guilabel:`Set mount points` menu sets the mount points that the |CL|
installer uses for your |CL| installation and is shown in figure 12.
installer uses for your |CL| installation, shown in figure 12.
.. figure:: figures/cgdisk-manual-install-12.png
:scale: 50 %
@@ -233,21 +232,21 @@ installer uses for your |CL| installation and is shown in figure 12.
Figure 12: :guilabel:`Set mount points`
In this menu you need to set the mount points for the boot and root partitions
and select to format them.
In this menu you need to set the mount points for the boot and root
partitions and select to format them.
#. Highlight the EFI System partition type menu entry and press the
:kbd:`Enter` key to edit this item. The :guilabel:`Set mount point of
sda1` menu is be shown.
sda1` menu is shown.
#. For the :guilabel:`Enter mount point:` type `/boot` and press
#. For :guilabel:`Enter mount point:` type `/boot` and press
:kbd:`Enter`.
#. Enable formatting the partition by checking the :guilabel:`[ ] Format`
toggle field.
Figure 13 shows the entered information. Select the :guilabel:`< Yes >`
button and press :kbd:`Enter`.
#. Press Tab to enter the :guilabel:`[ ] Format` field.
#. Press Enter/Spacebar to select :guilabel:`[ ] Format`, which allows
formatting of the partition.
Figure 13 shows the information entered. Select :guilabel:`< Next >`
and press :kbd:`Enter`.
.. figure:: figures/cgdisk-manual-install-13.png
:scale: 50 %
@@ -266,7 +265,8 @@ and select to format them.
Figure 14: :guilabel:`Set mount point of sda3`
The final :guilabel:`Set mount points` menu item looks like figure 15:
Upon completion, the :guilabel:`Set mount points` appear as shown
in figure 15:
.. figure:: figures/cgdisk-manual-install-15.png
:scale: 50 %
@@ -274,22 +274,12 @@ and select to format them.
Figure 15: :guilabel:`Set mount points completed`
#. Select the :guilabel:`< Next >` button and press :kbd:`Enter` to proceed to
the :guilabel:`Warning!` menu to accept your changes as shown in figure 16.
#. Select the :guilabel:`< Next >` button and press :kbd:`Enter`.
.. figure:: figures/cgdisk-manual-install-16.png
:scale: 50 %
:alt: Warning
Figure 16: :guilabel:`Warning`
Highlight the :guilabel:`< Yes >` button and press :kbd:`Enter` to accept
these changes and move on to the next step of the |CL| manual install
process.
This completes the process of manually setting up your hard drive
partitions and you can now :ref:`continue with the Clear Linux manual
install<choose-target-device>`.
You have completed the process of manually partitioning your target
system. Now, :ref:`return to the bare metal manual installation
<bare-metal-manual-install>` to complete installation of Clear Linux.
Continue at the section *Additional manual installer settings*.
.. _`GPT fdisk tutorial`:
http://www.rodsbooks.com/gdisk/
@@ -26,6 +26,8 @@ Boot the Clear Linux live image
#. Plug the imaged USB drive in and boot it up.
#. Log in as `root` and set a password.
.. _create and enable user space: https://clearlinux.org/documentation/clear-linux/guides/maintenance/enable-user-space
.. _`image`: https://download.clearlinux.org/image
@@ -1,34 +1,34 @@
.. _virtualbox:
Use VirtualBox\*
################
Run pre-configured Clear Linux\* as a VirtualBox\* guest OS
###########################################################
This section explains how to run |CLOSIA| inside a `VirtualBox environment`_.
Please ensure you have enabled `Intel® Virtualization Technology
<http://www.intel.com/content/www/us/en/virtualization/virtualization-technology/intel-virtualization-technology.html>`_
(Intel® VT) and `Intel® Virtualization Technology for Directed I/O
<https://software.intel.com/en-us/articles/intel-virtualization-technology-for-directed-io-vt-d-enhancing-intel-platforms-for-efficient-virtualization-of-io-devices>`_
(Intel® VT-d) in your BIOS/UEFI firmware configuration.
This section shows how to deploy a pre-configured Clear Linux\* image as a guest on the `VirtualBox hypervisor`_ .
Download VirtualBox
===================
VirtualBox is a hypervisor supported by Oracle. You can download it from the
`official VirtualBox website`_ and select the operating system you are using.
Download **version 5.0 or greater** to ensure support for
the :abbr:`AVX (Advanced Vector Extensions)` needed to run
|CLOSIA|
VirtualBox\* is a type 2 hypervisor from Oracle. Download and use **version 5.0 or greater** from the `official VirtualBox website`_.
.. _create_vm_vbox:
Install VirtualBox
===================
#. Enable `Intel® Virtualization Technology`_ (Intel® VT) and
`Intel®Virtualization Technology for Directed I/O`_ (Intel® VT-d) in the
host machines BIOS.
#. Log in and open a terminal emulator.
#. Install VirtualBox on your host machine per the
`appropriate instructions`_.
Create a virtual machine in VirtualBox
======================================
#. Download the `latest`_ **live** version (clear-XXXX-live.img.xz)
from https://download.clearlinux.org/image/. You can also use this command:
#. Download the `latest`_ **live** version (clear-XXXX-live.img.xz) of
Clear Linux. You can also use this command:
.. code-block:: bash
@@ -38,7 +38,7 @@ Create a virtual machine in VirtualBox
+ On Linux ::
$ xz -d clear-XXXX-live.img.xz
xz -d clear-XXXX-live.img.xz
+ On Windows you can use `7zip`_.
@@ -50,11 +50,11 @@ Create a virtual machine in VirtualBox
#. To convert a raw image to :abbr:`VDI (VirtualBox Disk Image)`
format, you can use one of the following commands::
$ VBoxManage convertfromraw clear-XXXX-live.img clear-XXXX-live.vdi --format VDI
VBoxManage convertfromraw clear-XXXX-live.img clear-XXXX-live.vdi --format VDI
or::
$ vbox-img convert --srcfilename clear-XXXX-live.img --dstfilename clear-XXXX-live.vdi --srcformat raw --dstformat vdi
vbox-img convert --srcfilename clear-XXXX-live.img --dstfilename clear-XXXX-live.vdi --srcformat raw --dstformat vdi
.. note:: Be sure you have VirtualBox directory in your PATH (i.e., on
@@ -64,7 +64,7 @@ Create a virtual machine in VirtualBox
.. code-block:: console
set PATH=%PATH%;"C:\Program Files\Oracle\VirtualBox"
set PATH=%PATH%;"C:\Program Files\Oracle\VirtualBox"
.. image:: ./figures/vbox-convert-image.png
:alt: Convert image in Windows command propt
@@ -72,7 +72,8 @@ Create a virtual machine in VirtualBox
#. Create a virtual machine using the VirtualBox assistant:
a. Type: **Linux**
b. Version: **Linux 2.6 / 3.x / 4.x (64-bit)**
c. Version: **Linux 2.6 / 3.x / 4.x (64-bit)**
.. image:: ./figures/vbox-create-vm.png
:alt: Create a new image in VirtualBox
@@ -98,43 +99,46 @@ Create a virtual machine in VirtualBox
Run your new VM
===============
|CLOSIA| supports VirtualBox kernel modules used
by the Linux kernel 4.9 :abbr:`LTS (Long Term Support)` (*kernel-lts bundle*).
This kernel was selected because |CL| OS's main kernel
|CL| supports VirtualBox kernel modules used
by the Linux kernel 4.9 :abbr:`LTS (Long Term Support)`
(*kernel-lts bundle*).This kernel was selected because |CL| OS's main kernel
(``kernel-native``) bundle keeps up-to-date with the upstream Linux kernel,
and sometimes VirtualBox kernel modules aren't compatible with pre-kernel
releases.
In the first boot, |CL| will ask for a login user, type **root** and
then the system will ask you for a new password.
On the first boot, |CL| requests a user login.
#. Type **root**.
#. Enter a new password when prompted.
To install the VirtualBox kernel modules, here are the steps:
#. Install the bundle that supports VirtualBox modules::
# swupd bundle-add kernel-lts
swupd bundle-add kernel-lts
#. Set a timeout in the bootmanager to shows a menu at boot time::
# clr-boot-manager set-timeout 10
clr-boot-manager set-timeout 10
#. Update the bootloader entries with::
# clr-boot-manager update
clr-boot-manager update
#. Reboot your system with::
# reboot
reboot
and choose **clear-linux-lts-4.9.XX-YYY** kernel version.
#. (*Optional*) Unset timeout to boot directly to LTS version::
# clr-boot-manager set-timeout 0
clr-boot-manager set-timeout 0
#. (*Mandatory*) Update bootmanger to use always LTS version::
# clr-boot-manager update
clr-boot-manager update
Install Guest Additions
@@ -151,11 +155,11 @@ VirtualBox Guest Additions, follow these steps:
#. Install Linux users Guest Additions::
# install-vbox-lga
install-vbox-lga
#. Reboot your system::
# reboot
reboot
Troubleshooting
@@ -167,7 +171,6 @@ On Windows OS, *VirtualBox* cannot do a **Hardware Virtualization** when
.. image:: ./figures/vbox-no-vtx.png
:alt: VirtualBox hardware acceleration error
To disable *Hyper-V* you should execute::
bcdedit /set {current} hypervisorlaunchtype off
@@ -178,8 +181,8 @@ To enable Hyper-V again, you should execute::
bcdedit /set {current} hypervisorlaunchtype Auto
.. _appropriate instructions: https://www.virtualbox.org/manual/ch02.html
.. _official VirtualBox website: https://www.virtualbox.org/wiki/Downloads
.. _VirtualBox environment: https://www.virtualbox.org/
.. _VirtualBox hypervisor: https://www.virtualbox.org/
.. _latest: https://download.clearlinux.org/image/
.. _7zip: http://www.7-zip.org/
@@ -46,7 +46,7 @@ Uncompress the Clear Linux image
********************************
Released |CL| images are compressed with either GNU zip (*.gz*) or XZ
(*.xz*). The compression type depends on the target platform or image
(*.xz*). The compression type depends on the target platform or
environment. To uncompress the image, follow these steps:
#. Start a terminal emulator.
@@ -38,15 +38,15 @@ checksum file designated with the suffix `-SHA512SUMS`.
shasum -a512 ./clear-[version number]-[image type].[compression type] | diff ./clear-[version number]-[image type].[compression type]-SHA512SUMS -
If the checksum of the downloaded image is different than the original
checksum, the differences are displayed. Otherwise, an empty output indicates
checksum, the differences will be displayed. Otherwise, an empty output indicates
a match and your downloaded image is good.
Uncompress the Clear Linux image
********************************
Released |CL| images are compressed with either GNU zip (*.gz*) or XZ
(*.xz*). The compression type depends on the target platform or image
environment. To uncompress the image, follow these steps:
We compress all released |CL| images by default with either GNU zip
(`.gz`) or xz (`.xz`). The compression type we use depends on the target
platform or environment. To uncompress the image, follow these steps:
#. Start the Terminal app.
#. Go to the directory with the downloaded image.
@@ -43,7 +43,7 @@ Uncompress the Clear Linux image
********************************
Released |CL| images are compressed with either GNU zip (*.gz*) or XZ
(*.xz*). The compression type depends on the target platform or image
(*.xz*). The compression type depends on the target platform or
environment. To uncompress the image, follow these steps:
#. Download and install `7-Zip`_.