代理程序中继设备是位于防火墙后面或另一网络位置的代理程序的通信代理。
关于此任务
当服务器与远程代理程序之间至少有一个低带宽 WAN 连接时,IBM UrbanCode Deploy 服务器可以通过中继设备将工作发送到其他地理位置的代理程序。代理程序中继设备要求远程网络中只有单个服务器与该服务器联系。其他远程代理程序通过使用代理程序中继设备与服务器通信。远程网络中所有代理程序与服务器的通信都通过中继设备进行。
过程
- 将代理程序中继设备安装程序下载到要安装代理程序中继设备的计算机并将其解压:
- 要从服务器下载安装程序,请单击页面右上角的帮助
按钮,然后单击工具。接着单击 IBM UrbanCode Deploy 代理程序中继设备,然后下载并解压文件。
- 要使用命令行在服务器上查找安装程序,请转至以下位置并将文件复制到目标系统:installation_folder/opt/tomcat/webapps/ROOT/tools/agent-relay.zip
- 将压缩的安装文件解压。
- 从解压的 agent-relay-install 目录中,运行
install.cmd 脚本 (Windows) 或 install.sh 文件(Linux 或 UNIX)。
- 安装程序会提示您输入以下信息。 可以通过按 Enter 键接受缺省值(显示在方括号内)。如果给出了两个选项(例如,Y/n),那么大写的选项是缺省值。
- Please enter the directory where you would like to install the agent relay.
- 输入该中继设备的目录。如果输入现有目录,那么程序会提示您升级该中继设备。有关升级的信息,请参阅升级 IBM UrbanCode Deploy。
- Please enter your java home
- 指定 Java 的安装目录。确保 JAVA_HOME 环境变量指向此目录。
- Enter the name of this relay.
- 输入代理程序中继设备的名称。每个中继设备都必须具有唯一名称。缺省名称为 agent-relay。
- Enter the IP or hostname which this Agent Relay should use.
- 输入中继设备将侦听的 IP 地址或主机名。在大多数情况下,代理程序将侦听可供计算机使用的所有
IP 地址;在这种情况下,请指定 0.0.0.0。
- Enter the port which this Agent Relay should proxy HTTP requests on.
- 输入代理程序中继设备在侦听来自代理程序的 HTTP 请求时使用的端口。缺省值为 20080。
- Enter the port which this Agent Relay should use for communication.
- 输入代理程序中继设备用于与远程代理程序进行基于 JMS 的通信的端口。缺省值为 7916。
- Connect the agent relay to a central server?
- 指定是否要将中继设备连接至 IBM UrbanCode Deploy 服务器。
- Enter the IP or hostname of your central server.
- 如果您指示了要将中继设备连接至服务器,请指定中继设备可以联系的服务器的 IP 或主机名。如果中继设备要连接至集群服务器,请指定负载均衡器的主机名。如果您指定主机名,请确保中继设备计算机可以通过 DNS 将该主机名解析为 IP 地址。
- Enter the port which the central server uses for communication.
- 如果您指示了要将中继设备连接至服务器,请输入服务器用来与代理程序通信的端口。缺省值为 7918。
- Use mutual authentication between the agent, relay and server.
- 如果需要相互认证,请输入 Y。有关激活相互认证的信息,请参阅 SSL 配置。
- Cache files on the relay which have been downloaded by
any connected agents?
- 如果您想要在代理程序中继设备上高速缓存文件,请输入
Y。
- What user would you like to use to run the agent relay?
- 在 Linux 或 UNIX 系统上,请指定运行代理程序中继设备的用户。
- What group would you like to use to run the agent relay?
- 在 Linux 或 UNIX 系统上,请指定要与代理程序中继设备相关联的组。
- Install the Agent Relay as Windows service?
- 如果要在 Windows 上安装中继设备,那么可以将其安装为 Windows 服务。缺省值为 N。
下一步做什么
如果必须修改中继设备,那么可以在
relay_installation\conf 目录的
agentrelay.properties 文件中编辑这些属性。
要启动代理程序中继设备,请转至中继设备的安装文件夹并运行以下命令:
bin/agentrelay start