- Documentation
Elastic Compute Service
Elastic Compute Service
User Guide
Security
Passwords and key pairs
Installing reset-authentication plug-in
Passwords and key pairs
Installing reset-authentication plug-in
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
- Execute the following command to download the reset-authentication plug-in.
- Download over the Internet
- Download over the intranet
warning
Only the China (Beijing) region is supported.
- Execute the following command to install the reset-authentication plug-in.
- Verify the installation result.
- Execute the following command. If "active" is displayed in the output, the plug-in is successfully installed.
- Execute the following command. If "enabled" is displayed in the output, the plug-in is successfully installed.
- Execute the following command to download the reset-authentication plug-in.
- Download over the Internet
- Download over the intranet
- Execute the following command to install the reset-authentication plug-in.
- Execute the following command to start the service.
- Execute the following command to specify that the reset-authentication plug-in starts automatically upon startup.
- Verify the installation result.
- Execute the following command. If "active" is displayed in the output, the plug-in is successfully installed.
- Execute the following command. If "enabled" is displayed in the output, the plug-in is successfully installed.
- Execute the following command to download the reset-authentication plug-in.
- Download over the Internet
- Download over the intranet
- Execute the following command to install the reset-authentication plug-in.
- Execute the following command to verify the installation result.
- If no error is displayed in the output, the plug-in is installed successfully.
Windows image
warning
You can install the reset-authentication plug-in only on a VolcanoEngine instance.
- On the desktop of the ECS instance, click "Start > Windows PowerShell" to open PowerShell.
- Execute the following command in PowerShell to download the script and the reset-authentication plug-in.
- Execute the following command to create the C:\Program Files\Reset Authentication folder.
- Execute the following command to enter the Reset Authentication folder.
- Execute the following command to download the ps1 auto-start script to the C:\Program Files\Cloudbase Solutions\Cloudbase-Init\LocalScripts folder.
- Execute the following command to download the reset-authentication plug-in to the C:\Program Files\Reset Authentication folder.
- In PowerShell, execute the following commands in sequence to perform initialization operation.
- Execute the following command to obtain the instance UUID.
- 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.
- Execute the following command to start the reset-authentication plug-in.
Last updated: 2026.06.18 17:49:49