Install a Supervisor Service on a Supervisor

After adding a Supervisor Service to vCenter Server, you can install it on a Supervisor in your vSphere IaaS control plane environment. If you install a newer version of the Supervisor Service, it overrides any older service versions on that Supervisor. Only one Supervisor Service version can run on a Supervisor at a time.

• Learn more about the supported Supervisor Services and how to download their service YAML files at http://vmware.com/go/supervisor-service.

Prerequisites

• Add a new Supervisor Service or a newer version of and existing service to vCenter Server. See Add a Supervisor Service to vCenter Server or Add a New Version to a Supervisor Service.
• Verify that you have the Manage Supervisor Services on Supervisors privilege on the Supervisor where you want to install the service.
• If the Supervisor Service requires persistent storage, configure the vSAN Data Persistence platform. See Using vSAN Data Persistence Platform with Modern Stateful Services.

Procedure

1. From the vSphere Client home menu, select Workload Management.
2. Select Services.
3. In the card of the Supervisor Service that you want to install, select Actions > Manage Service.
4. From the Install Version drop-down menu, select the Supervisor Service version.
   Note: You cannot install Supervisor Service versions that are Deactivated.
5. Select the Supervisor where you want to install the service.
6. Click Next.
   Compatibility pre-checks are performed to determine weather the Supervisor Service version that you want to install is compatible with the Supervisor. If the service version is compatible with the Supervisor, you can proceed with the installation. In case the selected service version is not compatible with the Supervisor two types of messages are displayed that describe the exact incompatibility:

   • Warning messages. You can skip the warning messages, but you must acknowledge them to proceed with the installation.
   • Error messages. Error message indicate that the Supervisor Service version is incompatible with the Supervisor and cannot be installed. In case of error messages, you must first resolve the incompatibility that was detected before you are able to install the service on the particular Supervisor.
7. In the YAML Service Config field, enter configuration properties if the service requires any.
8. View the installation progress for the service on Supervisors.
   1. Select the Supervisors tab and select a Supervisor where you install the service.
   2. Click Configure and click Supervisor Services > Overview.
   3. Select the Installed tab.

Results

The Supervisor Service is in Configuring state, which means that all the necessary resources are being created in the Supervisor and the service YAML is being applied to the cluster. Once the YAML is successfully applied to the Supervisor with all its resources and namespace created or updated, the service state changes to Configured. The service is available to all the namespaces in that cluster and DevOps engineers can use it with their workloads.

What to do next

Configure the Supervisor Service by using the interface. See where to find it at Access the Management Interface of a Supervisor Service on the Supervisor Cluster.