Merge branch 'vmware-fix' into 'master'

Vmware fix

Fix VMWare documentation

See merge request !156
This commit is contained in:
Rodrigo Caballero
2017-04-25 10:16:57 -07:00
3 changed files with 73 additions and 72 deletions
+2
View File
@@ -24,6 +24,8 @@ the :abbr:`AVX (Advanced Vector Extensions)` needed to run
|CLOSIA|
.. _create_vm_vbox:
Create a virtual machine in VirtualBox
======================================
+51 -60
View File
@@ -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
<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.
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 <create_vm_vbox>` 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
+20 -12
View File
@@ -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 <create_vm_vbox>` 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.