diff --git a/source/vm-virtualbox.rst b/source/vm-virtualbox.rst index 8e33c43b..9de48a0e 100644 --- a/source/vm-virtualbox.rst +++ b/source/vm-virtualbox.rst @@ -24,6 +24,8 @@ the :abbr:`AVX (Advanced Vector Extensions)` needed to run |CLOSIA| +.. _create_vm_vbox: + Create a virtual machine in VirtualBox ====================================== diff --git a/source/vm-vmware-esxi.rst b/source/vm-vmware-esxi.rst index 4db05ed2..b7c5a6ca 100644 --- a/source/vm-vmware-esxi.rst +++ b/source/vm-vmware-esxi.rst @@ -1,89 +1,80 @@ .. _vm-vmware-esxi: -Using *VMware** ESXi guest +Using VMware\* ESXi guest ########################## -This topic, which is based on *VMware vSphere 6*, explains how to use Clear Linux* OS -for Intel® Architecture as ESXi Guest. +This section is based on *VMware vSphere 6* and explains how to use |CLOSIA| +as ESXi Guest. -Please ensure you have enabled `Intel® Virtualization Technology -`_ -(Intel® VT) and `Intel® Virtualization Technology for Directed I/O -`_ -(Intel® VT-d) in your BIOS/UEFI firmware configuration. +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`_ live version of the disk image. +#. 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:: _static/images/7zipwin.png + :alt: 7zip extract here command + #. Create a virtual machine with the following configuration: - - **Guest OS**: Linux, Distribution Other 3.x Linux (64-bits) + * :guilabel:`Guest OS`: Linux, Distribution: Other 3.x Linux (64-bits) - - **UEFI support**: Clear Linux uses `systemd-boot` as the UEFI boot manager - for EFI images. Find the settings for this option using the vSphere GUI; go - to the configuration settings of the virtual machine and select - **EFI boot firmware**. + * :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`. - - **IDE disk**: Convert to vmdk and attach the Clear Linux image you downloaded - above. To convert Clear Linux image to VMware disk (vmdk) you can use the - ``qemu-img`` command:: + * :guilabel:`SCSI Para-virtualized disk`: Convert to + :abbr:`VMDK (VMware DisK)` and attach the |CL| image downloaded above. - $ qemu-img convert -f raw -O vmdk -p clear-vmware.img clear-vmware.vmdk + + On Linux, To convert Clear Linux image to VMDK\* you can use the + :command:`qemu-img` command: -#. Start the virtual machine + .. code-block:: console + qemu-img convert -f raw -O vmdk -o adapter_type=lsilogic -o compat6 -p clear-vmware.img clear-vmware.vmdk -Using an optimized kernel for *VMware* -====================================== + + 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. -Clear Linux provides an optional bundle called *kernel-vmware* that contains a -specialized kernel with specific configuration for VMware hypervisor, including: +#. Transfer the Clear Linux image to the VMware ESXi server and use the + :command:`vmkfstools` command. Access to ESXi command line is required: -* **vmw_balloon** -- A technique for memory reclamation that works like a - balloon. A guest can be inflated to reclaim physical memory. The balloon - can also be deflated to allow the guest free memory pages. + .. code-block:: console -* **vmw_pvscsi** -- A driver that allows use of the para-virtualized SCSI provided - by *VMware* hypervisors. + vmkfstools -i clear-vmware.vmdk -d zeroedthick clear-vmware-fix.vmdk -* **vmxnet3** -- Allows use of VMware virtual ethernet NICs. +#. Add the converted image to the guest using the VMware vSphere virtual + machine settings. -* **vmwgfx** -- Allows use of a DRM driver for the VMware virtual hardware - -To use these features, add the ``kernel-vmware`` bundle to your Clear Linux install:: - - # swupd bundle-add kernel-vmware - -Now turn off the virtual machine and change the configuration as follows: - - - **Guest OS**: Linux / 3.x Linux (64-bits) - - - **UEFI support**: Clear Linux uses `systemd-boot` as the UEFI boot manager - for EFI images. To add UEFI support, go to "Configuration settings of the - virtual machine" -> "General Tab" -> "And select EFI boot firmware" - - - **SCSI Para-virtualized disk**: Convert the Clear Linux image to an SCSI - VMware disk image and re-attach it. - - #. Extract the image from the EXSi server to one Linux machine and use - ``qemu-img`` command:: - - $ qemu-img convert -f raw -O vmdk -o adapter_type=lsilogic -o compat6 -p clear-vmware.img clear-vmware.vmdk - - #. Transfer the Clear Linux image to the VMware ESXi server and use the - :command:`vmkfstools` command (you need to access to ESXi command line ):: - - $ vmkfstools -i clear-vmware.vmdk -d zeroedthick clear-vmware-fix.vmdk - - #. Add the converted image to the guest by using VMware vSphere virtual - machine settings - -Finally, start the modified virtual machine. +#. 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/vm-vmware-player.rst b/source/vm-vmware-player.rst index b973454f..7e9a866d 100644 --- a/source/vm-vmware-player.rst +++ b/source/vm-vmware-player.rst @@ -38,16 +38,20 @@ Follow the instructions from the Setup Assistant. Prepare Image ============= -#. Download the `latest`_ Clear Linux OS for Intel Architecture **live** - disk image, named ``[clear-[version_number]-live.img.xz]``. +#. Download the `latest`_ |CL| **live** version (clear-XXXX-live.img.xz) -#. Decompress the image. Uncompressed image size ~ **5GB**. +#. Decompress the downloaded image. Uncompressed image size is ~ **5GB**. - * On Linux :: + + On Linux :: - $ unxz clear-VERSION-live.img.xz + $ xz -d clear-XXXX-live.img.xz - * On Windows you can use `7zip`_. + + On Windows you can use `7zip`_. + + - Right-click the file to *extract in the same directory*. + + .. image:: _static/images/7zipwin.png + :alt: 7zip extract here command #. Convert the installer to :abbr:`VMDK (Virtual Machine Disk)` format. @@ -55,17 +59,21 @@ Prepare Image $ qemu-img convert -O vmdk clear-VERSION-live.img clear.vmdk - * On Windows, you can convert the live image to vmdk format (from raw format to vmdk) - with a tool like VBoxManage from `VirtualBox`_. + * On Windows, you can convert the live image to VMDK format + (from RAW format to VMDK) with a tool like *VBoxManage* from + `VirtualBox`_. You can refer on + :ref:`how to create a VM on VirtualBox ` as example. Run using VMware* Player ======================== -#. Create a new virtual machine. +Create a new virtual machine by following the next steps. -#. Click on “Create a new Virtual Machine”. +#. Launch **VMWare Workstation Player**. + +#. On main window click on “Create a new Virtual Machine”. * Select “**I will install the operating system later**”, and click on “Next”. * Select “**Linux**” as “Guest operating system” and version **Other Linux 3.x kernel 64-bit**. @@ -85,8 +93,8 @@ Run using VMware* Player * Remove any default attached hard disk. * Click on “Add” option below devices list tab and choose Hard disk. - * Choose **SATA** as the virtual disk type. - * Use the existing Clear Linux OS for Intel Architecture virtual disk + * Choose **SATA** as the virtual disk type. + * Use the existing Clear Linux OS for Intel Architecture virtual disk The live disk must be set as ``SATA 0:1 Hard Disk (SATA)``; you can verify this under the “Advanced" section of the disk settings.