changed usage of uncompress to decompress where it made sense

This commit is contained in:
Kevin Putnam
2018-10-01 11:14:42 -07:00
parent 2f1ba1f36e
commit ecffbf09e5
19 changed files with 67 additions and 67 deletions
@@ -65,7 +65,7 @@ Our version of ``qemu-lite`` has the following modifications:
* **Direct kernel boot**, allowing fast booting by loading the kernel as
an uncompressed ELF binary. Although the kernel image is slightly larger
than a compressed one, it is faster to read and boot the larger
file than it is to uncompress and boot the slightly smaller file.
file than it is to decompress and boot the slightly smaller file.
* **Added an** :abbr:`OCI (Open Container Initiative)` **runtime-compliant
wrapper**, AKA ``cor``, for easier integration with
:abbr:`OCI (Open Container Initiative)`-compliant host orchestration systems.
@@ -136,7 +136,7 @@ fast and lightweight hypervisor. Optimizations to `kvmtool`_ include:
* **Direct kernel boot** -- The hypervisor can boot the kernel directly as
an uncompressed ELF binary. Although the kernel image is slightly larger
than a compressed one, it is faster to read and boot the larger
file than it is to uncompress and boot the slightly smaller file.
file than it is to decompress and boot the slightly smaller file.
Client mini-OS
@@ -260,7 +260,7 @@ Modifications to `kvmtool`_ include:
* **Direct kernel boot** -- The hypervisor can boot the kernel directly as
an uncompressed ELF binary. Although the kernel image is slightly larger
than a compressed one, it ends up being faster to read and boot the larger
file than it is to uncompress and boot the slightly smaller file.
file than it is to decompress and boot the slightly smaller file.
.. _qemu-lite:
@@ -22,11 +22,11 @@ Look for the :file:`clear-[version number]-installer.img.xz` file. You can also
curl -O https://download.clearlinux.org/image/clear-$(curl https://download.clearlinux.org/latest)-installer.img.xz
Once you have downloaded the image, verify and uncompress the file.
Once you have downloaded the image, verify and decompress the file.
.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst
.. include:: ../../guides/maintenance/download-verify-decompress-linux.rst
:Start-after: verify-linux:
:end-before: To uncompress a GZ
:end-before: To decompress a GZ
.. include:: ../bootable-usb/bootable-usb-linux.rst
:Start-after: copy-usb-linux:
@@ -17,7 +17,7 @@ Instructions are also available for other operating systems:
:start-after: incl-image-filename:
:end-before: incl-image-filename-end:
.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst
.. include:: ../../guides/maintenance/download-verify-decompress-linux.rst
:Start-after: verify-linux:
.. _copy-usb-linux:
@@ -35,7 +35,7 @@ Burn the |CL| image onto a USB drive
sudo -s
#. Go to the directory with the uncompressed image.
#. Go to the directory with the decompressed image.
#. Plug in the USB drive.
#. Identify the USB drive using the :command:`lsblk` command. This shows all
drives attached to the system, including the primary hard disk. In the
@@ -17,7 +17,7 @@ Instructions are also available for other operating systems:
:start-after: incl-image-filename:
:end-before: incl-image-filename-end:
.. include:: ../../guides/maintenance/download-verify-uncompress-mac.rst
.. include:: ../../guides/maintenance/download-verify-decompress-mac.rst
:start-after: verify-mac:
@@ -29,7 +29,7 @@ Burn the |CL| image onto a USB drive
|CAUTION-BACKUP-USB|
#. Launch the Terminal app.
#. Go to the directory with the uncompressed image.
#. Go to the directory with the decompressed image.
#. Plug in a USB drive and get its identifier by entering the command
:command:`diskutil list`. See Figure 1.
@@ -17,7 +17,7 @@ Instructions are also available for other operating systems:
:start-after: incl-image-filename:
:end-before: incl-image-filename-end:
.. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst
.. include:: ../../guides/maintenance/download-verify-decompress-windows.rst
:Start-after: verify-windows:
Burn the |CL| image onto a USB drive
@@ -29,7 +29,7 @@ a virtual network.
Create a virtual machine
************************
#. Download and uncompress the latest hyperv disk image
#. Download and decompress the latest hyperv disk image
:file:`clear-XXXXX-hyperv.img.gz`, where XXXXX is the latest
available version of |CL| from our `downloads`_ section.
@@ -68,13 +68,13 @@ this command:
Visit :ref:`image-types` for additional information about all available |CL| images.
.. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst
.. include:: ../../guides/maintenance/download-verify-decompress-windows.rst
:Start-after: verify-windows:
We also provide instructions for other operating systems:
* :ref:`download-verify-uncompress-linux`
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-decompress-linux`
* :ref:`download-verify-decompress-mac`
Create and configure a new VM
*****************************
@@ -182,7 +182,7 @@ Create and configure a new VM
Attach the pre-configured |CL| VMware image
*******************************************
#. Move the downloaded and uncompressed pre-configured |CL| VMware image file
#. Move the downloaded and decompressed pre-configured |CL| VMware image file
:file:`clear-[version number]-basic.vmdk` to the directory where your
newly-created VM resides.
@@ -70,13 +70,13 @@ Look for :file:`clear-[version number]-installer.iso.xz`.
Visit :ref:`image-types` for additional information about all available |CL| images.
.. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst
.. include:: ../../guides/maintenance/download-verify-decompress-windows.rst
:Start-after: verify-windows:
We also provide instructions for other operating systems:
* :ref:`download-verify-uncompress-linux`
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-decompress-linux`
* :ref:`download-verify-decompress-mac`
Create and configure a new VM
*****************************
@@ -103,7 +103,7 @@ Create and configure a new VM
Figure 2: VMware Workstation 14 Player - Select |CL| installer ISO
#. Click the :guilabel:`Browse` button and select the uncompressed |CL|
#. Click the :guilabel:`Browse` button and select the decompressed |CL|
installer ISO.
#. Click the :guilabel:`Next` button.
@@ -38,14 +38,14 @@ Download the latest |CL| installer ISO
Get the latest |CL| installer ISO image from the `image`_ repository.
Look for :file:`clear-[version number]-installer.iso.xz`.
.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst
.. include:: ../../guides/maintenance/download-verify-decompress-linux.rst
:Start-after: verify-linux:
:end-before: To uncompress a GZ
:end-before: To decompress a GZ
For alternative instructions on other operating systems, see:
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-uncompress-windows`
* :ref:`download-verify-decompress-mac`
* :ref:`download-verify-decompress-windows`
Upload the |CL| installer ISO to the VMware server
**************************************************
@@ -81,7 +81,7 @@ Upload the |CL| installer ISO to the VMware server
Figure 3: VMware ESXi - Datastore > Upload ISO
#. Select the uncompressed |CL| installer ISO file :file:`clear-[version number]-installer.iso`
#. Select the decompressed |CL| installer ISO file :file:`clear-[version number]-installer.iso`
and upload it.
Create and configure a new VM
@@ -40,20 +40,20 @@ this command:
Visit :ref:`image-types` for additional information about all available |CL| images.
.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst
.. include:: ../../guides/maintenance/download-verify-decompress-linux.rst
:Start-after: verify-linux:
:end-before: To uncompress a GZ
:end-before: To decompress a GZ
For alternative instructions on other operating systems, see:
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-uncompress-windows`
* :ref:`download-verify-decompress-mac`
* :ref:`download-verify-decompress-windows`
Upload the |CL| image to the VMware server
******************************************
Once the |CL| VMware prebuilt image has been downloaded and
uncompressed on your local system, it must be uploaded to a datastore
decompressed on your local system, it must be uploaded to a datastore
on the VMware ESXi server.
The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_
@@ -92,7 +92,7 @@ The steps in this section can also be referenced from the `VMware documentation
Figure 3: VMware ESXi - Datastore > Upload VMware image
#. Select the uncompressed |CL| VMware image file
#. Select the decompressed |CL| VMware image file
:file:`clear-[version number]-vmware.vmdk` and upload it.
Convert the |CL| image to an ESXi-supported format
@@ -1,15 +1,15 @@
.. _download-verify-uncompress-linux:
.. _download-verify-decompress-linux:
Download, verify, and uncompress a Clear Linux image on Linux
Download, verify, and decompress a Clear Linux image on Linux
#############################################################
This guide describes the types of |CLOSIA| images available, where to download
them, how to verify the integrity of an image, and how to uncompress it.
This guide describes the types of |CL-ATTR| images available, where to download
them, how to verify the integrity of an image, and how to decompress it.
Instructions for other operating systems are available:
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-uncompress-windows`
* :ref:`download-verify-decompress-mac`
* :ref:`download-verify-decompress-windows`
Image types
***********
@@ -45,23 +45,23 @@ the screen followed by `OK`.
For a more in-depth discussion of image verification including checking the
certificate see :ref:`image-content-validation`.
Uncompress the Clear Linux image
Decompress 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
environment. To uncompress the image, follow these steps:
environment. To decompress the image, follow these steps:
#. Start a terminal emulator.
#. Go to the directory with the downloaded image.
To uncompress an XZ image, enter:
To decompress an XZ image, enter:
.. code-block:: bash
unxz clear-[version number]-[image type].xz
To uncompress a GZ image, enter:
To decompress a GZ image, enter:
.. code-block:: bash
@@ -1,15 +1,15 @@
.. _download-verify-uncompress-mac:
.. _download-verify-decompress-mac:
Download, verify, and uncompress a Clear Linux image on macOS\*
Download, verify, and decompress a Clear Linux image on macOS\*
###############################################################
This guide describes the types of |CLOSIA| images available, where to download
them, how to verify the integrity of an image, and how to uncompress it.
This guide describes the types of |CL-ATTR| images available, where to download
them, how to verify the integrity of an image, and how to decompress it.
Instructions for other operating systems are available:
* :ref:`download-verify-uncompress-linux`
* :ref:`download-verify-uncompress-windows`
* :ref:`download-verify-decompress-linux`
* :ref:`download-verify-decompress-windows`
Image types
***********
@@ -41,16 +41,16 @@ If the checksum of the downloaded image is different than the original
checksum, the differences will be displayed. Otherwise, an empty output indicates
a match and your downloaded image is good.
Uncompress the Clear Linux image
Decompress the Clear Linux image
********************************
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:
platform or environment. To decompress the image, follow these steps:
#. Start the Terminal app.
#. Go to the directory with the downloaded image.
#. Use the :command:`gunzip` command to uncompress either compression type. For example:
#. Use the :command:`gunzip` command to decompress either compression type. For example:
.. code-block:: bash
@@ -1,15 +1,15 @@
.. _download-verify-uncompress-windows:
.. _download-verify-decompress-windows:
Download, verify, and uncompress a Clear Linux image on Windows\*
Download, verify, and decompress a Clear Linux image on Windows\*
#################################################################
This guide describes the types of |CLOSIA| images available, where to download
them, how to verify the integrity of an image, and how to uncompress it.
This guide describes the types of |CL-ATTR| images available, where to download
them, how to verify the integrity of an image, and how to decompress it.
Instructions for other operating systems are available:
* :ref:`download-verify-uncompress-linux`
* :ref:`download-verify-uncompress-mac`
* :ref:`download-verify-decompress-linux`
* :ref:`download-verify-decompress-mac`
Image types
***********
@@ -39,19 +39,19 @@ checksum file designated with the suffix `-SHA512SUMS`.
#. Manually compare the output with the original checksum value shown in
the downloaded checksum file and make sure they match.
Uncompress the Clear Linux image
Decompress 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
environment. To uncompress the image, follow these steps:
environment. To decompress the image, follow these steps:
#. Download and install `7-Zip`_.
#. Go to the directory with the downloaded image and right-click it.
#. From the pop-up menu, select :guilabel:`7-Zip` and select
:guilabel:`Extract Here` as shown in Figure 1.
.. figure:: figures/download-verify-uncompress-windows-fig-1.png
.. figure:: figures/download-verify-decompress-windows-fig-1.png
:scale: 80 %
:alt: 7-Zip extract file

