Start, stop, or uninstall Cloud Assistant Agent - Elastic Compute Service

Cloud Assistant Agent is an agent that runs Cloud Assistant commands on Elastic Compute Service (ECS) instances. This topic describes how to start, stop, or uninstall Cloud Assistant Agent.

Start or stop Cloud Assistant Agent on a Windows instance

To start or stop Cloud Assistant Agent on a Windows instance, perform the following steps.

Warning

Aliyun Assist Service is the process of Cloud Assistant Agent. If you stop the Aliyun Assist Service process on an instance, Cloud Assistant Agent also stops. This may cause an exception on the instance and a failure to stop the instance in the ECS console. Proceed with caution when you stop Cloud Assistant Agent.

Connect to the Windows instance.
For more information, see Connect to a Windows instance by using a username and password.
Click the Start icon and choose Windows Administrative Tools > Computer Management.
Choose Computer Management (Local) > Services and Applications > Services.
Find Aliyun Assist Service and click Stop the service or Restart the service.

Uninstall Cloud Assistant Agent from a Windows instance

If you no longer need Cloud Assistant Agent, perform the following steps to uninstall Cloud Assistant Agent:

Stop Cloud Assistant Agent. For more information, see the Start or stop Cloud Assistant Agent on a Windows instance section of this topic.
Delete the C:\ProgramData\aliyun\assist directory.

Start or stop Cloud Assistant Agent on a Linux instance

Note

Before you stop Cloud Assistant Agent, you must uninstall the Cloud Assistant daemon process. For more information, see the Uninstall the Cloud Assistant daemon process from a Linux instance section of this topic.

To start or stop Cloud Assistant Agent on a Linux instance, perform the following steps:

Connect to the Linux instance.
For more information, see Connect to a Linux instance by using a username and password.
Run the following commands to start or stop Cloud Assistant Agent based on the initialization process of the Linux instance.
- In most cases, Linux operating systems that are based on new Linux kernel versions use the systemd initialization process. Perform the following operations:
  - Check whether the instance uses the systemd initialization process. If command output is displayed, the instance uses systemd.
```
strings /sbin/init | grep "/lib/system"
```
  - Stop Cloud Assistant Agent.
```
systemctl stop aliyun.service
```
  - Start Cloud Assistant Agent.
```
systemctl start aliyun.service
```
  - Restart Cloud Assistant Agent.
```
systemctl restart aliyun.service
```
- In most cases, Ubuntu 14 and earlier operating systems use the UpStart initialization process. Perform the following operations:
  - Check whether the instance uses the UpStart initialization process. If command output is displayed, the instance uses UpStart.
```
strings /sbin/init | grep "upstart"
```
  - Stop Cloud Assistant Agent.
```
/sbin/initctl stop aliyun-service
```
  - Start Cloud Assistant Agent.
```
/sbin/initctl start aliyun-service
```
  - Restart Cloud Assistant Agent.
```
/sbin/initctl restart aliyun-service
```
- In most cases, Linux operating systems that are based on early Linux kernel versions use the sysvinit initialization process. Perform the following operations:
  - Check whether the instance uses the sysvinit initialization process. If the instance uses sysvinit, a command output is displayed.
```
strings /sbin/init | grep "sysvinit"
```
  - Stop Cloud Assistant Agent.
```
/etc/init.d/aliyun-service stop
```
  - Start Cloud Assistant Agent.
```
/etc/init.d/aliyun-service start
```
  - Restart Cloud Assistant Agent.
```
/etc/init.d/aliyun-service restart
```

Uninstall the Cloud Assistant daemon process from a Linux instance

The Cloud Assistant daemon process monitors resource consumption, reports the status of Cloud Assistant Agent, and restarts Cloud Assistant Agent when Cloud Assistant Agent fails. Before you uninstall Cloud Assistant Agent, you must uninstall the Cloud Assistant daemon process.

Note

The Cloud Assistant daemon process is available only for Linux instances.

Connect to the Linux instance.
For more information, see Connect to a Linux instance by using a username and password.
Stop the Cloud Assistant daemon process.
```
/usr/local/share/assist-daemon/assist_daemon --stop
```
Note
In the preceding command, /usr/local/share/assist-daemon/assist_daemon is the default path of the Cloud Assistant daemon process.

Uninstall the Cloud Assistant daemon process.

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

Delete the directory of the Cloud Assistant daemon process.
```
rm -rf /usr/local/share/assist-daemon
```

Uninstall Cloud Assistant Agent from a Linux instance

If you no longer need Cloud Assistant Agent, perform the following steps to uninstall Cloud Assistant Agent:

Connect to the Linux instance.
For more information, see Connect to a Linux instance by using a username and password.
Uninstall the Cloud Assistant daemon process.
For more information, see the Uninstall the Cloud Assistant daemon process from a Linux instance section of this topic.
Stop Cloud Assistant Agent.
For more information, see the Start or stop Cloud Assistant Agent on a Linux instance section of this topic.
Use one of the following methods 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, perform the following operations:
  1. Run the sudo dpkg -l command to query the name of the Cloud Assistant DEB package.
  2. Run the sudo dpkg -r <Name of the Cloud Assistant DEB package> command to uninstall the Cloud Assistant DEB package.
- Run the rm -rf /usr/local/share/aliyun-assist command to delete the directory of Cloud Assistant Agent.