| Flags | | |
| /install | This flag defines the action as Installation. To uninstall, repair, or update see the section below. | |
| /components | Defines what components you are installing. Can be agent, coordinator, or agent,coordinator to install both at once. | |
| /Coordinator | The IP address or hostname of the associated Coordinator. Mandatory for the installation of an Agent and a Backup Coordinator.
If the Coordinator does NOT use the default port number (31104), you should add the port to the Coordinator name and put them both in quotes as follows: “Coordinator_Name:Port_No.”For example:“192.100.00.01:12345” | |
| /Coord:Backup | Use this flag to indicate that the Coordinator you are installing is a backup coordinator. | |
| /help | View usage information and full list of flags | |
| General Options | | |
| /AddToPath={ON|OFF} | Controls whether the Incredibuild installation folder is added to the system search path. | ON |
| /InstallDir={Install dir path} | Allows manual specification of the Incredibuild installation folder. | C:\Program Files (x86)\Incredibuild |
| Agent Options | | |
| /Agent:AutoSelectPorts={ON|OFF} | Controls whether setup should automatically select the first available TCP/IP ports for the Agent Service and Helper cores. If this option is ON, any manual port specification will be overridden.
Limitation: This option requires you to manually open all required ports. Using the/Agent:OpenFirewall flag is not supported when using the /Agent:AutoSelectPorts flag. | OFF |
| /AGENT:BUILDCACHEENDPOINT=OFF | When configured, the Build Cache service is not started automatically. | |
| /AGENT:BUILDCACHECLUSTER={Cluster name} | Specifies the Build Cache cluster.
Note: A Build Cache cluster cannot be combined with a remote server. Specify either a Build Cache cluster or a remote server. | |
| /AGENT:BUILDCACHELOCAL={ON|OFF} | Controls whether to use local Build Cache.
This is not supported for 32-bit Windows. | |
| /AGENT:BUILDCACHEREADONLY={ON|OFF} | Controls whether to use Build Cache in read-only mode. | |
| /AGENT:BUILDCACHEREMOTESERVER={server:port} | Specifies the Build Cache remote server and port.
Note: A Build Cache remote server cannot be combined with a cluster. Specify either a Build Cache remote server or a cluster. | |
| /Agent:FILECACHE={Number in MBs} | Allows manual specification, in MBs, of the maximum size of the Agent file cache folder. | 4096 |
| /Agent:Group={Build Group name} | Assign an Agent to a Build Group during installation. If the name you specify does not exist, the Build Group will be created. | Default Build Group |
| /AGENT:HELPERASSIGNMENTPRIORITY | Sets the Helper assignment priority. Lower values mean that the helper is more likely to be used. | 3 |
| /Agent:HelperPort={Port no.} | Allows manual specification of the Agent Helper port, required for the communication between an Initiator and the Helper cores. This manual specification will take effect only if the /Agent:AutoSelectPorts option is OFF. | 31106 |
| /Agent:InstallAddins={ON|OFF} | Controls whether the installation procedure should also install Incredibuild Add-in/Extension in Visual Studio IDE. | ON |
| /Agent:OpenFirewall={ON|OFF} | Controls whether setup should open Agent ports in the Windows Firewall.
Limitation: This option should not be used together with /Agent:AutoSelectPorts. In that case, Incredibuild does not know which ports will be needed in advance, and you will be required to manually open all required ports on your Firewall. | ON |
| /Agent:ServicePort={Port no.} | Allows manual specification of the Incredibuild Agent Service port, required for the communication with the Coordinator. This manual specification will take effect only if the /Agent:AutoSelectPorts option is OFF. | 31105 |
| /Agent:AgentRole={Helper/Initiator/Helper,Initiator} | Indicates the type of the Agent license. | |
| /Agent:InitiatorType={Fixed/Floating/CI_Fixed/CI_Floating} | Defines the license type of the Initiator. | Fixed |
| /Agent:HelperType={Fixed/Floating} | Defines the license type of the helper. | Fixed |
| /Agent:HelperCores={#|%} | Limits the number of cores that can be used when agent is helping build distribution. Can be specified in real number of cores or percentage of total core count. | |
| /Agent:Description | | |
| /Agent:SSLKey=“{path to .key file}“ | If you are using SSL, the path to the key you want to place on the Agent.
Importing files from remote machines using UNC (e.g. \remote_machine\certs\coordinator.crt) is not supported. | |
| /Agent:SSLCer=“{path to .crt file}“ | If you are using SSL, the path to the certificate you want to place on the Agent.
Importing files from remote machines using UNC (e.g. \remote_machine\certs\coordinator.crt) is not supported. | |
| /Agent:BuildCache=on | Assign a Build Cache license to the Initiator Agent. The agent will be enabled as a Build Cache Endpoint with the default settings. | |
| /Agent:BuildCacheServicePort={port number} | Define the value of the Build Cache Endpoint port. | 51100 |
| /Agent:CacheDirectoryLocation=“{path}“ | The location of the folder that will contain the Build Cache files. If the folder requires credentials, you can specify them in Agent Settings > Build Cache. | |
| /Agent:MaxFileCacheSize={#} | The maximum size of the Build Cache folder in GB. | |
| /Agent:SingleUse={True} | This marks a floating initiator agent as a single-use Agent (such as a VM). This is important to set if you use a large number of single-use Agents to prevent their data from being saved in the Coordinator. | |
/Agent:BackupCoordHost
/Agent:BackupCoordPort | If you are using a Backup Coordinator and it is active, use these flags to specify the machine name and port to use. This is only needed when installing an Agent while the Backup Coordinator is active, otherwise the location of the Backup Coordinator is communicated from the Primary Coordinator directly to all of the Agents automatically. | |
| | |
| Coordinator Options | | |
| /coord:username={user name} | The username to access the Coordinator. Required for clean installation (not repair). The username must be between 4-20 characters and cannot contain spaces or special characters. | |
| /coord:password={password} | The password to access the Coordinator, required for clean installation (not repair). The password must be at least 8 characters, contain one uppercase letter, and one special character. However, passwords cannot contain the character ^. | |
| /coord:OpenFirewall={ON|OFF} | Controls whether setup should open the Coordinator service ports in the Windows Firewall. | ON |
| /coord:DatabaseDir | The directory for the Coordinator’s database. | |
| /coord:ServicePort={Port no.} | Define the value of the Agent Communications port. | 31104 |
| /coord:IncredibuildManagerPort={Port no.} | Define the value of the Incredibuild Manager port. | 8000 |
| /coord:CoordApiPort={Port no.} | Define the value of the Coordinator Service port. | 31100 |
| /License:OpenFirewall={ON|OFF} | Controls whether setup should open the license port in the Windows Firewall. | ON |
| /License:ServicePort={Port no.} | Allows manual specification of the License Service port. This is required to communicate with the license service. | 50052 |
| /coord:sslkey=“{path to .key file}“ | If you are using SSL, the path to the key you want to place on the Coordinator. | |
| /coord:sslcer=“{path to .crt file}“ | If you are using SSL, the path to the certificate you want to place on the Coordinator. | |
| /accept_eula | When installing or upgrading a Coordinator, this flag automatically accepts the End User License Agreement (EULA). If you do not add this flag, you will be prompted to manually accept the EULA in the command line. | |
