升级、禁止自动升级云助手Agent

通过重命名aliyun_assist_update文件，禁止自动升级云助手Agent。

• Windows Server系统：在PowerShell中运行以下命令，将自动升级程序aliyun_assist_update重命名为aliyun_assist_update.bk。

  Rename-Item -Path 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe'-NewName 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe.bk'

• Linux系统：执行以下命令，将自动升级程序aliyun_assist_update重命名为aliyun_assist_update.bk。

  mv /usr/local/share/aliyun-assist/{version}/aliyun_assist_update /usr/local/share/aliyun-assist/{version}/aliyun_assist_update.bk

如果您想恢复自动升级，请将文件名改回aliyun_assist_update。

• Windows Server系统：

  Rename-Item -Path 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe.bk' -NewName 'C:\ProgramData\aliyun\assist\{version}\aliyun_assist_update.exe'

• Linux系统：

  mv /usr/local/share/aliyun-assist/{version}/aliyun_assist_update.bk /usr/local/share/aliyun-assist/{version}/aliyun_assist_update

对于Linux操作系统下版本号不低于2.2.1.140的云助手Agent和Windows操作系统下版本号不低于2.1.1.140的云助手Agent，您可以通过云助手Agent在指定路径下创建配置文件来禁止升级云助手Agent：

步骤一：禁止云助手Agent启动时检查升级

在云助手Agent安装目录内的config目录下创建文件disable_bootstrap_update即可禁用当前版本的云助手Agent启动时检查升级，在跨版本目录内的config目录下创建该文件可禁用本机上所有版本的云助手Agent启动时检查升级。disable_bootstrap_update文件不需要写入任何内容。

• Windows Server系统：在PowerShell中运行以下命令。

  # 例如执行以下命令将会禁止指定版本号的云助手Agent启动时的检查升级
  New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_bootstrap_update
  # 例如执行以下命令禁止云助手Agent启动时检查升级，对各个版本都有效
  New-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update

• Linux系统：运行以下命令。

  # 例如执行以下命令将会禁止指定版本号的云助手Agent启动时的检查升级
  touch /usr/local/share/aliyun-assist/{version}/config/disable_bootstrap_update
  # 例如执行以下命令禁止云助手Agent启动时检查升级，对各个版本都有效
  touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update

步骤二：禁止云助手Agent自动检查更新

在云助手Agent安装目录内的config目录下创建文件disable_update即可禁用该版本的云助手Agent自动升级，在跨版本目录内的config目录下创建该文件可禁用本机上所有版本的云助手Agent自动升级。disable_update文件不需要写入任何内容。

• Windows Server系统：在PowerShell中运行以下命令。

  # 例如执行以下命令将会禁止指定版本号的云助手Agent的自动升级
  New-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_update
  # 例如执行以下命令禁止云助手Agent的自动升级，对各个版本都有效
  New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

• Linux系统：运行以下命令。

  # 例如执行以下命令将会禁止指定版本号的云助手Agent的自动升级
  touch /usr/local/share/aliyun-assist/{version}/config/disable_update
  # 例如执行以下命令禁止云助手Agent的自动升级，对各个版本都有效
  touch /usr/local/share/aliyun-assist/config/disable_update

如果您想恢复自动升级，请删除配置文件disable_update和disable_bootstrap_update。

• Windows Server系统：在PowerShell中运行以下命令。

  Remove-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_update
  Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update
  
  Remove-Item -Path C:\ProgramData\aliyun\assist\{version}\config\disable_bootstrap_update
  Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update

• Linux系统：运行以下命令。

  rm /usr/local/share/aliyun-assist/{version}/config/disable_update
  rm /usr/local/share/aliyun-assist/config/disable_update
  
  rm /usr/local/share/aliyun-assist/{version}/config/disable_bootstrap_update
  rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update

自动升级失效时，您可以调用公共命令进行升级。

1. 访问ECS控制台-云助手。

2. 在ECS云助手页面，单击公共命令页签。

3. 找到如下待执行的公共命令（选择最新版本），单击执行。

   • Linux实例：ACS-ECS-UpdateAliyunAssist-linux.sh。

   • Windows实例：ACS-ECS-UpdateAliyunAssist-windows.ps1。

     

4. 在执行命令面板中，按照界面提示配置相关参数并单击执行。

   • 执行计划：选择命令执行的时间。更多信息，请参见执行计划详细信息。

   • 选择实例：选择需要升级云助手的实例，该实例需处于运行中状态且已安装云助手的客户端。

     更多参数说明，请参见查看和执行公共命令。

   当执行结果类似如下所示时，说明云助手Agent已升级成功。

您也可以手动下载最新的安装包进行升级。更多的安装方式，请参见安装云助手Agent。

示例：以RPM包为例，执行以下命令为x86架构的Linux实例下载并安装最新的云助手安装包。

wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm