安装ICAgent（区域外主机）

前提条件

安装ICAgent前，请确保本地浏览器的时间、时区与主机的时间、时区一致。如果不一致，可能会导致日志上报出错。

安装方式说明

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

首次安装（Linux环境）

1. 在云日志服务管理控制台，左侧导航栏选择“主机管理 > 主机”，进入“主机”页面。
2. “主机类型”选择“区域外主机”。
3. “安装系统”选择“Linux”。
4. 设置网络连通性方式。区域外主机将日志上报到当前区域LTS的网络通路，建议您优先选择专线，更稳定可靠。
   • 若选择“公网”，直接从6开始执行。
   • 若选择“专线”，需要从5开始执行。

5. 选择“连通LTS后端方式”，在专线连通场景下，默认区域外主机与当前区域LTS网络不通，安装在区域外主机上的ICAgent无法直接访问华为云管理面上报日志的网段。因此需要配置网络打通方案，使用跳板机或VPCEP的方式去连通LTS。
   • 选择“连通LTS后端方式”为“VPCEP”时：
     配置VPCEP域名。请您在华为云网络工程师的协助下，在区域外云上配置VPCEP的DNS域名解析规则，将VPCEP的域名解析到指定IP。配置完成后，在“安装ICAgent”页面根据界面提示复制命令：

     ping {VPCEP域名}

     选择一台待采集日志的主机，执行该命令。如果能ping通，表示网络配置连通。跳转到6开始执行。

   • 选择“连通LTS后端方式”为“跳板机”时：
     1. 创建Linux操作系统的ECS弹性云服务器作为跳板机。

        登录弹性云服务器控制台，创建一个Linux操作系统的ECS。创建ECS的具体步骤，请参考购买弹性云服务器。如果您已有符合条件ECS，可直接使用作为跳板机，不需要再次创建。

        

        • 推荐CentOS 6.5 64bit及其以上版本的镜像， 最低规格为1vCPUs | 1GB，推荐规格为2vCPUs | 4GB。
        • 如果跳板机使用公网与区域外主机互通，那么需要开通EIP；如果跳板机使用云专线VPC对等连接方式与区域外主机互通，那么不需要开通EIP。
        • 跳板机的区域要与LTS当前Region一致。
     2. 添加跳板机ECS使用的安全组规则，开放入方向对应端口，保证区域外主机到跳板机数据连通。
        1. 登录弹性云服务器控制台，查看弹性云服务器列表，找到作为跳板机的弹性云服务器。
        2. 单击跳板机名称进入ECS详情，单击安全组名称，进入安全组详情页。
        3. 在该安全组详情页，选择“入方向规则”页签，单击“添加规则 ”。请按照表2设置端口，更多参数可根据业务网络需求填写。详情请参考添加安全组规则。

           表2 安全组规则

           策略	协议	端口	说明
           允许	TCP	8149,8102,8923,30200,30201,80	ICAgent发送数据到跳板机的端口列表，保证非本区域主机到跳板机ECS的数据连通性。

     3. 返回弹性云服务器列表，找到5.a中作为跳板机的弹性云服务器，可以获取私有IP及弹性公网IP（如跳板机开通EIP，此处会显示弹性公网IP）。
     4. 返回云日志服务控制台，在“安装ICAgent”页面中输入获取到的跳板机私有IP，生成跳板机转发命令。
        

        跳板机私有IP是指VPC内网IP。

     5. 在“安装ICAgent”页面单击“复制命令”，复制SSH Tunnel转发命令。

        ssh -f -N -L {跳板机私有IP}:8149:{LTS上报IP}:8149 -L {跳板机私有IP}:8102:{LTS上报IP}:8102 -L {跳板机私有IP}:8923:{LTS上报IP}:8923 -L {跳板机私有IP}:30200:{LTS上报IP}:30200 -L {跳板机私有IP}:30201:{LTS上报IP}:30201 -L {跳板机私有IP}:80:icagent-{region}.{obs_domain}:80 {跳板机私有IP}

     6. 以root用户名密码登录跳板机，执行复制的SSH Tunnel转发命令。
     7. 执行netstat -lnp | grep ssh命令查看对应端口是否被侦听，如果返回结果如图1所示，说明TCP端口已开通。
        图1 TCP端口验证结果
        
        

        如果跳板机ECS掉电重启，请重新执行netstat -lnp | grep ssh命令。

     8. 在“安装ICAgent”页面，填写DC和跳板机连接IP。
        • DC：自定义主机节点所属数据中心名称，便于分类查看主机。由数字、大小写字母、中划线、下划线组成，并且最多不超过64个字符。

          跳板机连接IP：如果跳板机使用EIP方式连通区域外主机，此处填写跳板机弹性IP；如果跳板机与区域外主机使用云专线VPC对等连接方式，此处填写跳板机VPC内网IP，即私有IP。弹性IP和私有IP的查看可参考5.c。

