Merge branch 'vbox-more-images' into 'master'

Several fixes in vbox and others

* Add one more image to VirtualBox documentation
* Fix images indentation
* Use CL and CLOSIA
* Add a sentence to al VM files to enable VT-x and VT-d.

See merge request !146
This commit is contained in:
Tullis, Michael L
2017-03-01 11:43:24 -08:00
6 changed files with 57 additions and 15 deletions
Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

+6
View File
@@ -6,6 +6,12 @@ Using Hyper-V\*
This section explains how to run |CLOSIA| inside a
`Windows Server Virtualization`_\* or **Hyper-V** environment.
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>`_ (VT-d)
in your BIOS/UEFI firmware configuration.
Install Hyper-V
================
+7 -1
View File
@@ -7,6 +7,12 @@ The easiest way to get started in a virtualized environment is to download
a recent KVM image from the `images`_ directory. Here you'll find a kvm
image file, the UEFI firmware helper, and the KVM start helper script.
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>`_ (VT-d)
in your BIOS/UEFI firmware configuration.
Starter script
==============
@@ -49,4 +55,4 @@ and removing the ``aio=threads``
.. _qemu shell script: http://download.clearlinux.org/image/start_qemu.sh
.. _images: http://download.clearlinux.org/image/
.. _images: http://download.clearlinux.org/image/
+30 -14
View File
@@ -3,9 +3,17 @@
Using VirtualBox*
#################
This section explains how to run Clear Linux OS for Intel® Architecture
This section explains how to run |CLOSIA|
inside a `VirtualBox`_\* environment.
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>`_ (VT-d)
in your BIOS/UEFI firmware configuration.
Download VirtualBox
===================
@@ -15,7 +23,7 @@ the operating system you are using.
Download **version 5.0 or greater** to ensure support for
the :abbr:`AVX (Advanced Vector Extensions)` needed to run
Clear Linux OS for Intel Architecture.
|CLOSIA|
Create a virtual machine in VirtualBox
@@ -63,19 +71,20 @@ Create a virtual machine in VirtualBox
a. Type: **Linux**
b. Version: **Linux 2.6 / 3.x / 4.x (64-bit)**
.. image:: _static/images/vbox-create-vm.png
:alt: Create a new image in VirtualBox
.. image:: _static/images/vbox-create-vm.png
:alt: Create a new image in VirtualBox
|
c. Select default memory size.
.. image:: _static/images/vbox-memory-size.png
.. image:: _static/images/vbox-memory-size.png
|
d. Attach the virtual disk created in step number 3 as a virtual hard
disk file. Click the folder icon (lower right) to browse to find the VDI file.
disk file. Click the folder icon (lower right) to browse to find the
VDI file.
.. image:: _static/images/vbox-hdisk.png
.. image:: _static/images/vbox-hdisk.png
#. After it is created, go to settings to enable **EFI support**
@@ -88,14 +97,14 @@ Create a virtual machine in VirtualBox
Run your new VM
===============
Clear Linux OS for Intel Architecture supports VirtualBox kernel modules used
|CLOSIA| supports VirtualBox kernel modules used
by the Linux kernel 4.9 :abbr:`LTS (Long Term Support)` (*kernel-lts bundle*).
This kernel was selected because Clear Linux OS's main kernel
This kernel was selected because |CL| OS's main kernel
(``kernel-native``) bundle keeps up-to-date with the upstream Linux kernel,
and sometimes VirtualBox kernel modules aren't compatible with pre-kernel
releases.
In the first boot, Clear Linux will ask for a login user, type **root** and
In the first boot, |CL| will ask for a login user, type **root** and
then the system will ask you for a new password.
To install the VirtualBox kernel modules, here are the steps:
@@ -147,7 +156,7 @@ VirtualBox Guest Additions, follow these steps:
# reboot
#. (*Optional*) To use Clear Linux graphical user interface,
#. (*Optional*) To use |CL| graphical user interface,
add the GUI bundle::
# swupd bundle-add os-utils-gui
@@ -157,21 +166,28 @@ VirtualBox Guest Additions, follow these steps:
# startx
Clear Linux doesn't provide a graphical display manager.
|CL| doesn't provide a graphical display manager.
.. image:: _static/images/vbox-x.png
:alt: XFCE Clear Linux on Virtual Box
:alt: XFCE |CL| on Virtual Box
Troubleshooting
---------------
On Windows OS, *VirtualBox* cannot do a **Hardware Virtualization** when
*Hyper-V* is enabled. To disable *Hyper-V* you should execute::
*Hyper-V* is enabled.
.. image:: _static/images/vbox-no-vtx.png
:alt: VirtualBox hardware acceleration error
|
To disable *Hyper-V* you should execute::
bcdedit /set {current} hypervisorlaunchtype off
in an **Administrator: Command Prompt**, then reboot your system.
To enable Hyper-V again, you should execute::
bcdedit /set {current} hypervisorlaunchtype Auto
+7
View File
@@ -7,6 +7,13 @@ 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.
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>`_ (VT-d)
in your BIOS/UEFI firmware configuration.
Run Clear Linux OS for Intel Architecture
=========================================
+7
View File
@@ -6,6 +6,13 @@ Using VMware* Player
This section explains how to run Clear Linux OS for Intel® Architecture
within a `VMware Player`_ environment.
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>`_ (VT-d)
in your BIOS/UEFI firmware configuration.
Install VMware Player
=====================