安装ICAgent（区域外主机）

前提条件

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

使用限制

• Linux环境：ICAgent安装支持的Linux操作系统。
• Windows环境：仅支持在如下64位系统的Windows环境中安装ICAgent。

  Windows Server 2016 R2 Datacenter
  Windows Server 2016 R2 Standard
  Windows Server 2016 Datacenter English
  Windows Server 2016 R2 Standard English
  
  Windows Server 2012 R2 Datacenter
  Windows Server 2012 R2 Standard
  Windows Server 2012 Datacenter English
  Windows Server 2012 R2 Standard English
  
  Windows Server 2008 R2 Enterprise
  Windows Server 2008 R2 Standard
  Windows Server 2008 Enterprise English
  Windows Server 2008 R2 Standard English

  Windows环境不支持在云日志服务主机管理界面对ICAgent进行升级和卸载操作，只支持日志采集功能。如果需要使用新版本，请先卸载旧版本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）。
        图1 获取私有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掉电重启，请重新执行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）。
        图3 复制私有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命令查看对应端口是否被侦听，如果返回结果如图4所示，说明TCP端口已开通。
        图4 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）。
   图5 复制私有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版本后重试。