Elastic Compute Service:Alibaba Cloud managed instance

The server can directly access the Internet

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 that you obtained in Step 6 to the script file.

      vim installAssistant.sh

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

3. Run the following command to grant execution permissions on the installation script:

   sudo chmod 755 installAssistant.sh

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

   sudo ./installAssistant.sh

   After the installation is complete, if the following information is returned, the installation is successful.

The server can access the Internet only through a proxy server

This section describes how to install Cloud Assistant Agent through a proxy server and register a managed instance through a proxy server. CentOS 7.8 is used in this example.

1. Log on to the server by SSH.

   For more information, see Connection methods.

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

   x86 architecture:

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

   ARM 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

   You must change <http://your_proxy_address> to your proxy server address.

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

   x86 architecture:

   sudo rpm -ivh aliyun_assist_latest.rpm --force

   ARM architecture:

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

4. Configure a proxy for Cloud Assistant.

   1. Modify the Cloud Assistant service configuration file.

      Modify the Cloud Assistant service configuration file and configure the ALIYUN_ASSIST_PROXY environment variable. Perform the following steps:

      1. Create the /etc/sysconfig/aliyun file by using vim.

         sudo vim /etc/sysconfig/aliyun

      2. Enter the following content. Then, save and close the file.

         ALIYUN_ASSIST_PROXY=<http://your_proxy_address>

         Important

         You must change <http://your_proxy_address> to your proxy server address.

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

      sudo systemctl daemon-reload

   3. Run the following command to restart Cloud Assistant:

       sudo systemctl restart aliyun.service

      After Cloud Assistant is started, if the /usr/local/share/aliyun-assist/{version}/log/aliyun_assist_main.logDetected environment variable ALIYUN_ASSIST_PROXY for proxy setting information exists in the Cloud Assistant log (default log path: ), a proxy is configured for Cloud Assistant.

5. Run the following command to register a Cloud Assistant managed instance through a proxy server:

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

      sudo export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>

      Important

      You must change <http://your_proxy_address> to your proxy server address.

   2. Run the following command to register the server as an instance managed by Cloud Assistant:

      Important

      This is only an example. You must directly copy the code that is generated in Step 6 in the console.

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

A server is connected to a virtual private cloud (VPC) by using Express Connect

This section describes how to install Cloud Assistant Agent by using Express Connect and register a managed instance in a VPC. CentOS is used in this example.

1. Log on to the server by using SSH.

   For more information, see Connection methods.

2. Run the following script to register a managed instance in a VPC:

   The following code is an example. You must change the values of RegionId, ActivationCode, and ActivationId to the values in the automatically generated script in Step 6.

   CentOS operating system

   #/bin/bash
   ## Specify a region based on the geographical location of the server.
   regionId="cn-hangzhou"
   if [[ -n $regionId ]]; then
       bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
       ## Download Cloud Assistant Agent.
       wget -q https://${bucket}/linux/aliyun_assist_latest.rpm
       ## Install Cloud Assistant Agent.
       sudo rpm -ivh aliyun_assist_latest.rpm --force
   fi
   ## Register the server as a managed instance in a VPC. Enter the following setting to set the network type to VPC: NetworkMode "vpc"
   ## Copy the values of RegionId, ActivationCode, and ActivationId from the place where the registration code was created in the ECS console.
   sudo aliyun-service --register \
     --NetworkMode "vpc" \
     --RegionId "${regionId}" \
     --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
     --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

   Debian and other Linux operating systems

   #/bin/bash
   
   ## Specify a region based on the geographical location of the server.
   regionId="cn-hangzhou"
   
   if [[ -n $regionId ]]; then
       bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
       ## Download Cloud Assistant Agent.
       wget -q https://${bucket}/linux/aliyun_assist_latest.deb
       ## Install Cloud Assistant Agent.
       sudo dpkg -i aliyun_assist_latest.deb
   fi
   
   
   ## Register the server as a managed instance in a VPC. Enter the following setting to set the network type to VPC: NetworkMode "vpc"
   ## Copy the values of RegionId, ActivationCode, and ActivationId from the place where the registration code was generated in the ECS console.
   sudo aliyun-service --register \
     --NetworkMode "vpc" \
     --RegionId "${regionId}" \
     --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
     --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

The server can directly access the Internet

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

   For more information, see Connection methods.

