Update time.rst

Removed adding the polkit and instead added sudo to the timecatectl set-ntp command.

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

@@ -84,8 +84,6 @@ 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,8 +73,6 @@ 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,19 +1,30 @@
 .. _bootable-usb:
 
-Create a bootable USB drive using BalenaEtcher
-##############################################
+Create a bootable USB drive
+###########################
+
+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
 ====================================
 
@@ -22,90 +33,184 @@ 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.
 
-#. Launch balenaEtcher.
-
-   .. figure:: /_figures/bootable-usb/balenaEtcher_Start.PNG
-      :scale: 100%
-      :alt: BalenaEtcher Start
-         
-      Figure X: BalenaEtcher Start
- 
-#. Press :guilabel:`Select Image`.
+#. Open a terminal window.
 
 #. 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 :guilabel:`Change` under the middel icon.
-    
-   .. note::
-      This shows all USB drives attached to the system.
+#. Identify the USB drive using the :command:`lsblk` command with these options:
+   ``-po NAME,SIZE,TYPE,FSTYPE,PARTLABEL,MOUNTPOINT,VENDOR,MODEL``. This shows all
+   drives attached to the system, including the primary hard disk. In the
+   example output below, there are 3 drives (`/dev/sda`, `/dev/sdb`, and `/dev/sdc`) 
+   attached, where `/dev/sda` is the primary drive and the remaining are USB drives.
 
-   .. figure:: /_figures/bootable-usb/balenaEtcher_DriveSlect.PNG
-      :scale: 100%
-      :alt: 
-         
-      Figure X: 
+   .. code-block:: bash
 
-#. Select the proper drive and press :guilabel:`Continue`.
+      lsblk -po NAME,SIZE,TYPE,FSTYPE,PARTLABEL,MOUNTPOINT,VENDOR,MODEL
 
-   .. figure:: /_figures/bootable-usb/balenaEtcher_ReadyToFlash.PNG
-      :scale: 100%
-      :alt: 
-      
-      Figure X: 
+   Example output:
 
-#. When ready Press the  :guilabel:`Flash!` Button.
+   .. code-block:: console
 
-#. Flashing starting.
-
-   .. figure:: /_figures/bootable-usb/balenaEtcher_StartingToFlash.PNG
-      :scale: 100%
-      :alt: 
-
-      Figure X: 
-
-#. Flashing in progress.
-
-   .. figure:: /_figures/bootable-usb/balenaEtcher_Flashing.PNG
-      :scale: 100%
-      :alt: 
-      
-      Figure X: 
-
-#. Flashing complete.
-
-   .. figure:: /_figures/bootable-usb/balenaEtcher_Done.PNG
-      :scale: 100%
-      :alt: 
-      
-      Figure X: 
+      NAME          SIZE VENDOR   MODEL                    TRAN   TYPE PARTLABEL                    MOUNTPOINT
+      /dev/sda    119.2G ATA      SAMSUNG_MZ7PC128HAFU-000 sata   disk                              
+      ├─/dev/sda1   450M                                          part Basic data partition         
+      ├─/dev/sda2   100M                                          part EFI system partition         
+      ├─/dev/sda3    16M                                          part Microsoft reserved partition 
+      ├─/dev/sda4  97.2G                                          part Basic data partition         
+      ├─/dev/sda5   142M                                          part EFI                          
+      ├─/dev/sda6   245M                                          part linux-swap                   [SWAP]
+      └─/dev/sda7  21.1G                                          part /                            /
+      /dev/sdb      7.5G General  UDisk                    usb    disk                              
+      └─/dev/sdb1   7.5G                                          part Microsoft Basic Data         /run/media/clear/CENA_X64FRE
+      /dev/sdc       15G          Patriot_Memory           usb    disk                              
+      └─/dev/sdc1    15G                                          part                              /run/media/clear/U
 
    .. note::
-      The process can take more than a few minutes. When the process completes, close BalenaEtcher.
-      
 
-Ejecting the |CL| image USB drive
-=================================
+      Some Linux distros may automatically mount a USB drive when it is plugged in.
+
+#. 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 removing the drive could cause
+   Not fully unmounting the USB drive before burning an image could cause
    file system checksum errors in it. If this happens, burn the image again,
