diff --git a/source/index.rst b/source/index.rst index d49a6314..2fcca30b 100644 --- a/source/index.rst +++ b/source/index.rst @@ -16,15 +16,6 @@ Getting started index_gs.rst -Running in a virtualized environment -==================================== - -.. toctree:: - :maxdepth: 2 - - index_vm.rst - - Software update =============== @@ -62,14 +53,14 @@ OpenStack* implementation Indices and tables -################## +================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` License and disclaimers -####################### +======================= .. toctree:: .. include:: documentation_license.rst diff --git a/source/index_gs.rst b/source/index_gs.rst index 84661c6d..b285630e 100644 --- a/source/index_gs.rst +++ b/source/index_gs.rst @@ -9,3 +9,9 @@ Getting started gs_creating_bootable_usb gs_installing_clr_as_host gs-clear-containers-gettting-started + vm-kvm + 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 index 99baacd4..4a9866f1 100644 --- a/source/vm-hyper-v.rst +++ b/source/vm-hyper-v.rst @@ -1,22 +1,21 @@ .. _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/. diff --git a/source/vm-virtualbox.rst b/source/vm-virtualbox.rst index f30fe974..b4227970 100644 --- a/source/vm-virtualbox.rst +++ b/source/vm-virtualbox.rst @@ -1,14 +1,13 @@ .. _vm-virtualbox: -================ Using VirtualBox -================ +################ This section explains how to run Clear Linux inside VirtualBox_ environment. Download VirtualBox -------------------- +=================== Virtualbox is a hypervisor supported by *Oracle**, you can download it from its official site @@ -21,7 +20,7 @@ that is used in Clear Linux. 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/. @@ -60,7 +59,7 @@ Create a virtual machine in VirtualBox * System -> Enable EFI (special OSes only) Run your new VM ---------------- +=============== Clear Linux comes with VirtualBox kernel modules in a bundle. You can install these modules using diff --git a/source/vm-vmware-esxi.rst b/source/vm-vmware-esxi.rst index 74b21b97..07ae7a16 100644 --- a/source/vm-vmware-esxi.rst +++ b/source/vm-vmware-esxi.rst @@ -1,44 +1,41 @@ .. _vm-vmware-esxi: Using VMware* ESXi guest -======================== +######################## -This documentation explains how to use Clear Linux as ESXi Guest. -This docuemnt is based on VMware vSphere 6. +This topic, which is based on VMware vSphere* 6, explains how to use Clear Linux* OS +for Intel® Architecture as ESXi Guest. +Run Clear Linux OS for Intel Architecture +========================================= -**************** -Run Clear Linux* -**************** - -1. In order to boot Clear Linux* download the latest_ live disk image from +1. To boot Clear Linux OS for Intel Architecture, download the latest_ live disk image from https://download.clearlinux.org/image/ -2. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. +2. Decompress the image. Uncompressed image size is ~ **5GiB**. 3. Create and configure a virtual machine with the following configuration: - - Guest Operating system: **Linux, Distribution Other 3.x Linux (64-bits)** + - Guest Operating system: **Linux, Distribution Other 3.x Linux (64-bits)** - - **UEFI support**: Clear Linux uses as default bootloader systemd-boot a - UEFI boot manager for EFI images + - **UEFI support**: Clear Linux uses as default bootloader systemd-boot a + UEFI boot manager for EFI images - .. tip:: - In VMware vShere GUI go to the configuration settings of the - virtual machine->General Tab-> And select **EFI boot firmware** + .. tip:: + 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:: + - **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 4. Start the Clear Linux* virtual machine -********************************* -Using optimized kernel for VMware -********************************* +Using optimized kernel for VMware* +================================== Clear Linux provides a bundle called *kernel-vmware* that contains a specialized kernel that uses an specific configuration for *VMware hypervisor* such as: diff --git a/source/vm-vmware-player.rst b/source/vm-vmware-player.rst index 5a22eb68..1a8a2ed9 100644 --- a/source/vm-vmware-player.rst +++ b/source/vm-vmware-player.rst @@ -1,14 +1,13 @@ .. _vm-vmware-player: -==================== Using VMware* Player -==================== +#################### This section explains how to run Clear Linux inside `VMWare Player`_ environment. Install VMware player ---------------------- +===================== *VMware Workstation Player*, formerly VMware Player, is a virtualization software package for x64 computers running Microsoft Windows or Linux. To @@ -16,7 +15,7 @@ download VMware player, you can click on the following link: https://www.vmware.com/products/player/playerpro-evaluation.html Player on Linux -^^^^^^^^^^^^^^^ +--------------- If you have chosen Linux option, you got a :file:`VMWARE_FILE.bundle` file. To install VMWare Player, run: @@ -26,12 +25,12 @@ install VMWare Player, run: $ sudo bash ./VMware-Player-12.0.0-2985596.x86_64.bundle Player on windows -^^^^^^^^^^^^^^^^^ +----------------- Please follow the instructions from the Setup Assistant Prepare Clear Linux Image -------------------------- +========================= Download the latest_ Clear Linux live disk image from https://download.clearlinux.org/image/. In Clear Linux website you can find @@ -66,11 +65,11 @@ download the live image (clear-XXXX-live.img.xz). Run Clear Linux* using VMware* Player -------------------------------------- +===================================== Create a new Virtual Machine -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +---------------------------- Click on “Create a new Virtual Machine” @@ -84,7 +83,7 @@ Click on “Create a new Virtual Machine” 4. Perform the *remaining steps* using the default options. Change boot type to EFI -^^^^^^^^^^^^^^^^^^^^^^^ +----------------------- You must change VMware virtual machine *configuration* to **support efi firmware**, by editing a configuration .vmx file, @@ -95,7 +94,7 @@ that is located in the virtual machine folder, and add the next line: firmware = "efi" Attach Clear Linux image as SATA disk -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +------------------------------------- When you have created a new virtual machine, you can edit its configuration: @@ -115,7 +114,7 @@ verify it in “Advanced button” in the disk settings Start the virtual machine -------------------------- +========================= After the above configuration start the virtual machine.