Delete an ESX Agency

A solution can delete an ESX agency by calling the Agency.destroyAgency() method on the Agency object.

Typically, before deleting an ESX agency, a solution firsts call the EsxAgentManager.uninstall() method to put the agency in the uninstalled state. The solution tracks the progress of EsxAgentManager.uninstall() and only calls destroyAgency() to remove the ESX agency when the status of the ESX agency is green.

If your solution does not need to track the removal of the ESX agency and its ESX agents, you can call destroyAgency() without first calling uninstall(). ESX Agent Manager removes the ESX agency and all of the ESX agents without tracking the status of the uninstallation process.

Alternatively, disconnecting the solution from vCenter Server by calling the ExtensionManager.unregisterExtension() method removes all ESX agencies and ESX agents.

The EAM Sample Solution does not call the Agency.destroyAgency() method directly. The EAM Sample Solution calls the Agency.disable() and Agency.uninstall() methods to set the ESX agents in the uninstalled state, then calls ExtensionManager.unregisterExtension() to unregister the solution from vCenter Server, which removes the ESX agency and the ESX agents.

Prerequisites

Download the vSphere ESX Agent Manager SDK.
Verify that you have set up and started the EAM Sample Solution in an application server.
Verify that you have opened eam_work_folder\src\com\vmware\eam\sample\solution\AgentHandler.java in an editor.
Verify that you have opened eam_work_folder\src\com\vmware\eam\sample\solution\Manager.java in an editor.

Procedure

Call the Agency.disable() method to disable the ESX agency.
Calling the Agency.disable() method powers off the ESX agent virtual machines, but does not undeploy them.
The EAM Sample Solution calls the Agency.disable() method in the AgentHandler.java class.
```
public void disable() throws RuntimeFaultFaultMsg {
   waitForSetup();
      _eamConnection.getStub().disable(_agency);
}
```
Call the Agency.uninstall() method to put the ESX agency in the uninstalled state.
Calling the Agency.uninstall() method uninstalls all the ESX agents in the ESX agency.
The EAM Sample Solution calls the Agency.uninstall() method in the AgentHandler.java class.
```
public void uninstall() throws RuntimeFaultFaultMsg {
   waitForSetup();
      _eamConnection.getStub().uninstall(_agency);
}
```

Delete the ESX agency and ESX agents.

Option	Description
Call the Agency.destroyAgency() method on the Agency object.	Deletes the agency and its ESX agents, but the solution remains registered with ExtensionManager.
Call the ExtensionManager.unregisterExtension() method on the Extension object.	Unregisters the solution from vCenter Server, which uninstalls the solution and deletes the ESX agency and its ESX agents.

The EAM Sample Solution deletes the ESX agency by calling the ExtensionManager.unregisterExtension() method in the Manager.java class.

public void cleanup() throws NotFoundFaultMsg, RuntimeFaultFaultMsg { 
   if (_eamConnection != null) {
      _eamConnection.disconnect();
   }

    _vimConnection.getStub().unregisterExtension(_vimConnection.getExtensionManager(),
                                                 EXTENSION_KEY);
}

Results

You defined a function to delete an ESX agency from a solution.