云助手客户端是为ECS实例执行云助手命令的代理程序。本文提供安装、升级、停止以及启动云助手客户端的操作指示。

通过下载链接安装客户端

说明
  • 2017年12月01日之后使用公共镜像创建的ECS实例,默认预装云助手客户端。如果您的实例是2017年12月01日之前购买的,若需要使用云助手相关功能,请自行安装云助手客户端。
  • 使用自定义镜像或者云市场镜像创建的ECS实例,请参见云助手查询您的实例规格以及操作系统是否能使用云助手服务,再自行安装客户端。

Windows实例以下步骤安装客户端。

  1. 远程连接Windows实例
  2. 下载云助手客户端
  3. 双击客户端文件,根据安装向导完成安装。
    说明 如果您选择默认安装路径,则客户端在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\
  4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区

Linux实例需要根据您的操作系统,选择下列安装方式的其中一种。

  • RPM包安装,适合CentOS、RHEL和SUSE Linux等操作系统:
    1. 远程连接Linux实例
    2. 运行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm下载云助手客户端rpm包
    3. 运行rpm -ivh aliyun_assist.rpm安装云助手客户端。
    4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
  • deb包安装,适合Debian和Ubuntu等操作系统:
    1. 远程连接Linux实例。
    2. 运行wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.deb下载云助手客户端deb包。
    3. 运行dpkg -i aliyun_assist.deb安装云助手客户端。
    4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
  • 源码编译安装:
    1. 远程连接Linux实例。
    2. 运行git clone https://github.com/aliyun/aliyun_assist_client下载云助手客户端源码。
    3. 进入源码存放目录。
    4. 运行cmake .生成编译文件。
      说明 若编译时报错CMAKE_MINIMUM_REQUIRED,请前往CMake官网升级CMake服务至3.1及以上版本。
    5. 运行make开始编译。
    6. 运行./cmake_install.sh安装云助手客户端。
    7. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区
说明 如果您选择默认安装路径,则客户端在Linux实例中的安装目录为:
  • CoreOS操作系统:/opt/local/share/aliyun-assist/
  • 其他操作系统(Ubuntu、Debian、Red Hat、SUSE Linux Enterprise Server、OpenSUSE和Aliyun Linux等):/usr/local/share/aliyun-assist/

通过阿里云CLI安装客户端

前提条件

  • 本示例在命令行工具中完成,请确保您已经安装了阿里云命令行工具CLI。如何获取和安装阿里云CLI,请参见阿里云命令行工具CLI
  • 已获取地域ID,示例命令中需要填写。详细的地域ID,请参见地域和可用区

操作步骤

  1. 调用DescribeCloudAssistantStatus查询目标ECS实例是否安装了云助手客户端。
    aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp --output cols=CloudAssistantStatus
    当返回CloudAssistantStatus=true结果时,表示您的ECS实例已安装云助手客户端。否则请继续进入下一步。
  2. 调用InstallCloudAssistant为ECS实例安装云助手客户端。
    aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8ogXXXXXXp
  3. 调用RebootInstance重启目标ECS实例。
    aliyun ecs RebootInstance --RegionId TheRegionId --InstanceId i-bp1g6zv0ce8ogXXXXXXp
  4. (仅经典网络类型实例)在云助手的安装目录下创建名为region-id的文件,在文件中填入ECS实例所属地域的ID,例如cn-hangzhou。更多取值请参见地域和可用区

升级客户端

云助手客户端每隔一个小时会运行升级资源检测进程,该进程程序所在路径为:

  • Windows实例:C:\ProgramData\aliyun\assist\${version}/aliyun_assist_update
  • Linux实例:/usr/local/share/aliyun-assist/${version}/aliyun_assist_update
自动升级失效时,您可以创建升级命令CreateCommand),定期执行。以RPM安装包为例,以下云助手命令可以升级云助手客户端:
wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm
rpm -U aliyun_assist.rpm

禁止升级客户端

云助手客户端升级进程默认自启动,您也可以禁用该服务:

  • Windows实例:在命令提示符窗口CMD中运行rename aliyun_assist_update
  • Linux实例:运行chmod a-x aliyun_assist_update

停止或启动客户端

Windows实例

  1. 远程连接Windows实例
  2. 选择计算机管理 > 服务和应用程序 > 服务,并找到AliyunService
    警告 AliyunService是云助手客户端服务的运行名称,停止AliyunService相当于停止云助手客户端,这可能会导致ECS实例异常,并无法在ECS管理控制台停止运行中的ECS实例。建议您谨慎停止云助手客户端。
  3. 单击停止此服务或者重启动此服务
    重启动此服务

Linux实例

  1. 远程连接Linux实例
  2. 运行以下命令检查云助手客户端的版本。
    aliyun-service -v
    说明 对于高于1.0.1.308版本的云助手客户端,不再使用agentwatch管理云助手客户端服务。因此,您需要根据返回的云助手客户端版本号决定如何停止或者启动云助手客户端。
  3. 根据返回的云助手客户端版本选择操作方式。
    • 对于1.0.1.308及更低版本的云助手客户端,请根据ECS实例的init系统选择以下命令停止云助手客户端服务。
      • Debian、CentOS和Red Hat等操作系统:
        #停止云助手客户端
        systemctl stop agentwatch
        #启动云助手客户端
        systemctl start agentwatch
      • 使用其他init系统的操作系统:
        #停止云助手客户端
        chkconfig agentwatch off
        #启动云助手客户端
        chkconfig agentwatch on
    • 对于高于1.0.1.308版本的云助手客户端,请根据ECS实例的init系统选择以下命令停止云助手客户端服务。
      • 采用新版本内核的Linux系统通常使用systemd初始化进程服务,操作如下:
        #查询您的ECS实例是否使用systemd初始化进程服务,有返回信息则表示使用的是systemd
        strings /sbin/init | grep "/lib/system"
        #停止云助手客户端
        systemctl stop aliyun.service
        #启动云助手客户端
        systemctl start aliyun.service
      • 对于Ubuntu14及更低版本的Linux系统,通常使用UpStart初始化进程服务,操作如下:
        #查询您的ECS实例是否使用UpStart初始化进程服务,有返回信息则表示使用的是UpStart
        strings /sbin/init | grep "upstart"
        #停止云助手客户端
        /sbin/initctl stop aliyun-service
        #启动云助手客户端
        /sbin/initctl start aliyun-service
      • 采用低版本内核的Linux系统通常使用sysvinit初始化进程服务,操作如下:
        #查询您的ECS实例是否使用sysvinit初始化进程服务,有返回信息则表示使用的是sysvinit
        strings /sbin/init | grep "sysvinit"
        #停止云助手客户端
        /etc/init.d/aliyun-service stop
        #启动云助手客户端
        /etc/init.d/aliyun-service start

相关链接