-   ensuring all the USB drive partitions are unmounted first befor removing drive.
+   ensuring all the USB drive partitions are unmounted first.
 
+.. _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,9 +3,7 @@
 |CL-ATTR| on VMware\* Workstation Player
 ########################################
 
-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.
+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.
 
 .. contents::
    :local:
@@ -25,9 +23,9 @@ it, see :ref:`vmware-esxi-install-cl`.
 
 .. note::
 
-   The screenshots in this document show the Windows version of the
-   VMware Workstation Player 15.5.1. The menus and prompts are similar to those
-   in other versions and for the Linux version, save some minor wording 
+   The screenshots on this document show the Windows version of the
+   VMware Workstation 15 Player. The menus and prompts are similar to those
+   in other versions and for the Linux OS save some minor wording 
    differences.
 
 Install the VMware Workstation Player hypervisor
@@ -40,38 +38,41 @@ 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's OS:
+   appropriate for your system OS:
 
    * On supported Linux distros:
 
-     a. Ensure your Linux distro is running a GUI desktop.
+     #. Enable 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:
 
-     a. Start the installer.
+     #. Start the installer.
      #. Follow the setup wizard.
 
 For additional help, see the `VMware Workstation Player Documentation`_.
 
-Create a blank VM
-*****************
+Create and configure a new VM
+*****************************
 
 #. Start the ``VMware Workstation Player`` app.
 
 #. On the home screen, click :guilabel:`Create a New Virtual Machine`. See
    Figure 1.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-01.png
+   .. figure:: /_figures/vmw-player/vmw-player-01.png
       :scale: 100%
       :alt: VMware Workstation Player - Create a new virtual machine
 
@@ -80,9 +81,7 @@ Create a blank VM
 
 #. Select :guilabel:`I will install the operating system later`.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-02.png
+   .. figure:: /_figures/vmw-player/vmw-player-02.png
       :scale: 100%
       :alt: I will install the operating system later.
 
@@ -90,13 +89,11 @@ Create a blank VM
 
 #. Click the :guilabel:`Next` button.
 
-#. On the :guilabel:`Select a Guest Operating System` window, set the
+#. On the :guilabel:`Select a Guest Operating System`, set the
    :guilabel:`Guest operating system` setting to :guilabel:`Linux`. See
    Figure 3.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-03.png
+   .. figure:: /_figures/vmw-player/vmw-player-03.png
       :scale: 100%
       :alt: VMware Workstation Player - Select guest operating system type
 
@@ -111,9 +108,7 @@ Create a blank VM
 #. On the :guilabel:`Name the Virtual Machine` screen, name the new VM. See
    Figure 4.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-04.png
+   .. figure:: /_figures/vmw-player/vmw-player-04.png
       :scale: 100%
       :alt: VMware Workstation Player - Name virtual machine
 
@@ -122,12 +117,9 @@ Create a blank VM
 #. Click the :guilabel:`Next` button.
 
 #. On the :guilabel:`Specify Disk Capacity` screen, set the VM's maximum disk
-   size. If you're planning to use a pre-built image, just use the default
-   size for now. See Figure 5.
+   size. See Figure 5.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-05.png
+   .. figure:: /_figures/vmw-player/vmw-player-05.png
       :scale: 100%
       :alt: VMware Workstation Player - Set disk capacity
 
@@ -143,19 +135,15 @@ Create a blank VM
 #. On the :guilabel:`Ready to Create Virtual Machine` screen, click the
    :guilabel:`Customize Hardware...` button. See Figure 6.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-06.png
+   .. 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 a desired value. See Figure 7.
+#. Select :guilabel:`Memory` and set the size to 2GB. See Figure 7.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-07.png
+   .. figure:: /_figures/vmw-player/vmw-player-07.png
       :scale: 100%
       :alt: VMware Workstation Player - Set memory size
 
@@ -163,7 +151,7 @@ Create a blank VM
 
    .. note::
 