6. 获取AK/SK。详细请参考如何获取访问密钥AK/SK。在“安装ICAgent”页面，复制ICAgent安装命令时需要替换AK/SK。
7. 使用PuTTY等远程登录工具，以root用户登录待安装ICAgent的区域外主机，执行ICAgent安装命令进行安装。

   当显示“ICAgent install success”时，表示安装成功，ICAgent已安装在了/opt/oss/servicemgr/目录。安装成功后，在云日志服务左侧导航栏中选择“主机管理 > 主机”，查看该服务器中ICAgent的状态。

   

   如果安装失败，请卸载ICAgent后重新安装，如果还未安装成功，请联系技术支持。

首次安装（Windows环境）

1. 在云日志服务管理控制台，左侧导航栏选择“主机管理 > 主机”，进入“主机”页面。
2. “主机类型”选择“区域外主机”。
3. “安装系统”选择“Windows”。
4. 设置“网络连通性方式”。区域外主机将日志上报到LTS的网络通路（公网或专线），建议您优先选择专线，更稳定可靠。
   • 若选择“公网”，直接从6开始执行。
   • 若选择“专线”，需要从5开始执行。

5. 选择“连通LTS后端方式”，在专线连通场景下，默认区域外主机与当前区域LTS网络不通，安装在区域外主机上的ICAgent无法直接访问华为云管理面上报日志的网段。因此需要配置网络打通方案，使用跳板机或VPCEP的方式去连通LTS。
   • 选择“连通LTS后端方式”为“VPCEP”时：
     配置VPCEP域名。请您在华为云网络工程师的协助下，在区域外云上配置VPCEP的DNS域名解析规则，将VPCEP的域名解析到指定IP。配置完成后，在“安装ICAgent”页面根据界面提示复制命令：

     ping {VPCEP域名}

     选择一台待采集日志的主机，执行该命令。如果能ping通，表示网络配置连通。跳转到7开始执行。

   • 选择“连通LTS后端方式”为“跳板机”时：
     1. 创建Linux操作系统的ECS弹性云服务器作为跳板机。

        登录弹性云服务器控制台，创建一个Linux操作系统的ECS。创建ECS的具体步骤，请参考购买弹性云服务器。如果您已有符合条件ECS，可直接使用作为跳板机，不需要再次创建。

        

        • 推荐CentOS 6.5 64bit及其以上版本的镜像， 最低规格为1vCPUs | 1GB，推荐规格为2vCPUs | 4GB。
        • 如果跳板机使用公网与区域外主机互通，那么需要开通EIP；如果跳板机使用云专线VPC对等连接方式与区域外主机互通，那么不需要开通EIP。
        • 跳板机的区域要与LTS当前Region一致。
     2. 添加跳板机ECS使用的安全组规则，开放入方向对应端口，保证区域外主机到跳板机数据连通。
        1. 登录弹性云服务器控制台，查看弹性云服务器列表，找到作为跳板机的弹性云服务器。
        2. 单击跳板机名称进入ECS详情，单击安全组名称，进入安全组详情页。
        3. 在该安全组详情页，选择“入方向规则”页签，单击“添加规则 ”。请按照表3设置端口，更多参数可根据业务网络需求填写。详情请参考添加安全组规则。

           表3 安全组规则

           策略	协议	端口	说明
           允许	TCP	8149,8102,8923,30200,30201,80	ICAgent发送数据到跳板机的端口列表，保证非本区域主机到跳板机ECS的数据连通性。

     3. 返回弹性云服务器列表，找到5.a中作为跳板机的弹性云服务器，可以查看到私有IP及弹性公网IP（如跳板机开通EIP，此处会显示弹性公网IP）。
     4. 返回云日志服务控制台，在“安装ICAgent”页面中输入获取到的跳板机私有IP，生成跳板机转发命令。
        

        跳板机私有IP是指VPC内网IP。

     5. 在“安装ICAgent”页面单击“复制命令”，复制SSH Tunnel转发命令。

        ssh -f -N -L {跳板机私有IP}:8149:{LTS上报IP}:8149 -L {跳板机私有IP}:8102:{LTS上报IP}:8102 -L {跳板机私有IP}:8923:{LTS上报IP}:8923 -L {跳板机私有IP}:30200:{LTS上报IP}:30200 -L {跳板机私有IP}:30201:{LTS上报IP}:30201 -L {跳板机私有IP}:80:icagent-{region}.{obs_domain}:80 {跳板机私有IP}

     6. 以root用户登录跳板机，执行复制的SSH Tunnel转发命令。
     7. 执行netstat -lnp | grep ssh命令查看对应端口是否被侦听，如果返回结果如图2所示，说明TCP端口已开通。
        图2 TCP端口验证开通结果
        
        

        如果跳板机ECS掉电重启，请重新执行如上命令。

