From be55e1bcf569beae0a3bb85edb0ed0a70712e1b0 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:32:44 -0700 Subject: [PATCH 1/6] Add reference back to VMware player install. --- .../vmware-esxi-preconfigured-cl-image.rst | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 92dcf185..75b67d8f 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -5,7 +5,7 @@ Run preconfigured Clear Linux image as a VMware\* ESXi guest OS `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top of server hardware. With VMware ESXi, you can create, configure, manage, -and run |CLOSIA| virtual machines in the cloud. +and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5 Update 1 using these steps: @@ -18,14 +18,18 @@ VMware ESXi 6.5 Update 1 using these steps: #. Create and configure a new VM. #. Power on the VM and boot |CL|. -If you would prefer to perform a fresh installation of |CL| into a new VMware +If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. +Visit :ref:`image-types` to learn more about the available images. + + .. note:: VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. + -Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** From f014bc5c0112102e6290d74a54738bd7ac45c1b3 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 11:47:22 -0700 Subject: [PATCH 2/6] Change to ToC directive with page anchors --- .../vmware-esxi-preconfigured-cl-image.rst | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 75b67d8f..b149e4fd 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -8,19 +8,10 @@ of server hardware. With VMware ESXi, you can create, configure, manage, and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on -VMware ESXi 6.5 Update 1 using these steps: - -#. Download the latest Clear Linux VMware image. -#. Verify the integrity of the |CL| image. -#. Uncompress the |CL| image. -#. Upload the Clear Linux image to the VMware server. -#. Convert the Clear Linux image to an ESXi-supported format. -#. Create and configure a new VM. -#. Power on the VM and boot |CL|. +VMware ESXi 6.5. If you would prefer to perform a manual installation of |CL| into a new VMware ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. - Visit :ref:`image-types` to learn more about the available images. @@ -30,6 +21,9 @@ Visit :ref:`image-types` to learn more about the available images. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. +.. contents:: + :depth: 2 + Download the latest Clear Linux VMware image ******************************************** @@ -243,7 +237,7 @@ After configuring the settings above, power on the VM. Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: -********* +--------- * :ref:`vmware-esxi-install-cl` From 371b823e2ebb1c4856e582252e524a69daa93996 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:06:52 -0700 Subject: [PATCH 3/6] Recommend using vMA and add VMware doc references vMA is the official recommendation from VMware for running vmkfstools. --- .../vmware-esxi-preconfigured-cl-image.rst | 42 +++++++++++++++---- 1 file changed, 35 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index b149e4fd..5e8fcbf0 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -28,7 +28,7 @@ Visit :ref:`image-types` to learn more about the available images. Download the latest Clear Linux VMware image ******************************************** -Get the latest |CL| VMware image from the `image`_ repository. +Get the latest |CL| VMware prebuilt image from the `image`_ repository. Look for :file:`clear-[version number]-vmware.vmdk.xz`. You can also use this command: @@ -48,10 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -#. Connect to the VMware server and login to an account with sufficient +Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, +it must be uploaded to a datastore on the VMware ESXi server. + +The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ + +#. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Storage`. - See Figure 1. + +#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. + See Figure 1 + #. Under the :guilabel:`Datastores` tab, click the :guilabel:`Datastore browser` button. @@ -85,14 +92,28 @@ Upload the Clear Linux image to the VMware server Convert the Clear Linux image to an ESXi-supported format ********************************************************* -#. SSH into the VMware server and login to an account with root privileges. -#. Locate the uploaded image, which is typically found in `/vmfs/volumes/datastore1`. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, +it must be converted to a format for usable with VMware's ESXi hypervisor. + +The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ + +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. + + .. note:: + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . + + As a security best practice, remember to disable SSH access after following the steps in this section. + + +#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. + #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: .. code-block:: console - # vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk Two files should result from this: @@ -102,6 +123,8 @@ Convert the Clear Linux image to an ESXi-supported format The :file:`clear-[version number]-esxi.vmdk` file will be used in the next section when you create a new VM. + + Create and configure a new VM ***************************** @@ -242,5 +265,10 @@ Also see: * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html +.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 +.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image From fcc3d3095cc2b26583245189d8950016b3c9a690 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Mon, 25 Jun 2018 14:08:51 -0700 Subject: [PATCH 4/6] Fix broken link reference --- .../vmware-esxi-preconfigured-cl-image.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5e8fcbf0..82c4edf4 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -266,7 +266,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant appliance`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From 5d3058169266c8ed018a15b3f8c3ce6381a87b36 Mon Sep 17 00:00:00 2001 From: puneetse <22071208+puneetse@users.noreply.github.com> Date: Tue, 26 Jun 2018 11:47:00 -0700 Subject: [PATCH 5/6] Add vCLI option to connect vMA is being deprecated --- .../vmware-esxi-preconfigured-cl-image.rst | 20 ++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 82c4edf4..5f60534e 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -48,15 +48,17 @@ For alternative instructions on other operating systems, see: Upload the Clear Linux image to the VMware server ************************************************* -Once the |CL| VMware prebuilt image has been downloaded and uncompressed on your local system, -it must be uploaded to a datastore on the VMware ESXi server. +Once the |CL| VMware prebuilt image has been downloaded and +uncompressed on your local system, it must be uploaded to a datastore +on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ #. Connect to the VMware ESXi server and login to an account with sufficient permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, select :guilabel:`Storage`. +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. See Figure 1 #. Under the :guilabel:`Datastores` tab, click @@ -97,16 +99,18 @@ it must be converted to a format for usable with VMware's ESXi hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance configured and available, you can temporarily enable SSH directly on the ESXi host by referencing + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing the `VMware documentation on Enable the Secure Shell (SSH)`_ . As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. #. Use the :command:`vmkfstools` command to perform the conversion, as shown below: @@ -132,7 +136,8 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. #. In the right window, click the :guilabel:`Create / Register VM` button. @@ -267,6 +272,7 @@ Also see: .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html .. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html .. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ +.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ .. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 .. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html .. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html From d1542099f307753a8a2b1223cc79460c94ff0efb Mon Sep 17 00:00:00 2001 From: Michael Vincerra Date: Tue, 26 Jun 2018 17:25:33 -0700 Subject: [PATCH 6/6] Corrects syntax for: - Figures and labels - Internal TOC - External references to URLs - Relative paths to files Signed-off-by: Michael Vincerra --- .../vmware-esxi-preconfigured-cl-image.rst | 268 +++++++++--------- 1 file changed, 138 insertions(+), 130 deletions(-) diff --git a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst index 5f60534e..23751b7d 100644 --- a/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst +++ b/source/clear-linux/get-started/virtual-machine-install/vmware-esxi-preconfigured-cl-image.rst @@ -1,6 +1,6 @@ .. _vmware-esxi-preconfigured-cl-image: -Run preconfigured Clear Linux image as a VMware\* ESXi guest OS +Run preconfigured Clear Linux\* image as a VMware\* ESXi guest OS ############################################################### `VMware ESXi`_ is a type 1 bare-metal hypervisor which runs directly on top @@ -10,21 +10,20 @@ and run |CLOSIA| virtual machines at scale. This section shows you how to deploy a preconfigured |CL| VMware image on VMware ESXi 6.5. -If you would prefer to perform a manual installation of |CL| into a new VMware -ESXi :abbr:`VM (Virtual Machine)` instead, see :ref:`vmware-esxi-install-cl`. -Visit :ref:`image-types` to learn more about the available images. - +If you would prefer to perform a manual installation of |CL| into a new +VMware ESXi :abbr:`VM (Virtual Machine)` instead, see +:ref:`vmware-esxi-install-cl`. Visit :ref:`image-types` to learn more about +the available images. .. note:: - VMware also offers a type 2 hypervisor called `VMware Workstation Player`_ which is designed for the desktop environment. + VMware also offers a type 2 hypervisor called `VMware Workstation Player` + which is designed for the desktop environment. See :ref:`vmw-player-preconf` or see :ref:`vmw-player`. - -.. contents:: +.. contents:: :local: :depth: 2 - Download the latest Clear Linux VMware image ******************************************** @@ -54,80 +53,81 @@ on the VMware ESXi server. The steps in this section can also be referenced from the `VMware documentation on Using the Datastore File Browser`_ -#. Connect to the VMware ESXi server and login to an account with sufficient - permission to create and manage VMs. +#. Connect to the VMware ESXi server and login to an account with sufficient + permission to create and manage VMs. -#. Under the :guilabel:`Navigator` window on the left side, - select :guilabel:`Storage`. - See Figure 1 +#. Under the :guilabel:`Navigator` window on the left side, + select :guilabel:`Storage`. + See Figure 1 -#. Under the :guilabel:`Datastores` tab, click - the :guilabel:`Datastore browser` button. +#. Under the :guilabel:`Datastores` tab, click + the :guilabel:`Datastore browser` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-1.png :scale: 100 % :alt: VMware ESXi - Navigator > Storage Figure 1: VMware ESXi - Navigator > Storage -#. Click the :guilabel:`Create directory` button and name the directory - `Clear Linux VM`. See Figure 2. +#. Click the :guilabel:`Create directory` button and name the directory + `Clear Linux VM`. See Figure 2. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-2.png :scale: 100 % :alt: VMware ESXi - Datastore > Create directory Figure 2: VMware ESXi - Datastore > Create directory -#. Select the newly-created directory and click the :guilabel:`Upload` - button. See Figure 3. +#. Select the newly-created directory and click the :guilabel:`Upload` + button. See Figure 3. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-3.png :scale: 100 % :alt: VMware ESXi - Datastore > Upload VMware image Figure 3: VMware ESXi - Datastore > Upload VMware image -#. Select the uncompressed |CL| VMware image file - :file:`clear-[version number]-vmware.vmdk` and upload it. +#. Select the uncompressed |CL| VMware image file + :file:`clear-[version number]-vmware.vmdk` and upload it. Convert the Clear Linux image to an ESXi-supported format ********************************************************* -Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi datastore, -it must be converted to a format for usable with VMware's ESXi hypervisor. +Once the |CL| VMware prebuilt image has been uploaded to the VMware ESXi +datastore, it must be converted to a format for usable with VMware's ESXi +hypervisor. The steps in this section can also be referenced from the `VMware documentation on Cloning and converting virtual machine disks with vmkfstools`_ -#. SSH into the `vSphere Management Assistant`_ appliance that is managing the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. +#. SSH into the `vSphere Management Assistant`_ appliance that is managing + the ESXi host or connect to the vSphere hosting using the `vSphere CLI`_. - .. note:: - If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, - you can temporarily enable SSH directly on the ESXi host by referencing - the `VMware documentation on Enable the Secure Shell (SSH)`_ . + .. note:: + + If there is no :abbr:`vMA (vSphere Management Assistant)` appliance or :abbr:`vCLI (vSphere CLI)` configured and available, + you can temporarily enable SSH directly on the ESXi host by referencing + the `VMware documentation on Enable the Secure Shell (SSH)`_ . - As a security best practice, remember to disable SSH access after following the steps in this section. + As a security best practice, remember to disable SSH access after following the steps in this section. -#. Locate the uploaded image, which is typically found in - :file:`/vmfs/volumes/datastore1`. +#. Locate the uploaded image, which is typically found in + :file:`/vmfs/volumes/datastore1`. -#. Use the :command:`vmkfstools` command to perform the conversion, as - shown below: +#. Use the :command:`vmkfstools` command to perform the conversion, as + shown below: - .. code-block:: console + .. code-block:: console - vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk + vmkfstools -i clear-[version number]-vmware.vmdk -d zeroedthick clear-[version number]-esxi.vmdk - Two files should result from this: - - * :file:`clear-[version number]-esxi-flat.vmdk` - * :file:`clear-[version number]-esxi.vmdk` - - The :file:`clear-[version number]-esxi.vmdk` file will be used in the - next section when you create a new VM. + Two files should result from this: + * :file:`clear-[version number]-esxi-flat.vmdk` + * :file:`clear-[version number]-esxi.vmdk` + The :file:`clear-[version number]-esxi.vmdk` file will be used in the + next section when you create a new VM. Create and configure a new VM ***************************** @@ -136,145 +136,153 @@ In this section, you will create a new VM, configure its basic parameters such as number of CPUs, memory size, and then attach the converted |CL| VMware image. Also, in order to boot |CL|, you must enable UEFI support. -#. Under the :guilabel:`Navigator` window, select - :guilabel:`Virtual Machines`. See Figure 4. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 4. -#. In the right window, click the :guilabel:`Create / Register VM` button. +#. In the right window, click the :guilabel:`Create / Register VM` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-4.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines Figure 4: VMware ESXi - Navigator > Virtual Machines -#. On the :guilabel:`Select creation type` step: +#. On the :guilabel:`Select creation type` step: - #. Select the :guilabel:`Create a new virtual machine` option. See - Figure 5. + #. Select the :guilabel:`Create a new virtual machine` option. See + Figure 5. - #. Click the :guilabel:`Next` button. + #. Click the :guilabel:`Next` button. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png - :scale: 100 % - :alt: VMware ESXi - Create a new virtual machine + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-5.png + :scale: 100 % + :alt: VMware ESXi - Create a new virtual machine - Figure 5: VMware ESXi - Create a new virtual machine + Figure 5: VMware ESXi - Create a new virtual machine -#. On the :guilabel:`Select a name and guest OS` step: +#. On the :guilabel:`Select a name and guest OS` step: - #. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - #. Set the :guilabel:`Compatability` option to :guilabel:`ESXi 6.5 virtual machine`. - #. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. - #. Set the :guilabel:`Guest OS version` option to :guilabel:`Other 3.x or later Linux (64-bit)`. - #. Click the :guilabel:`Next` button. +#. Give the new VM a name in the :guilabel:`Name` field. See Figure 6. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png - :scale: 100 % - :alt: VMware ESXi - Give a name and select guest OS type +#. Set the :guilabel:`Compatability` option to + :guilabel:`ESXi 6.5 virtual machine`. +#. Set the :guilabel:`Guest OS family` option to :guilabel:`Linux`. +#. Set the :guilabel:`Guest OS version` option to + :guilabel:`Other 3.x or later Linux (64-bit)`. +#. Click the :guilabel:`Next` button. - Figure 6: VMware ESXi - Give a name and select guest OS type + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-6.png + :scale: 100 % + :alt: VMware ESXi - Give a name and select guest OS type -#. On the :guilabel:`Select storage` step: + Figure 6: VMware ESXi - Give a name and select guest OS type - #. Accept the default option. - #. Click the :guilabel:`Next` button. +#. On the :guilabel:`Select storage` step: -#. On the :guilabel:`Customize settings` step: + #. Accept the default option. + #. Click the :guilabel:`Next` button. - #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. - #. Expand the :guilabel:`CPU` setting and enable :guilabel:`Hardware virtualization` by - checking :guilabel:`Expose hardware assisted virtualization to the guest OS`. +#. On the :guilabel:`Customize settings` step: - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png - :scale: 100 % - :alt: VMware ESXi - Enable hardware virtualization + #. Click the :guilabel:`Virtual Hardware` button. See Figure 7. + #. Expand the :guilabel:`CPU` setting and enable + :guilabel:`Hardware virtualization` by checking + :guilabel:`Expose hardware assisted virtualization to the guest OS`. - Figure 7: VMware ESXi - Enable hardware virtualization + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-7.png + :scale: 100 % + :alt: VMware ESXi - Enable hardware virtualization - #. Remove the default :guilabel:`Hard drive 1` setting by clicking - the `X` icon on the right side. See Figure 8. + Figure 7: VMware ESXi - Enable hardware virtualization - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png - :scale: 100 % - :alt: VMware ESXi - Remove hard drive + #. Remove the default :guilabel:`Hard drive 1` setting by clicking + the `X` icon on the right side. See Figure 8. - Figure 8: VMware ESXi - Remove hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-8.png + :scale: 100 % + :alt: VMware ESXi - Remove hard drive - #. Since a preconfigured image will be used, - the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it by unchecking the :guilabel:`Connect` checkbox. See Figure 9. + Figure 8: VMware ESXi - Remove hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png - :scale: 100 % - :alt: VMware ESXi - Disconnect the CD/DVD drive + #. Since a preconfigured image will be used, + the :guilabel:`CD/DVD Drive 1` setting will not be needed. Disable it + by unchecking the :guilabel:`Connect` checkbox. See Figure 9. - Figure 9: VMware ESXi - Disconnect the CD/DVD drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-9.png + :scale: 100 % + :alt: VMware ESXi - Disconnect the CD/DVD drive - #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was - converted from the preconfigured |CL| VMware image. + Figure 9: VMware ESXi - Disconnect the CD/DVD drive - #. Click the :guilabel:`Add hard disk` button and select the - :guilabel:`Existing hard drive` option. See Figure 10. + #. Attach the :file:`clear-[version number]-esxi.vmdk` file that was + converted from the preconfigured |CL| VMware image. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png - :scale: 100 % - :alt: VMware ESXi - Add an existing hard drive + #. Click the :guilabel:`Add hard disk` button and select the + :guilabel:`Existing hard drive` option. See Figure 10. - Figure 10: VMware ESXi - Add an existing hard drive + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-10.png + :scale: 100 % + :alt: VMware ESXi - Add an existing hard drive - #. Select the converted :file:`clear-[version number]-esxi.vmdk` - file. Do not use the original unconverted :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. + Figure 10: VMware ESXi - Add an existing hard drive - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png - :scale: 100 % - :alt: VMware ESXi - Select the converted `vmdk` file + #. Select the converted :file:`clear-[version number]-esxi.vmdk` + file. Do not use the original unconverted + :file:`clear-[version number]-vmware.vmdk` file. See Figure 11. - Figure 11: VMware ESXi - Select the converted :file:`clear-[version number]-esxi.vmdk` file + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-11.png + :scale: 100 % + :alt: VMware ESXi - Select the converted `vmdk` file -#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. + Figure 11: VMware ESXi - Select the converted + :file:`clear-[version number]-esxi.vmdk` file - #. Click the :guilabel:`VM Options` button. See Figure 12. - #. Expand the :guilabel:`Boot Options` setting. - #. For the :guilabel:`Firmware` setting, click the drop-down list to - the right of it and select the :guilabel:`EFI` option. +#. |CL| needs UEFI support in order to boot. Enable UEFI boot support. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png - :scale: 100 % - :alt: VMware ESXi - Set boot firmware to EFI + #. Click the :guilabel:`VM Options` button. See Figure 12. + #. Expand the :guilabel:`Boot Options` setting. + #. For the :guilabel:`Firmware` setting, click the drop-down list to + the right of it and select the :guilabel:`EFI` option. - Figure 12: VMware ESXi - Set boot firmware to EFI + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-12.png + :scale: 100 % + :alt: VMware ESXi - Set boot firmware to EFI -#. Click the :guilabel:`Save` button. -#. Click the :guilabel:`Next` button. -#. Click the :guilabel:`Finish` button. + Figure 12: VMware ESXi - Set boot firmware to EFI + +#. Click the :guilabel:`Save` button. +#. Click the :guilabel:`Next` button. +#. Click the :guilabel:`Finish` button. Power on the VM and boot Clear Linux ************************************ After configuring the settings above, power on the VM. -#. Under the :guilabel:`Navigator` window, select :guilabel:`Virtual Machines`. See Figure 13. -#. In the right window, select the newly-created VM. -#. Click the :guilabel:`Power on` button. -#. Click on the icon representing the VM to bring it into view and maximize - its window. +#. Under the :guilabel:`Navigator` window, select + :guilabel:`Virtual Machines`. See Figure 13. +#. In the right window, select the newly-created VM. +#. Click the :guilabel:`Power on` button. +#. Click on the icon representing the VM to bring it into view and maximize + its window. - .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png + .. figure:: figures/vmware-esxi/vmware-esxi-preconfigured-cl-image-13.png :scale: 100 % :alt: VMware ESXi - Navigator > Virtual Machines > Power on VM Figure 13: VMware ESXi - Navigator > Virtual Machines > Power on VM Also see: ---------- +========= * :ref:`vmware-esxi-install-cl` .. _VMware ESXi: https://www.vmware.com/products/esxi-and-esx.html -.. _`VMware documentation on Using the Datastore File Browser`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html -.. _`vSphere Management Assistant`: https://www.vmware.com/support/developer/vima/ -.. _`vSphere CLI`: https://www.vmware.com/support/developer/vcli/ -.. _`VMware documentation on Cloning and converting virtual machine disks with vmkfstools`: https://kb.vmware.com/kb/1028042 -.. _`VMware documentation on Enable the Secure Shell (SSH)`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html -.. _`VMware documentation on General ESXi Security Recommendations`: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html +.. _VMware documentation on Using the Datastore File Browser: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-7533A767-8396-4844-A3F2-206047D254EA.html +.. _vSphere Management Assistant: https://www.vmware.com/support/developer/vima/ +.. _vSphere CLI: https://www.vmware.com/support/developer/vcli/ +.. _VMware documentation on Cloning and converting virtual machine disks with vmkfstools: https://kb.vmware.com/kb/1028042 +.. _VMware documentation on Enable the Secure Shell (SSH): https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.html.hostclient.doc/GUID-B649CB74-832F-467B-B6A4-8BA67AD5C1F0.html +.. _VMware documentation on General ESXi Security Recommendations: https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-B39474AF-6778-499A-B8AB-E973BE6D4899.html .. _VMware Workstation Player: https://www.vmware.com/products/workstation-player.html .. _image: https://download.clearlinux.org/image