# 安装ICAgent（Linux） #### 前提条件 ICAgent是采集代理，在进行ICAgent安装前，需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器，则要保证本地浏览器、多个服务器的时区、时间都一致。否则，可能会导致安装后不能在界面上准确查看应用的拓扑、调用链等数据。 #### 安装方式说明 ICAgent有两种安装方式，您可以按照您的场景进行选择。您需要注意的是，下述两种安装方式，都不适用于容器节点（通过ServiceStage、AOS、CCE创建的集群容器节点），容器节点要使用APM，可参考[快速入门](https://support.huaweicloud.com/qs-apm/apm_00_0002.html)根据应用的部署方式进行操作。安装方式见[表1]： 表1安装方式 | 方式 | 适用场景 | |:---|:---| | 首次安装 | 当满足以下条件时，您需要按照该方式安装： 1. 服务器已经绑定了EIP。绑定EIP的详细操作请参见[为弹性云服务器申请和绑定弹性IP](https://support.huaweicloud.com/qs-eip/eip_qs_0001.html)。 2. 该服务器上未安装过ICAgent。 | | 继承安装 | 当满足以下条件时，您需要按照该方式安装： 您有多个服务器需要安装ICAgent，其中一个服务器绑定了EIP，而剩余的没有绑定EIP。其中一个服务器已经通过首次安装方式装好了ICAgent，对于没有绑定EIP的服务器，您可以采用该安装方式。 | #### 首次安装 您在华为云上申请服务器后，在Linux环境下安装ICAgent，需执行如下操作： 1. 获取AK/SK，通过如下两种方式获取AK/SK： - 通过创建委托获取临时AK/SK。 ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/note_3.0-zh-cn.png) 安装ICAgent的每个ECS节点需要在弹性云服务器界面上绑定已创建的委托，5分钟后委托生效。 - 通过新增访问密钥获取永久AK/SK。 2. 在左侧导航栏中选择"采集管理 \> Agent管理"。 3. 单击"安装ICAgent"，选择"主机类型"为"华为云主机"、"安装系统"为"Linux"。 4. 生成ICAgent安装命令，并复制该命令。 - 如[图1]所示，如果您已获取永久AK/SK，选择"安装方式"为"获取AK/SK凭证"，请在文本框中输入已获取的AK/SK，生成ICAgent安装命令。单击"复制命令"，复制ICAgent安装命令。 图1输入AK/SK凭证 ![](https://support.huaweicloud.com/usermanual-apm/zh-cn_image_0175105969.png) ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/note_3.0-zh-cn.png) 请确保输入正确的AK/SK，否则将无法安装ICAgent。 - 如果您已通过创建委托获取临时AK/SK，选择"安装方式"为"创建IAM委托"，单击"复制命令"，复制ICAgent安装命令。 5. 使用远程登录工具，以**root** 用户登录待安装ICAgent的服务器，执行ICAgent安装命令进行安装。 ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/note_3.0-zh-cn.png) - 当显示"ICAgent install success"时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后，在应用性能管理左侧导航栏中选择"采集管理 \> Agent管理"，查看该服务器ICAgent状态。 - 安装失败，请参考卸载ICAgent章节的[卸载ICAgent（Linux）](https://support.huaweicloud.com/usermanual-apm/apm_02_0015.html)后重新安装，如果还未安装成功，请联系华为云工程师。 #### 继承安装 当您已有服务器安装过ICAgent，且该服务器"/opt/ICAgent/"路径下ICAgent安装包**ICProbeAgent.tar.gz**存在，通过该方式可对远端服务器进行一键式继承安装。 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用户密码。 ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/note_3.0-zh-cn.png) - 如果已安装ICAgent的服务器安装过expect工具，执行上述命令后，即可完成安装。如果已安装ICAgent的服务器未安装expect工具，请根据提示输入，进行安装。 - 请确保已安装ICAgent的服务器可以使用root用户执行SSH、SCP命令，来与待安装ICAgent的服务器进行远端通信。 - 当显示"ICAgent install success"时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后，在应用性能管理左侧导航栏中选择"采集管理 \> Agent管理"，查看该服务器ICAgent状态。 - 安装失败，请参考卸载ICAgent章节的[卸载ICAgent（Linux）](https://support.huaweicloud.com/usermanual-apm/apm_02_0015.html)后重新安装，如果还未安装成功，请联系华为云工程师。 #### 继承批量安装 当您已有服务器安装过ICAgent，且该服务器"/opt/ICAgent/"路径下ICAgent安装包**ICProbeAgent.tar.gz**存在，通过该方式可对多个远端服务器进行一键式继承批量安装。 ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/notice_3.0-zh-cn.png) 1. 批量安装的ECS需和已安装成功的节点保持网络互通，scp、ssh命令可用。 2. 如果已安装的服务器使用了委托方式安装，其它批量安装的节点也需要设置委托。 3. 批量安装脚本依赖python版本，建议在python2.x版本的机器上执行此操作，python3.x版本不支持。 **前提条件** 已收集需要安装Agent的所有虚拟机IP、密码，按照iplist.cfg格式整理好，并上传到已安装过ICAgent机器的/opt/ICAgent/目录下。iplist.cfg格式示例如下所示，IP与密码之间用空格隔开： *192.168.0.109 密码（请根据实际填写）* *192.168.0.39 密码（请根据实际填写）* ![](https://support.huaweicloud.com/usermanual-apm/public_sys-resources/note_3.0-zh-cn.png) - 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状态。 #### ICAgent状态 ICAgent状态说明详见下表。 表2ICAgent状态 | 状态 | 说明 | |:---|:---| | 运行 | 该主机ICAgent运行正常。 | | 未安装 | 该主机未安装ICAgent。安装ICAgent，详细操作请参见[安装ICAgent（Linux）](https://support.huaweicloud.com/usermanual-apm/apm_02_0013.html)。 | | 安装中 | 正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右，请耐心等待。 | | 安装失败 | 该主机ICAgent安装失败，请[登录服务器卸载](https://support.huaweicloud.com/usermanual-apm/apm_02_0015.html#apm_02_0015__s3b88a85d5fc54597bdb601e26408a808)后重新安装。 | | 升级中 | 正在升级该主机ICAgent。升级ICAgent预计需要1分钟左右，请耐心等待。 | | 升级失败 | 该主机ICAgent升级失败。请[登录服务器卸载](https://support.huaweicloud.com/usermanual-apm/apm_02_0015.html#apm_02_0015__s3b88a85d5fc54597bdb601e26408a808)后重新安装。 | | 离线 | 输入的AK/SK错误或ECS委托设置错误导致该主机ICAgent功能异常。请获取正确的AK/SK或正确设置ECS委托。 | | 异常 | 该主机ICAgent功能异常，请联系技术支持。 |