mirror of
https://github.com/clearlinux/clear-linux-documentation.git
synced 2026-06-29 09:16:08 +00:00
Rewrite Hyper-V document with images (#729)
This commit is contained in:
puneetse
committed by
michael vincerra
michael vincerra
parent
bb874bec89
commit
17e70abdf2
Binary file not shown.
|
After Width: | Height: | Size: 6.8 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 9.2 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 9.5 KiB |
@@ -3,66 +3,145 @@
|
||||
|CL-ATTR| on Microsoft Hyper-V\*
|
||||
################################
|
||||
|
||||
This page explains how to run |CL-ATTR| inside a
|
||||
`Windows Server Virtualization`_\* or **Hyper-V** environment.
|
||||
This page explains how to run a |CL-ATTR| :abbr:`VM (virtual machine)` on a
|
||||
a Microsoft Hyper-V\* hypervisor.
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
:depth: 1
|
||||
|
||||
|
||||
Overview
|
||||
********
|
||||
|
||||
Hyper-V is a type 1 bare-metal hypervisor that runs directly on system
|
||||
hardware.
|
||||
|
||||
Hyper-V is available both on server and client Windows operating systems as
|
||||
`Hyper-V on Windows Server`_ and `Hyper-V on Windows 10`_.
|
||||
|
||||
Prerequisites
|
||||
*************
|
||||
|
||||
* Enable `Intel® Virtualization Technology`_ (Intel® VT)
|
||||
* Enable virtualization, such as `Intel® Virtualization Technology`_
|
||||
(Intel® VT) and `Intel® Virtualization Technology for Directed I/O`_ (Intel®
|
||||
VT-d), on the host system from EFI/BIOS.
|
||||
|
||||
* Enable `Intel® Virtualization Technology for Directed I/O`_ (Intel® VT-d) in
|
||||
your BIOS/UEFI firmware configuration.
|
||||
* Hyper-V installed on a capable Windows operating system. Refer to the
|
||||
Microsoft documentation on `Install the Hyper-V role on Windows Server`_ or
|
||||
`Install Hyper-V on Windows 10`_.
|
||||
|
||||
Enable Hyper-V
|
||||
**************
|
||||
* Configure appropriate virtual networking in Hyper-V. Refer to the Microsoft
|
||||
documentation on `Create a virtual network on Window Server`_ or `Create a
|
||||
virtual network on Window 10`_.
|
||||
|
||||
Please refer to `Install Hyper-V on Windows 10`_ to enable and configure
|
||||
*Hyper-V* on your machine.
|
||||
|
||||
Create a virtual network
|
||||
************************
|
||||
Download the |CL| disk image for Hyper-V
|
||||
****************************************
|
||||
|
||||
Once *Hyper-V* has been enabled on your Windows system, you will need to
|
||||
create a virtual network in the **Hyper-V Manager**. Refer to the
|
||||
`Create a virtual network`_ documentation to create and configure
|
||||
a virtual network.
|
||||
|CL| provide a virtual disk image for Hyper-V with |CL| pre-installed. This
|
||||
includes a |CL| :ref:`Hyper-V specific kernel <compatible-kernels>` with
|
||||
Hyper-V Linux drivers ready-to-go. Get the latest |CL| image for Microsoft*
|
||||
Hyper-V from the `downloads`_ website. The file is named
|
||||
:file:`clear-[VERSION]-hyperv.vhdx.gz`.
|
||||
|
||||
Create a virtual machine
|
||||
************************
|
||||
We also provide instructions for downloading and verifying a Clear Linux
|
||||
images. For more information, refer to :ref:`download-verify-decompress`.
|
||||
|
||||
#. Download and decompress the latest hyperv disk image
|
||||
:file:`clear-XXXXX-hyperv.img.gz`, where XXXXX is the latest
|
||||
available version of |CL| from our `Downloads`_ page.
|
||||
After extraction, the file should be named
|
||||
:file:`clear-[VERSION]-hyperv.vhdx`.
|
||||
|
||||
#. Create a virtual machine using the **Hyper-V Manager**:
|
||||
|
||||
a. Choose **Generation 2** when prompted to *specify VM generation*.
|
||||
b. Choose **Use an existing virtual hard disk** and browse to find the
|
||||
:file:`clear-XXXX-hyperv.vhdx` file.
|
||||
c. When finished, open VM settings, select Firmware Section and in Secure
|
||||
Boot config, **uncheck** Enable Secure Boot.
|
||||
Create and configure new VM
|
||||
****************************
|
||||
|
||||
.. note:: Currently, |CL| does not boot with `secure boot`
|
||||
enabled.
|
||||
#. Open the **Hyper-V Manager** from the Start menu.
|
||||
|
||||
#. Connect to your new VM and start it. You should see a prompt:
|
||||
.. figure:: figures/hyper-v/hyper-v-01.png
|
||||
:scale: 100%
|
||||
:alt: Hyper-V Manager from the Start menu
|
||||
|
||||
Figure 1: Hyper-V Manager from the Start menu
|
||||
|
||||
|
||||
#. Create a *New Virtual Machine* by clicking the :guilabel:`Action` menu and
|
||||
selecting the :guilabel:`New` submenu, and selecting :guilabel:`Virtual
|
||||
Machine...`.
|
||||
|
||||
.. figure:: figures/hyper-v/hyper-v-02.png
|
||||
:scale: 100%
|
||||
:alt: New Virtual Machine in Hyper-V Manager
|
||||
|
||||
Figure 2: New Virtual Machine in Hyper-V Manager
|
||||
|
||||
#. Follow the *New Virtual Machine Wizard* to create a new virtual machine
|
||||
specifying the options below:
|
||||
|
||||
- **Name**: Choose name (e.g. ClearLinuxOS-VM).
|
||||
- **Generation**: Generation 2
|
||||
- **Startup memory**: 2048 MB or more
|
||||
- **Connect Virtual Hard Disk**: select :guilabel:`Use an existing virtual
|
||||
hard disk` and browse to find the :file:`clear-[VERSION]-hyperv.vhdx`
|
||||
file.
|
||||
|
||||
After finishing the wizard, the VM will be created but not powered on.
|
||||
|
||||
#. Go to *Virtual Machine Settings* by right-clicking the newly created |CL|
|
||||
VM in the Hyper-V Manager and selecting :guilabel:`Settings...`
|
||||
|
||||
- Under :guilabel:`Firmware`, select the Virtual disk and click
|
||||
:guilabel:`Move Up...` until it is at the top of the list.
|
||||
|
||||
- Under :guilabel:`Security`, uncheck the :guilabel:`Enable Secure Boot`
|
||||
checkbox.
|
||||
|
||||
- Under :guilabel:`Processor`, consider increasing the number of virtual
|
||||
processors assigned to the |CL| VM for performance.
|
||||
|
||||
.. figure:: figures/hyper-v/hyper-v-03.png
|
||||
:scale: 100%
|
||||
:alt: |CL| VM Settings in Hyper-V Manager
|
||||
|
||||
Figure 3: |CL| VM Settings page after selections
|
||||
|
||||
#. Click :guilabel:`Apply` at the bottom of the VM Settings screen.
|
||||
|
||||
#. Click :guilabel:`OK` at the bottom of the VM Setting screen.
|
||||
|
||||
|
||||
Start the VM
|
||||
************
|
||||
|
||||
#. Start the |CL| VM by right-clicking the VM in Hyper-V Manager and selecting
|
||||
:guilabel:`Start`
|
||||
|
||||
#. Connect to the VM console by right-clicking the VM in Hyper-V Manager and
|
||||
selecting :guilabel:`Connect...`. A new *Virtual Machine Connection* window
|
||||
will appear.
|
||||
|
||||
#. After |CL| is booted, login to the console with user *root*. You will be
|
||||
prompted to set a new password immediately.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
> User: root
|
||||
> User: root
|
||||
|
||||
#. Set a root user password.
|
||||
|CL-ATTR| on Microsoft Hyper-V\* is ready for use.
|
||||
|
||||
Your virtual machine running |CL| is ready!
|
||||
Related topics
|
||||
**************
|
||||
|
||||
.. _Windows Server Virtualization: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/about/
|
||||
.. _Install Hyper-V on Windows 10: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v
|
||||
.. _Create a virtual network: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/connect-to-network
|
||||
.. _Downloads: https://cdn.download.clearlinux.org/image/
|
||||
* :ref:`increase-virtual-disk-size`
|
||||
|
||||
|
||||
|
||||
.. _`Hyper-V on Windows Server`: https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-on-windows-server
|
||||
.. _`Hyper-V on Windows 10`: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/index
|
||||
.. _`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
|
||||
.. _`Install the Hyper-V role on Windows Server`: https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/get-started/install-the-hyper-v-role-on-windows-server
|
||||
.. _Install Hyper-V on Windows 10: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v
|
||||
.. _`Create a virtual network on Window Server`: https://docs.microsoft.com/en-us/windows-server/virtualization/hyper-v/get-started/create-a-virtual-switch-for-hyper-v-virtual-machines
|
||||
.. _`Create a virtual network on Window 10`: https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/connect-to-network
|
||||
.. _downloads: https://clearlinux.org/downloads
|
||||
|
||||
|
||||
Reference in New Issue
Block a user