2. Upload the installation script to the server.

   The installation script is the one that is generated when you create the registration code, which is the installation script generated in Step 6.

   Note

   Remote Desktop Connection allows you to directly copy the script file to the server. If the script file cannot be directly copied due to network environment limits, you can upload scripts by using FTP or other software.

3. Right-click the installation script and select Run With PowerShell to start installing Cloud Assistant Agent.

   

The server can access the Internet only through a proxy server

This section describes how to install Cloud Assistant Agent through a proxy server and register a managed instance through a proxy server. Windows Server 2016 Datacenter is used in this example.

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

   For more information, see Connection methods.

2. Configure a proxy server for the browser.

   1. Select Start > Control Panel.

   2. Click Network And Internet.

   3. Click Network And Sharing Center.

   4. Click Internet Options in the lower-left corner.

      

   5. Click the Connections tab, and then click LAN Settings.

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

3. Download the Cloud Assistant Agent installation package.

   1. Click Start, and 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 Cloud Assistant Agent.

   1. Go to the C:\ drive.

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

5. Configure a proxy server for Cloud Assistant.

   1. Select Start > Control Panel.

   2. Click System And Security.

   3. Click System.

   4. Click Advanced System Settings on the left.

      

   5. Click the Advanced tab, and then click Environment Variables.

   6. In the System Variables section, click New.

   7. Configure Variable Name and Variable Value, and then click OK.

      • Variable Name: Set this parameter to ALIYUN_ASSIST_PROXY.

      • Variable Value: Set this parameter to your proxy server.

   8. Run the following command in Windows PowerShell to restart Cloud Assistant:

      1. Run the following command to stop Cloud Assistant:

         net stop AliyunService

      2. Run the following command to restart Cloud Assistant:

         net start AliyunService

6. Register a Cloud Assistant managed instance through a proxy server in Windows PowerShell.

   1. Run the following command to go to the directory where Cloud Assistant Agent is installed:

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

      Important

      {version} indicates the version of Cloud Assistant. You must change it to the specific version that is installed.

   2. Run the following command to register the Windows server as an instance managed by Cloud Assistant:

      The following command is an example. You must change the values of RegionId, ActivationCode, and ActivationId to the values in the automatically generated script in Step 6.

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

A server is connected to a virtual private cloud (VPC) by using Express Connect

This section describes how to install Cloud Assistant Agent by using Express Connect and register a managed instance. Windows Server 2016 Datacenter is used in this example.

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

   For more information, see Connection methods.

2. Click Start, and select Windows PowerShell > Windows PowerShell.

3. Right-click Windows PowerShell and select Run As Administrator.

4. Run the following command in the Windows PowerShell dialog box:

   The following command is an example. You must change the values of RegionId, ActivationCode, and ActivationId to the values in the automatically generated script 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 SSH.

   For more information, see Connection methods.

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

   sudo aliyun-service --deregister

3. Disable and uninstall the Cloud Assistant daemon process.

   1. Run the following command to disable the Cloud Assistant daemon process:

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

      Note

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

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

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

4. Run the following command to disable Cloud Assistant Agent:

   Note

   The initialization process service used by the server varies based on the version of the Linux kernel. Linux that runs a recent kernel version (such as Ubuntu 18.04) generally uses the systemd initialization process service. In this example, the systemd initialization process service is used. For information about operations for other initialization process services, see Start, stop, or uninstall Cloud Assistant Agent.

   sudo systemctl stop aliyun.service

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

   • To uninstall the Cloud Assistant RPM package, run the following command:

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

   • To uninstall the Cloud Assistant DEB package, run the following command:

     sudo dpkg -r aliyun-assist

6. Delete the Cloud Assistant daemon process and Cloud Assistant Agent.

   1. Run the following command to delete the directory where the Cloud Assistant daemon process is stored:

      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 server

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

   For more information, see Connection methods.

2. Run Windows PowerShell.

   1. Click Start.

   2. Select Windows PowerShell > Windows PowerShell.

   3. Right-click Windows PowerShell and select Run As Administrator.

3. Run the following command in Windows PowerShell to unregister the managed instance:

   aliyun-service --deregister

4. Open the Services window.

   1. Click Start.

   2. Select Windows Administrative Tools > Services.

5. Find Aliyun Assist Service and click Stop The Service.