6. 通过“安装ICAgent”页面提示链接，下载ICAgent安装包。
7. 将ICAgent安装包存放到Windows主机目录（如：C:\ICAgent）并解压。
8. 获取AK/SK并保存好，复制ICAgent安装命令时需要替换AK/SK。详细请参考如何获取访问密钥AK/SK。

   如果选择“连通LTS后端方式”为“跳板机”时，那么此处还要填写跳板机连接IP。

   跳板机连接IP：如果跳板机使用EIP方式连通区域外主机，此处填写跳板机弹性IP；如果跳板机与区域外主机使用云专线VPC对等连接方式，此处填写跳板机VPC内网IP，即私有IP。弹性IP和私有IP的查看可参考5.c。

9. 在“安装ICAgent”页面，单击“复制命令”，复制ICAgent安装命令。
10. 登录Windows主机，打开cmd窗口并进入ICAgent安装包的解压目录，执行ICAgent安装命令进行安装。

    当显示“Service icagent installed successfully”时，表示安装成功。安装成功后，在云日志服务控制台左侧导航栏中选择“主机管理 > 主机”，查看ICAgent状态。

    

    如果安装失败，请卸载ICAgent后重新安装，如果还未安装成功，请联系技术支持。

创建多台跳板机通过ELB进行负载均衡

单跳板机可能发生单点故障带来运维的不稳定性，此时可以创建多个跳板机并通过ELB负载均衡将流量分摊到不同的跳板机上，提高接入的可靠性。

1. 创建Linux操作系统的ECS弹性云服务器作为跳板机。

   登录弹性云服务器控制台，创建一个Linux操作系统的ECS。创建ECS的具体步骤，请参考购买弹性云服务器。如果您已有符合条件ECS，可直接使用作为跳板机，不需要再次创建。

   

   • 推荐CentOS 6.5 64bit及其以上版本的镜像， 最低规格为1vCPUs | 1GB，推荐规格为2vCPUs | 4GB。
   • 如果跳板机使用公网与区域外主机互通，那么需要开通EIP；如果跳板机使用云专线VPC对等连接方式与区域外主机互通，那么不需要开通EIP。
   • 跳板机的区域要与LTS当前Region一致。

