Updated underlins

Signed-off-by: Anthony Pray anthony.s.pray@intel.com

source/get-started/bare-metal-install-desktop.rst

@@ -84,6 +84,8 @@ Ensure a network connection exists before launching the Software application.
    intended only for exploration. Do not attempt to install applications during
    exploration.
 
+.. _install-clr-desktop-start:
+
 Launch the |CL| installer
 =========================
 

source/get-started/bare-metal-install-server.rst

@@ -73,6 +73,8 @@ Follow these steps to install |CL| on the target system:
 
 #. With :guilabel:`Clear Linux OS` highlighted, select :kbd:`Enter`.
 
+.. _install-clr-server-start:
+
 Launch the |CL| Installer
 *************************
 

source/get-started/bootable-usb.rst

@@ -1,30 +1,19 @@
 .. _bootable-usb:
 
-Create a bootable USB drive
+Create a bootable USB drive using BalenaEtcher
-###########################
+##############################################
-
-Follow the instructions applicable to your system to create a bootable
-|CL-ATTR| USB drive:
-
-* :ref:`bootable-usb-linux`
-* :ref:`bootable-usb-mac`
-* :ref:`bootable-usb-windows`
 
 Prerequisites
 *************
 
 * Download the |CL| Desktop or Server image from the `Downloads`_ page
 * Recommended minimum **4GB** USB drive or larger
+* Download and install `BalenaEtcher`_
 
 .. _bootable-usb-linux:
 
-Create a bootable USB drive on Linux\*
-**************************************
-
 * Make sure you completed all `Prerequisites`_.
 
-* :ref:`verify-linux` on Linux.
-
 Burn the |CL| image onto a USB drive
 ====================================
 
@@ -33,184 +22,90 @@ Burn the |CL| image onto a USB drive
    Burning an image formats the USB drive and destroys all pre-existing
    content.  Back up your data before proceeding.
 
-#. Open a terminal window.
+#. Launch balenaEtcher.
+
+   .. figure:: /_figures/bootable-usb/balenaEtcher_Start.PNG
+      :scale: 100%
+      :alt: BalenaEtcher Start
+         
+      Figure X: BalenaEtcher Start
+ 
+#. Press :guilabel:`Select Image`.
 
 #. Change directory to where the image resides.
 
+#. Open the Image.
+
+   .. figure:: /_figures/bootable-usb/balenaEtcher_ImgaeSlect.PNG
+      :scale: 100%
+      :alt: 
+         
+      Figure X: 
+
 #. Plug in the USB drive.
 
-#. Identify the USB drive using the :command:`lsblk` command with these options:
+#. Identify the USB drive using the :guilabel:`Change` under the middel icon.
-   ``-po NAME,SIZE,TYPE,FSTYPE,PARTLABEL,MOUNTPOINT,VENDOR,MODEL``. This shows all
+    
-   drives attached to the system, including the primary hard disk. In the
+   .. note::
-   example output below, there are 3 drives (`/dev/sda`, `/dev/sdb`, and `/dev/sdc`) 
+      This shows all USB drives attached to the system.
-   attached, where `/dev/sda` is the primary drive and the remaining are USB drives.
 
-   .. code-block:: bash
+   .. figure:: /_figures/bootable-usb/balenaEtcher_DriveSlect.PNG
+      :scale: 100%
+      :alt: 
+         
+      Figure X: 
 
-      lsblk -po NAME,SIZE,TYPE,FSTYPE,PARTLABEL,MOUNTPOINT,VENDOR,MODEL
+#. Select the proper drive and press :guilabel:`Continue`.
 
-   Example output:
+   .. figure:: /_figures/bootable-usb/balenaEtcher_ReadyToFlash.PNG
+      :scale: 100%
+      :alt: 
+      
+      Figure X: 
 
-   .. code-block:: console
+#. When ready Press the  :guilabel:`Flash!` Button.
 
