静默安装
Incredibuild 静默安装下,您可以使用命令行安装 Incredibuild 组件。如果要在多台机器上安装 Incredibuild,或者不希望用户知道 Incredibuild 的安装,这种类型的安装将特别有用。
可以使用 Incredibuild 设置向导生成一个 Automated Installer 文件,并使用下面指定的语法运行该文件。
运行 Automated Installer
运行 Automated Installer
注意: 自动安装程序必须以管理员身份从 CMD 运行。
自动安装程序使用以下一般语法:
IBSetupConsole.exe /Install /Components={Component Name(s) - Comma Separated} /Coordinator={Coordinator IP Address/Hostname} [General Options] [Agent and Coordinator Options]
参数 | 描述 | 默认值 |
---|---|---|
标记 | ||
/Install | 这个标志将行动定义为安装。要卸载、修复或更新,请参见以下章节。 | |
/Components |
定义您要安装哪些组件。可以是Agent、Coordinator 或 Agent 和 Coordinator 两个同时安装。 |
|
/Coordinator |
相关 Coordinator 的 IP 地址或主机名。安装 Agent 和 Backup Coordinator 时必选。 |
|
/Coord:Backup | 使用这个标志表示您要安装的 Coordinator 是一个备份 Coordinator。 | |
/help | 查看使用信息和完整的标志列表 | |
通用选项 | ||
/AddToPath={ON|OFF} | 控制是否将 Incredibuild 安装文件夹添加至系统搜索路径。 | ON |
/InstallDir={Install dir path} | 允许手动指定 Incredibuild 安装文件夹。 | C:\Program Files (x86)\Incredibuild |
Agent 选项 |
||
/Agent:AutoSelectPorts={ON|OFF} |
控制设置是否应为 Agent Service 和 Helper 内核自动选择第一个可用的 TCP/IP 端口。如果此选项为 ON,则将覆盖任何手动指定的端口。 限制性: 该选项要求您手动打开所有需要的端口 。当使用 /Agent:OpenFirewall 标志时,不支持使用 /Agent:AutoSelectPorts 标志。 |
OFF |
/Agent:FILECACHE={Number in MBs} | 允许手动指定 Agent 文件缓存文件夹的最大尺寸(以 MB 为单位)。 | 4096 |
/Agent:Group={Build Group name} |
在安装过程中将 Agent 分配至 Build Group。如果您指定的名称不存在,将创建 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 端口。 限制性: 此选项不应该与 /Agent:AutoSelectPorts 一起使用。在这种情况下,Incredibuild 并不知道哪些端口是需要的,您需要手动打开防火墙上所有需要的端口 。 |
ON |
/Agent:ServicePort={Port no.} |
允许手动指定与 Coordinator 通信所需的 Incredibuild Agent Service 端口。此手动指定仅在 /Agent:AutoSelectPorts 选项为 OFF 的情况下生效。 | 31105 |
/Agent:AgentRole={Helper/Initiator/Helper,Initiator} |
表示 Agent 许可证的类型。 |
|
/Agent:InitiatorType={Fixed/Floating} |
定义启动器的许可类型。 |
Fixed |
/Agent:HelperType={Fixed/Floating} |
定义 helper 的许可类型。 |
Fixed |
/Agent:HelperCores={#|%} |
限制 agent 可用于协助工作负载分配的核心数量。可以用实际的核数或总核数的百分比来指定。 |
|
/Agent:Description |
|
|
/Agent:SSLKey="{path to .key file}" |
如果您正在使用 SSL,则为应用于 Agent 上的密钥路径。 |
|
/Agent:SSLCer="{path to .crt file}" |
如果您正在使用 SSL,则为应用于 Agent 上的证书路径。 |
|
/Agent:BuildCache |
向 Initiator Agent 分配 Build Cache 许可证。 |
|
/Agent:DbLocation="{path}" |
用于 Build Cache 的数据库。如果未指定,则默认数据库将在安装过程中自动安装在每个 Initiator 上。或者,您可以指定任何 Redis 数据库位置。如果数据库需要证书,可在 Agent Settings > Build Cache 中指定。 |
|
/Agent:CacheDirectoryLocation="{path}" |
文件夹位置将包含 Build Cache 文件。如果文件夹需要证书,可在 Agent Settings > Build Cache 中指定。 |
|
/Agent:MaxFileCacheSize={#} |
Build Cache 文件夹的最大大小。 |
|
Coordinator 选项 |
||
/COORD:USERNAME={user name} |
访问 Coordinator 的用户名(8 个字符长)。需要清洁的安装文件(不是修复)。 |
|
/COORD:PASSWORD={password} |
访问 Coordinator 的密码。需要清洁的安装文件(不是修复)。 |
|
/Coord:OpenFirewall={ON|OFF} |
控制设置是否应在 Windows Firewall 中打开 Coordinator 服务端口。 | ON |
/Coord:DatabaseDir |
Coordinator 数据库目录。 | |
/Coord:ServicePort={Port no.} |
定义 Agent 通信端口的值。 | 31104 |
/Coord:InterfacePort={Port no.} |
定义 Coordinator 用户界面端口的值。 | 8000 |
/Coord:CoordApiPort={Port no.} |
定义 Coordinator 服务端口的值。 | 31100 |
/License:OpenFirewall={ON|OFF} |
控制设置是否应在 Windows Firewall 中打开 Agent 端口。 | ON |
/License:ServicePort={Port no.} |
允许手动指定许可服务端口。这是与许可证服务进行通信的必要条件。 | 50052 |
/COORD:SSLKey="{path to .key file}" |
如果您正在使用 SSL,则为应用于 Coordinator 上的密钥路径。 |
|
/COORD:SSLCer="{path to .crt file}" |
如果您正在使用 SSL,则为应用于 Coordinator 上的证书路径。 |
|
示例
仅限安装 Coordinator
{path}\ibsetup_console.exe /install /Components=Coordinator /COORD:USERNAME={user name} /COORD:PASSWORD={password}
安装 Agent 和 Coordinator
注意: 如果您使用同一命令安装 Agent 和 Coordinator,则不能在同一命令中为 Agent 分配许可证。
示例 1
IBSetupConsole.exe /Install /Components=Coordinator,Agent /Coordinator={coord name}:31104 [General Options] /COORD:USERNAME={user name} /COORD:PASSWORD={password}
示例 2
{path}\ibsetup_console.exe /install /Components=Coordinator,Agent /ADDTOPATH=ON /COORD:USERNAME={user name} /COORD:PASSWORD={password} /AGENT:SERVICEPORT=25000 /AGENT:HELPERPORT=25001 /COORD:SERVICEPORT=25002
只安装 Agent
注意: 如果您在安装命令中分配一个许可证,请确保协调员中的许可证是可用的。
Helper Fixed
{path}\ibsetup_console.exe /install /Components=agent /Agent:AgentRole=Helper /Agent:HelperType=Fixed /Agent:HelperCores=4 /COORDINATOR={coord name}:31104
Helper Fixed 百分比
{path}\ibsetup_console.exe /install /Components=agent /Agent:AgentRole=Helper /Agent:HelperType=Fixed /Agent:HelperCores=25% /COORDINATOR={coord name}:31104
安装 Agent Helper Floating
{path}\ibsetup_console.exe /install /Components=agent /Agent:AgentRole=Helper /Agent:HelperType=Floating /Agent:HelperCores=4 /COORDINATOR={coord Name}:31104
仅安装 Agent 的 Initiator Fixed
{path}\ibsetup_console.exe /install /Components=agent /Agent:AgentRole=Initiator /Agent:InitiatorType=Fixed /COORDINATOR={coord name}:31104
卸载 Incredibuild,升级至新版本或修复现有安装
如要静默卸载 Incredibuild,升级至新软件版本或修复现有安装,可运行 Automated Installer 和相应的命令行选项:
> 如要卸载 Incredibuild:
IBSetupConsole.exe /uninstall
> 如要更新 Incredibuild:
IBSetupConsole.exe /update
> 如要修复 Incredibuild 安装:
IBSetupConsole.exe /repair