Assigning Agents to Build Groups During Installation

For Enterprise Edition only

You can assign an Agent to a Build Group during its installation via:

  • Silent installation

  • Setup wizard

Note: The Build Group must already exist.

Enabling Assignment

In order to assign an Agent to a Build Group during installation, enable this option on the Coordinator.

> To enable the assignment:

  1. Go to Coordinator > Coordinator Settings > Coordinator > API Accessand select Allow Agents self registration to Build Group.


  2. ClickOK.

Assigning an Agent via the Silent Installer

Use the option:/Agent:Group={Group name}

If a{Group name}is not specified, or if a non-existent group name is provided, the Agent is assigned to theDefaultBuild Group.

> To assign an Agent to a Build Group via the Automated Installer:

  • Use the command, adding the{Group name}value:

    IBSetupConsole.exe /Install /Components=Agent /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]

    For example:

    IBSetupConsole.exe /Install /Components=Agent /Coordinator=win10-1 /Agent:Group=QA

> To install both a Coordinator and an Agent:

  • Use the following command, adding the{Group name}value:

    IBSetupConsole.exe /Install /Components=Coordinator,Agent /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]

> To install an Agent with a Single-Use VM license:

  • Use the command, adding the{Group name}value:

    IBSetupConsole.exe /Install /Components=Agent,oneuse /Coordinator={COORDINATORNAME} /Agent:Group={Group name} [General Options] [Agent Options]

Assigning an Agent via the Setup Wizard

> To assign an Agent to a Build Group via the Setup wizard:

  1. Double-click the Incredibuild Setup file to start the Agent installation.

  2. Follow the Setup wizard instructions, and clickNextuntil you reach theCoordinator Selectionpage.

  3. SelectConnect Agent to existing Coordinator, and in theNetwork namefield, enter the Coordinator IP address or hostname.

  4. Click theAdvancedarrow and then, from theAssign this to Build Groupdropdown list, select the required Build Group.

  5. ClickNextand continue to follow the wizard instructions until you complete the Agent installation