-      NAME          SIZE VENDOR   MODEL                    TRAN   TYPE PARTLABEL                    MOUNTPOINT
+#. Flashing starting.
-      /dev/sda    119.2G ATA      SAMSUNG_MZ7PC128HAFU-000 sata   disk                              
+
-      ├─/dev/sda1   450M                                          part Basic data partition         
+   .. figure:: /_figures/bootable-usb/balenaEtcher_StartingToFlash.PNG
-      ├─/dev/sda2   100M                                          part EFI system partition         
+      :scale: 100%
-      ├─/dev/sda3    16M                                          part Microsoft reserved partition 
+      :alt: 
-      ├─/dev/sda4  97.2G                                          part Basic data partition         
+
-      ├─/dev/sda5   142M                                          part EFI                          
+      Figure X: 
-      ├─/dev/sda6   245M                                          part linux-swap                   [SWAP]
+
-      └─/dev/sda7  21.1G                                          part /                            /
+#. Flashing in progress.
-      /dev/sdb      7.5G General  UDisk                    usb    disk                              
+
-      └─/dev/sdb1   7.5G                                          part Microsoft Basic Data         /run/media/clear/CENA_X64FRE
+   .. figure:: /_figures/bootable-usb/balenaEtcher_Flashing.PNG
-      /dev/sdc       15G          Patriot_Memory           usb    disk                              
+      :scale: 100%
-      └─/dev/sdc1    15G                                          part                              /run/media/clear/U
+      :alt: 
+      
+      Figure X: 
+
+#. Flashing complete.
+
+   .. figure:: /_figures/bootable-usb/balenaEtcher_Done.PNG
+      :scale: 100%
+      :alt: 
+      
+      Figure X: 
 
    .. note::
+      The process can take more than a few minutes. When the process completes, close BalenaEtcher.
+      
 
-      Some Linux distros may automatically mount a USB drive when it is plugged in.
+Ejecting the |CL| image USB drive
-
+=================================
-#. If the USB drive you want to use is mounted, it must be umounted before
-   burning an image onto it.  Use the :command:`umount` command followed by
-   the device identifier/partition. For example, to unmount all of the 
-   ``/dev/sdc`` partitions:
-
-   .. code-block:: bash
-
-      sudo umount /dev/sdc*
-
-#. Burn the image onto the USB drive. This example burns an image onto ``/dev/sdc``.  
-   The device name of the USB may vary.
-
-   .. code-block:: bash
-
-      sudo dd if=./clear-[version number]-live-[desktop | server].iso of=/dev/sdc oflag=sync bs=4M status=progress
 
 .. caution::
 
-   Not fully unmounting the USB drive before burning an image could cause
+   Not fully unmounting the USB drive before removing the drive could cause
    file system checksum errors in it. If this happens, burn the image again,
-   ensuring all the USB drive partitions are unmounted first.
+   ensuring all the USB drive partitions are unmounted first befor removing drive.
 
-.. _bootable-usb-mac:
-
-Create a bootable USB drive on macOS\*
-**************************************
-
-* Make sure you completed all `Prerequisites`_.
-
-* :ref:`verify-mac` on macOS.
-
-Burn the |CL| image onto a USB drive
-====================================
-
-.. caution::
-
-   Burning an image formats the USB drive and destroys all pre-existing
-   content.  Back up your data before proceeding.
-
-#. Open a Terminal window.
-
-#. Change directory to where the image resides.
-
-#. Plug in a USB drive and get its identifier:
-
-   .. code-block:: bash
-
-      diskutil list
-
-   This lists available disks and their partitions, as shown in Figure 1.
-
-   .. figure:: /_figures/bootable-usb/bootable-usb-mac-01.png
-      :scale: 100 %
-      :alt: Get USB drive identifier
-
-      Figure 1: macOS - Get USB drive identifier
-
-#. Unmount the USB drive identified in the previous step. For example, to unmount /dev/disk2. The device name of the USB may vary.
-
-   .. code-block:: bash
-
-      diskutil umountDisk /dev/disk2
-
-#. Burn the image onto the drive using the :command:`dd` command.
-   This example uses `./`, your current directory, and it shows how to burn
-   an image onto `/dev/disk2`:
-
-   .. code-block:: bash
-
-      sudo dd if=./clear-[version number]-live-[desktop | server].iso of=/dev/disk2 bs=4m
-
-   To accelerate the imaging process, add an ‘r’ before the device identifier. Example: `sudo dd if=./clear-30800-live-server.iso of=/dev/rdisk2 bs=4m`.
-
-   Press :kbd:`<CTRL>-T` to check imaging progress.
-
-#. Eject the USB drive.
-
-   .. code-block:: bash
-
-      diskutil eject /dev/disk2
-
-.. _bootable-usb-windows:
-
-Create a bootable USB drive on Windows
-**************************************
-
-* Make sure you completed all `Prerequisites`_.
-
-* :ref:`verify-windows` on Windows\* OS.
-
-Burn the |CL| image onto a USB drive
-====================================
-
-.. caution::
-
-   Burning an image formats the USB drive and destroys all pre-existing
-   content.  Back up your data before proceeding.
-
-#. Download the `Rufus`_ utility to burn the image onto a USB drive.
-   We use Rufus 3.5 for this example.
-   **Only use the latest version of Rufus**.
-
-#. Plug in the USB drive.
-
-#. Launch Rufus.
-
-#. Under `Device`, select the USB drive.
-
-#. Under `Boot selection`, click the :guilabel:`SELECT` button.
-
-   .. note::
-
-      For other image tools, verify the `Volume label` is set to :guilabel:`CLR_ISO` **Do not change the label as installer relies on it.**
-
-#. In the dialog, navigate to where the |CL| ISO image was downloaded and select it.
-
-#. Click the :guilabel:`START` button. See Figure 2.
-
-   .. figure:: /_figures/bootable-usb/bootable-usb-windows-02.png
-      :scale: 80 %
-      :alt: Rufus utility
-
-      Figure 2: Rufus utility
-
-#. When the dialogue appears, select
-   :guilabel:`Write in ISO image mode (Recommended)`. See Figure 3.
-
-   .. figure:: /_figures/bootable-usb/bootable-usb-windows-03.png
-      :scale: 80 %
-      :alt: ISOHybrid image detected
-
-      Figure 3: ISOHybrid image detected
-
-#. Click :guilabel:`OK`.
-
-#. The process make take more than a few minutes. When the process completes,
-   close Rufus.
 
 #. Select the Windows taskbar menu for USB and select
    :guilabel:`Eject <drive name>`.
