Working with Agents
The Cluster Manager lets you perform agent management tasks such as setting the agent allocation and cluster sharing policies, changing the number of agents per host, and enabling, disabling, testing, or deleting agents.
See Agent Policies.
All builds continually adjust the number of agents they can use. Cluster sharing requires constant cooperation between `eMake ` and the Cluster Manager. Each `eMake ` machine sends a message to the Cluster Manager whenever it wants more agents.
Cluster sharing allows more than one build to run on a cluster by dynamically reallocating agents based on the cluster sharing policy set up in Cluster Manager. The policy is based on an Accelerator fair-sharing algorithm.
When you create a cluster sharing policy, in addition to the total number of agents in the cluster, you should consider the following information:
Same priority builds with the same boost share the cluster equally.
Higher priority class builds can take agents away from lower priority class builds.
A build cannot lose an agent if losing an agent will cause the build to go below its minimum, unless preemption is set to priority. Builds that cannot get a minimum number of agents must wait, where minimum is the lower of these values: the build class’s MinAgents and the build’s current MaxAgents.
The cluster sharing algorithm assigns agents to builds by reading the values for:
Maximum number of agents the build is capable of using, as specified by `eMake ` the last time it made an agent allocation request.
BuildID —Unique identifier for each build that sorts builds by age within each priority.
Priority —High, normal, or low.
Boost within each priority.
Any leftover or unused agents are distributed evenly based on priority and needed agents determination of running builds.
On Linux and Solaris platforms, follow these steps:
Change the value of the
AGENT_NUMBERto the number of agents you want to run.
On Windows platforms, use the
ecconfig utility (installed in
C:\ECloud\i686_win32\bin ) to change the number of agents.
ecconfig -numagents 2
A disabled agent, indicated by an empty checkbox, indicates the agent was taken offline from the cluster.
On the Agents page, click the checkbox in the Enabled column of the agent list to enable the agent in that row.
On the Agent Details page, click Enable Agent to enable that displayed agent.
A check mark in the Enabled column indicates an agent is enabled, meaning it is ready to work for a build, using the cluster.
On the Agents page, clilck the checkbox in the Enabled column of the agent list to disable the agent in that row.
On the Agent Details page, click Disable Agent to disable that displayed agent.
On the Agents page, for each agent in the agents list, a (alive) icon in the Status column indicates an agent is alive. A (not alive) icon indicates the agent is not responding, has timed out, or has been disabled.
At any time, you can test one or all agents to update the status list.
Either Click the (test agent) button in the Status column in the agents list or click the button on the Agent Details page to test that agent.
From the Filter drop-down menu, select the agent criteria.
Click the (test filtered agents) button in the Filtered Agents section of the page.
After a few seconds, a icon in the Status column appears to indicate an agent is alive. A icon indicates the agent is not responding or has timed out.
If necessary, click the View Messages link in the Actions column to help you determine what the error icon means.
Click the Agents tab to return to the agents list.
Deleting agents can mean simply deleting an agent from the agent list on the Agents page, or it could mean removing an agent from the cluster permanently. Unless agent hardware was physically disconnected, or the agent service was stopped, agents reappear in the agent list (because connected agents are automatically detected).
On the Agents page, click the Delete Agent link in the Action column for the agent you want to delete. This action removes the agent from the database.
On the Agent Details page, click Delete Agent to delete that displayed agent.
Go to the Filter drop-down menu and select a filter.
Click Run Filter.
Click Delete Filtered Agents.
From the Filter menu, select none, then click Run Filter.
This removes the agents from the database.