Elastic Compute Service:Install Cloud Assistant Agent on an ECS instance

Use RPM packages

This installation method is applicable to Linux operating systems, such as Alibaba Cloud Linux, CentOS, RHEL, and SUSE Linux.

1. Connect to a Linux instance as a user with sudo permissions.

   For more information, see Connection method overview.

2. Download the RPM package for Cloud Assistant Agent.

   Cloud Assistant Agent version		Download command
   Public URL for the latest version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"
   Public URL for a specific version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"
   Internal URL for the latest version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"
   Internal URL for a specific version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"

   Note

   • {version} indicates the version number of Cloud Assistant Agent.

   • {regionId} indicates the region ID of the instance on which you want to install Cloud Assistant Agent.

     To query the region in which an instance resides, click the ID of the instance on the instance list page in the ECS console and view the value of the Region parameter in the Basic Information section of the Instance Details page. Then, you can query the ID of the region in the Regions and zones topic.

   • You can specify the following version numbers of Cloud Assistant Agent to download Cloud Assistant Agent from public or internal URLs:

     • Version numbers that can be specified in public URLs:

       • x86 architecture: 1.0.1.413, 1.0.1.414, 1.0.1.448, 1.0.1.450, 1.0.2.458, 1.0.2.479, 1.0.2.541, 1.0.2.569, 1.0.2.574, 2.2.0.102, 2.2.0.106, 2.2.2.181, 2.2.3.187, 2.2.3.221, 2.2.3.247, 2.2.3.256, 2.2.3.269, 2.2.3.282, 2.2.3.289, 2.2.3.326, 2.2.3.349, 2.2.3.372, and 2.2.3.398

       • ARM architecture: 2.4.3.282, 2.4.3.326, 2.4.3.349, 2.4.3.372, and 2.4.3.398

     • Version numbers that can be specified in internal URLs:

       • x86 architecture: 1.0.1.407, 1.0.2.458, 1.0.2.479, 2.2.3.221, 2.2.3.247, 2.2.3.256, 2.2.3.265, 2.2.3.269, 2.2.3.282, 2.2.3.289, 2.2.3.326, 2.2.3.349, 2.2.3.372, and 2.2.3.398

       • ARM architecture: 2.4.3.282, 2.4.3.326, 2.4.3.349, 2.4.3.372, and 2.4.3.398

   For example, to download the RPM package for x86 version 1.0.2.458 of Cloud Assistant Agent in the China (Hangzhou) region, access the following internal URL:

   sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"

3. Install Cloud Assistant Agent.

   By default, Cloud Assistant Agent is installed in one of the following directories on Linux instances:

   • Default installation directory for CoreOS operating systems: /opt/local/share/aliyun-assist/

   • Default installation directory for other operating systems (such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE): /usr/local/share/aliyun-assist/

   To install the latest version of Cloud Assistant Agent on an instance, run one of the following commands based on the operating system architecture of the instance:

   • x86

     sudo rpm -ivh --force aliyun_assist_latest.rpm

   • ARM

     sudo rpm -ivh --force aliyun-assist-latest-1.aarch64.rpm

4. Perform operations based on the operating system or network type of the instance.

   • If the instance runs a Red Hat operating system, perform the following operations:

     1. Stop the qemu-ga service.

        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent

     2. Restart Cloud Assistant.

        sudo systemctl restart aliyun.service

   • If the instance resides in the classic network, perform the following operations:

     In the directory where Cloud Assistant Agent is installed, create a file named region-id and enter the region ID of the instance in the file. For example, to create the region-id file in the default installation directory and enter the region ID of the instance on which Cloud Assistant Agent is installed in the file, run one of the following commands based on the operating system of the instance:

     • CoreOS operating systems:

       sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

     • Other Linux operating systems, such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE:

       sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

     If the sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id command is run, a command output similar to the following one is returned.

Use DEB packages

This installation method is applicable to Linux operating systems such as Debian and Ubuntu.

