从命令行安装代理程序时,涉及运行批处理文件或 shell 脚本以及指定关于代理程序如何连接至服务器的信息。
开始之前
对于生产环境,请在安装了代理程序的系统上创建专用于运行代理程序的用户帐户。
请确保要安装代理程序的每台计算机都具有 Java™ Runtime
Environment (JRE) 或 Java Development
Kit (JDK) V7 或更高版本。
如果目标计算机具有
IBM® JRE 或 JDK,请将 JRE 或 JDK 更新为具有指定的服务刷新 (SR) 级别或更高服务刷新级别的 V7.0.0 SR4:
关于此任务
可以从 IBM UrbanCode Deploy Web 应用程序直接安装 UNIX
系统上运行的代理程序,请参阅远程安装代理进程。
为了进行简单评估,管理用户可以在服务器所在的系统上运行代理程序。但如果计划在若干系统上运行部署,请在每个系统上安装单独的代理程序。例如,如果测试环境由三个系统组成,请在每个系统上安装一个代理程序。对应用程序使用的每个环境执行相同的过程。
每个代理程序都需要相应的权限才能与 IBM UrbanCode Deploy 服务器通信(如果代理程序通过代理程序中继设备与 IBM UrbanCode Deploy 通信,请参阅远程安装代理进程)。
每个代理程序必须至少具有执行以下操作的许可权:
- 创建高速缓存。缺省情况下,该高速缓存位于运行代理程序的用户的主目录中。可以移动或禁用该高速缓存。
- 打开 TCP 连接。代理程序使用 TCP 连接来与服务器的 JMS 端口通信。
- 打开 HTTP(S) 连接。代理程序必须能够连接至 IBM UrbanCode Deploy
用户界面,才能从代码站存储库下载工件。
- 访问文件系统。许多代理程序需要对文件系统上的项具有读/写许可权。
过程
- 将代理程序安装程序下载到要安装代理程序的计算机并将其解压:
- 要从服务器下载安装程序,请单击页面右上角的帮助
按钮,然后单击工具。接着单击 IBM UrbanCode Deploy 代理程序,然后下载并解压文件。
- 要使用命令行在服务器上查找安装程序,请转至以下位置并将文件复制到目标系统:installation_folder/opt/tomcat/webapps/ROOT/tools/ibm-ucd-agent.zip
注: 如果要在
z/OS® 上安装代理程序,那么必须先将安装软件包中若干文本类型文件的字符编码转换为
IBM-1047 编码,然后才能使用这些文件。将安装文件解压并将以下文件转换为 IBM-1047 编码:
- install-agent.sh
- install.with.groovy.xml
- opt/apache-ant-1.8.4/bin/ant
- opt/apache-ant-1.8.4/bin/antRun
- opt/groovy-1.8.8/bin/groovy
- opt/groovy-1.8.8/bin/startGroovy
- install/AgentInstaller.groovy
要转
换文件,请在命令提示符处发出类似以下文本的命令:
iconv -f UTF-8 -t IBM-1047 filename >filename.bac
mv filename.bac filename
在转换这些文件后,将安装文件移至
z/OS 并继续执行安装。
- 在下载并解压安装软件包后,打开安装程序目录。
- 从此目录中,运行 install-agent.bat (Windows) 或 install-agent.sh(UNIX 或 Linux)。
注: 如果将代理程序安装为 Windows 服务,那么用户帐户必须具有以下特权:
- SE_INCREASE_QUOTA_NAME“调整进程的内存配额”
- SE_ASSIGNPRIMARYTOKEN_NAME“替换进程级别标记”
- SE_INTERACTIVE_LOGON_NAME“在本地登录”
将显示 IBM UrbanCode Deploy 代理程序安装程序,并且该安装程序会提示您提供以下信息。可以通过按 Enter 键接受缺省值(显示在方括号内)。如果给出了两个选项(例如,Y/n),那么大写的选项是缺省值。- Enter the directory where agent should be installed.
- 例如:C:\Program Files\IBM\UCDeploy-agent (Windows) 或 /opt/IBM/ibm-ucd/agent (UNIX)。如果该目录不存在,请输入
Y 以指示安装程序为您创建该目录。如果输入现有目录,那么程序会提供用于升级代理程序的选项。有关升级的信息,请参阅升级 IBM UrbanCode Deploy。
注: 请不要使用任何 shell 扩充字符或缩写词,例如,颚化音字符 (~)。
- Please enter the home directory of the JRE/JDK used to run the agent.
- 如果已安装 Java,那么 IBM UrbanCode Deploy 会将
Java 位置作为缺省值提出。要接受缺省值,请按 Enter 键,否则请覆盖缺省值并输入正确路径。
- Will the agent connect to a agent relay instead of directly to the server?
- 缺省值为 N。如果指定 Y,那么安装程序会提示您配置以下参数:
- hostname or address of the agent relay the agent will connect to
- 输入代理程序中继设备的主机名或 IP 地址。提供安装代理程序中继设备时使用的值。
- agent communication port for the agent relay
- 输入代理程序用于与代理程序中继设备进行基于 JMS 的通信的端口。缺省值为 7916。
- HTTP proxy port for the agent relay
- 输入代理程序用于与代理程序中继设备进行 HTTP 通信的端口。缺省值为 20080。
注: 当第一个中继设备失败时,您可以指定另外的中继设备进行使用。通过添加其他中继设备到
/agent-install/conf/agent/installed.properties
文件的 locked/agent.brokerUrl=failover\: 参数,
配置故障转移中继设备。中继设备配置语法为
agent_IP_or_hostname\:JMS_port。
中继设备之间用逗号隔开。以下示例显示对于两个中继设备的参数配置:
locked/agent.brokerUrl=failover\:(ah3\://relay1\:7916,ah3\://relay2\:7916)。
假定所有中继设备使用同一 HTTP 代理端口。首先,参数包含代理程序安装期间所配置的
中继设备的位置。
- Enter the host name or address of the server the agent will connect to.
- 缺省值为 localhost。如果代理程序要连接至集群服务器,请指定负载均衡器的主机名。
- Enter the agent communication port for the server
- 缺省值为 7918。
- Does the server agent communication use mutual authentication with SSL?
- 缺省值为 N。
如果使用 SSL,还请为服务器打开
SSL,否则代理程序将无法连接至服务器。如果要使用相互认证,那么此要求也适用。如果更改代理程序通信的端口号,那么必须在安装代理程序时提供这些端口号。
- Enter the name for this agent.
- 输入唯一名称。服务器使用此名称来识别此代理程序。名称不能超过 256 个字符并且无法更改。
- Enter teams to add this agent to, separated by commas.
- 缺省值为 NONE。
可以在代理程序首次连接至服务器时将代理程序添加到团队。代理程序首次连接至服务器时,将分配给指定的团队。请用逗号分隔多个团队;将忽略尾随空格。还将忽略不存在团队名称。
- Do you want to install the Agent as Windows service?
- (仅限于 Windows)。缺省值为 N。已安装为服务时,IBM UrbanCode Deploy 仅捕获
PATH 变量的值。将始终使用安装期间捕获的值,即使您以后更改这些值也是如此。对于新近的
Windows 版本,必须以管理员身份运行命令。
下一步做什么
按
正在启动代理程序中所述启动代理程序。如果正确配置了代理程序,那么
IBM UrbanCode Deploy 会自动识别代理程序;您不需要执行进一步的操作就可以开始使用代理程序。