The Coordinator Console Utility (xgCoordConsole.exe)

The Coordinator Console Utility (xgCoordConsole.exe)

The Coordinator Console utility (xgCoordConsole.exe) can be used for two purposes:

Coordinator Maintenance Tasks

To clear the file cache on all connected Agent machines:

Note:

This option can only be run from the machine running the Coordinator service, or from Agent machines that have been granted Remote Administration rights.

Generating the Coordinator Status XML File

To generate an XML file with the current information:

Additional command line options include:

Root Element Description

The XML file's root "CoordinatorStatus" element includes the attributes described in the following table:

Attribute Description
Role Either "Backup" or "Primary", depending on the Coordinator's configuration
Host The Coordinator's network name
Port The Coordinator service's IP port
AgentCount The number of Agents in the report. The report includes all subscribed Agents (both offline and online), as well as any unsubscribed Agents currently connected to the Coordinator and pending subscription.
ExportTime The time the XML file was created, in a 64-bit numeric value that corresponds to a Windows FILETIME structure
ExportTimeText The time the XML file was created, in text format
Version The installed IncrediBuild version build number
VersionText The installed IncrediBuild version text description
PrimaryCoordinatorOnline Boolean value describing whether the primary Coordinator is reachable
BackupCoordinatorOnline Boolean value describing whether the backup Coordinator is reachable

Note:

Agent Element Description

The XML includes an "Agent" element for every included Agent. The following table provides a description of the attributes, which are not explained in the Coordinator Monitor section:

Attribute Description
Online Whether the Agent is currently connected to the Coordinator
Version The version of IncrediBuild that the Agent is currently running (in numeric format)
Version Text The version of IncrediBuild that the Agent is currently running (in text format)
Host The network name of the Agent computer
Port The IP port used by the Agent Service
BuildAssignedCPUCount The total number of CPUs/cores assigned to the build that this Agent is running
WorkingForAgents The number of Agents currently assigned to the build that this Agent is running
LastConnected The last time this Agent connected to the Coordinator; in a 64-bit numeric value that corresponds to a Windows FILETIME structure