Install the Client Plug-Ins on a vCenter Server Appliance
You install the vSphere Client plug-ins for vSphere Integrated Containers by logging into the vCenter Server appliance and running a script. The script registers an extension with vCenter Server, and instructs vCenter Server to download the plug-in files from the file server in the vSphere Integrated Containers appliance.
- You can install the the Flex-based vSphere Web Client plug-in on vCenter Server 6.0 or 6.5.
- You can install the the HTML5 vSphere Client plug-in on vCenter Server 6.5.
Prerequisites
- You are installing the plug-ins on a vCenter Server appliance instance. If you are running vCenter Server on Windows, see Install the Client Plug-Ins on vCenter Server for Windows.
- Go to the vCenter Server Appliance Management Interface (VAMI) at https://vcsa_address:5480, click Access, and make sure that Bash Shell is enabled.
- You deployed the vSphere Integrated Containers appliance. For information about deploying the appliance, see Deploy the vSphere Integrated Containers Appliance.
NOTE: If the vSphere Integrated Containers appliance uses a different port for the file server, replace 9443 with the appropriate port in the procedure below.
Procedure
- Connect as root user to the vCenter Server Appliance by using SSH.
ssh root@vcsa_address
- Use
curl
to copy the vSphere Integrated Containers Engine binaries from the vSphere Integrated Containers appliance file server to the vCenter Server Appliance.curl -k https://vic_appliance_address:9443/vic_1.1.1.tar.gz -o vic_1.1.1.tar.gz
NOTE: Updatevic_1.1.x
to the appropriate version in the command above and in the next step. - Unpack the vSphere Integrated Containers binaries.
tar -zxf vic_1.1.x.tar.gz
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 theconfigs
file:sed -i 's#^\(VCENTER_IP=\).*$#\1"vcsa_address"#' ~/vic/ui/*/configs
Set the URL of the vSphere Integrated Containers appliance file server in the
/vic/ui/VCSA/configs
file.VIC_UI_HOST_URL="https://vic_appliance_address:9443/"
You must enter the full URL and include the closing forward slash (/
) after the port number.Alternatively, you can use
sed
:sed -i 's#^\(VIC_UI_HOST_URL=\).*$#\1"https://vic_appliance_address:9443"#' ~/vic/ui/*/configs
- Obtain the thumbprint of the vSphere Integrated Containers appliance file server certificate.
echo | openssl s_client -connect vic_appliance_address:9443 | openssl x509 -fingerprint -sha1 -noout
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
- Navigate to
/vic/ui/VCSA
, and run the installer script, entering the user name and password for the vCenter Server administrator account when prompted.cd vic/ui/VCSA
./install.sh
This first run of the script installs the HTML5 client. - When the installation finishes, stop and restart the HTML5 vSphere Client service.
service-control --stop vsphere-ui
service-control --start vsphere-ui
To install the plug-in for the Flex-based vSphere Web Client, edit
/vic/ui/VCSA/configs
again and set the plug-in type toflex
.PLUGIN_TYPE="flex"
Alternatively, you can use
sed
:sed -i 's#^\(PLUGIN_TYPE=\).*$#\1"flex"#' ~/vic/ui/*/configs
- Run the installer script, entering the user name and password for the vCenter Server administrator account when prompted.
cd vic/ui/VCSA
./install.sh
- When the installation finishes, stop and restart the Flex-based vSphere Web Client service.
service-control --stop vsphere-client
service-control --start vsphere-client
What to Do Next
To verify the deployment of the plug-in, see Access the vSphere Integrated Containers View in the HTML5 vSphere Client, Find VCH Information in the vSphere Clients, and Find Container Information in the vSphere Clients.