Elastic Compute Service:Alibaba Cloud managed instances

Public network

1. Log on to your third-party server.

2. Create an installation script on the server.

   1. Run the following command to create a script file, and copy the installation script from Step 6 into the script file.

      vim installAssistant.sh

   2. Press the Esc key, enter :wq, and then press the Enter key to save the file.

3. Run the following command to make the installation script executable.

   sudo chmod 755 installAssistant.sh

4. Run the following command to install the Cloud Assistant Agent on the server.

   sudo ./installAssistant.sh

   If the following information is returned, the installation is successful.

   register ok
   instance id: mi-hz018g48xxx
   Process completed.
   Process completed.
   restart service

Proxy server

This section uses CentOS 7.8 as an example to describe how to install the Cloud Assistant Agent and register a managed instance through a proxy server.

1. Log on to the server by using a method such as SSH.

   For more information, see Connection methods.

2. Run the following command to download the Cloud Assistant Agent through the proxy server.

   x86-based architecture:

   sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm

   ARM-based architecture:

   sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm

   Important

   Replace <http://your_proxy_address> with the address of your proxy server.

3. Run the following command to install the Cloud Assistant Agent.

   x86-based architecture:

   sudo rpm -ivh aliyun_assist_latest.rpm --force

   ARM-based architecture:

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

4. Configure a proxy for the Cloud Assistant service.

   1. Modify the Cloud Assistant service configuration file.

      Modify the Cloud Assistant service configuration file to set the ALIYUN_ASSIST_PROXY environment variable.

      1. Use a text editor such as Vim to create the /etc/sysconfig/aliyun file.

         sudo vim /etc/sysconfig/aliyun

      2. Enter the following content, and then save and exit the file.

         ALIYUN_ASSIST_PROXY=<http://your_proxy_address>

         Important

         Replace <http://your_proxy_address> with the address of your proxy server.

   2. Run the following command to reload the systemd configuration.

      sudo systemctl daemon-reload

   3. Run the following command to restart the Cloud Assistant service.

       sudo systemctl restart aliyun.service

      After the Cloud Assistant service starts, check the Cloud Assistant log file. By default, the log file is stored in the /usr/local/share/aliyun-assist/{version}/log/aliyun_assist_main.log path. If the log file contains the Detected environment variable ALIYUN_ASSIST_PROXY for proxy setting message, a proxy is configured for the Cloud Assistant service.

5. Run the following commands to register the managed instance through the proxy server.

   1. Run the following command to configure the proxy server.

      export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>

      Important

      Replace <http://your_proxy_address> with the address of your proxy server.

   2. Run the following command to register the server as a managed instance.

      Important

      This is provided as an example only. You need to directly copy the code that is generated in the console in Step 6.

      sudo aliyun-service --register --RegionId "cn-hangzhou" \
         --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
         --ActivationId "045CE381-0404-4F42-A44B-CC232B3E****"

Express Connect to VPC

This topic uses CentOS as an example to describe how to install the Cloud Assistant Agent by using Express Connect and then register a managed instance within a VPC.

1. Log on to the server by using a method such as SSH.

   For more information, see Connection methods.

2. Run the following script to register the managed instance over the VPC internal network.

   The sample code is as follows. Replace the values of RegionId, ActivationCode, and ActivationId with the values from the script that is automatically generated in Step 6.

   CentOS

   #/bin/bash
   ## Note: Set the region ID.
   regionId="cn-hangzhou"
   if [[ -n $regionId ]]; then
       bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
       ## Download the Cloud Assistant Agent.
       wget -q https://${bucket}/linux/aliyun_assist_latest.rpm
       ## Install the Cloud Assistant Agent.
       sudo rpm -ivh aliyun_assist_latest.rpm --force
   fi
   ## Register the managed instance over a VPC internal network. **Note: You must set the NetworkMode parameter to "vpc".**
   ## Copy the values of the RegionId, ActivationCode, and ActivationId parameters from the registration code creation page in the console.
   sudo aliyun-service --register \
     --NetworkMode "vpc" \
     --RegionId "${regionId}" \
     --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
     --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

   Debian and other Linux

   #!/bin/bash
   ## Note: Set the region ID.
   regionId="cn-hangzhou"
   if [[ -n $regionId ]]; then
       bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
       ## Download the Cloud Assistant Agent.
       wget -q https://${bucket}/linux/aliyun_assist_latest.deb
       ## Install the Cloud Assistant Agent.
       sudo dpkg -i aliyun_assist_latest.deb
   fi
   ## Register the managed instance over a VPC internal network. **Note: You must set the NetworkMode parameter to "vpc".**
   ## Copy the values of the RegionId, ActivationCode, and ActivationId parameters from the registration code creation page in the console.
   sudo aliyun-service --register \
     --NetworkMode "vpc" \
     --RegionId "${regionId}" \
     --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
     --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

Public network

1. Remotely log on to the server by using a method such as Remote Desktop Connection.

   For more information, see Connection methods.

2. Upload the installation script to the server.

   The installation script is the script generated in Step 6 when you create a registration code.

   Note

   Remote Desktop Connection allows you to directly copy script files to the server. If your network environment restricts direct copying, you can use other tools such as FTP to upload the script.

3. Right-click the installation script and select Run with PowerShell to install the Cloud Assistant Agent.

Proxy server

This section uses Windows Server 2016 Datacenter Edition as an example to describe how to install the Cloud Assistant Agent and register a managed instance through a proxy server.

1. Remotely log on to the server by using a method such as Remote Desktop Connection.

   For more information, see Connection methods.

