Moving the Coordinator to a New Machine

After you installed the Coordinator and connected to it Agents, you can move the Coordinator to another machine, and re-connect to the new Coordinator machine all the Agents together in one procedure. During this procedure, you will also unload the license from the original machine, and load it to the Coordinator on the new machine.

Note: You can also manually change the connected Coordinator of each Agent separately, by using the Agent Settings dialog box > Network > Coordinator > Computer drop-down list.

> To move an installed Coordinator to another machine:

1. While your Coordinator is still active on its original machine, install another Coordinator on the new machine, without loading to it a License File.Note: After you will move the Agents to the new Coordinator, you will unload your License File from the original Coordinator, and load it to the new Coordinator. 

2. On the original Coordinator machine, open the Coordinator Monitor, as follows:

   • On the taskbar, right-click Incredibuild Agent tray icon, and select Coordinator Monitor:

     

     Note: You can also open the Coordinator Monitor from the Start menu > Incredibuild > Incredibuild Coordinator.

3. On the Coordinator Monitor, select all existing Agents. Then, right-click, and select the Set Registry Value option:

   

4. On the Set Registry Value dialog box, set the following:

   • Value Category drop-down list – select BuildService.

   • Name field – enter CoordHost.

   • Data field – enter the IP address or hostname of the new Coordinator machine.

     

     Then, click OK. The selected Agents appear on the new Coordinator Monitor, but without a valid license:

     

5. On the original machine, open the Coordinator Settings dialog box by right-clicking Incredibuild Agent tray icon, and selecting the Coordinator Settings option.

6. On the Coordinator Settings dialog box of the original Coordinator, open the License section, and click the Unload License button:

   

7. After you unload the License File, copy this License File to the new Coordinator machine.

8. On the new Coordinator machine, open the Coordinator Settings dialog box. Then, open the License section, and click the Load License File… button:

   

9. Locate the License File, and load it to the new machine:

   

   Now, all the Agents are connected to the new Coordinator with a valid license, and the distribution of build tasks to Helpers can proceed as usual:

   

10. If you are using a Backup Coordinator, perform the following:

    1. Uninstall the Backup Coordinator.

    2. Reinstall the Backup Coordinator. Notes: You can reinstall the Backup Coordinator on the same machine. During the installation procedure, in the Coordinator Selection page, enter the IP address or hostname of the new Coordinator machine:

       

    3. On the Coordinator Settings dialog box of the new Coordinator, go to the Coordinator > Backup section, and select the machine name of the reinstalled Backup Coordinator: