changes.
| |  | There are three tabs in build grid screen: |
| | | There are three tabs in build grid screen: |
| | # *Active nodes* |
 | | Active nodes represents nodes in the build grid, and can take part in distributed builds. |
| | # *Connected nodes* |
| | Connected nodes represent connected but unauthorized nodes, a connected node becomes active node when it is authorized. |
| | | Active nodes represents nodes in the build grid, that can take part in distributed builds. |
| | # *Connected nodes* |
| | Connected nodes represent connected but unauthorized nodes, a connected node becomes active node when it is authorized. |
| | # *Inactive nodes* |
| | Inactive node is authorized, but is not active currently. When a node in this list is connected, it will be put into the active node list immediately. |
| | | Inactive node is authorized, but it is not currently active. When a node in this list is connected, it will be assigned to the active node list immediately. |
| | |
| | h1. Add/remove build nodes |
| | |
| | When QuickBuild server is initially installed, it only has one node in the grid - the build server itself, as indicated below: |
| | !initial-buildgrid.png! |
| | The active node list displays all the node in the build grid, with the first node being server node. Server node can not be restarted or removed. |
| | | The active node list displays all the nodes in the build grid, with the first node being server node. Server node can not be restarted or removed. |
| | * h4. To add more nodes to the grid: |
| | |
| | * h4. To add more nodes into the grid: |
| | # Follow the [agent installation guide|Build Agent Installation Guide] to install QuickBuild software on other build machines, and point them to the server instance. The newly connected agents will get the message _This build agent is not allowed to join the grid_, which means that the agent does not have permission to join the build grid. Next step explains how to allow the agent to join the build grid. |
| | # Login in to QuickBuild server as administrator and select the connected nodes tab like below: |
| | | # Login in to QuickBuild server as administrator and select the connected nodes tab as follows: |
| | !connected-nodes.png! |
| | The connected nodes list all agents connected to the server, but have not been allowed to join the build grid. You may choose one or more agents and click the _add_ icon to add them into the grid. The allowed agents will appear in the active node list after a while. |
| | | The connected nodes page lists all agents connected to the server that have not been allowed to join the build grid. You may choose one or more agents and click the _add_ icon to add them to the grid. The allowed agents will appear in the active node list after a while. |
| | |
| | * h4. To remove nodes from the grid: |
| | |
| | # For active nodes, select nodes and click the remove icon. Removed nodes will appear in connected node list. |
| | # For inactive nodes, select nodes and click the remove icon. |
| | | # For inactive nodes, select nodes and click the remove icon. |
| | |
| | h1. Grid node detail |
| | |
| | Details of an active node can be accessed by either clicking the grid node in the active node overview page, or by selecting the grid node from side bar of the build grid page as indicated below: |
| | |
| | !select-gridnode.png! |
| | |
| | * h4. {anchor:node attributes} Grid node attributes |
| | |
| | Node attributes can be used to filter nodes for certain steps by specifying the step property _node match condition_. For example, the condition _node.getAttribute("os.name").startsWith("Windows")_ matches only agents running Windows operating system, while condition _node.hasAttribute("ant")_ matches agents that have the attribute _ant_ defined. |
| | There are two set of attributes for a node: system defined attributes and user defined attributes. System defined attributes will be displayed if you select the _System Attributes_ tab as indicated below: |
| | | There are two sets of attributes for a node: system defined attributes and user defined attributes. System defined attributes will be displayed if you select the _System Attributes_ tab as indicated below: |
| | |
| | !system-attributes.png! |
| | |
| | System defined attributes include all environment variables and all Java system properties. |
| | |
| | User defined attributes are custom attributes that are defined by user to identify ability of the node. For example, if the agent has Ant and Maven installed, you may define user attributes to reflect this installation as follows: |
| | |
| | !user-attributes.png! |
| | |
| | * h4. Monitor grid node jobs |
| | |
| | A single unit of work running on a grid node is called a grid job. In most cases, it is just a step. A grid node may have many jobs running concurrently (for example, steps from builds of different configurations). The number of concurrent jobs is limited by node resources (such as working threads). If the resources are exhausted, newly arriving jobs will be waiting in the queue. A typical job monitoring screen looks like this: |
| | |
| | !jobqueue.png! |
Configuring Build Grid