静默安装

Incredibuild 静默安装下，您可以使用命令行安装 Incredibuild 组件。如果要在多台机器上安装 Incredibuild，或者不希望用户知道 Incredibuild 的安装，这种类型的安装将特别有用。

可以使用 Incredibuild 设置向导生成一个 Automated Installer 文件，并使用下面指定的语法运行该文件。

生成 Silent Installer

  1. 运行 Incredibuild 设置文件。

  2. 在 Setup Options 页面，选择 Create Automated Installer 并单击 Save As。


运行 Automated Installer

  1. 作为 Administrator 运行 CMD。

  2. 在 CMD 上，前往含有之前生成的 Automated Installer 文件的目录。

  3. 根据您想要安装的组件和下列语法，输入所需的安装命令和选项。请注意，每个命令只能安装一个组件。

    IBSetupConsole.exe /Install /Components={Component Name} 
/Coordinator={Coordinator IP Address/Hostname} 
[General Options] [Component Options]

其中:

  • Components [必选] 可以是下列之一： Agent、Coordinator、 Agent、oneuse。其中，oneuse 选项用于一次性虚拟机镜像。

  • Coordinator – 相关 Coordinator 的 IP 地址或主机名。安装 Agent 和 Backup Coordinator 时必选。
    如果 Coordinator 不使用默认端口号 (31104)，则应将端口添加至 Coordinator 名称并将它们放到引号中，格式为："Coordinator_Name:Port_No."。例如，"192.100.00.01:12345"。

  • General Options [可选] – 可以添加到所有安装命令中的通用安装选项。见下文。

  • Component Options [可选] – 每个安装组件特有的安装选项。

例如，使用 Automated Installer 安装 Agent

在 CMD 中输入以下命令，以在本地机器上安装 Agent。此 Agent 将与 Coordinator 通信，其主机名为 "Win10-1"：

IBSetupConsole.exe /Install /Components=Agent /Coordinator=Win10-1

通用选项

下列选项可添加至所有安装命令中：

通用选项 描述 默认值

/AddToPath={ON|OFF}

 控制是否将 Incredibuild 安装文件夹添加至系统搜索路径。 ON

/InstallDir={Install dir path}

 允许手动指定 Incredibuild 安装文件夹。 C:\Program Files (x86)\Incredibuild

用 Automated Installer 安装 Incredibuild 组件

用 Automated Installer 安装 Agent

用 Automated Installer 安装 Agent 时使用的语法如下所示：

IBSetupConsole.exe /Install /Components=Agent 
/Coordinator={Coordinator IP Address/Hostname} 
[General Options] [Agent Options]

下列选项可添加至 Agent 安装中：

Agent 选项 描述 默认值

/Agent:AutoSelectPorts={ON|OFF}

 控制设置是否应为 Agent Service 和 Helper 内核自动选择第一个可用的 TCP/IP 端口。如果此选项为 ON，则将覆盖任何手动指定的端口。 OFF
/Agent:FILECACHE={Number in MBs} 允许手动指定 Agent 文件缓存文件夹的最大尺寸（以 MB 为单位）。 4096

/Agent:Group={Build Group name}

 （仅用于 Enterprise Edition）通过输入所需 Build Group 的名称作为 {Group name} 的值，允许将 Agent 分配给特定 Build Group。有关更多信息，请参阅：将 Agent 分配给 Build Group。 默认 Build Group

/Agent:HelperPort={Port no.}

 允许手动指定 Initiator 和 Helper 内核之间通信所需的 Agent Helper 端口。此手动指定仅在 /Agent:AutoSelectPorts 选项为 OFF 的情况下生效。 31106

/Agent:InstallAddins={ON|OFF}

 控制安装程序是否也应在 Visual Studio IDE 中安装 Incredibuild Add-in/Extension。 ON

/Agent:OpenFirewall={ON|OFF}

 控制设置是否应在 Windows Firewall 中打开 Agent 端口。 ON

/Agent:ServicePort={Port no.}

 允许手动指定与 Coordinator 通信所需的 Incredibuild Agent Service 端口。此手动指定仅在 /Agent:AutoSelectPorts 选项为 OFF 的情况下生效。 31105

例如，用特定 Agent 选项安装 Agent。

输入以下命令在本地机器上安装 Agent。此 Agent 将与 Coordinator 通信，其主机名为 "Win10-1"。最大文件缓存大小将为 4500 MB。Agent 将分配给 "Dev" Build Group。

IBSetupConsole.exe /Install /Components=Agent /Coordinator=Win10-1  
/Agent:FileCache=4500 /Agent:Group=Dev

用 Automated Installer 安装主 Coordinator

用 Automated Installer 安装主 Coordinator 时使用的语法如下所示：

IBSetupConsole.exe /Install /Components=Coordinator 
[General Options] [Coordinator Options]

下列选项可添加至 Coordinator 安装中：

Coordinator 选项 描述 默认值

/Coord:OpenFirewall={ON|OFF}

 控制设置是否应在 Windows Firewall 中打开 Coordinator 服务端口。 ON

/Coord:ServicePort={Port no.}

 允许手动指定 Agent Communications 端口。 31104

用 Automated Installer 安装主 Coordinator 和 Agent

用 Automated Installer 安装 Agent 和主 Coordinator 时使用的语法如下所示：

IBSetupConsole.exe /Install /Components=Coordinator 
/Coordinator={Primary Coordinator IP Address/Hostname} 
[General Options] [Agent Options][Coordinator Options]
IBSetupConsole.exe /Install /Components=Agent 
/Coordinator={Primary Coordinator IP Address/Hostname} 
[General Options] [Agent Options][Coordinator Options]

用 Automated Installer 安装主 Backup Coordinator

Backup Coordinator 是在主 Coordinator 故障或不可用时接管主 Coordinator 关键功能的程序。Backup Coordinator 使分布式处理继续进行，而不受影响。在与主 Coordinator 连接的机器上安装 Backup Coordinator。

用 Automated Installer 安装备用 Coordinator 时使用的语法如下所示：

IBSetupConsole.exe /Install /Components=Coordinator /Coord:Backup 
/Coordinator={Primary Coordinator IP Address/Hostname} 
[General Options] [Coordinator Options]

注：可添加至此命令的 Coordinator 选项与主 Coordinator 的选项相同。

用 Automated Installer 安装带有一次性虚拟机许可证的 Agent

（仅适用于 Enterprise Edition）用 Automated Installer 安装带有一次性虚拟机许可证的 Agent 时使用的语法如下所示：

IBSetupConsole.exe /Install /Components=Agent,oneuse 
/Coordinator={Coordinator IP Address/Hostname} 
[General Options] [Agent Options] [Coordinator Options]

卸载 Incredibuild，升级至新版本或修复现有安装

如要静默卸载 Incredibuild，升级至新软件版本或修复现有安装，可运行 Automated Installer 和相应的命令行选项：

> 如要卸载 Incredibuild： 

IBSetupConsole /uninstall

> 如要更新 Incredibuild： 

IBSetupConsole /update

> 如要修复 Incredibuild 安装： 

IBSetupConsole /repair