-
+   
-.. _Rufus: https://rufus.ie/
+ 
 .. _Downloads: https://clearlinux.org/downloads
+.. _BalenaEtcher: https://www.balena.io/etcher/

source/get-started/virtual-machine-install/vmw-player.rst

@@ -3,7 +3,9 @@
 |CL-ATTR| on VMware\* Workstation Player
 ########################################
 
-This page explains how to create a new VMware Workstation Player hypervisor and use one of two images: the |CL| Desktop installer iso, or the |CL| Pre-configured VMWare image.
+This guide explains how to set up the VMware Workstation Player 15.5.1
+hypervisor and instantiate a VM instance of |CL| by installing it using 
+an ISO or using a pre-built image.
 
 .. contents::
    :local:
@@ -23,9 +25,9 @@ it, see :ref:`vmware-esxi-install-cl`.
 
 .. note::
 
-   The screenshots on this document show the Windows version of the
+   The screenshots in this document show the Windows version of the
-   VMware Workstation 15 Player. The menus and prompts are similar to those
+   VMware Workstation Player 15.5.1. The menus and prompts are similar to those
-   in other versions and for the Linux OS save some minor wording 
+   in other versions and for the Linux version, save some minor wording 
    differences.
 
 Install the VMware Workstation Player hypervisor
@@ -38,41 +40,38 @@ Install the VMware Workstation Player hypervisor
 #. `VMware Workstation Player`_ is available for Windows and Linux.
    Download your preferred version.
 
-   .. note::
-
-      By default, selecting download means you receive the latest version
-      of this application. Commands may differ based on the version.
-
 #. Install VMware Workstation Player by following the instructions
-   appropriate for your system OS:
+   appropriate for your system's OS:
 
    * On supported Linux distros:
 
-     #. Enable a GUI desktop.
+     a. Ensure your Linux distro is running a GUI desktop.
      #. Start a terminal emulator.
      #. Start the installer by issuing the command below and follow the
         guided steps.
 
         .. code-block:: console
 
-           sudo sh ./VMware-Player-[version number].x86_64.bundle
+           sudo sh ./VMware-Player-<version number>.x86_64.bundle
 
    * On Windows:
 
-     #. Start the installer.
+     a. Start the installer.
      #. Follow the setup wizard.
 
 For additional help, see the `VMware Workstation Player Documentation`_.
 
-Create and configure a new VM
+Create a blank VM
-*****************************
+*****************
 
 #. Start the ``VMware Workstation Player`` app.
 
 #. On the home screen, click :guilabel:`Create a New Virtual Machine`. See
    Figure 1.
 