2. Configure the proxy server for your browser.

   1. From the Start > Control Panel.

   2. Click Network and Internet.

   3. Click Network and Sharing Center.

   4. In the lower-left corner, click Internet Options.

   5. On the Connect tab, click LAN settings.

   6. In the Proxy server section, set the address and port of your proxy server, and then click OK.

3. Download the Cloud Assistant Agent installation package.

   1. From the Start menu, select Windows PowerShell > Windows PowerShell.

   2. Right-click Windows PowerShell and select Run as administrator.

   3. In the Windows PowerShell dialog box, run the following command to download the Cloud Assistant Agent installation package.

      Invoke-WebRequest -Uri 'https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe' -OutFile 'C:\\aliyun_agent_latest_setup.exe'

4. After the download is complete, install the Cloud Assistant Agent.

   1. Go to the C:\ drive.

   2. Double-click aliyun_agent_latest_setup.exe and follow the installation wizard to install the Cloud Assistant Agent.

5. Set a proxy server for Cloud Assistant.

   1. From the Start > Control Panel.

   2. Click System and Security.

   3. Click System.

   4. In the navigation pane on the left, click Advanced system settings.

   5. On the Premium tab, click Environment Variable.

   6. In the System Variable section, click New Resources.

   7. Set the Variable Name and Variable value, and then click OK.

      • Variable Name: Set to ALIYUN_ASSIST_PROXY.

      • Variable value: Set to your proxy server.

   8. In Windows PowerShell, run the following commands to restart the Cloud Assistant service.

      1. Run the following command to stop the Cloud Assistant service.

         net stop AliyunService

      2. Run the following command to restart the Cloud Assistant service.

         net start AliyunService

6. In Windows PowerShell, register the managed instance through the proxy server.

   1. Run the following command to go to the Cloud Assistant installation directory.

      cd C:\ProgramData\aliyun\assist\{version}

      Important

      Replace {version} with the version number of the installed Cloud Assistant Agent.

   2. Run the following command to register the server as a managed instance.

      An example of the command is as follows. Replace the values of RegionId, ActivationCode, and ActivationId with the values from the script that is automatically generated in Step 6.

       .\aliyun_assist_service.exe  --register  --RegionId="cn-hangzhou" --ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****" --ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"

Express Connect to VPC

This topic uses Windows Server 2016 Datacenter Edition as an example to describe how to use Express Connect to install Cloud Assistant Agent and then register a managed instance.

1. Remotely log on to the server by using a method such as Remote Desktop Connection.

   For more information, see Connection methods.

2. From the Start menu, select Windows PowerShell > Windows PowerShell.

3. Right-click Windows PowerShell and select Run as administrator.

4. In the Windows PowerShell dialog box, run the following command.

   The following is a command example. Replace the values of RegionId, ActivationCode, and ActivationId with the values from the script that is automatically generated in Step 6.

   $RegionId = "cn-hangzhou"
   $Bucket = "aliyun-client-assist-${RegionId}.oss-${RegionId}-internal.aliyuncs.com"
   Invoke-WebRequest -Uri "https://${Bucket}/windows/aliyun_agent_latest_setup.exe" `
   -OutFile 'C:\\aliyun_agent_latest_setup.exe'
   &"C:\\aliyun_agent_latest_setup.exe" '/S' '--register' `
   '--NetworkMode="vpc"' '--RegionId="cn-hangzhou"' `
   '--ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****"' `
   '--ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"'
   type C:\ProgramData\aliyun\assist\hybrid\instance-id
   Start-Sleep -s 30
   net stop AliyunService
   net start AliyunService

Linux servers

1. Log on to the server by using a method such as SSH.

   For more information, see Connection methods.

2. Run the following command to deregister the managed instance.

   sudo aliyun-service --deregister

3. Stop and uninstall the Cloud Assistant daemon.

   1. Run the following command to stop the Cloud Assistant daemon.

      sudo /usr/local/share/assist-daemon/assist_daemon --stop

      Note

      The default path of the Cloud Assistant daemon is /usr/local/share/assist-daemon/assist_daemon.

   2. Run the following command to uninstall the Cloud Assistant daemon.

      sudo /usr/local/share/assist-daemon/assist_daemon --delete

4. Run the following command to stop the Cloud Assistant Agent.

   Note

   Different Linux kernel versions use different init services. Linux distributions with newer kernels, such as Ubuntu 18.04, typically use the systemd init service. This section uses the systemd init service as an example. For instructions on other init services, see Stop and uninstall the Cloud Assistant Agent.

   sudo systemctl stop aliyun.service

5. Run the following command to uninstall the Cloud Assistant Agent.

   • For RPM-based package management systems:

     sudo rpm -qa | grep aliyun_assist | xargs sudo rpm -e

   • For DEB-based package management systems:

     sudo dpkg -r aliyun-assist

6. Delete the directories of the Cloud Assistant daemon and the Cloud Assistant Agent.

   1. Run the following command to delete the Cloud Assistant daemon directory.

      sudo rm -rf /usr/local/share/assist-daemon

   2. Run the following command to delete the Cloud Assistant Agent directory.

      sudo rm -rf /usr/local/share/aliyun-assist

Windows servers

1. Remotely log on to the server by using Remote Desktop Connection.

   For more information, see Connection methods.

2. Run Windows PowerShell.

   1. Click the Start menu.

   2. Select Windows PowerShell > Windows PowerShell.

   3. Right-click Windows PowerShell and select Run as administrator.

3. In the Windows PowerShell window, run the following command to deregister the managed instance.

   aliyun-service --deregister

4. Open the Services management window.

   1. Click the Start menu.

   2. Select Windows Administrative Tools > Service

5. Find Aliyun Assist Service and click Stop this service.