从命令行安装代理程序

从命令行安装代理程序时,涉及运行批处理文件或 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 通信,请参阅远程安装代理进程)。

每个代理程序必须至少具有执行以下操作的许可权:

过程

  1. 将代理程序安装程序下载到要安装代理程序的计算机并将其解压:
    • 要从服务器下载安装程序,请单击页面右上角的帮助 按钮,然后单击工具。接着单击 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 并继续执行安装。
  2. 在下载并解压安装软件包后,打开安装程序目录。
  3. 从此目录中,运行 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 会自动识别代理程序;您不需要执行进一步的操作就可以开始使用代理程序。

反馈