Before

Width:  |  Height:  |  Size: 44 KiB

After

Width:  |  Height:  |  Size: 44 KiB

@@ -4,7 +4,7 @@ Maintenance guide
#################
This guide provides step-by-step instructions for common tasks associated with
maintaining |CLOSIA| after :ref:`installation <get-started>` is completed.
maintaining |CL-ATTR| after :ref:`installation <get-started>` is completed.
.. toctree::
:maxdepth: 2
@@ -20,7 +20,7 @@ maintaining |CLOSIA| after :ref:`installation <get-started>` is completed.
telemetry-enable
time
increase-virtual-disk-size
download-verify-uncompress-linux
download-verify-uncompress-mac
download-verify-uncompress-windows
download-verify-decompress-linux
download-verify-decompress-mac
download-verify-decompress-windows
autospec
@@ -4,7 +4,7 @@ Use mixer tool
##############
*Mixing* refers to composing an operating system for specific use cases.
While the default |CLOSIA| provides options to install bundles for various
While the default |CL-ATTR| provides options to install bundles for various
server capabilities, some developers may wish to either augment the
operating system itself with functionality from their own packages or modify
the structure of current bundles to cater to their particular needs.
@@ -28,7 +28,7 @@ First, if your mix only uses |CL| content, *skip step 5* below.
Second, if your mix includes your own
:abbr:`RPMs (RPM Package Manager files)`, follow all these steps.
#. `Create ngninx web server to host mixer updates`_
#. `Create nginx web server to host mixer updates`_
#. `Create a workspace`_
#. `Generate the starting point for your mix`_
#. `Edit builder.conf`_
@@ -3,7 +3,7 @@
Create a Clear Linux\* based web server
#######################################
This tutorial shows you how to create a LAMP server using |CLOSIA| and how to use phpMyAdmin\* to manage an associated database.
This tutorial shows you how to create a LAMP server using |CL-ATTR| and how to use phpMyAdmin\* to manage an associated database.
In order to create a web server using |CL| as the host OS, your host system
must be running |CL|. This tutorial assumes you have successfully installed
@@ -360,7 +360,7 @@ our |CL| host system.
This example downloads and uses version 4.6.4.
#. Once the file has been successfully downloaded and verified, uncompress
#. Once the file has been successfully downloaded and verified, decompress
the file and directories into the Apache web server document root
directory. Use the following commands: