When you create an agency, you define the goal state of the ESX agents that the agency contains. The status of an ESX agency reflects the situation of the ESX agency in relation to its goal state.

ESX Agent Manager notifies a solution of the status of its ESX agencies. ESX Agent Manager defines three possible statuses for ESX agencies.

Table 1. ESX Agent Status

Status

Description

Green

The ESX agency has achieved its goal state.

Yellow

ESX Agent Manager is working to move the ESX agency into its goal state.

Red

The ESX agency cannot achieve its goal state. The solution or the vSphere administrator must actively resolve one or more issues. ESX Agent Manager reports the issues to the solution in the agency runtime. ESX Agent Manager can resolve certain issues if you select the agency, click the vertical ellipsis and click Resolve All Issues, for example if an ESX agent is powered off.

ESX Agent Manager sets the ESX agency status to yellow until the ESX agency reaches its goal state. This can either mean that the deployment of the ESX agents is still ongoing, or that ESX Agent Manager is attempting to remediate issues. You define the remediation of issues in the implementation of the solution, or you can leave the remediation of issues to the vSphere administrator, who can resolve the issue by using the ESX Agent Manager user interface.

The criteria on which ESX Agent Manager determines that the status of an ESX agency is green depends on the goal state of that ESX agency.

Table 2. Criteria for Meeting the Goal State of an ESX Agency

ESX Agency Goal State

Criteria for Green Status

Enabled

ESX Agent Manager has downloaded the ESX agent binaries from the OVF and VIB URLs, deployed the ESX agent virtual machines, installed the VIB, started the ESX agent virtual machines, and received heartbeats from all of them.

Disabled

ESX Agent Manager has downloaded the ESX agent binaries from the OVF and VIB URLs, deployed the ESX agent virtual machines, and installed the VIB.

Undeployed

ESX Agent Manager has powered off and deleted all the ESX agent virtual machines and uninstalled the VIB.

If the ESX agency cannot reach its goal state, ESX Agent Manager reports the issues to the solution and sets the status to red.

Note:

If the scope of an ESX agency is empty, there are no compute resources onto which to deploy ESX agents, so no ESX agents are deployed. In this case, ESX Agent Manager determines that the ESX agency has performed correctly, and sets the status to green.