配置云助手客户端

通过下载链接安装客户端

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。更多取值请参见地域和可用区。

通过阿里云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

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

相关链接

• 云助手客户端代码完全开源，您可以访问阿里云Github仓库参与开源计划
• 云助手
• InvokeCommand
• 云助手自动化部署实践