BuildMaster Documentation

Silent Installation

To help you automate and configure BuildMaster, the fully-automated silent installer can perform initial installation and upgrades. You could even use an instance of Otter to upgrade BuildMaster!

See the BuildMaster Agent Silent Install Options for how to silently install agents as well; note that you will not need to upgrade agents, as they are automatically upgraded when you upgrade BuildMaster.

Silent Install Options

/S Required for a silent install. If this is not specified, the UI will be displayed.
/Edition=<value> Required for a silent install. The desired BuildMaster edition: May be Express, Trial, or LicenseKey.
/EmailAddress=<value> The email address used for requesting a license key. Required if Edition is Express or Trial.
/FullName=<value> The user's full name used for requesting a license key. Required if Edition is Express or Trial.
/LicenseKeys=<value> Semicolon-separated list of licenses keys the installer will add to BuildMaster's license list. Only used if Edition is LicenseKey.
/TargetPath=<value> Root path where BuildMaster will be installed. The default is [SysDrive]:\BuildMaster.
/WebAppPath=<value> Path where the BuildMaster web application is installed. The default is [TargetPath]\WebApp.
/ServicePath=<value> Path where the BuildMaster service is installed. The default is [TargetPath]\Service.
/Extensions=<value> Path where the extension library is located. The default is [TargetPath]\Extensions.
/Artifacts=<value> Path where the artifact library is located. The default is [TargetPath]\Artifacts.
/WebTempPath=<value> Root path of the directory used by the BuildMaster web application for temporary files. The default is [TargetPath]\_WEBTMP.
/ServiceTempPath=<value> Root path of the directory used by the BuildMaster service for temporary files. The default is [TargetPath]\_SVCTMP.
/ConnectionString=<value> SQL Server connection string BuildMaster will use to connect to the database. The default is Data Source=localhost; Initial Catalog=BuildMaster; Integrated Security=True;.
/Port=<value> Port number the BuildMaster web application will listen to. The default is 81.
/UseIntegratedWebServer=<value> When true, the integrated web server is used to host BuildMaster; when false, IIS is used. The default is true.
/WebServerPrefixes=<value> Prefixes used by the integrated web server. The default is http://*:[Port]/.
/InstallSqlExpress Installs a SQL Express 2005 instance named BuildMaster if it is included in the installer package. The default is false.
/UserAccount=<value> User account of the BuildMaster service and web application. The default is LocalSystem.
/Password=<value> Password of the user account of the BuildMaster service and web application. Only used when UserAccount is not one of the standard service accounts.
/WebAppUserAccount=<value> User account of the BuildMaster web application. The default is [UserAccount].
/WebAppUserAccountPassword=<value> Password of the user account of the BuildMaster web application. The default is [Password].
/ServiceUserAccount=<value> User account of the BuildMaster service. The default is [UserAccount].
/ServiceUserAccountPassword=<value> Password of the user account of the BuildMaster service. The default is [Password].
/ConfigureIIS Creates an IIS website and application pool to host the BuildMaster web application. The default is false.
/LogFile=<value> If specified, writes out a detailed log file of the installation process to the specified path value.

Example

Install BuildMaster using the defalt settings with license key XXXXX:

BuildMasterSetup.exe /S /LicenseKeys=XXXXX

Silent Upgrade Options

/S Required for a silent upgrade. If this is not specified, the UI will be displayed.
/Upgrade Required to perform an upgrade. If this is not specified, the upgrade is not performed.
/BackupDatabase Backs up the BuildMaster database before the upgrade begins. The default is true.
/DatabaseBackupPath=<value> The path to save the backup of the BuildMaster database. The default is [SysDrive]:\BuildMaster\Backups.
/ConnectionString=<value> SQL connection string used for upgrading BuildMaster's database schema. The default is whatever connection string the BuildMaster service is currently using.
/LogFile=<value> If specified, writes out a detailed log file of the installation process to the specified path value.

Example

Upgrade BuildMaster using the default settings:

BuildMasterSetup.exe /S /Upgrade

Agent Silent Install Options

/S Required for a silent install. If this is not specified, the UI will be displayed.
/AgentType=<value> The desired agent type edition: May be IIS or TCP.
/TargetPath=<value> Root path where the agent will be installed. The default is [SysDrive]:\BuildMasterAgent.
/BinPath=<value> Path where the Agent binaries are installed. The default is [TargetPath]\Agent.
/ExtensionsPath=<value> Path where the agent stores its extensions. The default is [TargetPath]\AgentExtensions.
/TempPath=<value> Root path of the directory used by the BuildMaster agent for temporary files. The default is [TargetPath]\_AGTTMP.
/Port=<value> Port number the BuildMaster agent will listen to. The default is 81.
/UserAccount=<value> User account of the BuildMaster agent. The default is LocalSystem.
/Password=<value> Password of the user account of the BuildMaster agent. Only used when UserAccount is not one of the standard service accounts.
/SecurityToken=<value> Security token which BuildMaster instances must use to connect to this agent. No security token is required if this is not specified.
/Clients=<value> Semicolon-separated list of client IP addresses which are allowed to connect to the agent. Any client may connect if this is not specified.
/ServiceName=<value> The name of the Windows Service that will be installed. The default is INEDOBMAGT.

Example

Install a TCP agent using the defalt settings that listens on port 8080:

BuildMasterAgentSetup.exe /S /AgentType=TCP /Port=8080