diff --git a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst index 2ceb830f..d1ccc957 100644 --- a/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst +++ b/source/clear-linux/get-started/bare-metal-install/bare-metal-install.rst @@ -13,13 +13,23 @@ on bare metal using a bootable USB drive. :Start-after: bootable-usb-linux: :end-before: download-cl-image -.. include:: ../bootable-usb/bootable-usb-linux.rst - :Start-after: download-cl-image: - :end-before: verify-checksum +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum -.. include:: ../bootable-usb/bootable-usb-linux.rst - :Start-after: verify-checksum: - :end-before: copy-usb-linux +Download the latest Clear Linux installer image +=============================================== + +Get the latest |CL| installer image from the `image`_ directory. +Look for the :file:`clear-[version number]-installer.img.xz` file. + +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: verify-image-checksum-on-linux: + :end-before: uncompress-image-on-linux + +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: uncompress-image-on-linux: + :end-before: uncompress-gz-on-linux .. include:: ../bootable-usb/bootable-usb-linux.rst :Start-after: copy-usb-linux: @@ -317,3 +327,4 @@ system. These instructions are captured in the :ref:`enable-user-space`. .. _`NUC6i5SYH product page`: http://www.intel.com/content/www/us/en/nuc/nuc-kit-nuc6i5syh.html +.. _image: https://download.clearlinux.org/image \ No newline at end of file diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst index 718ce8fc..e911ae2c 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst @@ -13,36 +13,29 @@ Alternative instructions for other operating systems are available: .. _download-cl-image: +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum-on-linux + +.. _download-usb-suitable-images: + Download the latest Clear Linux image ===================================== -#. Go to the Clear Linux `image`_ repository and download the desired type: +There are 2 types of |CL| images that are suitable for burning onto and running +off a USB drive: - * Live image: `clear--live.img.xz` - * Installer image: `clear--installer.img.xz` + * Live image: :file:`clear-[version number]-live.img.xz` + * Installer image: :file:`clear-[version number]-installer.img.xz` - For older versions, see the `releases`_ page. +Go to the Clear Linux `image`_ repository and download the desired type. -#. Although not required, it is recommended to download the corresponding - checksum file (designated with `-SHA512SUMS` at the end of the filename) for - the image in order to verify its integrity. +.. _image: https://download.clearlinux.org/image -.. _verify-checksum: +.. _end-download-usb-suitable-images: -Verify the integrity of the download (recommended) -================================================== - -#. Start a terminal emulator. -#. Go to the directory with the downloaded files. -#. To verify the integrity of the image, enter the following (a live image - is used as example): - - .. code-block:: console - - $ sha512sum ./clear--live.img.xz | diff ./clear--live.img.xz-SHA512SUMS - - - If the checksum of the downloaded image is different than the original - checksum, the differences will displayed. An empty output indicates a match. +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: verify-image-checksum-on-linux: .. _copy-usb-linux: @@ -51,9 +44,7 @@ Burn the Clear Linux image onto a USB drive .. caution:: - Backup important data before proceeding. The process of burning an image - onto the USB drive completely formats the - USB drive and any existing content will be destroyed. + |CAUTION-BACKUP-USB| #. Open a terminal emulator and get root privilege. @@ -61,8 +52,8 @@ Burn the Clear Linux image onto a USB drive $ sudo -s +#. Go to the directory with the uncompressed image. #. Plug in the USB drive. - #. Identify the USB drive using the `lsblk` command. This shows all drives attached to the system, including the primary hard disk. In the example output below, there are 4 drives (`/dev/sda`, `/dev/sdb`, `/dev/sdc`, and @@ -101,19 +92,19 @@ Burn the Clear Linux image onto a USB drive Some Linux distros may automatically mount a USB drive when it is plugged in. To unmount, use the `umount` command followed by the device identifier/partition. For example: From the above `lsblk` output, - `/dev/sdd` has 2 mounted partitions. + `/dev/sdd` has 2 mounted partitions. To unmount them, enter: .. code-block:: console # umount /dev/sdd2 # umount /dev/sdd3 -#. Extract the downloaded image file and burn it onto the USB drive (`/dev/sdd` - is used as an example). +#. Burn the image onto the USB drive. The command-line example below burns an + uncompressed image onto `/dev/sdd`: .. code-block:: console - # xzcat clear--live.img.xz | dd of=/dev/sdd bs=4M status=progress + # dd if=./clear-[version number]-[image type] of=/dev/sdd bs=4M status=progress .. _usb-next: diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst index 6b7a1c90..1738fa70 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst @@ -11,66 +11,60 @@ Alternative instructions for other operating systems are available: * :ref:`bootable-usb-linux` * :ref:`bootable-usb-windows` +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum-on-linux + .. include:: bootable-usb-linux.rst - :Start-after: download-cl-image: - :end-before: verify-checksum + :Start-after: download-usb-suitable-images: + :end-before: end-download-usb-suitable-images -Verify the integrity of the download (recommended) -================================================== +.. include:: ../../guides/maintenance/download-verify-uncompress-mac.rst + :Start-after: verify-image-checksum-on-mac: + :end-before: uncompress-image-on-mac -#. Start the Terminal app. -#. Go to the directory with the downloaded files. -#. To verify the integrity of the image, enter the following commands: - - .. code-block:: console - - $ shasum -a512 ./clear--live.img.xz | diff ./clear--live.img.xz-SHA512SUMS - - - If the checksum of the downloaded image is different than the original's, - the differences will displayed. Otherwise, an empty output indicates a match. +.. include:: ../../guides/maintenance/download-verify-uncompress-mac.rst + :Start-after: uncompress-image-on-mac: Burn the Clear Linux image onto a USB drive =========================================== .. caution:: - Backup important data before proceeding. The process of burning an image - onto the USB drive completely formats the - USB drive and any existing content will be destroyed. + |CAUTION-BACKUP-USB| -#. Launch the Terminal application. - -#. Uncompress the |CL| image. - - .. code-block:: console - - $ gunzip clear--live.img.xz - -#. Plug in a USB drive and get its identifier. See Figure 1. +#. Launch the Terminal app. +#. Go to the directory with the uncompressed image. +#. Plug in a USB drive and get its identifier by entering the command + `diskutil list`. See Figure 1. .. code-block:: console $ diskutil list .. figure:: figures/bootable-usb-mac-1.png + :scale: 100 % :alt: Get USB drive identifier -#. Unmount the USB drive identified in the previous step (using `/dev/disk2` - as the example) +#. Unmount the USB drive identified in the previous step. The command-line + example below umounts `/dev/disk2`: .. code-block:: console $ diskutil umountDisk /dev/disk2 -#. Burn the image onto the drive. +#. Burn the image onto the drive. The command-line example below burns an + uncompressed image onto `/dev/disk2`: .. code-block:: console - $ sudo dd if=/path/to/clear--live.img of=/dev/rdisk2 bs=4m + $ sudo dd if=./clear-[version number]-[image type] of=/dev/rdisk2 bs=4m - * Adding an ‘r’ in front of the disk identifier should help speed up the - imaging process. - * Use `-T` to check imaging progress. + .. note:: + + * Adding an ‘r’ in front of the disk identifier should help speed up the + imaging process. + * Press :kbd:`-T` to check imaging progress. #. Eject the USB drive. diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 593bf32e..80786d34 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -11,43 +11,39 @@ Alternative instructions for other operating systems are available: * :ref:`bootable-usb-mac` * :ref:`bootable-usb-linux` +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum-on-linux + .. include:: bootable-usb-linux.rst - :Start-after: download-cl-image: - :end-before: verify-checksum + :Start-after: download-usb-suitable-images: + :end-before: end-download-usb-suitable-images -Verify the integrity of the download (recommended) -================================================== +.. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst + :Start-after: verify-image-checksum-on-windows: + :end-before: uncompress-image-on-windows -#. Start Command-Prompt. -#. Go to the directory with the downloaded files. -#. To verify the integrity of the image, enter the following commands: - - .. code-block:: console - - C:\> CertUtil -hashfile ./clear--live.img.xz sha512 - - Compare the output with the original checksum to make sure they match. +.. include:: ../../guides/maintenance/download-verify-uncompress-windows.rst + :Start-after: uncompress-image-on-windows: Burn the Clear Linux image onto a USB drive =========================================== .. caution:: - Backup important data before proceeding. The process of burning an image - onto the USB drive completely formats the - USB drive and any existing content will be destroyed. + |CAUTION-BACKUP-USB| #. Download the `Rufus`_ tool to burn the image onto a USB drive. - #. Plug in the USB drive. - -#. Select the |CL| image file and ensure that “Create a bootable disk using DD - Image” is checked. See Figure 1. +#. Click the CD-ROM icon button and select the |CL| image file. See Figure 1. +#. Ensure that :guilabel:`Create a bootable disk using DD + Image` is checked. .. figure:: figures/bootable-usb-windows-1.png + :scale: 100 % :alt: Burn image onto USB drive -#. Click Start. +#. Click :guilabel:`Start`. Next steps ---------- diff --git a/source/clear-linux/get-started/live-image.rst b/source/clear-linux/get-started/live-image.rst index 1c9c323e..f6ad029c 100644 --- a/source/clear-linux/get-started/live-image.rst +++ b/source/clear-linux/get-started/live-image.rst @@ -12,21 +12,23 @@ great way to use |CL| without modifying your computer's hard disk. :Start-after: bootable-usb-linux: :end-before: download-cl-image -Download the latest Clear Linux Live image -****************************************** +.. include:: ../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum -#. Get the latest |CL| Live image from the `image`_ page. Look for - `clear--live.img.xz`. +Download the latest Clear Linux live image +========================================== - For older versions, see the `releases`_ page. +Get the latest |CL| live image from the `image`_ directory. +Look for :file:`clear-[version number]-live.img.xz`. -#. Although not required, it is recommended to download the corresponding - checksum file (designated with `-SHA512SUMS` at the end of the filename) for - the image in order to verify its integrity. +.. include:: ../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: verify-image-checksum-on-linux: + :end-before: uncompress-image-on-linux -.. include:: bootable-usb/bootable-usb-linux.rst - :Start-after: verify-checksum: - :end-before: verify-checksum-on-macos +.. include:: ../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: uncompress-image-on-linux: + :end-before: uncompress-gz-on-linux .. include:: bootable-usb/bootable-usb-linux.rst :Start-after: copy-usb-linux: @@ -34,16 +36,16 @@ Download the latest Clear Linux Live image .. _boot-live-image: -Boot the Clear Linux Live image +Boot the Clear Linux live image ******************************* #. Configure the BIOS/UEFI firmware settings of the target system: - * Enable `Intel® Virtualization Technology (Intel® VT)`_ - * Enable `Intel® Virtualization Technology for Directed I/O (Intel® VT-d)`_ - * Disable `Secure Boot` - + + * Enable `Intel® Virtualization Technology (Intel® VT)`_. + * Enable `Intel® Virtualization Technology for Directed I/O (Intel® VT-d)`_. + * Disable `Secure Boot`. + #. Plug the imaged USB drive in and boot it up. - #. Log in as `root` and set a password. .. _`releases`: https://download.clearlinux.org/releases diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi.rst deleted file mode 100644 index 1ee967e4..00000000 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi.rst +++ /dev/null @@ -1,80 +0,0 @@ -.. _vmware-esxi: - -Use VMware\* ESXi guest -####################### - - -This section is based on *VMware vSphere 6* and explains how to use |CLOSIA| -as ESXi Guest. - -Ensure `Intel® Virtualization Technology`_ (Intel® VT) and -`Intel® Virtualization Technology for Directed I/O`_ (Intel® VT-d) are both -enabled in your BIOS/UEFI firmware configuration. - -Run Clear Linux OS for Intel Architecture -========================================= - -#. Download the `latest`_ |CL| **live** version - :file:`clear-{release-number}-live.img.xz`. - -#. Decompress the downloaded image. Uncompressed image size is ~ **5GB**. - - * On Linux: - - .. code-block:: console - - $ xz -d clear-{release-number}-live.img.xz - - * On Windows, use `7zip`_. - - - Right-click the file and select - :menuselection:`Extract in the same directory`. - - .. image:: ./figures/7zipwin.png - :alt: 7zip extract here command - -#. Create a virtual machine with the following configuration: - - * :guilabel:`Guest OS`: Linux, Distribution: Other 3.x Linux (64-bits) - - * :guilabel:`UEFI support`: |CL| uses `systemd-boot` as the UEFI - boot manager for EFI images. Add UEFI support. Find this option's - settings using the vSphere GUI. Go to the - :menuselection:`Configuration settings of the virtual machine-->General` - Tab and select :guilabel:`EFI boot firmware`. - - * :guilabel:`SCSI Para-virtualized disk`: Convert to - :abbr:`VMDK (VMware DisK)` and attach the |CL| image downloaded above. - - + On Linux, To convert Clear Linux image to VMDK\* you can use the - :command:`qemu-img` command: - - .. code-block:: console - - qemu-img convert -f raw -O vmdk -o adapter_type=lsilogic -o compat6 -p clear-vmware.img clear-vmware.vmdk - - + On Windows, convert the live image from RAW to VMDK format with a - tool like :program:`VBoxManage` from `VirtualBox`_. You can refer on - :ref:`how to create a VM on VirtualBox ` as an - example. - -#. Transfer the Clear Linux image to the VMware ESXi server and use the - :command:`vmkfstools` command. Access to ESXi command line is required: - - .. code-block:: console - - vmkfstools -i clear-vmware.vmdk -d zeroedthick clear-vmware-fix.vmdk - -#. Add the converted image to the guest using the VMware vSphere virtual - machine settings. - -#. Start the virtual machine. - -.. _latest: https://download.clearlinux.org/image/ -.. _7zip: http://www.7-zip.org/ -.. _VirtualBox: https://www.virtualbox.org/ -.. _Intel® Virtualization Technology: - http://www.intel.com/content/www/us/en/virtualization/virtualization-technology/intel-virtualization-technology.html -.. _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 - diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst new file mode 100644 index 00000000..15a757d6 --- /dev/null +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -0,0 +1,117 @@ +.. _download-verify-uncompress-linux: + +Download, verify, and uncompress a Clear Linux image on Linux +############################################################# + +This section explains the types of |CLOSIA| images available, where to download +them, how to verify the integrity of an image, and how to uncompress it. + +Alternative instructions for other operating systems are available: + +* :ref:`download-verify-uncompress-mac` +* :ref:`download-verify-uncompress-windows` + +.. _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-[version number]-[image type].[compression type] + +The *[version number]* field specifies the version number. + +The *[image type]* 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 *[compression type]* 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-on-linux: + +Verify the integrity of the Clear Linux image +============================================= + +Before you use a downloaded |CL| image, it is recommended that you 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 official corresponding SHA512 checksum file of your downloaded |CL| image. +#. 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-[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 will displayed. Otherwise, an empty output indicates +a match and your downloaded image is good. + +.. _uncompress-image-on-linux: + +Uncompress the Clear Linux image +================================ + +All released |CL| images are compressed by default using either GNU zip +(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which +platform/enviroment the image is targeted for. Uncompress your image using +these steps: + +#. 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-[version number]-[image type].xz + +.. _uncompress-gz-on-linux: + + To uncompress a GZ image, enter: + + .. code-block:: console + + $ gunzip clear-[version number]-[image type].gz \ No newline at end of file diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst new file mode 100644 index 00000000..d0e05782 --- /dev/null +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst @@ -0,0 +1,59 @@ +.. _download-verify-uncompress-mac: + +Download, verify, and uncompress a Clear Linux image on macOS +############################################################# + +This section explains the types of |CLOSIA| images available, where to download +them, how to verify the integrity of an image, and how to uncompress it. + +Alternative instructions for other operating systems are available: + +* :ref:`download-verify-uncompress-linux` +* :ref:`download-verify-uncompress-windows` + +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum-on-linux + +.. _verify-image-checksum-on-mac: + +Verify the integrity of the Clear Linux image +============================================= + +Before you use a downloaded |CL| image, it is recommended that you 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 official corresponding SHA512 checksum file of your downloaded |CL| image. +#. Start the 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-[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 will displayed. Otherwise, an empty output indicates +a match and your downloaded image is good. + +.. _uncompress-image-on-mac: + +Uncompress the Clear Linux image +================================ + +All released |CL| images are compressed by default using either GNU zip +(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which +platform/enviroment the image is targeted for. Uncompress your image using +these steps: + +#. Start the Terminal app. +#. Go to the directory with the downloaded image. +#. You can use the `gunzip` command to uncompress both types of compression formats. + For examples: + + .. code-block:: console + + $ gunzip clear-[version number]-[image type].xz + $ gunzip clear-[version number]-[image type].gz \ No newline at end of file diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst new file mode 100644 index 00000000..17fcb45a --- /dev/null +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst @@ -0,0 +1,60 @@ +.. _download-verify-uncompress-windows: + +Download, verify, and uncompress a Clear Linux image on Windows +############################################################### + +This section explains the types of |CLOSIA| images available, where to download +them, how to verify the integrity of an image, and how to uncompress it. + +Alternative instructions for other operating systems are available: + +* :ref:`download-verify-uncompress-linux` +* :ref:`download-verify-uncompress-mac` + +.. include:: ../../guides/maintenance/download-verify-uncompress-linux.rst + :Start-after: types-of-cl-images: + :end-before: verify-image-checksum-on-linux + +.. _verify-image-checksum-on-windows: + +Verify the integrity of the Clear Linux image +============================================= + +Before you use a downloaded |CL| image, it is recommended that you 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 official corresponding SHA512 checksum file of your downloaded |CL| image. +#. 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-[version number]-[image type].[compression type] sha512 + +#. Manually compare the output with the original checksum value shown in + the downloaded checksum file and make sure they match. + +.. _uncompress-image-on-windows: + +Uncompress the Clear Linux image +================================ + +All released |CL| images are compressed by default using either GNU zip +(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which +platform/enviroment the image is targeted for. Uncompress your image using +these steps: + +#. 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 100755 index 00000000..0b0ee7f6 Binary files /dev/null and b/source/clear-linux/guides/maintenance/figures/7zipwin.png differ diff --git a/source/clear-linux/guides/maintenance/maintenance.rst b/source/clear-linux/guides/maintenance/maintenance.rst index fb86d493..cd546abe 100644 --- a/source/clear-linux/guides/maintenance/maintenance.rst +++ b/source/clear-linux/guides/maintenance/maintenance.rst @@ -16,3 +16,6 @@ maintaining |CLOSIA| after :ref:`installation ` is completed. validate-signatures telemetry-enable time + download-verify-uncompress-linux + download-verify-uncompress-mac + download-verify-uncompress-windows diff --git a/source/substitutions.txt b/source/substitutions.txt index 051cd808..b8bc7513 100644 --- a/source/substitutions.txt +++ b/source/substitutions.txt @@ -3,3 +3,6 @@ .. |CLOSIA| replace:: Clear Linux* OS for Intel® Architecture .. |CC| replace:: Clear Containers + +.. |CAUTION-BACKUP-USB| replace:: + Burning an image formats the USB drive, thus destroying all existing content. Backup your data before proceeding.