1. Connect to a Linux instance as a user with sudo permissions.

   For more information, see Connection method overview.

2. Download the DEB package for Cloud Assistant Agent.

   Cloud Assistant Agent version		Download command
   Public URL for the latest version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"
   Public URL for a specific version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.deb"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"
   Internal URL for the latest version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.deb"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"
   Internal URL for a specific version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.deb"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"

   Note

   • {version} indicates the version number of Cloud Assistant Agent.

   • {regionId} indicates the region ID of the instance on which you want to install Cloud Assistant Agent.

     To query the region in which an instance resides, click the ID of the instance on the instance list page in the ECS console and view the value of the Region parameter in the Basic Information section of the Instance Details page. Then, you can query the ID of the region in the Regions and zones topic.

   • You can specify the following version numbers of Cloud Assistant Agent to download Cloud Assistant Agent from public or internal URLs:

     • Version numbers that can be specified in public URLs:

       • x86 architecture: 1.0.1.413, 1.0.1.414, 1.0.1.448, 1.0.1.450, 1.0.2.458, 1.0.2.479, 1.0.2.541, 1.0.2.569, 1.0.2.574, 2.2.0.102, 2.2.0.106, 2.2.2.181, 2.2.3.187, 2.2.3.221, 2.2.3.247, 2.2.3.256, 2.2.3.269, 2.2.3.282, 2.2.3.289, 2.2.3.326, 2.2.3.349, 2.2.3.372, and 2.2.3.398

       • ARM architecture: 2.4.3.282, 2.4.3.326, 2.4.3.349, 2.4.3.372, and 2.4.3.398

     • Version numbers that can be specified in internal URLs:

       • x86 architecture: 1.0.1.407, 1.0.2.458, 1.0.2.479, 2.2.3.221, 2.2.3.247, 2.2.3.256, 2.2.3.265, 2.2.3.269, 2.2.3.282, 2.2.3.289, 2.2.3.326, 2.2.3.349, 2.2.3.372, and 2.2.3.398

       • ARM architecture: 2.4.3.282, 2.4.3.326, 2.4.3.349, 2.4.3.372, and 2.4.3.398

   For example, to download the Debian package for x86 version 1.0.2.458 of Cloud Assistant Agent in the China (Hangzhou) region, access the following internal URL:

   sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.deb"

3. (Optional) If an earlier version of Cloud Assistant Agent is installed on the instance, uninstall the earlier version.

   sudo dpkg -r aliyun-assist

4. Install Cloud Assistant Agent.

   By default, Cloud Assistant Agent is installed in one of the following directories on Linux instances:

   • Default installation directory for CoreOS operating systems: /opt/local/share/aliyun-assist/

   • Default installation directory for other operating systems (such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE): /usr/local/share/aliyun-assist/

   To install the latest version of Cloud Assistant Agent on an instance, run one of the following commands based on the operating system architecture of the instance:

   • x86

     sudo dpkg -i aliyun_assist_latest.deb

   • ARM

     sudo dpkg -i aliyun-assist_latest-1_arm64.deb

5. If the instance resides in the classic network, perform the following operations:

   In the directory where Cloud Assistant Agent is installed, create a file named region-id and enter the region ID of the instance in the file. For example, to create the region-id file in the default installation directory and enter the region ID of the instance on which Cloud Assistant Agent is installed in the file, run one of the following commands based on the operating system of the instance:

   • CoreOS operating systems:

     sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

   • Other Linux operating systems, such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE:

     sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

   If the sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id command is run, a command output similar to the following one is returned.

Use binary packages

This installation method is applicable to mainstream Linux operating systems.

1. Connect to a Linux instance as a user with sudo permissions.

   For more information, see Connection method overview.

