diff --git a/source/_figures/vmw-player/vmw-player-01.png b/source/_figures/vmw-player/vmw-player-01.png index 23ba879a..ece95983 100644 Binary files a/source/_figures/vmw-player/vmw-player-01.png and b/source/_figures/vmw-player/vmw-player-01.png differ diff --git a/source/_figures/vmw-player/vmw-player-01.png.original b/source/_figures/vmw-player/vmw-player-01.png.original new file mode 100755 index 00000000..91abf770 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-01.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-02.png b/source/_figures/vmw-player/vmw-player-02.png index 06132d4b..3498a786 100644 Binary files a/source/_figures/vmw-player/vmw-player-02.png and b/source/_figures/vmw-player/vmw-player-02.png differ diff --git a/source/_figures/vmw-player/vmw-player-02.png.original b/source/_figures/vmw-player/vmw-player-02.png.original new file mode 100755 index 00000000..b2b3c90d Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-02.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-03.png b/source/_figures/vmw-player/vmw-player-03.png index e037b30e..6d5cdcb4 100644 Binary files a/source/_figures/vmw-player/vmw-player-03.png and b/source/_figures/vmw-player/vmw-player-03.png differ diff --git a/source/_figures/vmw-player/vmw-player-03.png.original b/source/_figures/vmw-player/vmw-player-03.png.original new file mode 100755 index 00000000..b0d1759b Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-03.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-04.png b/source/_figures/vmw-player/vmw-player-04.png index ea4d9f69..719ee1b3 100644 Binary files a/source/_figures/vmw-player/vmw-player-04.png and b/source/_figures/vmw-player/vmw-player-04.png differ diff --git a/source/_figures/vmw-player/vmw-player-04.png.original b/source/_figures/vmw-player/vmw-player-04.png.original new file mode 100755 index 00000000..fee537cb Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-04.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-05.png b/source/_figures/vmw-player/vmw-player-05.png index 27147973..f9a867e2 100644 Binary files a/source/_figures/vmw-player/vmw-player-05.png and b/source/_figures/vmw-player/vmw-player-05.png differ diff --git a/source/_figures/vmw-player/vmw-player-05.png.original b/source/_figures/vmw-player/vmw-player-05.png.original new file mode 100755 index 00000000..fd3141f2 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-05.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-06.png b/source/_figures/vmw-player/vmw-player-06.png index d8157359..b40b499c 100644 Binary files a/source/_figures/vmw-player/vmw-player-06.png and b/source/_figures/vmw-player/vmw-player-06.png differ diff --git a/source/_figures/vmw-player/vmw-player-06.png.original b/source/_figures/vmw-player/vmw-player-06.png.original new file mode 100755 index 00000000..524429ec Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-06.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-07.png b/source/_figures/vmw-player/vmw-player-07.png index 89686569..0c78ae36 100644 Binary files a/source/_figures/vmw-player/vmw-player-07.png and b/source/_figures/vmw-player/vmw-player-07.png differ diff --git a/source/_figures/vmw-player/vmw-player-07.png.original b/source/_figures/vmw-player/vmw-player-07.png.original new file mode 100755 index 00000000..a840144e Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-07.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-08.png b/source/_figures/vmw-player/vmw-player-08.png index 891e3366..f6842c11 100644 Binary files a/source/_figures/vmw-player/vmw-player-08.png and b/source/_figures/vmw-player/vmw-player-08.png differ diff --git a/source/_figures/vmw-player/vmw-player-08.png.original b/source/_figures/vmw-player/vmw-player-08.png.original new file mode 100755 index 00000000..53ca3644 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-08.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-09.png b/source/_figures/vmw-player/vmw-player-09.png old mode 100644 new mode 100755 index 1eba9c88..9ef2d938 Binary files a/source/_figures/vmw-player/vmw-player-09.png and b/source/_figures/vmw-player/vmw-player-09.png differ diff --git a/source/_figures/vmw-player/vmw-player-09.png.original b/source/_figures/vmw-player/vmw-player-09.png.original new file mode 100755 index 00000000..01a389f6 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-09.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-10.png b/source/_figures/vmw-player/vmw-player-10.png index 4eeee082..3b7f6b65 100644 Binary files a/source/_figures/vmw-player/vmw-player-10.png and b/source/_figures/vmw-player/vmw-player-10.png differ diff --git a/source/_figures/vmw-player/vmw-player-10.png.original b/source/_figures/vmw-player/vmw-player-10.png.original new file mode 100755 index 00000000..669dc47b Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-10.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-11.png b/source/_figures/vmw-player/vmw-player-11.png index 4f6687c7..e4281ace 100644 Binary files a/source/_figures/vmw-player/vmw-player-11.png and b/source/_figures/vmw-player/vmw-player-11.png differ diff --git a/source/_figures/vmw-player/vmw-player-11.png.original b/source/_figures/vmw-player/vmw-player-11.png.original new file mode 100755 index 00000000..387867df Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-11.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-12.png b/source/_figures/vmw-player/vmw-player-12.png new file mode 100755 index 00000000..08744dc5 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-12.png differ diff --git a/source/_figures/vmw-player/vmw-player-12.png.original b/source/_figures/vmw-player/vmw-player-12.png.original new file mode 100755 index 00000000..8948c5d9 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-12.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-13.png b/source/_figures/vmw-player/vmw-player-13.png new file mode 100755 index 00000000..f09ccedd Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-13.png differ diff --git a/source/_figures/vmw-player/vmw-player-13.png.original b/source/_figures/vmw-player/vmw-player-13.png.original new file mode 100755 index 00000000..f5587e7f Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-13.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-14.png b/source/_figures/vmw-player/vmw-player-14.png new file mode 100755 index 00000000..6daf0f80 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-14.png differ diff --git a/source/_figures/vmw-player/vmw-player-14.png.original b/source/_figures/vmw-player/vmw-player-14.png.original new file mode 100755 index 00000000..2a084eb0 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-14.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-15.png b/source/_figures/vmw-player/vmw-player-15.png new file mode 100755 index 00000000..339e70ad Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-15.png differ diff --git a/source/_figures/vmw-player/vmw-player-15.png.original b/source/_figures/vmw-player/vmw-player-15.png.original new file mode 100755 index 00000000..76c271e4 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-15.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-16.png b/source/_figures/vmw-player/vmw-player-16.png new file mode 100755 index 00000000..6b983f01 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-16.png differ diff --git a/source/_figures/vmw-player/vmw-player-16.png.original b/source/_figures/vmw-player/vmw-player-16.png.original new file mode 100755 index 00000000..103e6b69 Binary files /dev/null and b/source/_figures/vmw-player/vmw-player-16.png.original differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-01.png b/source/_figures/vmw-player/vmw-player-preconf-01.png deleted file mode 100644 index 69b6a24e..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-01.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-02.png b/source/_figures/vmw-player/vmw-player-preconf-02.png deleted file mode 100644 index d24c0612..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-02.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-03.png b/source/_figures/vmw-player/vmw-player-preconf-03.png deleted file mode 100644 index 2fbe4cea..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-03.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-04.png b/source/_figures/vmw-player/vmw-player-preconf-04.png deleted file mode 100644 index 6a01685f..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-04.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-05.png b/source/_figures/vmw-player/vmw-player-preconf-05.png deleted file mode 100644 index 22f40dfc..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-05.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-06.png b/source/_figures/vmw-player/vmw-player-preconf-06.png deleted file mode 100644 index eeb4b36e..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-06.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-07.png b/source/_figures/vmw-player/vmw-player-preconf-07.png deleted file mode 100644 index 4f46b24e..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-07.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-08.png b/source/_figures/vmw-player/vmw-player-preconf-08.png deleted file mode 100644 index d86378bb..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-08.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-09.png b/source/_figures/vmw-player/vmw-player-preconf-09.png deleted file mode 100644 index 416fb206..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-09.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-12.png b/source/_figures/vmw-player/vmw-player-preconf-12.png deleted file mode 100644 index 3efc71e4..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-12.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-13.png b/source/_figures/vmw-player/vmw-player-preconf-13.png deleted file mode 100644 index 8cd9d0a9..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-13.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-14.png b/source/_figures/vmw-player/vmw-player-preconf-14.png deleted file mode 100644 index 36f43d3e..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-14.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-15.png b/source/_figures/vmw-player/vmw-player-preconf-15.png deleted file mode 100644 index 30f77a88..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-15.png and /dev/null differ diff --git a/source/_figures/vmw-player/vmw-player-preconf-16.png b/source/_figures/vmw-player/vmw-player-preconf-16.png deleted file mode 100644 index e115111e..00000000 Binary files a/source/_figures/vmw-player/vmw-player-preconf-16.png and /dev/null differ diff --git a/source/get-started/bare-metal-install-desktop.rst b/source/get-started/bare-metal-install-desktop.rst index 58033762..7cab985d 100644 --- a/source/get-started/bare-metal-install-desktop.rst +++ b/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 ========================= diff --git a/source/get-started/bare-metal-install-server.rst b/source/get-started/bare-metal-install-server.rst index 5ab1a9c1..8e732138 100644 --- a/source/get-started/bare-metal-install-server.rst +++ b/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 ************************* diff --git a/source/get-started/virtual-machine-install/vmw-player.rst b/source/get-started/virtual-machine-install/vmw-player.rst index 9cb76883..be88cf45 100644 --- a/source/get-started/virtual-machine-install/vmw-player.rst +++ b/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 - VMware Workstation 15 Player. The menus and prompts are similar to those - in other versions and for the Linux OS save some minor wording + 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 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-.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. - - .. 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`. +#. Close the ``VMware Workstation Player`` app. #. 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 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:`` + :kbd:`` 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 + * On Linux distros: :file:`/home/username/vmware` + * On Windows: :file:`C:\\Users\\username\\Documents\\Virtual Machines` -Install open-vm-tools -********************* +Instantiate |CL| +**************** -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. +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:: -#. Power on your |CL| virtual machine. On the -:guilabel:`VMware Workstation Player` home screen, select your VM. -See Figure 10. + .. tab:: Install |CL| using ISO -#. 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 - sudo systemctl enable --now open-vm-tools + #. Click :guilabel:`Edit virtual machine settings`. -More information is available on the `VMWare Tools Product Documentation`_ -site. + .. rst-class:: dropshadow + + .. 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