本文导读

展开导读

文档首页/ 应用运维管理 AOM/ 用户指南（安卡拉区域）/ 用户指南/ 采集管理/ 安装ICAgent

安装ICAgent

更新时间：2024-04-15 GMT+08:00

ICAgent状态说明详见下表。

表1 ICAgent状态
状态	说明
运行	该主机ICAgent运行正常。
未安装	该主机未安装ICAgent。安装ICAgent，详细操作请参见安装ICAgent。
安装中	正在为该主机安装ICAgent。安装ICAgent预计需要1分钟左右，请耐心等待。
安装失败	该主机ICAgent安装失败，请登录服务器卸载后重新安装。
升级中	正在升级该主机ICAgent。升级ICAgent预计需要1分钟左右，请耐心等待。
升级失败	该主机ICAgent升级失败。请登录服务器卸载后重新安装。
离线	输入的AK/SK错误导致该主机ICAgent功能异常。请获取正确的AK/SK后重新安装。
异常	该主机ICAgent功能异常，请联系技术人员处理。
受限	AOM服务的License受限，需要用户查看License使用情况，并及时更新。

安装前提

在进行ICAgent安装前，需要先确保本地浏览器时间与服务器时区、时间都一致。若有多个服务器，则要保证本地浏览器、多个服务器的时区、时间都一致。否则，可能会导致安装后不能在界面上准确查看应用、服务器的指标数据。

安装方式说明

ICAgent有两种安装方式，您可以按照您的场景进行选择。

安装方式见表2：

表2 安装方式
方式	适用场景
首次安装	当满足以下条件时，您需要按照该方式安装：服务器已经绑定了EIP（弹性公网IP）。该服务器上未安装过ICAgent。
继承安装	当满足以下条件时，您需要按照该方式安装：您有多个服务器需要安装ICAgent，其中一个服务器绑定了EIP，而剩余的没有绑定EIP。绑定EIP的服务器已经通过首次安装方式装好了ICAgent，对于没有绑定EIP的服务器，您可以采用该安装方式。

首次安装

您申请服务器后，首次安装ICAgent，需执行如下操作：

获取AK/SK。请获取并使用公共用户账号的AK/SK，请勿使用个人账号的AK/SK。

须知：

请确保公共用户账号及其创建的AK/SK不会被删除或禁用。AK/SK被删除，会导致安装的ICAgent无法正常上报数据到AOM/LTS。
- 若您已获取过AK/SK，请跳过该步骤。
- 若您未获取过AK/SK，请获取AK/SK。
在菜单栏选择“采集管理”，进入“Agent管理”界面。
在页面右侧的下拉列表中选择“其他: 用户自定义接入主机”，单击“安装ICAgent”。
单击“复制命令” 复制安装命令。
使用PuTTY等远程登录工具，以root用户登录待安装ICAgent的服务器，执行以下命令，在安装前关闭历史记录。

set +o history
执行4复制的安装命令，并根据提示输入1获取的AK/SK。
安装完成后，执行以下命令，开启历史记录。

set -o history

说明：

当显示“ICAgent install success.”时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后，在“Agent管理”界面，选择“其他: 用户自定义接入主机”，查看该服务器ICAgent状态。
安装失败，请参考卸载ICAgent章节的登录服务器卸载后重新安装，如果还未安装成功，请联系技术工程师。

继承安装

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

须知：

升级ICAgent后，“/opt/ICAgent/”路径及保存在该路径下的文件均被删除，请重新安装ICAgent后，再执行继承安装操作。

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

bash /opt/oss/servicemgr/ICAgent/bin/remoteInstall/remote_install.sh -ip x.x.x.x
根据提示输入待安装ICAgent的服务器root用户密码。
说明：
- 如果已安装ICAgent的服务器安装过expect工具，执行上述命令后，即可完成安装。如果已安装ICAgent的服务器未安装expect工具，请根据提示输入，进行安装。
- 请确保已安装ICAgent的服务器可以使用root用户执行SSH、SCP命令，来与待安装ICAgent的服务器进行远端通信。
- 请确保ICProbeAgent.tar.gz完整传输到待安装服务器。
- 当显示“ICAgent install success”时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后，在“Agent管理”界面，选择“其他: 用户自定义接入主机”，查看该服务器ICAgent状态。
- 安装失败，请参考卸载ICAgent章节的登录服务器卸载后重新安装，如果还未安装成功，请联系技术工程师。

继承批量安装

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

须知：

批量安装的ECS需和已安装成功的节点保持网络互通，scp、ssh命令可用。
如果已安装的服务器使用了委托方式安装，其它批量安装的节点也需要设置委托。
批量安装脚本依赖python版本，建议在python2.x版本的机器上执行此操作，python3.x版本不支持。
iplist.cfg文件中每一行应以回车作为结尾。
升级ICAgent后，“/opt/ICAgent/”路径及保存在该路径下的文件均被删除，请重新安装ICAgent后，再执行继承批量安装操作。

前提条件

已收集需要安装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版本后重试。

操作步骤

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

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

根据脚本提示输入待安装机器的root用户默认密码，如果所有IP的密码在iplist.cfg中已有配置，则直接输入回车键跳过即可，否则请输入默认密码。
```
batch install begin
start to install python pexpect module
use local pyexpect package
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.时，则表示配置文件中的所有主机安装操作已完成。
安装完成后，在“Agent管理”界面，选择“其他: 用户自定义接入主机”，查看该服务器ICAgent状态。

父主题： 采集管理

上一篇：采集管理

下一篇：升级ICAgent

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消