更新时间:2022-02-21 GMT+08:00

安装ICAgent

ICAgent状态说明详见下表。

表1 ICAgent状态

状态

说明

运行

该主机ICAgent运行正常。

未安装

该主机未安装ICAgent。安装ICAgent,详细操作请参见安装ICAgent

安装中

正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右,请耐心等待。

安装失败

该主机ICAgent安装失败,请登录服务器卸载后重新安装。

升级中

正在升级该主机ICAgent。升级ICAgent预计需要1分钟左右,请耐心等待。

升级失败

该主机ICAgent升级失败。请登录服务器卸载后重新安装。

离线

输入的AK/SK错误导致该主机ICAgent功能异常。请获取正确的AK/SK后重新安装。

异常

该主机ICAgent功能异常,请联系技术人员处理。

安装前提

ICAgent是采集代理,在进行ICAgent安装前,需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器,则要保证本地浏览器、多个服务器的时区、时间都一致。否则,可能会导致安装后不能在界面上准确查看应用的拓扑、调用链等数据。

安装方式说明

ICAgent有两种安装方式,您可以按照您的场景进行选择。您需要注意的是,下述两种安装方式,都不适用于容器节点(通过ServiceStage、AOS、CCE创建的集群容器节点),容器节点要使用APM,根据应用的部署方式进行操作。安装方式见表2

表2 安装方式

方式

适用场景

首次安装

当满足以下条件时,您需要按照该方式安装:

  1. 服务器已经绑定弹性IP。
  2. 该服务器上未安装过ICAgent。

继承安装

当满足以下条件时,您需要按照该方式安装:

您有多个服务器需要安装ICAgent,其中一个服务器绑定了EIP,而剩余的没有绑定EIP。其中一个服务器已经通过首次安装方式装好了ICAgent,对于没有绑定EIP的服务器,您可以采用该安装方式。

首次安装

申请服务器后,首次安装ICAgent,需执行如下操作:

  1. 获取AK/SK。

    • 若您已在云获取过AK/SK,请跳过该步骤。
    • 若您未在云获取过AK/SK,请参考如何获取AK/SK

  2. 登录应用性能管理
  3. 在左侧导航栏中选择“采集管理 >Agent管理”。
  4. 单击“安装ICAgent”。
  5. 生成ICAgent安装命令,并复制该命令。

    1. 在文本框中输入已获取的AK/SK,生成ICAgent安装命令。

      请确保以上参数输入正确,否则将无法安装ICAgent。

    2. 单击“复制命令”。

  6. 使用PuTTY等远程登录工具,以root用户登录待安装ICAgent的服务器,执行步骤5.b复制到的安装命令进行安装。

    • 当显示“ICAgent install success”时,表示安装成功,ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后,在应用性能管理左侧导航栏中选择“采集管理 > Agent管理”,查看该服务器ICAgent状态。
    • 安装失败,请参考卸载ICAgent章节的卸载ICAgent后重新安装,如果还未安装成功,请联系技术工程师。

继承安装

当您已有服务器安装过ICAgent,且该服务器“/opt/ICAgent/”路径下ICAgent安装包ICProbeAgent.zip存在,通过该方式可对远端服务器进行一键式继承安装。

  1. 在已安装ICAgent的服务器上执行如下命令,其中x.x.x.x表示服务器IP地址。

    bash /opt/oss/servicemgr/ICAgent/bin/remoteInstall/remote_install.sh -ip x.x.x.x

  2. 根据提示输入待安装ICAgent的服务器root用户密码。

    • 如果已安装ICAgent的服务器安装过expect工具,执行上述命令后,即可完成安装。如果已安装ICAgent的服务器未安装expect工具,请根据提示输入,进行安装。
    • 请确保已安装ICAgent的服务器可以使用root用户执行SSH、SCP命令,来与待安装ICAgent的服务器进行远端通信。
    • 当显示“ICAgent install success”时,表示安装成功,ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后,在应用性能管理左侧导航栏中选择“采集管理 > Agent管理”,查看该服务器ICAgent状态。
    • 安装失败,请参考卸载ICAgent章节的卸载ICAgent后重新安装,如果还未安装成功,请联系技术工程师。

继承批量安装

当您已有服务器安装过ICAgent,且该服务器“/opt/ICAgent/”路径下ICAgent安装包ICProbeAgent.zip存在,通过该方式可对多个远端服务器进行一键式继承批量安装。

  1. 批量安装的ECS需和已安装成功的节点保持网络互通,scp、ssh命令可用。
  2. 批量安装脚本依赖python版本,建议在python2.x版本的机器上执行此操作,python3.x版本不支持。

前提条件

已收集需要安装Agent的所有虚拟机IP、密码,按照iplist.cfg格式整理好,并上传到已安装过ICAgent机器的/opt/ICAgent/目录下。iplist.cfg格式示例如下所示,IP与密码之间用空格隔开:

192.168.0.109 密码(请根据实际填写)

192.168.0.39 密码(请根据实际填写)

  • iplist.cfg中包含您的敏感信息,建议您使用完之后清理一下。
  • 如果所有弹性云服务器的密码一致,iplist.cfg中只需列出IP,无需填写密码,在执行时输入此密码即可;如果某个IP密码与其他不一致,则需在此IP后填写其密码。
  • 批量安装功能依赖python2.7.*版本,如果安装时提示找不到python请安装python版本后重试。

操作步骤

  1. 在已安装ICAgent的服务器上执行如下命令。

    bash /opt/oss/servicemgr/ICAgent/bin/remoteInstall/remote_install.sh -batchModeConfig /opt/ICAgent/iplist.cfg

    根据脚本提示输入待安装机器的root用户默认密码,如果所有IP的密码在iplist.cfg中已有配置,则直接输入回车键跳过即可,否则请输入默认密码。

    batch install begin
    Please input default passwd:
    send cmd to 192.168.0.109
    send cmd to 192.168.0.39
    2 tasks running, please wait...
    2 tasks running, please wait...
    2 tasks running, please wait...
    End of install agent: 192.168.0.39
    End of install agent: 192.168.0.109
    All hosts install icagent finish.

    请耐心等待,当提示All hosts install icagent finish.时,则表示配置文件中的所有主机安装操作已完成。

  2. 安装完成后,在应用性能管理左侧导航栏中选择“采集管理 > Agent管理”,查看该服务器ICAgent状态。