diff --git a/source/_static/images/vbox-no-vtx.png b/source/_static/images/vbox-no-vtx.png new file mode 100644 index 00000000..ba6344de Binary files /dev/null and b/source/_static/images/vbox-no-vtx.png differ diff --git a/source/vm-hyper-v.rst b/source/vm-hyper-v.rst index c52f4556..ee582d96 100644 --- a/source/vm-hyper-v.rst +++ b/source/vm-hyper-v.rst @@ -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 +`_ (Intel® VT) and +`Intel® Virtualization Technology for Directed I/O +`_ (VT-d) +in your BIOS/UEFI firmware configuration. Install Hyper-V ================ diff --git a/source/vm-kvm.rst b/source/vm-kvm.rst index fa89a276..7fba1acb 100644 --- a/source/vm-kvm.rst +++ b/source/vm-kvm.rst @@ -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 +`_ (Intel® VT) and +`Intel® Virtualization Technology for Directed I/O +`_ (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/ \ No newline at end of file +.. _images: http://download.clearlinux.org/image/ diff --git a/source/vm-virtualbox.rst b/source/vm-virtualbox.rst index c037d430..f6c8ac7b 100644 --- a/source/vm-virtualbox.rst +++ b/source/vm-virtualbox.rst @@ -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 +`_ (Intel® VT) and +`Intel® Virtualization Technology for Directed I/O +`_ (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 diff --git a/source/vm-vmware-esxi.rst b/source/vm-vmware-esxi.rst index b72ad2ed..d5017d95 100644 --- a/source/vm-vmware-esxi.rst +++ b/source/vm-vmware-esxi.rst @@ -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 +`_ (Intel® VT) and +`Intel® Virtualization Technology for Directed I/O +`_ (VT-d) +in your BIOS/UEFI firmware configuration. + Run Clear Linux OS for Intel Architecture ========================================= diff --git a/source/vm-vmware-player.rst b/source/vm-vmware-player.rst index 830c1057..16bc914f 100644 --- a/source/vm-vmware-player.rst +++ b/source/vm-vmware-player.rst @@ -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 +`_ (Intel® VT) and +`Intel® Virtualization Technology for Directed I/O +`_ (VT-d) +in your BIOS/UEFI firmware configuration. + Install VMware Player =====================