2. 添加跳板机ECS使用的安全组规则，开放入方向对应端口，保证区域外主机到跳板机数据连通。
   1. 登录弹性云服务器控制台，查看弹性云服务器列表，找到作为跳板机的弹性云服务器。
   2. 单击跳板机名称进入ECS详情，单击安全组名称，进入安全组详情页。
   3. 在该安全组详情页，选择“入方向规则”页签，单击“添加规则 ”。请按照表4设置端口，更多参数可根据业务网络需求填写。详情请参考添加安全组规则。

      表4 安全组规则

      策略	协议	端口	说明
      允许	TCP	8149,8102,8923,30200,30201,80	ICAgent发送数据到跳板机的端口列表，保证非本区域主机到跳板机ECS的数据连通性。

3. 返回弹性云服务器列表，找到1中作为跳板机的弹性云服务器，可以查看到私有IP及弹性IP（如跳板机开通EIP，此处会显示弹性IP）。
4. 登录云日志服务控制台，在左侧导航栏选择“主机管理 ”，单击“安装ICAgent”，在“安装ICAgent”页面中输入跳板机私有IP，生成跳板机转发命令。
   

   跳板机私有IP是指VPC内网IP。

5. 在“安装ICAgent”页面单击“复制命令”，复制SSH Tunnel转发命令。

   ssh -f -N -L {跳板机私有IP}:8149:{LTS上报IP}:8149 -L {跳板机私有IP}:8102:{LTS上报IP}:8102 -L {跳板机私有IP}:8923:{LTS上报IP}:8923 -L {跳板机私有IP}:30200:{LTS上报IP}:30200 -L {跳板机私有IP}:30201:{LTS上报IP}:30201 -L {跳板机私有IP}:80:icagent-{region}.{obs_domain}:80 {跳板机私有IP}

6. 以root用户登录跳板机，执行复制的SSH Tunnel转发命令。

7. 重复以上步骤创建多个跳板机，并且将多个跳板机放入同一个VPC中。即在创建弹性云服务器，进行网络配置时，选择同一个虚拟私有云。
8. 登录弹性负载均衡控制台，创建弹性负载均衡ELB。具体请参见创建弹性负载均衡，在创建时需注意以下几点。
   1. 创建ELB，在网络配置时，选择与跳板机ECS相同的VPC。
   2. 新建弹性公网IP，ELB的弹性公网IP将作为跳板机连接IP。
   3. 带宽根据业务量申请，并进行适配。

9. 分别为TCP的端口30200、30201、8149、8923、8102、80添加监听器。具体请参见添加TCP监听器。
10. 创建一个后端服务器组，并将所有的跳板机放置在同一个后端服务器组，具体请参见添加后端云服务器。
11. 返回云日志服务控制台，在“安装ICAgent”页面，将ELB的弹性公网IP填写到“跳板机连接IP”中，复制安装命令，在对应区域外主机上执行即可。

继承安装（Linux环境）

您有多个服务器需要安装ICAgent，其中一个服务器已经通过首次安装方式装好了ICAgent，且该服务器“/opt/ICAgent/”路径下存在ICAgent的安装包ICProbeAgent.tar.gz，对于没有安装ICAgent的服务器，可以通过该方式对服务器进行一键式继承安装。

1. 在已安装ICAgent的服务器上执行如下命令，其中x.x.x.x表示待安装ICAgent服务器的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后重新安装，如果还未安装成功，请联系技术支持。
3. 当显示“ICAgent install success”时，表示安装成功，ICAgent已安装在了“/opt/oss/servicemgr/”目录。安装成功后，在云日志服务左侧导航栏中选择主机管理 > 主机”，查看该服务器ICAgent的状态。

继承批量安装（Linux环境）

您有多个服务器需要安装ICAgent，其中一个服务器已经通过首次安装方式装好了ICAgent，且该服务器“/opt/ICAgent/”路径下存在ICAgent的安装包ICProbeAgent.tar.gz，对于没有安装ICAgent的服务器，可以通过该方式对服务器进行一键式继承批量安装。

• 批量安装的服务器需同属一个VPC下，并在同一个网段中。
• 批量安装功能依赖python3.*版本，如果安装时提示找不到python请在服务器上安装python版本后重试。