You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Passwords and key pairs
Upgrading reset-authentication plug-in
Copy page
Download PDF
Upgrading reset-authentication plug-in
Applicable scenarios​
Before you change the hostname of an instance, you need to follow the instructions in this topic to upgrade the reset-authentication plug-in to the specified version.​
Procedure​
Linux images​
Refer to the following instructions to upgrade the reset-authentication plug-in based on your Linux distribution.​
tip​
  • Instances created using CentOS 6.9/6.10 or Ubuntu 14.04 do not support hostname changes.​
  • For an instance in the China (Beijing) region, if an EIP is not associated with the instance, you can use the private domain name to download the reset-authentication plug-in. For an instance in other regions, associate an EIP with the instance, and then use the public domain name to download the reset-authentication plug-in.​
​
Ubuntu, Debian, and veLinux series
OpenSUSE, Fedora, CentOS 7/8/Stream, Rocky Linux, and AlmaLinux series
​
  1. Execute the following command to check whether the reset-authentication plug-in is installed.​
  • ​
    dpkg -s reset-authentication​
    ​
  • If the following output is displayed, the 1.0.4 version of the reset-authentication plug-in has been installed. Proceed to Step 3.​
  • ​alt​​
  • If the following output is displayed, the plug-in is not installed. Proceed to Step 4.​
  • ​alt​​
  1. Execute the following command to uninstall the old version of the reset-authentication plug-in.​
  • ​
    dpkg -r reset-authentication​
    ​
  1. Execute the following command to download the latest version of the plug-in.​
  • Download over the Internet​
  • ​
    wget http://volc-ecs.tos-s3-cn-beijing.volces.com/reset-authentication_1.0.11-0_amd64.deb​
    ​
  • Download over the intranet​
warning​
Only the China (Beijing) region supports this feature.​
  • ​
    wget http://volc-ecs.tos-s3-cn-beijing.ivolces.com/reset-authentication_1.0.11-0_amd64.deb​
    ​
  1. Execute the following command to install the latest version of the plug-in.​
  • ​
    dpkg -i reset-authentication_1.0.11-0_amd64.deb​
    ​
  1. Verify the result.​
  • Execute the following command. If "active" is displayed in the output, the plug-in is successfully installed.​
  • ​
    systemctl is-active reset-authentication.service​
    ​
  • Execute the following command. If "enabled" is displayed in the output, the plug-in is successfully installed.​
  • ​
    systemctl is-enabled reset-authentication.service​
    ​
  • ​
​
Windows images​
  1. Check whether the reset-authentication plug-in is installed.​
  • Check whether the C:\Program Files\Reset Authentication directory exists and whether there are any files and a log folder in the directory, open the log file, and view the version.​
  • If the preceding files exist, an older version of the plug-in has been installed (as shown in the following figure). You can re-download the new plug-in and execute the following command to start the reset-authentication plug-in.​
  • "C:\Program Files\Reset Authentication\reset-authentication.exe"​
  • If the preceding files do not exist, the reset-authentication plug-in is not installed. Proceed to Step 3.​
  1. Download and install the latest version of the plug-in.​
  1. Create the C:\Program Files\Reset Authentication directory.​
  1. On the desktop of the ECS instance, click "Start > Windows PowerShell" to open PowerShell.​
  1. Execute the following commands in PowerShell to download the ps1 auto-start script and the reset-authentication plug-in, and save them to the specific directories.​
  • ps1 auto-start script​
  • ​
    wget -Uri "http://volc-ecs.tos-s3-cn-beijing.volces.com/reset-authentication.ps1" -OutFile "C:\Program Files\Cloudbase Solutions\Cloudbase-Init\LocalScripts\reset-authentication.ps1"​
    ​
  • Reset-authentication plug-in​
  • ​
    wget -Uri "http://volc-ecs.tos-s3-cn-beijing.volces.com/reset-authentication.exe" -OutFile "C:\Program Files\Reset Authentication\reset-authentication.exe"​
    ​
  1. In PowerShell, execute the following commands in sequence to perform initialization operations.​
  1. Execute the following command to obtain the instance UUID.​
  • ​
    $instance_id = ((Invoke-WebRequest -URI "http://100.96.0.96/openstack/latest/meta_data.json" -UseBasicParsing).Content | ConvertFrom-Json).uuid​
    ​
  1. Execute the following command to delete part of the Cloudbase-init registry configuration so that the reset-authentication plug-in can work as expected.​
  • If you have not run Cloudbase-init, you do not need to execute this command.​
  • ​
    Remove-ItemProperty "HKLM:\SOFTWARE\Cloudbase Solutions\Cloudbase-Init\$instance_id\Plugins" LocalScriptsPlugin​
    ​
  1. Execute the following command to start the reset-authentication plug-in.​
  • ​
    "C:\Program Files\Reset Authentication\reset-authentication.exe"​
    ​
  • ​
Last updated: 2026.06.18 17:49:49