-   .. figure:: /_figures/vmw-player/vmw-player-01.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-01.png
       :scale: 100%
       :alt: VMware Workstation Player - Create a new virtual machine
 
@@ -81,7 +80,9 @@ Create and configure a new VM
 
 #. Select :guilabel:`I will install the operating system later`.
 
-   .. figure:: /_figures/vmw-player/vmw-player-02.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-02.png
       :scale: 100%
       :alt: I will install the operating system later.
 
@@ -89,11 +90,13 @@ Create and configure a new VM
 
 #. Click the :guilabel:`Next` button.
 
-#. On the :guilabel:`Select a Guest Operating System`, set the
+#. On the :guilabel:`Select a Guest Operating System` window, set the
    :guilabel:`Guest operating system` setting to :guilabel:`Linux`. See
    Figure 3.
 
-   .. figure:: /_figures/vmw-player/vmw-player-03.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-03.png
       :scale: 100%
       :alt: VMware Workstation Player - Select guest operating system type
 
@@ -108,7 +111,9 @@ Create and configure a new VM
 #. On the :guilabel:`Name the Virtual Machine` screen, name the new VM. See
    Figure 4.
 
-   .. figure:: /_figures/vmw-player/vmw-player-04.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-04.png
       :scale: 100%
       :alt: VMware Workstation Player - Name virtual machine
 
@@ -117,9 +122,12 @@ Create and configure a new VM
 #. Click the :guilabel:`Next` button.
 
 #. On the :guilabel:`Specify Disk Capacity` screen, set the VM's maximum disk
-   size. See Figure 5.
+   size. If you're planning to use a pre-built image, just use the default
+   size for now. See Figure 5.
 
-   .. figure:: /_figures/vmw-player/vmw-player-05.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-05.png
       :scale: 100%
       :alt: VMware Workstation Player - Set disk capacity
 
@@ -135,15 +143,19 @@ Create and configure a new VM
 #. On the :guilabel:`Ready to Create Virtual Machine` screen, click the
    :guilabel:`Customize Hardware...` button. See Figure 6.
 
-   .. figure:: /_figures/vmw-player/vmw-player-06.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-06.png
       :scale: 100%
       :alt: VMware Workstation Player - Customize hardware
 
       Figure 6: VMware Workstation Player - Customize hardware
 
-#. Select :guilabel:`Memory` and set the size to 2GB. See Figure 7.
+#. Select :guilabel:`Memory` and set a desired value. See Figure 7.
 
-   .. figure:: /_figures/vmw-player/vmw-player-07.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-07.png
       :scale: 100%
       :alt: VMware Workstation Player - Set memory size
 
@@ -151,7 +163,7 @@ Create and configure a new VM
 
    .. note::
 
-      The |CL| installer ISO needs a minimum of 2GB of RAM.
+      The |CL| live installer ISO needs a minimum of 1GB of RAM.
       After completing installation, |CL| can run on as little as
       128MB of RAM. Thus, you can reduce the memory size if needed.
       See :ref:`system-requirements` for more details.
@@ -159,7 +171,9 @@ Create and configure a new VM
 #. Under the :guilabel:`Device` list, select :guilabel:`Processors`. See
    Figure 8.
 
-   .. figure:: /_figures/vmw-player/vmw-player-08.png
+   .. rst-class:: dropshadow
+
+   .. figure:: ../../_figures/vmw-player/vmw-player-08.png
       :scale: 100%
       :alt: VMware Workstation Player - Set virtualization engine option
 
@@ -167,10 +181,10 @@ Create and configure a new VM
       option
 
 #. Under :guilabel:`Processors` and :guilabel:`Number of processor cores`, 
-   enter 4. 
+   enter the desired number of cores. 
 
 #. Under the :guilabel:`Virtualization engine` section,
-   check :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`.
+   check the :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI` box.
 
 #. Click the :guilabel:`Close` button.
 
@@ -179,17 +193,9 @@ Create and configure a new VM
 Enable UEFI boot support
 ************************
 
-|CL| needs UEFI support to boot. To enable UEFI:
+|CL| needs UEFI support to boot and work properly. To enable it:
 
