mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-08-28 03:16:49 +00:00
Merge branch 'vmware-fix' into 'master'
Vmware fix Fix VMWare documentation See merge request !156
This commit is contained in:
@@ -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
@@ -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
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user