From 4602a4e03c7b460e5465b2483c1eb3208d593e1b Mon Sep 17 00:00:00 2001 From: Robert Nesius Date: Tue, 21 Feb 2017 18:43:54 -0800 Subject: [PATCH 1/2] Updated HyperV docs --- source/vm-hyper-v.rst | 36 +++--------------------------------- 1 file changed, 3 insertions(+), 33 deletions(-) diff --git a/source/vm-hyper-v.rst b/source/vm-hyper-v.rst index ddd753f1..50b25c06 100644 --- a/source/vm-hyper-v.rst +++ b/source/vm-hyper-v.rst @@ -17,43 +17,13 @@ Please refer to `Microsoft documentation`_ to install and configure Create a virtual machine ======================== -#. Download the `latest`_ live version (clear-XXXX-live.img.xz) of Clear Linux OS - for Intel Architecture. - -#. Decompress the downloaded image. Uncompressed image size is ~ **5GB**. - -#. To convert a raw image to :abbr:`VHD (Virtual Hard Disk)` - format, you can use VirtualBox_ or QEMU_. - - * With *VirtualBox*, you can use one of the following commands:: - - > VBoxManage convertfromraw clear-XXXX-live.img clear-XXXX-live.vhd --format VHD - - or:: - - > vbox-img convert --srcfilename clear-XXXX-live.img --dstfilename clear-XXXX-live.vhd --srcformat raw --dstformat vhd - - * With *QEMU*, you can use the following command:: - - > qemu-img convert -f raw -O vpc clear-XXXX-live.img clear-XXXX-live.vhd - - You can test your new *VHD image* using the **PowerShell** command line:: - - PS C:\> Test-VHD -Path c:\path\to\clear-XXXX-live.vhd - - Clear Linux OS for Intel Architecture uses *EFI* to boot. Since this feature - is availible only in `Generation 2`_ or later virtual machines, you'll need - to convert from **VHD** to **VHDX**. To do this, you can use the following - *PowerShell* command:: - - PS C:\> Convert-VHD -Path c:\path\to\clear-XXXX-live.vhd -DestinationPath c:\path\to\clear-XXXX-live.vhdx - - You can save the new *VHDX* virtual hard disk in :file:`C:\\Users\\Public\\Documents\\Hyper-V\\Virtual Hard Disks`. +#. Download and uncompress the latest hyperv disk image (`clear-XXXX-hyperv.img.xz`) of Clear Linux OS + for Intel Architecture from https://download.clearlinux.org/image/. #. Create a virtual machine using the **Hyper-V Manager**: * Choose **Generation 2** when you need to *specify VM generation*. - * Choose **Use an existing virtual hard disk** and browse to find the :file:`clear-XXXX-live.vhdx` file. + * Choose **Use an existing virtual hard disk** and browse to find the :file:`clear-XXXX-hyperv.vhdx` file. * When finised, open VM settings, select Firmware Section and in Secure Boot config, **uncheck** Enable Secure Boot. From a0cef16c2b4cfc74322cd2b582d69efde8ea99b3 Mon Sep 17 00:00:00 2001 From: Rodrigo Caballero Date: Fri, 24 Feb 2017 15:04:47 -0600 Subject: [PATCH 2/2] Edit and improve markup and language. Improved the markup to ensure the steps were properly numbered and the content rendered as intended. Signed-off-by: Rodrigo Caballero --- source/vm-hyper-v.rst | 39 ++++++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 17 deletions(-) diff --git a/source/vm-hyper-v.rst b/source/vm-hyper-v.rst index 50b25c06..54476516 100644 --- a/source/vm-hyper-v.rst +++ b/source/vm-hyper-v.rst @@ -1,44 +1,49 @@ .. _vm-hyper-v: -Using Hyper-V -############# +Using Hyper-V\* +############### -This section explains how to run Clear Linux OS for Intel® Architecture -inside a `Windows Server Virtualization`_ *A.K.A.* **Hyper-V** environment. +This section explains how to run |CLOSIA| inside a +`Windows Server Virtualization`_\* or **Hyper-V** environment. -Install Hyper-V* +Install Hyper-V ================ -Please refer to `Microsoft documentation`_ to install and configure +Please refer to the `Microsoft documentation`_ to install and configure *Hyper-V* on your machine. Create a virtual machine ======================== -#. Download and uncompress the latest hyperv disk image (`clear-XXXX-hyperv.img.xz`) of Clear Linux OS - for Intel Architecture from https://download.clearlinux.org/image/. +#. Download and uncompress the latest hyperv disk image :file:`clear-XXXX- + hyperv.img.xz`) of |CLOSIA| from our `downloads`_ section. #. Create a virtual machine using the **Hyper-V Manager**: - * Choose **Generation 2** when you need to *specify VM generation*. - * Choose **Use an existing virtual hard disk** and browse to find the :file:`clear-XXXX-hyperv.vhdx` file. - * When finised, open VM settings, select Firmware Section and in Secure Boot - config, **uncheck** Enable Secure Boot. + #. Choose **Generation 2** when prompted to *specify VM generation*. + #. Choose **Use an existing virtual hard disk** and browse to find the + :file:`clear-XXXX-hyperv.vhdx` file. + #. When finished, open VM settings, select Firmware Section and in Secure + Boot config, **uncheck** Enable Secure Boot. - + Currently Clear Linux does not boot with secure boot enabled. + .. note:: Currently, Clear Linux does not boot with :option:`secure boot` + enabled. -#. Finally, connect to your new VM and start it. You should see a prompt asking for - a user; use:: +#. Connect to your new VM and start it. You should see a prompt: + + .. code-block:: console > User: root - and set a root user password. +#. Set a root user password. + +Your virtual machine running |CLOSIA| is ready! .. _Windows Server Virtualization: https://www.microsoft.com/en-us/server-cloud/solutions/virtualization.aspx .. _Microsoft documentation: https://www.microsoft.com/en-us/server-cloud/solutions/virtualization.aspx -.. _latest: https://download.clearlinux.org/image/ +.. _downloads: https://download.clearlinux.org/image/ .. _7zip: http://www.7-zip.org/ .. _VirtualBox: https://www.virtualbox.org/ .. _QEMU: http://wiki.qemu.org/Links