-#. Power off the VM. click the :guilabel:`Player` menu. See Figure 9.
+#. Close the ``VMware Workstation Player`` app.
-
-   .. figure:: /_figures/vmw-player/vmw-player-09.png
-      :scale: 100%
-      :alt: VMware Workstation Player - Power off virtual machine
-
-      Figure 9: VMware Workstation Player - Power off virtual machine
-
-#. Go to :guilabel:`Power` and select :guilabel:`Shut Down Guest`.
 
 #. Add the following line to the end of your VM's :file:`.vmx` file.
 
@@ -201,189 +207,198 @@ Enable UEFI boot support
 
       Depending on the OS, you can typically find the VMware VM files under:
 
-      * On Linux distros: :file:`/home/username/vmware`
+        * On Linux distros: :file:`/home/username/vmware`
-      * On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`
+        * On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`
-
-Download the latest |CL| image
-******************************
-
-Download the appropriate image per the tab below. We also provide 
-additional information about :ref:`image-types` and instructions on how to 
-:ref:`download-verify-decompress`.
-
-Attach the appropriate image
-============================
-   
-   .. tabs::
-
-      .. tab:: |CL| Desktop 
-
-         This option provides a live-desktop iso installer. 
-
-         #. Navigate to the `downloads`_ page and download the |CL| Desktop.
-            After the download is complete, you will attach this image.
-
-         #. On the :guilabel:`VMware Workstation 15 Player`, right-click the 
-            new VM, created in `Create and configure a new VM`_. 
-
-         #. From the pop-up menu, select :guilabel:`Settings`. 
-
-         #. From :guilabel:`Virtual Machine settings`, 
-            under :guilabel:`Hardware`, select ``CD/DVD``.
-
-         #. Under :guilabel:`Connection` at right, select 
-            :guilabel:`Use ISO image file`. 
-
-         #. Click :guilabel:`Browse` and select the decompressed 
-            |CL| installer ISO. See Figure 10.
-            
-            .. figure:: /_figures/vmw-player/vmw-player-10.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Select |CL| installer ISO
-
-               Figure 10: VMware Workstation Player - Select |CL| installer
-               ISO   
-
-         #. Follow the guide :ref:`install-on-target-start` to complete the
-            installation of |CL|.
-
-         #. After the installation completes, reboot the VM. This reboot
-            restarts the |CL| installer.
-
-         #. To enable the mouse pointer so you access VMware Workstation
-            Player's menus, press :kbd:`<CTRL>` + :kbd:`<ALT>` on the keyboard.
-
-         #. To disconnect the CD/DVD to stop it from booting the |CL|
-            installer ISO again, click the :guilabel:`Player` menu. See
-            Figure below.
-
-            .. figure:: /_figures/vmw-player/vmw-player-11.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Edit CD/DVD settings
-
-               Figure 11: VMware Workstation Player - Edit CD/DVD settings
-
-         #. Go to :menuselection:`Removable Devices-->CD/DVD 
-            (IDE)-->Disconnect`.
-
-         #. Click the :guilabel:`OK` button.
-
-         #. Continue below. 
-
-      .. tab:: |CL| Pre-configured VMWare image
-
-         #. Navigate to the `downloads`_ page and select the ``VMware`` 
-            image. Look for :file:`clear-[version number]-vmware.vmdk.xz`. 
-
-         #. Move the downloaded and decompressed pre-configured |CL| VMware
-            image file :file:`clear-[version number]-basic.vmdk` to the
-            directory where your newly-created VM resides.
-
-            .. note::
-
-               Depending on the OS, you can typically find the VMware VM
-               files under:
-
-               * Linux distros :file:`/home/username/vmware`
-               * Windows :file:`C:\Users\username\Documents\Virtual Machines`
-
-         #. On the :guilabel:`VMware Workstation 15 Player`, right-click the 
-            new VM, created in `Create and configure a new VM`_. 
-
-         #. From the pop-up menu, select :guilabel:`Settings`. 
-
-         #. Under :guilabel:`Hardware` and :guilabel:`Device` list, select 
-            :guilabel:`Hard Disk (SCSI)`. See figure 12.
-
-            .. figure:: /_figures/vmw-player/vmw-player-preconf-12.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Remove hard drive
-
-               Figure 12: VMware Workstation Player - Remove hard drive
-
-         #. Click the :guilabel:`Remove` button.
-
-         #. To add a new hard disk and attach the pre-configured |CL| 
-            VMware image, click the :guilabel:`Add` button. See Figure 13.
-
-            .. figure:: /_figures/vmw-player/vmw-player-preconf-13.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Add new hard drive
-
-               Figure 13: VMware Workstation Player - Add new hard drive
-
-         #. Under the :guilabel:`Hardware types` section, select 
-            :guilabel:`Hard Disk`.
-
-         #. Click the :guilabel:`Next` button.
-
-         #. Select your preferred :guilabel:`Virtual disk type`. 
-            See figure 14.
-
-            .. figure:: /_figures/vmw-player/vmw-player-preconf-14.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Select virtual disk type
-
-            Figure 14: VMware Workstation Player - Select virtual disk type
-
-         #. Select the :guilabel:`Use an existing virtual disk` option. 
-            See figure 15.
-
-            .. figure:: /_figures/vmw-player/vmw-player-preconf-15.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Use existing virtual disk
-
-               Figure 15: VMware Workstation Player - Use existing virtual disk
-
-         #. Click the :guilabel:`Browse` button and select the
-            pre-configured |CL| VMware image file. See figure 16.
-
-            .. figure:: ../../_figures/vmw-player/vmw-player-preconf-16.png
-               :scale: 100%
-               :alt: VMware Workstation Player - Select ready-made VMware |CL|
-
-               Figure 16: VMware Workstation Player - Select ready-made VMware |CL| image file
-
-         #. Click the :guilabel:`Finish` button.
-
-            .. note::
-
-               When asked to convert the existing virtual disk to a newer format, selecting either option works.
-
-Install |CL| into the new VM
-****************************
-
-#. Select the newly-created VM and click the :guilabel:`Play virtual machine`
-   button. See Figure below.
-
-   .. figure:: /_figures/vmw-player/vmw-player-17.png
-      :scale: 100%
-      :alt: VMware Workstation Player - Power on virtual machine
-
-      Figure 17: VMware Workstation Player - Power on virtual machine
       
-Install open-vm-tools
+Instantiate |CL| 
-*********************
+****************
 
-Optional: You may want to install the `open-vm-tools` in your virtual
+If you want to install |CL| from scratch, following the instructions
-machine. The Open Virtual Machine Tools (open-vm-tools) are the open source
+in the **Install |CL| using ISO** tab.  Otherwise, follow the 
-implementation of VMware Tools for Linux\* guest operating systems.
+**Use |CL| pre-built VMware image** tab to use our pre-built image.
+ 
+.. tabs::
 
-#. Power on your |CL| virtual machine. On the 
+   .. tab:: Install |CL| using ISO 
-:guilabel:`VMware Workstation Player` home screen, select your VM. 
-See Figure 10.
 
-#. Click :guilabel:`Play virtual machine`.
+      #. Navigate to the |CL| `Downloads`_ page and download either the ``Server``
+         or ``Desktop`` ISO image.  After the download is complete, you will 
+         attach this image.
 
-#. In |CL| you can install the bundle, and enable the tools, in your VM.
+      #. Start the ``VMware Workstation Player`` app.
 
-   .. code-block:: bash
+      #. Select the VM that was created in section `Create a blank VM`_. 
+         See Figure 9.
 
-      sudo swupd bundle-add os-cloudguest-vmware
+      #. Click :guilabel:`Edit virtual machine settings`.
-      sudo systemctl enable --now open-vm-tools
 
-More information is available on the `VMWare Tools Product Documentation`_
+         .. rst-class:: dropshadow
-site.
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-09.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Edit virtual machine settings
+
+            Figure 09: VMware Workstation Player - Edit virtual machine settings
+
+      #. In the :guilabel:`Virtual Machine settings` window, 
+         under :guilabel:`Hardware`, select guilabel:`CD/DVD (IDE)`.
+         See Figure 10.
+
+      #. Under :guilabel:`Connection` at the right, select 
+         :guilabel:`Use ISO image file`. 
+
+      #. Click :guilabel:`Browse` and select the 
+         |CL| installer ISO. 
+            
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-10.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Select |CL| installer ISO
+
+            Figure 10: VMware Workstation Player - Select |CL| installer ISO   
+
+      #. Click :guilabel:`OK` to close the :guilabel:`Virtual Machine settings`
+         window.
+
+      #. Start the VM by clicking :guilabel:`Play virtual machine`.
+
+      #. Follow one of these guides to complete the installation of |CL|. 
+         
+         * *Desktop* version: :ref:`install-clr-desktop-start` 
+         * *Server* version: :ref:`install-clr-server-start` 
+
+      #. Reboot the VM after the installation completes.
+
+      #. Install the ``os-cloudguest-vmware`` bundle, the open source
+         VMware Tools for Linux\* guest operating systems, which enables
+         new features and improves general performance.
+
+         .. code-block:: bash
+
+            sudo swupd bundle-add os-cloudguest-vmware
+            sudo systemctl enable --now open-vm-tools
+
+         More information is available on the `VMWare Tools Product Documentation`_
+         site.
+
+   .. tab:: Use |CL| pre-built VMWare image
+
+      #. Navigate to the |CL| `Downloads`_ page and download the ``VMware`` 
+         image. 
+
+      #. Decompress the downloaded file and move it to the
+         directory where your newly-created VM files reside.
+
+         .. note::
+
+            Depending on the OS, you can typically find the VMware VM
+            files under:
+
+            * Linux distros :file:`/home/username/vmware`
+            * Windows :file:`C:\Users\username\Documents\Virtual Machines`
+
+      #. Start the ``VMware Workstation Player`` app.
+
+      #. Select the VM that was created in section `Create a blank VM`_. 
+         See Figure 9.
+
+      #. Click :guilabel:`Edit virtual machine settings`.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-09.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Edit virtual machine settings
+
+            Figure 9: VMware Workstation Player - Edit virtual machine settings
+
+      #. Under :guilabel:`Hardware` and :guilabel:`Device` list, select 
+         :guilabel:`Hard Disk (SCSI)`. See Figure 11.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-11.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Remove hard drive
+
+            Figure 11: VMware Workstation Player - Remove hard drive
+
+      #. Click the :guilabel:`Remove` button.
+
+      #. To add a new hard disk and attach the pre-built |CL| 
+         VMware image, click the :guilabel:`Add` button. See Figure 12.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-12.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Add new device
+
+            Figure 12: VMware Workstation Player - Add new device
+
+      #. Under the :guilabel:`Hardware types` section, select 
+         :guilabel:`Hard Disk`. See Figure 13.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-13.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Add hard drive
+
+            Figure 13: VMware Workstation Player - Add hard drive
+
+      #. Click the :guilabel:`Next` button.
+
+      #. Select your preferred :guilabel:`Virtual disk type`. 
+         See Figure 14.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-14.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Select virtual disk type
+
+         Figure 14: VMware Workstation Player - Select virtual disk type
+
+      #. Select the :guilabel:`Use an existing virtual disk` option. 
+         See Figure 15.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-15.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Use existing virtual disk
+
+            Figure 15: VMware Workstation Player - Use existing virtual disk
+
+      #. Click the :guilabel:`Browse` button and select the
+         pre-built |CL| VMware image file. See Figure 16.
+
+         .. rst-class:: dropshadow
+
+         .. figure:: ../../_figures/vmw-player/vmw-player-16.png
+            :scale: 100%
+            :alt: VMware Workstation Player - Select pre-built VMware |CL| image file
+
+            Figure 16: VMware Workstation Player - Select pre-built VMware |CL| 
+            image file
+
+      #. Click the :guilabel:`Finish` button.
+
+         .. note::
+
+            When asked to convert the existing virtual disk to a newer format, 
+            selecting either option works.
+
+      #. Click the :guilabel:`OK` button. 
+
+      #. Start the VM by clicking :guilabel:`Play virtual machine`.
+ 
+         .. note::
+
+            If you need to increase the disk size of the pre-built |CL| image, see
+            :ref:`increase-virtual-disk-size`.
 
 Related topics
 **************
@@ -400,6 +415,6 @@ For other guides on using the VMWare Player and ESXi, see:
 .. _VMware Workstation Player Documentation:
    https://docs.vmware.com/en/VMware-Workstation-Player/index.html
 
-.. _downloads: https://clearlinux.org/downloads
+.. _Downloads: https://clearlinux.org/downloads
 
 .. _VMWare Tools Product Documentation: https://docs.vmware.com/en/VMware-Tools/10.1.0/com.vmware.vsphere.vmwaretools.doc/GUID-8B6EA5B7-453B-48AA-92E5-DB7F061341D1.html