-      The |CL| live installer ISO needs a minimum of 1GB of RAM.
+      The |CL| installer ISO needs a minimum of 2GB 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.
@@ -171,9 +159,7 @@ Create a blank VM
 #. Under the :guilabel:`Device` list, select :guilabel:`Processors`. See
    Figure 8.
 
-   .. rst-class:: dropshadow
-
-   .. figure:: ../../_figures/vmw-player/vmw-player-08.png
+   .. figure:: /_figures/vmw-player/vmw-player-08.png
       :scale: 100%
       :alt: VMware Workstation Player - Set virtualization engine option
 
@@ -181,10 +167,10 @@ Create a blank VM
       option
 
 #. Under :guilabel:`Processors` and :guilabel:`Number of processor cores`, 
-   enter the desired number of cores. 
+   enter 4. 
 
 #. Under the :guilabel:`Virtualization engine` section,
-   check the :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI` box.
+   check :guilabel:`Virtualize Intel VT-x/EPT or AMD-V/RVI`.
 
 #. Click the :guilabel:`Close` button.
 
@@ -193,9 +179,17 @@ Create a blank VM
 Enable UEFI boot support
 ************************
 
-|CL| needs UEFI support to boot and work properly. To enable it:
+|CL| needs UEFI support to boot. To enable UEFI:
 
-#. Close the ``VMware Workstation Player`` app.
+#. Power off the VM. click the :guilabel:`Player` menu. See Figure 9.
+
+   .. 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.
 
@@ -207,198 +201,189 @@ 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 Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`
-      
-Instantiate |CL| 
-****************
+      * On Linux distros: :file:`/home/username/vmware`
+      * On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines`
 
-If you want to install |CL| from scratch, following the instructions
-in the **Install |CL| using ISO** tab.  Otherwise, follow the 
-**Use |CL| pre-built VMware image** tab to use our pre-built image.
- 
-.. tabs::
+Download the latest |CL| image
+******************************
 
-   .. tab:: Install |CL| using ISO 
+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`.
 
-      #. 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.
+Attach the appropriate image
+============================
+   
+   .. tabs::
 
-      #. Start the ``VMware Workstation Player`` app.
+      .. tab:: |CL| Desktop 
 
-      #. Select the VM that was created in section `Create a blank VM`_. 
-         See Figure 9.
+         This option provides a live-desktop iso installer. 
 
-      #. Click :guilabel:`Edit virtual machine settings`.
+         #. Navigate to the `downloads`_ page and download the |CL| Desktop.
+            After the download is complete, you will attach this image.
 
-         .. rst-class:: dropshadow
+         #. On the :guilabel:`VMware Workstation 15 Player`, right-click the 
+            new VM, created in `Create and configure a new VM`_. 
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-09.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Edit virtual machine settings
+         #. From the pop-up menu, select :guilabel:`Settings`. 
 
-            Figure 09: VMware Workstation Player - Edit virtual machine settings
+         #. From :guilabel:`Virtual Machine settings`, 
+            under :guilabel:`Hardware`, select ``CD/DVD``.
 
-      #. In the :guilabel:`Virtual Machine settings` window, 
-         under :guilabel:`Hardware`, select guilabel:`CD/DVD (IDE)`.
-         See Figure 10.
+         #. Under :guilabel:`Connection` at right, select 
+            :guilabel:`Use ISO image file`. 
 
-      #. Under :guilabel:`Connection` at the right, select 
-         :guilabel:`Use ISO image file`. 
-
-      #. Click :guilabel:`Browse` and select the 
-         |CL| installer ISO. 
+         #. Click :guilabel:`Browse` and select the decompressed 
+            |CL| installer ISO. See Figure 10.
             
-         .. rst-class:: dropshadow
+            .. figure:: /_figures/vmw-player/vmw-player-10.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Select |CL| installer ISO
 
-         .. 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   
 
-            Figure 10: VMware Workstation Player - Select |CL| installer ISO   
+         #. Follow the guide :ref:`install-on-target-start` to complete the
+            installation of |CL|.
 
