Upgrade the vSphere Client Plug-Ins on vCenter Server Appliance

If you have previous installations of the vSphere Client plug-ins for vSphere Integrated Containers, you must upgrade them. This procedure describes how to upgrade existing plug-ins for a vCenter Server Appliance.


IMPORTANT: The upgrade script does not function if you have set the VIC_MACHINE_THUMBPRINT environment variable on the system on which you run the script. Delete the VIC_MACHINE_THUMBPRINT environment variable before running the script.


  1. Connect as root user to the vCenter Server Appliance by using SSH.
    ssh root@vcsa_address
  2. Start bash.
  3. Set the following environment variables:

    • vSphere Integrated Containers appliance address:
      export VIC_ADDRESS=vic_appliance_address
    • vSphere Integrated Containers Engine bundle file:

      export VIC_BUNDLE=vic_v1.3.0.tar.gz

      If you are upgrading to a different version of the appliance, update 1.3.0 to the appropriate version in the command above. You can see the correct version by going to https://vic_appliance_address:9443/files/ in a browser.

  4. Use curl to copy the new vSphere Integrated Containers Engine binaries from the file server in the upgraded vSphere Integrated Containers appliance to the vCenter Server Appliance.

    Copy and paste the following command as shown:

    curl -kL https://${VIC_ADDRESS}:9443/files/${VIC_BUNDLE} -o ${VIC_BUNDLE}

  5. Unpack the vSphere Integrated Containers binaries.
    tar -zxf ${VIC_BUNDLE}
  6. Navigate to /vic/ui/VCSA, run the upgrade script, and follow the prompts.
    cd vic/ui/VCSA
    1. Enter the FQDN or IP address of the vCenter Server instance.
    2. Enter the user name and password for the vCenter Server administrator account.
    3. Enter yes if the vCenter Server certificate thumbprint is legitimate, and wait for the install process to finish.
    4. (Optional) If the version that you try to install is same or older than the one already installed, enter yes to force reinstall and wait for the process to finish.
  7. When the upgrade finishes, stop and restart the vSphere Client services.

    NOTE: The Flex-based plug-in has no new features in this release. However, the upgrade script updates the metadata for the Flex-based client. Consequently, you must restart both of the HTML5 and Flex-based clients.

    • HTML5 vSphere Client:
      service-control --stop vsphere-ui
      service-control --start vsphere-ui
    • Flex-based vSphere Web Client:
      service-control --stop vsphere-client
      service-control --start vsphere-client

What to Do Next

Log in to the HTML5 vSphere Client, go to the vSphere Integrated Containers view, and verify that the version number reflects the upgrade.

results matching ""

    No results matching ""