Upgrade HTML5 vSphere Client Plug-In on a vCenter Server Appliance

If you have a previous 1.1.x installation of the HTML5 vSphere Client plug-in for vSphere Integrated Containers and you download a newer 1.1.y version of vSphere Integrated Containers, you must upgrade the HTML5 plug-in. This procedure describes how to upgrade an existing HTML5 plug-in for a vCenter Server Appliance.

NOTE: No new development work is planned for the plug-in for the Flex-based vSphere Web Client. In this and future releases, only the HTML5 vSphere Client will be updated. This release adds no new features to the Flex plug-in. If you installed the Flex plug-in with a previous release of vSphere Integrated Containers, there is no upgrade to perform.

Prerequisites

• You are upgrading the HTML5 plug-in on a vCenter Server appliance instance. If you are running vCenter Server on Windows, see Upgrade the HTML5 vSphere Client Plug-In on vCenter Server for Windows.
• You deployed an older version of the vSphere Integrated Containers plug-in for the HTML5 vSphere Client with a previous version of vSphere Integrated Containers 1.1.x. For information about installing the HTML5 plug-in for the first time, see Install the Client Plug-Ins on a vCenter Server Appliance.
• You upgraded an existing vSphere Integrated Containers 1.1.x appliance to a newer 1.1.y version. For information about upgrading the vSphere Integrated Containers appliance, see Upgrade the vSphere Integrated Containers Appliance.
• Go to the vCenter Server Appliance Management Interface (VAMI) at https://vcsa_address:5480, click Access, and make sure that Bash Shell is enabled.

NOTE: If the upgraded vSphere Integrated Containers appliance uses a different port for the file server, replace 9443 with the appropriate port in the procedure below.

Procedure

1. Connect as root user to the vCenter Server Appliance by using SSH.

   ssh root@vcsa_address

2. 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.

   curl -k https://upgraded_vic_appliance_address:9443/vic_1.1.x.tar.gz -o vic_1.1.x.tar.gz

   NOTE: Update vic_1.1.x to the appropriate version in the command above and in the next step.
3. Unpack the vSphere Integrated Containers binaries.

   tar -zxf vic_1.1.x.tar.gz

4. Use a text editor to set the vCenter Server address in the /vic/ui/VCSA/configs file.

   VCENTER_IP="vcsa_address"

   Alternatively, you can use a utility such as sed to update the configs file:

   sed -i 's#^\(VCENTER_IP=\).*$#\1"vcsa_address"#' ~/vic/ui/*/configs

5. Set the address of the upgraded vSphere Integrated Containers appliance in the /vic/ui/VCSA/configs file.

   VIC_UI_HOST_URL="https://upgraded_vic_appliance_address:9443/"

   Alternatively, you can use sed:

   sed -i 's#^\(VIC_UI_HOST_URL=\).*$#\1"https://upgraded_vic_appliance_address:9443"#' ~/vic/ui/*/configs

6. Obtain the thumbprint of the upgraded vSphere Integrated Containers appliance file server certificate.

   echo | openssl s_client -connect upgraded_vic_appliance_address:9443 | openssl x509 -fingerprint -sha1 -noout

7. Set the certificate thumbprint in the /vic/ui/VCSA/configs file, replacing thumbprint with the output of the command from the preceding step.

   VIC_UI_HOST_THUMBPRINT="thumbprint"

   Alternatively, you can use sed:

   sed -i 's#^\(VIC_UI_HOST_THUMBPRINT=\).*$#\1"thumbprint"#' ~/vic/ui/*/configs

8. Navigate to /vic/ui/VCSA, and run the upgrade script, entering the user name and password for the vCenter Server administrator account when prompted.

   cd vic/ui/VCSA

   ./upgrade.sh

9. When the upgrade finishes, stop and restart the HTML5 vSphere Client service.

   service-control --stop vsphere-ui

   service-control --start vsphere-ui

What to Do Next

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