2. Download the binary package for Cloud Assistant Agent.

   Cloud Assistant Agent version		Download command
   Public URL for the latest version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest_update.zip"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"
   Public URL for a specific version	x86	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"
   	ARM	sudo wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"
   Internal URL for the latest version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest_update.zip"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"
   Internal URL for a specific version	x86	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"
   	ARM	sudo wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"

   Note

   • {version} indicates the version number of Cloud Assistant Agent.

   • {regionId} indicates the region ID of the instance on which you want to install Cloud Assistant Agent.

     To query the region in which an instance resides, click the ID of the instance on the instance list page in the ECS console and view the value of the Region parameter in the Basic Information section of the Instance Details page. Then, you can query the ID of the region in the Regions and zones topic.

   • You can specify the following version numbers of Cloud Assistant Agent to download Cloud Assistant Agent from public or internal URLs:

     • x86 architecture: 2.2.3.282, 2.2.3.289, 2.2.3.326, 2.2.3.349, 2.2.3.372, and 2.2.3.398

     • ARM architecture: 2.4.3.282, 2.4.3.326, 2.4.3.349, 2.4.3.372, and 2.4.3.398

   For example, to download the binary package for x86 version 2.2.3.282 of Cloud Assistant Agent in the China (Hangzhou) region, access the following internal URL:

   sudo wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_2.2.3.282_update.zip"

3. Install Cloud Assistant Agent.

   By default, Cloud Assistant Agent is installed in one of the following directories on Linux instances:

   • Default installation directory for CoreOS operating systems: /opt/local/share/aliyun-assist/

   • Default installation directory for other operating systems, such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE: /usr/local/share/aliyun-assist/

   Decompress the binary package to the installation directory and install Cloud Assistant Agent. For example, to install version 2.2.3.282 of Cloud Assistant Agent on an instance that uses an x86 operating system, run the following commands:

   sudo unzip  -o aliyun_assist_2.2.3.282_update.zip -d /usr/local/share/aliyun-assist/
   sudo chmod a+x /usr/local/share/aliyun-assist/2.2.3.282/update_install
   sudo bash /usr/local/share/aliyun-assist/2.2.3.282/update_install

4. Perform operations based on the operating system or network type of the instance.

   • If the instance runs a Red Hat operating system, perform the following operations:

     1. Stop the qemu-ga service.

        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent

     2. Restart Cloud Assistant.

        sudo systemctl restart aliyun.service

   • If the instance resides in the classic network, perform the following operations:

     In the directory where Cloud Assistant Agent is installed, create a file named region-id and enter the region ID of the instance in the file. For example, to create the region-id file in the default installation directory and enter the region ID of the instance on which Cloud Assistant Agent is installed in the file, run one of the following commands based on the operating system of the instance:

     • CoreOS operating systems:

       sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

     • Other Linux operating systems, such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE:

       sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

     If the sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id command is run, a command output similar to the following one is returned.

Use source code

1. Connect to a Linux instance as a user with sudo permissions.

   For more information, see Connection method overview.

2. Install necessary software, such as Git and Go.

   In this example, YUM is used. If you use other Linux operating systems, use the corresponding package manager.

   • Install Git.

     sudo yum install git -y

   • Install Go.

     sudo yum install go -y

3. Download the source code for Cloud Assistant Agent.

   sudo git clone https://github.com/aliyun/aliyun_assist_client

4. Access the directory where the source code is stored.

   cd ./aliyun_assist_client

5. Compile the source code.

   sudo go build

   If no error message is returned, Cloud Assistant Agent is installed.

6. If the instance resides in the classic network, perform the following operations:

   In the directory where Cloud Assistant Agent is installed, create a file named region-id and enter the region ID of the instance in the file. For example, to create the region-id file in the default installation directory and enter the region ID of the instance on which Cloud Assistant Agent is installed in the file, run one of the following commands based on the operating system of the instance:

   • CoreOS operating systems:

     sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'

   • Other Linux operating systems, such as Alibaba Cloud Linux, Ubuntu, Debian, Red Hat, SUSE Linux Enterprise Server, and openSUSE:

     sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

   If the sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id command is run, a command output similar to the following one is returned.

7. Run Cloud Assistant Agent.

   aliyun-service -d