Install the vSphere Integrated Containers Engine Plug-In on a vCenter Server Appliance by Using a Web Server

If you are running the vCenter Server Appliance, you can use a Web server to host the vSphere Web Client plug-in for vSphere Integrated Containers Engine.

Prerequisites

  • You deployed at least one virtual container host (VCH) to a vCenter Server Appliance instance.
  • You are running a Web server that the vCenter Server Appliance can access.
  • If you deployed the VCH to a vCenter Server 6.5 instance, use the Flash-based vSphere Web Client to view the vSphere Web Client plug-in for vSphere Integrated Containers Engine. vSphere Integrated Containers Engine does not currently provide a plug-in for the new HTML5 vSphere Client.

Procedure

  1. On the system on which you run vic-machine, navigate to the folder that contains the vic-machine utility and open the ui folder.
  2. Upload the plug-in bundle to your Web server.
    vic_unpack_dir/vic/ui/vsphere-client-serenity/com.vmware.vicui.Vicui-version.zip
  3. Open the vic_unpack_dir/vic/ui/VCSA/configs file in a text editor.
  4. Enter the IPv4 address or FQDN of the vCenter Server instance on which to install the plug-in.
    VCENTER_IP="vcenter_server_address"
  5. Enter the path to the folder on your Web server that contains the com.vmware.vicui.Vicui-version.zip file.
    VIC_UI_HOST_URL="vicui_zip_location"
  6. (Optional) If you used an HTTPS address in VIC_UI_HOST_URL, provide the SHA-1 thumbprint of the Web server.
    VIC_UI_HOST_THUMBPRINT="thumbprint"
    NOTE: Use colon delimitation in the thumbprint. Do not use space delimitation.
  7. Save and close the configs file.
  8. (Optional) If you run vic-machine on a Windows system, open the vic_unpack_dir/vic/ui/VCSA/install.sh file in a text editor and point PLUGIN_MANAGER_BIN to the Windows UI executable.

    Before:

    if [[ $(echo $OS | grep -i "darwin") ]] ; then
       PLUGIN_MANAGER_BIN="../../vic-ui-darwin"
      else
       PLUGIN_MANAGER_BIN="../../vic-ui-linux"
    After:
    if [[ $(echo $OS | grep -i "darwin") ]] ; then
       PLUGIN_MANAGER_BIN="../../vic-ui-darwin"
      else
       PLUGIN_MANAGER_BIN="../../vic-ui-windows"
  9. Open a command prompt, navigate to vic_unpack_dir/vic/ui/VCSA, and run the installer.

    ./install.sh

    • Make sure that install.sh is executable by running chmod before you run it.
    • On Windows systems, run install.sh in a UNIX shell that supports SSH and SCP, for example Cygwyn or Git Bash. Do not use Windows 10 native Bash.
  10. Enter the user name and password for the vCenter Server administrator account.
  11. When installation finishes, if you are logged into the vSphere Web Client, log out then log back in again.

What to Do Next Check that the deployment has succeeded by following the procedure in Verify the Deployment of the vSphere Integrated Containers Engine Plug-In.