-      #. Click :guilabel:`OK` to close the :guilabel:`Virtual Machine settings`
-         window.
+         #. After the installation completes, reboot the VM. This reboot
+            restarts the |CL| installer.
 
-      #. Start the VM by clicking :guilabel:`Play virtual machine`.
+         #. To enable the mouse pointer so you access VMware Workstation
+            Player's menus, press :kbd:`<CTRL>` + :kbd:`<ALT>` on the keyboard.
 
-      #. 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` 
+         #. To disconnect the CD/DVD to stop it from booting the |CL|
+            installer ISO again, click the :guilabel:`Player` menu. See
+            Figure below.
 
-      #. Reboot the VM after the installation completes.
+            .. figure:: /_figures/vmw-player/vmw-player-11.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Edit CD/DVD settings
 
-      #. Install the ``os-cloudguest-vmware`` bundle, the open source
-         VMware Tools for Linux\* guest operating systems, which enables
-         new features and improves general performance.
+               Figure 11: VMware Workstation Player - Edit CD/DVD settings
 
-         .. code-block:: bash
+         #. Go to :menuselection:`Removable Devices-->CD/DVD 
+            (IDE)-->Disconnect`.
 
-            sudo swupd bundle-add os-cloudguest-vmware
-            sudo systemctl enable --now open-vm-tools
+         #. Click the :guilabel:`OK` button.
 
-         More information is available on the `VMWare Tools Product Documentation`_
-         site.
+         #. Continue below. 
 
-   .. tab:: Use |CL| pre-built VMWare image
+      .. tab:: |CL| Pre-configured VMWare image
 
-      #. Navigate to the |CL| `Downloads`_ page and download the ``VMware`` 
-         image. 
+         #. Navigate to the `downloads`_ page and select the ``VMware`` 
+            image. Look for :file:`clear-[version number]-vmware.vmdk.xz`. 
 
-      #. Decompress the downloaded file and move it to the
-         directory where your newly-created VM files reside.
+         #. 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::
+            .. note::
 
-            Depending on the OS, you can typically find the VMware VM
-            files under:
+               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`
+               * Linux distros :file:`/home/username/vmware`
+               * Windows :file:`C:\Users\username\Documents\Virtual Machines`
 
-      #. Start the ``VMware Workstation Player`` app.
+         #. On the :guilabel:`VMware Workstation 15 Player`, right-click the 
+            new VM, created in `Create and configure a new VM`_. 
 
-      #. Select the VM that was created in section `Create a blank VM`_. 
-         See Figure 9.
+         #. From the pop-up menu, select :guilabel:`Settings`. 
 
-      #. Click :guilabel:`Edit virtual machine settings`.
+         #. Under :guilabel:`Hardware` and :guilabel:`Device` list, select 
+            :guilabel:`Hard Disk (SCSI)`. See figure 12.
 
-         .. rst-class:: dropshadow
+            .. figure:: /_figures/vmw-player/vmw-player-preconf-12.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Remove hard drive
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-09.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Edit virtual machine settings
+               Figure 12: VMware Workstation Player - Remove hard drive
 
-            Figure 9: VMware Workstation Player - Edit virtual machine settings
+         #. Click the :guilabel:`Remove` button.
 
-      #. Under :guilabel:`Hardware` and :guilabel:`Device` list, select 
-         :guilabel:`Hard Disk (SCSI)`. See Figure 11.
+         #. To add a new hard disk and attach the pre-configured |CL| 
+            VMware image, click the :guilabel:`Add` button. See Figure 13.
 
-         .. rst-class:: dropshadow
+            .. figure:: /_figures/vmw-player/vmw-player-preconf-13.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Add new hard drive
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-11.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Remove hard drive
+               Figure 13: VMware Workstation Player - Add new hard drive
 
-            Figure 11: VMware Workstation Player - Remove hard drive
+         #. Under the :guilabel:`Hardware types` section, select 
+            :guilabel:`Hard Disk`.
 
-      #. Click the :guilabel:`Remove` button.
+         #. Click the :guilabel:`Next` button.
 
-      #. To add a new hard disk and attach the pre-built |CL| 
-         VMware image, click the :guilabel:`Add` button. See Figure 12.
+         #. Select your preferred :guilabel:`Virtual disk type`. 
+            See figure 14.
 
