The Cloud Assistant Agent is an agent that runs Cloud Assistant commands on Elastic Compute Service (ECS) instances. This topic describes how to upgrade and disable upgrades for the Cloud Assistant Agent.
Prerequisites
The Cloud Assistant Agent is installed. For more information, see Install the .Automatic upgrade
- Windows instances: C:\ProgramData\aliyun\assist\${version}/aliyun_assist_update
- Linux instances: /usr/local/share/aliyun-assist/${version}/aliyun_assist_update
Manual upgrade
If automatic upgrades do not take effect, you can run the ACS-ECS-UpdateAliyunAssist-linux.sh
common command on Linux instances or the ACS-ECS-UpdateAliyunAssist-windows.ps1
common command on Windows instances to manually upgrade the Cloud Assistant Agent.
wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && rpm -ivh --force aliyun_assist_latest.rpm
Manually disable upgrades
Use a configuration file to disable upgrades for the Cloud Assistant Agent
For Cloud Assistant Agent 2.2.1.140 or later on Linux instances and Cloud Assistant Agent 2.1.1.140 or later on Windows instances, you can disable upgrades by creating a configuration file in a specified path.
- Disable the Cloud Assistant Agent from checking for upgrades on startup
To disable a specific version of the Cloud Assistant Agent from checking for upgrades on startup, find the installation directory of the Cloud Assistant Agent version and create the disable_bootstrap_update file in the config folder. To disable all versions of the Cloud Assistant Agent on an instance from checking for upgrades on startup, find the general installation directory of all Cloud Assistant Agent versions and create the disable_bootstrap_update file in the config folder. You do not need to write data to the disable_bootstrap_update file.
- If the instance on which the Cloud Assistant Agent is installed runs a Windows Server operating system, run the following commands in PowerShell.
# For example, run the following command to disable a specific version of the Cloud Assistant Agent from checking for upgrades on startup: New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_bootstrap_update # For example, run the following command to disable all versions of the Cloud Assistant Agent from checking for upgrades on startup: New-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update
- If the instance on which the Cloud Assistant Agent is installed runs a Linux operating system, run the following commands.
# For example, run the following command to disable a specific version of the Cloud Assistant Agent from checking for upgrades on startup: touch /usr/local/share/aliyun-assist/{version}/config/disable_bootstrap_update # For example, run the following command to disable all versions of the Cloud Assistant Agent from checking for upgrades on startup: touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
Note {version} specifies the version number of the Cloud Assistant Agent. - If the instance on which the Cloud Assistant Agent is installed runs a Windows Server operating system, run the following commands in PowerShell.
- Disable the Cloud Assistant Agent from checking for updates
To disable a specific version of the Cloud Assistant Agent from checking for updates, find the installation directory of the Cloud Assistant Agent version and create the disable_update file in the config folder. To disable all versions of the Cloud Assistant Agent on an instance from checking for updates, find the general installation directory of all Cloud Assistant Agent versions and create the disable_update file in the config folder. You do not need to write data to the disable_update file.
- If the instance on which the Cloud Assistant Agent is installed runs a Windows Server operating system, run the following commands in PowerShell.
# For example, run the following command to disable a specific version of the Cloud Assistant Agent from checking for updates: New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_update # For example, run the following command to disable all versions of the Cloud Assistant Agent from checking for updates: New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
- If the instance on which the Cloud Assistant Agent is installed runs a Linux operating system, run the following commands.
# For example, run the following command to disable a specific version of the Cloud Assistant Agent from checking for updates: touch /usr/local/share/aliyun-assist/{version}/config/disable_update # For example, run the following command to disable all versions of the Cloud Assistant Agent from checking for updates: touch /usr/local/share/aliyun-assist/config/disable_update
Note {version} specifies the version number of the Cloud Assistant Agent. - If the instance on which the Cloud Assistant Agent is installed runs a Windows Server operating system, run the following commands in PowerShell.
Disable the automatic upgrade program to disable upgrades for the Cloud Assistant Agent
You can disable upgrades for the Cloud Assistant Agent by disabling the aliyun_assist_update automatic upgrade program.
- If the instance on which the Cloud Assistant Agent is installed runs a Windows Server operating system, run the following command in PowerShell:
Rename-Item -Path 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe'-NewName 'C:\ProgramData\aliyun\assist\${version}\aliyun_assist_update.exe.bk'
- If the instance on which the Cloud Assistant Agent is installed runs a Linux operating system, run the following command:
chmod a-x aliyun_assist_update