From b0f7c457133ea7ac20d2f0d5eec03e580ad41b10 Mon Sep 17 00:00:00 2001 From: Leona Date: Wed, 4 May 2016 12:23:37 -0700 Subject: [PATCH] editing vm-vmware-player.rst file for syntax, formatting, grammar, lists Signed-off-by: Leona --- source/vm-vmware-player.rst | 114 ++++++++++++++---------------------- 1 file changed, 44 insertions(+), 70 deletions(-) diff --git a/source/vm-vmware-player.rst b/source/vm-vmware-player.rst index 1a8a2ed9..ac3b73d5 100644 --- a/source/vm-vmware-player.rst +++ b/source/vm-vmware-player.rst @@ -1,125 +1,99 @@ .. _vm-vmware-player: -Using VMware* Player -#################### +Using *VMware* Player +##################### -This section explains how to run Clear Linux inside -`VMWare Player`_ environment. +This section explains how to run Clear Linux within a `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 -download VMware player, you can click on the following link: -https://www.vmware.com/products/player/playerpro-evaluation.html +software package for x64 computers running Microsoft Windows or Linux. Download +VMware player from the `VMware website`_. Player on Linux --------------- -If you have chosen Linux option, you got a :file:`VMWARE_FILE.bundle` file. To -install VMWare Player, run: +For the Linux option, you should have a ``VMware-Player-[version]_FILE.bundle`` file. To +install it, run: :: - $ sudo bash ./VMware-Player-12.0.0-2985596.x86_64.bundle + $ sudo bash ./VMware-Player-[version].x86_64.bundle -Player on windows +Player on Windows ----------------- -Please follow the instructions from the Setup Assistant +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 -different image flavors (kvm, clear-containers, cloud and live), please -download the live image (clear-XXXX-live.img.xz). +#. Download the `latest`_ Clear Linux **live** disk image, named + ``[clear-[version_number]-live.img.xz]``. -1. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. +#. Decompress the Clear Linux image. Uncompressed image size ~ **5GB**. - - On Linux :: + * On Linux :: $ unxz clear-VERSION-live.img.xz - - On Windows + * On Windows you can use `7zip`_. - You can use 7zip_. +#. Convert the installer to :abbr:`VMDK (Virtual Machine Disk)` format. -2. Convert installer to :abbr:`VMDK (Virtual Machine Disk)` format. - - - On linux - - Convert Clear Linux raw installer image in vmdk virtual disk, for doing - this there are a lot of tools, this is an option: - - :: + * On Linux, you can use ``qemu-img convert``:: $ qemu-img convert -O vmdk clear-VERSION-live.img clear.vmdk - - On Windows - - To convert live image to vmdk format ( from raw format to vmdk) you can - use different tools for this purpose (e.g., VBoxManage from VirtualBox_). + * On Windows, you can convert the live image to vmdk format (from raw format to vmdk) + with a tool like VBoxManage from `VirtualBox`_. Run Clear Linux* using VMware* Player ===================================== -Create a new Virtual Machine ----------------------------- +#. Create a new virtual machine. -Click on “Create a new Virtual Machine” +#. Click on “Create a new Virtual Machine”. -1. Select “**I will install the operating system later**”, and click on “Next”. + * Select “**I will install the operating system later**”, and click on “Next”. + * Select “**Linux**” as “Guest operating system” and version **Other Linux 3.x kernel 64-bit**. + * Type a name for the new virtual machine. + * Perform the *remaining steps* using the default options. -2. Select “**Linux**” as “Guest operating system” and version “**Other Linux 3.x - kernel 64-bit**”. +#. Change boot type to EFI. You must change the VMware virtual machine *configuration* + to **Support EFI firmware**; you can do this by editing the configuration ``.vmx`` + file located in the virtual machine folder and adding the following line:: -3. Type a name for the new virtual machine. + firmware = "efi" -4. Perform the *remaining steps* using the default options. +#. Attach the Clear Linux image as SATA disk. And when you have a new virtual machine, + edit its configuration as follows: -Change boot type to EFI ------------------------ - -You must change VMware virtual machine *configuration* to -**support efi firmware**, by editing a configuration .vmx file, -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: - -1. Click on “Edit virtual machine settings” - -2. Remove any default attached hard disk - -3. Click on “Add” option below devices list tab and choose Hard disk. - - i. Choose “SATA” as virtual disk type. - - - Use the existing Clear Linux* virtual disk - -The Clear Linux live disk must set as “SATA 0:1 Hard Disk (SATA)” you can -verify it in “Advanced button” in the disk settings + * Click on “Edit virtual machine settings”. + * Remove any default attached hard disk. + * Click on “Add” option below devices list tab and choose Hard disk. + * Choose **SATA** as the virtual disk type. + * Use the existing Clear Linux virtual disk + The Clear Linux live disk must set as ``SATA 0:1 Hard Disk (SATA)``; you can verify + this under the “Advanced" section of the disk settings. Start the virtual machine ========================= -After the above configuration start the virtual machine. +After configuring the settings above, start the virtual machine. + +.. _VMware website: https://www.vmware.com/products/player/playerpro-evaluation.html .. _VMWare Player: http://www.vmware.com/products/player/ -.. _latest: https://download.clearlinux.org/latest +.. _latest: https://download.clearlinux.org/current/ .. _7zip: http://www.7-zip.org/ .. _VirtualBox: https://www.virtualbox.org/