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

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

  1. Connect as root user to the vCenter Server Appliance by using SSH.
    ssh root@vcsa_address
  2. 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: 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 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

  6. 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
  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 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.
  9. When the installation finishes, stop and restart the HTML5 vSphere Client service.
    service-control --stop vsphere-ui
    service-control --start vsphere-ui
  10. To install the plug-in for the Flex-based vSphere Web Client, edit /vic/ui/VCSA/configs again and set the plug-in type to flex.

    PLUGIN_TYPE="flex"

    Alternatively, you can use sed:

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

  11. Run the installer script, entering the user name and password for the vCenter Server administrator account when prompted.
    cd vic/ui/VCSA
    ./install.sh
  12. 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.

results matching ""

    No results matching ""