Elastic Compute Service:Install Cloud Assistant Agent

Linux

This script installs the latest version of the agent by default. To install a specific version, modify VERSION=latest.

#!/bin/bash

VERSION=latest
PACKAGE=
PKG_URI=

DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com

arch=$(uname -m)
echo "[main] arch = ${arch}"
case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm; then
            PACKAGE="aliyun_assist_${VERSION}.rpm"
        else
            PACKAGE="aliyun_assist_${VERSION}.deb"
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
esac

if command -v wget; then
    sudo wget $PKG_URI
elif command -v curl; then
    curl -o $PACKAGE $PKG_URI
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1;
fi;

if command -v rpm; then
    sudo rpm -ivh --force $PACKAGE
elif command -v dpkg; then
    sudo dpkg -i $PACKAGE
else
    echo "[WARN] command rpm/dpkg not found, exit"
    exit 2;
fi

if [[ -e /etc/redhat-release ]]; then
    if sudo systemctl status qemu-guest-agent; then
        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent
        sudo systemctl restart aliyun.service
    fi
fi

Windows

Method 1: Download from browser.

1. Open the following URL in a browser to download Cloud Assistant Agent.

   https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe

2. Install Cloud Assistant Agent.

   Double-click the agent file and follow the installation wizard. The default installation path is C:\ProgramData\aliyun\assist\.

Method 2: Install by PowerShell

curl -UseBasicParsing -Uri https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
;"C:\\aliyun_agent_latest_setup.exe" '/S' 

Install from binary package

• For Alibaba Cloud ECS instances

  This script installs the latest version of the agent by default. To install a specific version, modify VERSION=latest.

  #!/bin/bash
  
  VERSION=latest
  PACKAGE=
  PKG_URI=
  
  REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
  DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
  
  arch=$(uname -m)
  echo "[main] arch = ${arch}"
  case $arch in
      "i386"|"i686"|"x86_64"|"amd64")
          PACKAGE="aliyun_assist_${VERSION}_update.zip"
          PKG_URI="https://$DOMAIN/linux/$PACKAGE"
          ;;
      *)
          PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
          PKG_URI="https://$DOMAIN/arm/$PACKAGE"
  esac
  
  if command -v wget; then
      sudo wget $PKG_URI
  elif command -v curl; then
      curl -o $PACKAGE $PKG_URI
  else
      echo "[WARN] command wget/curl not found, exit"
      exit 1
  fi;
  
  TARGET_DIR=/usr/local/share/aliyun-assist
  sudo unzip -o $PACKAGE -d $TARGET_DIR/
  TRUE_VERSION=$(cat $TARGET_DIR/version)
  sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
  sudo bash $TARGET_DIR/$TRUE_VERSION/update_install

• For managed instances (non-Alibaba Cloud servers)

  #!/bin/bash
  
  VERSION=latest
  PACKAGE=
  PKG_URI=
  
  DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
  
  arch=$(uname -m)
  echo "[main] arch = ${arch}"
  case $arch in
      "i386"|"i686"|"x86_64"|"amd64")
          PACKAGE="aliyun_assist_${VERSION}_update.zip"
          PKG_URI="https://$DOMAIN/linux/$PACKAGE"
          ;;
      *)
          PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
          PKG_URI="https://$DOMAIN/arm/$PACKAGE"
  esac
  
  if command -v wget; then
      sudo wget $PKG_URI
  elif command -v curl; then
      curl -o $PACKAGE $PKG_URI
  else
      echo "[WARN] command wget/curl not found, exit"
      exit 1
  fi;
  
  TARGET_DIR=/usr/local/share/aliyun-assist
  sudo unzip -o $PACKAGE -d $TARGET_DIR/
  TRUE_VERSION=$(cat $TARGET_DIR/version)
  sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
  sudo bash $TARGET_DIR/$TRUE_VERSION/update_install

Install from source code

The example uses yum for installation. If you are using a different Linux distribution, use the corresponding package manager.

1. Install Git and Go.

   # Install Git
   sudo yum install git -y
   
   # Install Go
   sudo yum install go -y

2. Download Cloud Assistant Agent source code.

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

3. Navigate to the source code directory and compile the code.

   # Go to the source code directory
   cd ./aliyun_assist_client
   
   # Compile the source code
   sudo go build

   If the command runs without errors, the installation is successful.

Linux

1. In the agent's installation directory, create a file named region-id that contains the region ID of the ECS instance.

   For example, for the China (Hangzhou) region, create the region-id file in the default installation directory.

   • CoreOS:

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

   • Other OS (such as Alibaba Cloud Linux, Ubuntu, Debian, RedHat, SUSE Linux Enterprise Server, and OpenSUSE):

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

2. Run Cloud Assistant Agent.

   aliyun-service -d

Windows