diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-10.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-10.png index ba26d552..85688105 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-10.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-10.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-11.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-11.png index 3f11505d..bb134ba2 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-11.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-11.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-12.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-12.png index 6c1460fa..ba26d552 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-12.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-12.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-13.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-13.png index 9d654081..3f11505d 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-13.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-13.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-14.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-14.png new file mode 100755 index 00000000..59e07de1 Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-14.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-15.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-15.png new file mode 100755 index 00000000..9d654081 Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-15.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-16.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-18.png similarity index 100% rename from source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-16.png rename to source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-18.png diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-19.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-19.png deleted file mode 100755 index 6e7cb4a4..00000000 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-19.png and /dev/null differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-20.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-20.png deleted file mode 100755 index 5c5bd338..00000000 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-20.png and /dev/null differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-21.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-21.png index fe3c517f..6e7cb4a4 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-21.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-21.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-22.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-22.png index d1af9ceb..5c5bd338 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-22.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-22.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-23.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-23.png index 9648bdaa..fe3c517f 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-23.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-23.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-24.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-24.png index eb9aa462..d1af9ceb 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-24.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-24.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-25.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-25.png new file mode 100755 index 00000000..9648bdaa Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-25.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-26.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-26.png new file mode 100755 index 00000000..c12c90fb Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-26.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-8.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-8.png index cd4a5fbe..b188da8a 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-8.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-8.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-9.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-9.png index bb134ba2..24e72696 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-9.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-9.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-10.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-10.png index 9cae0f41..8bd4aef8 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-10.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-10.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-11.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-11.png index 78384651..256a0c15 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-11.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-11.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-12.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-12.png index 7176122b..9cae0f41 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-12.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-12.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-13.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-13.png index 4a4125bc..78384651 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-13.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-13.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-14.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-14.png new file mode 100755 index 00000000..5e2c9eb3 Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-14.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-15.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-15.png new file mode 100755 index 00000000..4a4125bc Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-15.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-16.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-18.png similarity index 100% rename from source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-16.png rename to source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-18.png diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-19.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-19.png deleted file mode 100755 index 823250de..00000000 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-19.png and /dev/null differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-20.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-20.png deleted file mode 100755 index a96a77e6..00000000 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-20.png and /dev/null differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-21.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-21.png index 67316ce9..823250de 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-21.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-21.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-22.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-22.png index ab82c8ac..a96a77e6 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-22.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-22.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-23.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-23.png index 70da1e2f..67316ce9 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-23.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-23.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-24.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-24.png index 1749bbc6..ab82c8ac 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-24.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-24.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-25.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-25.png new file mode 100755 index 00000000..70da1e2f Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-25.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-26.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-26.png new file mode 100755 index 00000000..9959fdd4 Binary files /dev/null and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-26.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-8.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-8.png index 85ec3950..8efbe0e9 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-8.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-8.png differ diff --git a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-9.png b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-9.png index 256a0c15..2ac1d771 100755 Binary files a/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-9.png and b/source/clear-linux/get-started/virtual-machine-install/figures/vmware-esxi/vmware-esxi-originals/vmware-esxi-9.png differ diff --git a/source/clear-linux/guides/maintenance/download-image.rst b/source/clear-linux/guides/maintenance/download-image.rst new file mode 100644 index 00000000..b66220b6 --- /dev/null +++ b/source/clear-linux/guides/maintenance/download-image.rst @@ -0,0 +1,186 @@ +.. _download-image: + +Download, verify, and uncompress a Clear Linux image +#################################################### + +.. _types-of-cl-images: + +Types of Clear Linux images +=========================== + +|CL| offers many types of `images`_ for different platforms and environments. + +The naming convention of a |CL| image filename is: + + .. code-block:: console + + clear--. + +The ** field specifies the version number. + +The ** field specifies the type of image and its corresponding file format. The current list of images available are: + +.. list-table:: Table 1: Types of Clear Linux images + :widths: 20, 60 + :header-rows: 1 + + * - Image Type + - Description + * - azure.vhd + - Image for Microsoft Azure + * - azure-docker.vhd + - Image with the Docker installed for Microsoft Azure + * - azure-machine-learning.vhd + - Image with the `machine-learning-basic` bundle installed for Microsoft Azure + * - cloud.img + - Image for cloud deployment such as OpenStack, etc. + * - containers.img + - An optimized image utilized by Clear Containers runtime + * - hyperv.vhdx + - Image for Microsoft HyperV + * - hyperv-mini.vhdx + - A minimal image with fewer bundles for Microsoft HyperV + * - installer.img + - An interactive installer image for installing Clear Linux + * - installer.iso + - An ISO of the interactive installer image for installing Clear Linux + * - kvm.img + - Image for booting in a simple VM with start_qemu.sh + * - live.img + - A live boot image of Clear Linux + * - vmware.vmdk + - Image for VMware + +The ** field specifies the compression type. Two types of +compressions are used, namely GNU zip (*.gz*) and XZ (*.xz*). + +.. _images: https://download.clearlinux.org/image + +.. _verify-image-checksum: + +Verify the integrity of the Clear Linux image +============================================= + +Before using a downloaded |CL| image, it is recommended to verify its integrity +to eliminate the chance, albeit small, that it might be corrupted due to any +download issues. To support this, each released |CL| image is accompanied by an +official SHA512 checksum file, which is designated with the suffix `-SHA512SUMS`. + +#. Download the corresponding checksum file so it can be used to verify the + SHA512 checksum result of the downloaded image. +#. Verify the integrity of the image using these steps: + +.. _verify-image-checksum-on-linux: + + *On Linux distros:* + + #. Start a terminal emulator. + #. Go to the directory with the downloaded image and checksum files. + #. Verify the integrity of the image and compare it to its original checksum by entering: + + .. code-block:: console + + $ sha512sum ./clear--. | diff ./clear--.-SHA512SUMS - + + If the checksum of the downloaded image is different than the original + checksum, the differences will displayed. Otherwise, an empty output indicates a match. + +.. _verify-image-checksum-on-macos: + + *On macOS:* + + #. Start Terminal app. + #. Go to the directory with the downloaded image and checksum files. + #. Verify the integrity of the image and compare it to its original checksum by entering: + + .. code-block:: console + + $ shasum -a512 ./clear--. | diff ./clear--.-SHA512SUMS - + + If the checksum of the downloaded image is different than the original + checksum, the differences will displayed. Otherwise, an empty output indicates a match. + +.. _verify-image-checksum-on-windows: + + *On Windows:* + + #. Start Command-Prompt. + #. Go to the directory with the downloaded image and checksum files. + #. Get the SHA512 checksum of the image by entering: + + .. code-block:: console + + C:\> CertUtil -hashfile ./clear--. sha512 + + #. Manually compare the output with the original checksum value shown in + the downloaded checksum file and make sure they match. + +.. _uncompress-image: + +Uncompress the Clear Linux image +================================ + +All released |CL| images are compressed by default. Two types of +compressions are used, namely GNU zip (`.gz`) and XZ (`.xz`). + +Uncompress the image using these steps: + +.. _uncompress-image-on-linux: + +*On Linux distros:* + +#. Start a terminal emulator. +#. Go to the directory with the downloaded image. + +.. _uncompress-xz-on-linux: + + To uncompress an XZ image, enter: + + .. code-block:: console + + $ unxz clear--.xz + +.. _uncompress-gz-on-linux: + + To uncompress a GZ image, enter: + + .. code-block:: console + + $ gunzip clear--.gz + +.. _uncompress-image-on-mac: + +*On macOS:* + +#. Start Terminal app. +#. Go to the directory with the downloaded image. + +.. _uncompress-xz-on-mac: + + To uncompress an XZ image, enter: + + .. code-block:: console + + $ gunzip clear--.xz + +.. _uncompress-gz-on-mac: + + To uncompress a GZ image, enter: + + $ gunzip clear--.gz + +.. _uncompress-image-on-windows: + +*On Windows:* + +#. Download and install `7zip`_. +#. Locate the |CL| image and right-click it. +#. From the pop-up menu, select :guilabel:`7-Zip` and select :guilabel:`Extract here`. + + .. figure:: figures/7zipwin.png + :scale: 80 % + :alt: 7-Zip extract file + + Figure 1: Windows - 7-Zip extract file + +.. _7zip: http://www.7-zip.org/ \ No newline at end of file diff --git a/source/clear-linux/guides/maintenance/figures/7zipwin.png b/source/clear-linux/guides/maintenance/figures/7zipwin.png new file mode 100644 index 00000000..0b0ee7f6 Binary files /dev/null and b/source/clear-linux/guides/maintenance/figures/7zipwin.png differ