-         .. rst-class:: dropshadow
+            .. figure:: /_figures/vmw-player/vmw-player-preconf-14.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Select virtual disk type
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-12.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Add new device
+            Figure 14: VMware Workstation Player - Select virtual disk type
 
-            Figure 12: VMware Workstation Player - Add new device
+         #. Select the :guilabel:`Use an existing virtual disk` option. 
+            See figure 15.
 
-      #. Under the :guilabel:`Hardware types` section, select 
-         :guilabel:`Hard Disk`. See Figure 13.
+            .. figure:: /_figures/vmw-player/vmw-player-preconf-15.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Use existing virtual disk
 
-         .. rst-class:: dropshadow
+               Figure 15: VMware Workstation Player - Use existing virtual disk
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-13.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Add hard drive
+         #. Click the :guilabel:`Browse` button and select the
+            pre-configured |CL| VMware image file. See figure 16.
 
-            Figure 13: VMware Workstation Player - Add hard drive
+            .. figure:: ../../_figures/vmw-player/vmw-player-preconf-16.png
+               :scale: 100%
+               :alt: VMware Workstation Player - Select ready-made VMware |CL|
 
-      #. Click the :guilabel:`Next` button.
+               Figure 16: VMware Workstation Player - Select ready-made VMware |CL| image file
 
-      #. Select your preferred :guilabel:`Virtual disk type`. 
-         See Figure 14.
+         #. Click the :guilabel:`Finish` button.
 
-         .. rst-class:: dropshadow
+            .. note::
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-14.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Select virtual disk type
+               When asked to convert the existing virtual disk to a newer format, selecting either option works.
 
-         Figure 14: VMware Workstation Player - Select virtual disk type
+Install |CL| into the new VM
+****************************
 
-      #. Select the :guilabel:`Use an existing virtual disk` option. 
-         See Figure 15.
+#. Select the newly-created VM and click the :guilabel:`Play virtual machine`
+   button. See Figure below.
 
-         .. rst-class:: dropshadow
+   .. figure:: /_figures/vmw-player/vmw-player-17.png
+      :scale: 100%
+      :alt: VMware Workstation Player - Power on virtual machine
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-15.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Use existing virtual disk
+      Figure 17: VMware Workstation Player - Power on virtual machine
+      
+Install open-vm-tools
+*********************
 
-            Figure 15: VMware Workstation Player - Use existing virtual disk
+Optional: You may want to install the `open-vm-tools` in your virtual
+machine. The Open Virtual Machine Tools (open-vm-tools) are the open source
+implementation of VMware Tools for Linux\* guest operating systems.
 
-      #. Click the :guilabel:`Browse` button and select the
-         pre-built |CL| VMware image file. See Figure 16.
+#. Power on your |CL| virtual machine. On the 
+:guilabel:`VMware Workstation Player` home screen, select your VM. 
+See Figure 10.
 
-         .. rst-class:: dropshadow
+#. Click :guilabel:`Play virtual machine`.
 
-         .. figure:: ../../_figures/vmw-player/vmw-player-16.png
-            :scale: 100%
-            :alt: VMware Workstation Player - Select pre-built VMware |CL| image file
+#. In |CL| you can install the bundle, and enable the tools, in your VM.
 
-            Figure 16: VMware Workstation Player - Select pre-built VMware |CL| 
-            image file
+   .. code-block:: bash
 
-      #. Click the :guilabel:`Finish` button.
+      sudo swupd bundle-add os-cloudguest-vmware
+      sudo systemctl enable --now open-vm-tools
 
-         .. 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`.
+More information is available on the `VMWare Tools Product Documentation`_
+site.
 
 Related topics
 **************
@@ -415,6 +400,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

source/guides/network/time.rst

@@ -45,7 +45,7 @@ the default :abbr:`NTP (Network Time Protocol)` servers cannot be reached.
 
    .. code-block:: bash
 
-      timedatectl set-ntp true
+      sudo timedatectl set-ntp true
 
 .. note::