The cloud assistant client is an agent that facilitates cloud assistant command invocation on ECS instances. The cloud assistant client does not perform any operations. Instead, the cloud assistant client allows you to start all operations on ECS instances under your account. By default, instances created later than Dec 1, 2017 are pre-installed with the cloud assistant client. If an ECS instance was created earlier than Dec 1, 2017 and you want to use cloud assistant service, you can install the cloud assistant client manually. This topic describes how to install, update, and disable the cloud assistant client in an ECS instance.

Install cloud assistant client

Windows

  1. Connect to a Windows instance.
  2. Download the cloud assistant client.
  3. Double-click the client file and follow the instructions to install the client.

Linux

Based on the distribution of Linux, to install cloud assistant client, select the required method from the following installation options.

  • Install the RPM package:

    1. Connect to a Linux instance by using a password.
    2. Run wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.rpm to download the RPM package of the cloud assistant client.
    3. Run rpm -ivh aliyun_assist.rpm  to install the cloud assistant client.
  • Install the DEB package:

    1. Connect to your Linux instance.
    2. Run wget https://repo-aliyun-assist.oss-cn-beijing.aliyuncs.com/download/aliyun_assist.deb to download the DEB package of the cloud assistant client.
    3. Run dpkg -i aliyun_assist.deb to install the cloud assistant client.
  • Install with the compilation file of source code:

    1. Connect to your Linux instance.
    2. Run git clone https://github.com/aliyun/aliyun_assist_client to download the cloud assistant client source code.
    3. Enter the source code directory.
    4. Run cmake . to generate the compilation file.
    5. Run make to start compilation.
    6. Run cmake_install.sh  to install the cloud assistant client.

Update the cloud assistant client

The update process of the cloud assistant client runs one time every hour to query update resources for the client. Depending on the OS installed in your instance, the update process is located at the following directory:

  • Windows instance: C:\ProgramData\aliyun\assist\${version}/aliyun_assist_update

  • Linux instance: /usr/local/share/aliyun-assist/${version}/aliyun_assist_update

Generally, the update process is one of the startup items in the instance. However, you can disable the update process as follows:

  • Windows instance: Run rename aliyun_assist_update in CMD or PowerShell.

  • Linux instance: Run chmod a-x aliyun_assist_update.

Disable the cloud assistant client

Note The cloud assistant client is managed by the Aliyun service. If you disable the client, the Aliyun service is also disabled, which means stopping an instance in the ECS console may fail. Exercise caution before performing this action.

Windows instance

  1. Connect to a Windows instance.
  2. Select Computer Management > Services and Applications > ServicesAliyunService
  3. Click Stop the service.

Linux instance

  1. Connect to a Linux instance by using a password.
  2. Run the following commands to disable the cloud assistant client.
    
    systemctl stop agentwatch
    chkconfig agentwatch off

What to do next

You can visit the GitHub aliyun_assist_client to explore the open source stack of cloud assistant.

You can also use the cloud assistant client for the following actions: