diff --git a/.gitignore b/.gitignore index 20a09cc4..8b707190 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,5 @@ source/_build/ # ignore vi temporary files *.swp +*~ +.*~ diff --git a/source/index_vm.rst b/source/index_vm.rst index cae2797d..8719be12 100644 --- a/source/index_vm.rst +++ b/source/index_vm.rst @@ -8,4 +8,5 @@ Running in a virtualized environment vm-virtualbox vm-vmware-esxi vm-vmware-player + vm-hyper-v diff --git a/source/vm-hyper-v.rst b/source/vm-hyper-v.rst new file mode 100644 index 00000000..04757dcc --- /dev/null +++ b/source/vm-hyper-v.rst @@ -0,0 +1,74 @@ +.. _vm-hyper-v: + +================ +Using Hyper-V +================ + +This section explains how to run Clear Linux inside +`Windows Server Virtualization`_ *A.K.A.* **Hyper-V** environment. + + +Install Hyper-V +--------------- + +Please refer to `Microsoft documentation`_ to install and configure +*Hyper-V* on your machine. + + +Create a virtual machine +------------------------ + +1. Download the latest_ Clear Linux live version (clear-XXXX-live.img.xz) + from https://download.clearlinux.org/image/. + +2. Decompress Clear Linux image (you can use 7zip_). Uncompressed image + size is ~ **5GiB**. + +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) + + * Using *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 + + * Using *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 with:: + + 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 + 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**: + + * 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. + + You will see a prompt asking for a user, use: + + * User: root + * A new password will be asked for user root + + +.. _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/latest +.. _7zip: http://www.7-zip.org/ +.. _VirtualBox: https://www.virtualbox.org/ +.. _QEMU: http://wiki.qemu.org/Links +.. _Generation 2: https://technet.microsoft.com/en-us/library/dn282285.aspx diff --git a/source/vm-virtualbox.rst b/source/vm-virtualbox.rst index 67efb8e2..f30fe974 100644 --- a/source/vm-virtualbox.rst +++ b/source/vm-virtualbox.rst @@ -26,7 +26,7 @@ Create a virtual machine in VirtualBox 1. Download the latest_ Clear linux live version (clear-XXXX-live.img.xz) from https://download.clearlinux.org/image/. -2. Decompress clear linux image +2. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. - On Linux :: diff --git a/source/vm-vmware-esxi.rst b/source/vm-vmware-esxi.rst index 9fbe5d47..74b21b97 100644 --- a/source/vm-vmware-esxi.rst +++ b/source/vm-vmware-esxi.rst @@ -14,8 +14,9 @@ Run Clear Linux* 1. In order to boot Clear Linux* download the latest_ live disk image from https://download.clearlinux.org/image/ +2. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. -2. Create and configure a virtual machine with the following configuration: +3. Create and configure a virtual machine with the following configuration: - Guest Operating system: **Linux, Distribution Other 3.x Linux (64-bits)** @@ -26,13 +27,14 @@ Run Clear Linux* In VMware vShere GUI go to the configuration settings of the virtual machine->General Tab-> And select **EFI boot firmware** + - **IDE disk**: Convert to vmdk and attach the Clear Linux image downloaded above. To convert Clear Linux image to VMWare* disk (vmdk) you can use qemu-img command:: $qemu-img convert -f raw -O vmdk -p clear-vmware.img clear-vmware.vmdk -3. Start the Clear Linux* virtual machine +4. Start the Clear Linux* virtual machine ********************************* Using optimized kernel for VMware diff --git a/source/vm-vmware-player.rst b/source/vm-vmware-player.rst index 8c424f92..5a22eb68 100644 --- a/source/vm-vmware-player.rst +++ b/source/vm-vmware-player.rst @@ -38,7 +38,7 @@ https://download.clearlinux.org/image/. In Clear Linux website you can find different image flavors (kvm, clear-containers, cloud and live), please download the live image (clear-XXXX-live.img.xz). -1. Decompress the image: +1. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. - On Linux ::