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

Elastic Compute Service

Copy page
Download PDF
Passwords and key pairs
Installing reset-authentication plug-in
Copy page
Download PDF
Installing reset-authentication plug-in
Applicable scenarios​
Before you reset the password, associate a key pair with an instance, or disassociate a key pair from an instance, you need to follow the instructions in this topic to install the reset-authentication plug-in for the instance.​
warning​
  • Instances created by using a custom image must have the reset-authentication plug-in installed. Otherwise, the image may not work as expected.​
  • Some images provided by the platform have the reset-authentication plug-in pre-installed. You can log in to a Linux instance and execute the following command to check whether the plug-in is installed:​
  • systemctl status reset-authentication​
  • If the following output is returned, the plug-in is not installed. You can refer to this topic for installation instructions.​
  • reset-authentication.service could not be found.​
Procedure​
Linux image​
Download and install the reset-authentication plug-in based on your Linux distribution.​
tip​
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
CentOS 6 series
​
  1. Execute the following command to download the reset-authentication 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 is supported.​
  • ​
    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 reset-authentication plug-in.​
  • ​
    dpkg -i reset-authentication_1.0.11-0_amd64.deb​
    ​
  1. Verify the installation 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 image​
warning​
You can install the reset-authentication plug-in only on a VolcanoEngine instance.​
  1. On the desktop of the ECS instance, click "Start > Windows PowerShell" to open PowerShell.​
  1. Execute the following command in PowerShell to download the script and the reset-authentication plug-in.​
  1. Execute the following command to create the C:\Program Files\Reset Authentication folder.​
  • ​
    New-Item -ItemType Directory -Path "C:\Program Files\Reset Authentication"​
    ​
  1. Execute the following command to enter the Reset Authentication folder.​
  • ​
    cd "C:\Program Files\Reset Authentication"​
    ​
  1. Execute the following command to download the ps1 auto-start script to the C:\Program Files\Cloudbase Solutions\Cloudbase-Init\LocalScripts folder.​
  • ​
    Invoke-WebRequest -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"​
    ​
  1. Execute the following command to download the reset-authentication plug-in to the C:\Program Files\Reset Authentication folder.​
  • ​
    Invoke-WebRequest -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 operation.​
  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.​
  • ​
    Start-Process -Wait -FilePath "C:\Program Files\Reset Authentication\reset-authentication.exe"​
    ​
​
Last updated: 2026.06.18 17:49:49