From 9299392103c5751b6ade7aa7768596677b3122dd Mon Sep 17 00:00:00 2001 From: Leona Date: Wed, 4 May 2016 08:11:39 -0700 Subject: [PATCH] correcting formatting, grammar and typos in vm-hyper-v.rst Signed-off-by: Leona --- source/vm-hyper-v.rst | 40 ++++++++++++++++++---------------------- 1 file changed, 18 insertions(+), 22 deletions(-) diff --git a/source/vm-hyper-v.rst b/source/vm-hyper-v.rst index 4a9866f1..24176417 100644 --- a/source/vm-hyper-v.rst +++ b/source/vm-hyper-v.rst @@ -3,7 +3,7 @@ Using Hyper-V ############# -This section explains how to run Clear Linux inside +This section explains how to run Clear Linux inside a `Windows Server Virtualization`_ *A.K.A.* **Hyper-V** environment. @@ -17,52 +17,48 @@ Please refer to `Microsoft documentation`_ to install and configure Create a virtual machine ======================== -1. Download the latest_ Clear Linux live version (clear-XXXX-live.img.xz) - from https://download.clearlinux.org/image/. +#. Download the `latest`_ live version (clear-XXXX-live.img.xz) of Clear Linux. -2. Decompress Clear Linux image (you can use 7zip_). Uncompressed image - size is ~ **5GiB**. +#. Decompress the downloaded image. Uncompressed image size is ~ **5GB**. -3. To convert Clear Linux raw image to :abbr:`VHD (Virtual Hard Disk)` - format, you need to use VirtualBox_ or QEMU_ (windows version available on - internet) +#. To convert a Clear Linux raw image to :abbr:`VHD (Virtual Hard Disk)` + format, you can use VirtualBox_ or QEMU_. - * Using *VirtualBox* you can use one of the following commands:: + * With *VirtualBox*, you can use one of the following commands:: - VBoxManage convertfromraw clear-XXXX-live.img clear-XXXX-live.vhd --format VHD + > 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 + > vbox-img convert --srcfilename clear-XXXX-live.img --dstfilename clear-XXXX-live.vhd --srcformat raw --dstformat vhd - * Using *QEMU* you can use the following command:: + * With *QEMU*, you can use the following command:: - qemu-img convert -f raw -O vpc clear-XXXX-live.img clear-XXXX-live.vhd + > 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 with:: + 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 uses *EFI* to boot, and this featue is only availible in `Generation 2`_ - virtual machines, so, you need to convert from **VHD** to **VHDX**, to do this + Clear Linux uses *EFI* to boot. Since this featue 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`. -4. Create virtual machine using the **Hyper-V Manager**: +#. 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. -5. Connect to your new VM and start it. +#. Finally, connect to your new VM and start it. You should see a prompt asking for + a user; use:: - You will see a prompt asking for a user, use: - - * User: root - * A new password will be asked for user root + > User: root + and set a root user password. .. _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