Updated on 2026-06-01 GMT+08:00

Installing the One-Click Password Reset Plug-In

Scenarios

You are advised to install the password reset plug-in CloudResetPwdAgent before creating a private image. In this way, you can reset the password of ECSs created from the image by a few clicks.

  • ECSs created from a public image have this plug-in installed by default.
  • For ECSs created from an external image file, install the plug-in by performing the operations in this section.

Precautions

  • You can decide whether to install the CloudResetPwdAgent plug-in.
  • The plug-in has been open-sourced in GitHub according to GNU General Public License V2.0.
  • Not all OSs support the one-click password reset plug-in. Table 1 lists the OSs that support this plug-in.

For CentOS 8, disable SELinux before you install the one-click password reset plug-in. After the plug-in is installed, you can enable SELinux if necessary.

Table 1 OSs that support the one-click password reset plug-in
OS Type OS Version

SUSE

SUSE Linux Enterprise Server 15 SP7 64bit

SUSE Linux Enterprise Server 15 SP6 64bit

SUSE Linux Enterprise Server 15 SP5 64bit

SUSE Linux Enterprise Server 15 SP4 64bit

SUSE Linux Enterprise Server 15 SP3 64bit

SUSE Linux Enterprise Server 15 SP2 64bit

SUSE Linux Enterprise Server 15 SP1 64bit

SUSE Linux Enterprise Server 15 64bit

SUSE Linux Enterprise Server 12 SP5 64bit

SUSE Linux Enterprise Server 12 SP4 64bit

SUSE Linux Enterprise Server 12 SP3 64bit

SUSE Linux Enterprise Server 12 SP2 64bit

SUSE Linux Enterprise Server 12 SP1 64bit

SUSE Linux Enterprise Server 11 SP4 64bit

SUSE Linux Enterprise Server 11 SP3 64bit

SUSE Linux Enterprise Server 11 SP3 32bit

Oracle Linux

Oracle Linux Server release 10.0 64bit

Oracle Linux Server release 9.6 64bit

Oracle Linux Server release 9.5 64bit

Oracle Linux Server release 9.4 64bit

Oracle Linux Server release 9.3 64bit

Oracle Linux Server release 9.2 64bit

Oracle Linux Server release 9.1 64bit

Oracle Linux Server release 9.0 64bit

Oracle Linux Server release 8.10 64bit

Oracle Linux Server release 8.9 64bit

Oracle Linux Server release 8.8 64bit

Oracle Linux Server release 8.7 64bit

Oracle Linux Server release 8.6 64bit

Oracle Linux Server release 8.5 64bit

Oracle Linux Server release 8.4 64bit

Oracle Linux Server release 8.3 64bit

Oracle Linux Server release 8.2 64bit

Oracle Linux Server release 8.1 64bit

Oracle Linux Server release 8.0 64bit

Oracle Linux Server release 7.9 64bit

Oracle Linux Server release 7.8 64bit

Oracle Linux Server release 7.7 64bit

Oracle Linux Server release 7.6 64bit

Oracle Linux Server release 7.5 64bit

Oracle Linux Server release 7.4 64bit

Oracle Linux Server release 7.3 64bit

Oracle Linux Server release 7.2 64bit

Oracle Linux Server release 7.1 64bit

Oracle Linux Server release 7.0 64bit

Oracle Linux Server release 6.10 64bit

Oracle Linux Server release 6.9 64bit

Oracle Linux Server release 6.8 64bit

Oracle Linux Server release 6.7 64bit

Oracle Linux Server release 6.5 64bit

Red Hat

Redhat Linux Enterprise 10.0 64bit

Redhat Linux Enterprise 9.6 64bit

Redhat Linux Enterprise 9.5 64bit

Redhat Linux Enterprise 9.4 64bit

Redhat Linux Enterprise 9.3 64bit

Redhat Linux Enterprise 9.2 64bit

Redhat Linux Enterprise 9.1 64bit

Redhat Linux Enterprise 9.0 64bit

Redhat Linux Enterprise 8.10 64bit

Redhat Linux Enterprise 8.9 64bit

Redhat Linux Enterprise 8.8 64bit

Redhat Linux Enterprise 8.7 64bit

Redhat Linux Enterprise 8.6 64bit

Redhat Linux Enterprise 8.5 64bit

Redhat Linux Enterprise 8.4 64bit

Redhat Linux Enterprise 8.3 64bit

Redhat Linux Enterprise 8.2 64bit

Redhat Linux Enterprise 8.1 64bit

Redhat Linux Enterprise 8.0 64bit

Redhat Linux Enterprise 7.9 64bit

Redhat Linux Enterprise 7.8 64bit

Redhat Linux Enterprise 7.7 64bit

Redhat Linux Enterprise 7.6 64bit

Redhat Linux Enterprise 7.5 64bit

Redhat Linux Enterprise 7.4 64bit

Redhat Linux Enterprise 7.3 64bit

Redhat Linux Enterprise 7.2 64bit

Redhat Linux Enterprise 7.1 64bit

Redhat Linux Enterprise 7.0 64bit

Redhat Linux Enterprise 6.10 64bit

Redhat Linux Enterprise 6.9 64bit

Redhat Linux Enterprise 6.8 64bit

Redhat Linux Enterprise 6.7 64bit

Redhat Linux Enterprise 6.6 64bit

Redhat Linux Enterprise 6.6 32bit

Redhat Linux Enterprise 6.5 64bit

Redhat Linux Enterprise 6.4 64bit

Redhat Linux Enterprise 6.4 32bit

AlmaLinux

AlmaLinux 10.1 64bit

AlmaLinux 10.0 64bit

AlmaLinux 9.7 64bit

AlmaLinux 9.6 64bit

AlmaLinux 9.5 64bit

AlmaLinux 9.4 64bit

AlmaLinux 9.3 64bit

AlmaLinux 9.2 64bit

AlmaLinux 9.1 64bit

AlmaLinux 9.0 64bit

AlmaLinux 8.10 64bit

AlmaLinux 8.9 64bit

AlmaLinux 8.8 64bit

AlmaLinux 8.7 64bit

AlmaLinux 8.6 64bit

AlmaLinux 8.5 64bit

AlmaLinux 8.4 64bit

AlmaLinux 8.3 64bit

UnionTechOS

UnionTechOS Server 20 (1070e) Euler 64bit

UnionTechOS Server 20 (1060e) Euler 64bit

UnionTechOS Server 20 (1050u2e) Euler 64bit

UnionTechOS Server 20 (1050e) Euler 64bit

UnionTechOS Server 20 (1020e) Euler 64bit

UnionTechOS Server 20 Euler 64bit

Rocky

Rocky Linux 10.1 64bit

Rocky Linux 10.0 64bit

Rocky Linux 9.7 64bit

Rocky Linux 9.6 64bit

Rocky Linux 9.5 64bit

Rocky Linux 9.4 64bit

Rocky Linux 9.3 64bit

Rocky Linux 9.2 64bit

Rocky Linux 9.1 64bit

Rocky Linux 9.0 64bit

Rocky Linux 8.10 64bit

Rocky Linux 8.9 64bit

Rocky Linux 8.8 64bit

Rocky Linux 8.7 64bit

Rocky Linux 8.6 64bit

Rocky Linux 8.5 64bit

Rocky Linux 8.4 64bit

Rocky Linux 8.3 64bit

FreeBSD

FreeBSD 14.3 64bit

FreeBSD 14.2 64bit

FreeBSD 14.1 64bit

FreeBSD 14.0 64bit

FreeBSD 13.2 64bit

FreeBSD 13.1 64bit

FreeBSD 13.0 64bit

FreeBSD 12.4 64bit

FreeBSD 12.3 64bit

FreeBSD 12.2 64bit

FreeBSD 12.1 64bit

FreeBSD 12.0 64bit

FreeBSD 11.4 64bit

FreeBSD 11.3 64bit

FreeBSD 11.2 64bit

FreeBSD 11.1 64bit

FreeBSD 11.0 64bit

CentOS Stream

CentOS Stream 10 64bit

CentOS Stream 9 64bit

CentOS Stream 8 64bit

Ubuntu

Ubuntu 24.04 server 64bit

Ubuntu 22.04 server 64bit

Ubuntu 20.04 server 64bit

Ubuntu 19.04 server 64bit

Ubuntu 18.04.2 server 64bit

Ubuntu 18.04.1 server 64bit

Ubuntu 18.04 server 64bit

Ubuntu 16.04.6 server 64bit

Ubuntu 16.04.5 server 64bit

Ubuntu 16.04.4 server 64bit

Ubuntu 16.04.3 server 64bit

Ubuntu 16.04.2 server 64bit

Ubuntu 16.04 server 64bit

Ubuntu 14.04.5 server 64bit

Ubuntu 14.04.4 server 64bit

Ubuntu 14.04.4 server 32bit

Ubuntu 14.04.3 server 64bit

Ubuntu 14.04.3 server 32bit

Ubuntu 14.04.1 server 64bit

Ubuntu 14.04.1 server 32bit

Ubuntu 14.04 server 64bit

Ubuntu 14.04 server 32bit

openSUSE

OpenSUSE 15.7 64bit

OpenSUSE 15.6 64bit

OpenSUSE 15.6 64bit

OpenSUSE 15.5 64bit

OpenSUSE 15.4 64bit

OpenSUSE 15.3 64bit

OpenSUSE 15.2 64bit

OpenSUSE 15.1 64bit

OpenSUSE 15.0 64bit

OpenSUSE 42.3 64bit

OpenSUSE 42.2 64bit

OpenSUSE 42.1 64bit

OpenSUSE 13.2 64bit

OpenSUSE 11.3 64bit

CentOS

CentOS 8.5 64bit

CentOS 8.4 64bit

CentOS 8.3 64bit

CentOS 8.2 64bit

CentOS 8.1 64bit

CentOS 8.0 64bit

CentOS 7.9 64bit

CentOS 7.8 64bit

CentOS 7.7 64bit

CentOS 7.6 64bit

CentOS 7.5 64bit

CentOS 7.4 64bit

CentOS 7.3 64bit

CentOS 7.2 64bit

CentOS 7.1 64bit

CentOS 7.0 64bit

CentOS 7.0 32bit

CentOS 6.10 64bit

CentOS 6.10 32bit

CentOS 6.9 64bit

CentOS 6.8 64bit

CentOS 6.7 64bit

CentOS 6.7 32bit

CentOS 6.6 64bit

CentOS 6.6 32bit

CentOS 6.5 64bit

CentOS 6.5 32bit

CentOS 6.4 64bit

CentOS 6.4 32bit

CentOS 6.3 64bit

CentOS 6.3 32bit

Debian

Debian GNU/Linux 13.2.0 64bit

Debian GNU/Linux 13.0.0 64bit

Debian GNU/Linux 12.11.0 64bit

Debian GNU/Linux 12.10.0 64bit

Debian GNU/Linux 12.9.0 64bit

Debian GNU/Linux 12.8.0 64bit

Debian GNU/Linux 12.7.0 64bit

Debian GNU/Linux 12.6.0 64bit

Debian GNU/Linux 12.5.0 64bit

Debian GNU/Linux 12.3.0 64bit

Debian GNU/Linux 12.4.0 64bit

Debian GNU/Linux 12.2.0 64bit

Debian GNU/Linux 12.1.0 64bit

Debian GNU/Linux 12.0.0 64bit

Debian GNU/Linux 11.11.0 64bit

Debian GNU/Linux 11.10.0 64bit

Debian GNU/Linux 11.9.0 64bit

Debian GNU/Linux 11.8.0 64bit

Debian GNU/Linux 11.7.0 64bit

Debian GNU/Linux 11.6.0 64bit

Debian GNU/Linux 11.5.0 64bit

Debian GNU/Linux 11.4.0 64bit

Debian GNU/Linux 11.3.0 64bit

Debian GNU/Linux 11.2.0 64bit

Debian GNU/Linux 11.1.0 64bit

Debian GNU/Linux 11.0.0 64bit

Debian GNU/Linux 10.13.0 64bit

Debian GNU/Linux 10.12.0 64bit

Debian GNU/Linux 10.11.0 64bit

Debian GNU/Linux 10.10.0 64bit

Debian GNU/Linux 10.9.0 64bit

Debian GNU/Linux 10.8.0 64bit

Debian GNU/Linux 10.7.0 64bit

Debian GNU/Linux 10.6.0 64bit

Debian GNU/Linux 10.5.0 64bit

Debian GNU/Linux 10.4.0 64bit

Debian GNU/Linux 10.3.0 64bit

Debian GNU/Linux 10.2.0 64bit

Debian GNU/Linux 10.1.0 64bit

Debian GNU/Linux 10.0.0 64bit

Debian GNU/Linux 9.13.0 64bit

Debian GNU/Linux 9.3.0 64bit

Debian GNU/Linux 9.0.0 64bit

Debian GNU/Linux 8.8.0 64bit

Debian GNU/Linux 8.7.0 64bit

Debian GNU/Linux 8.6.0 64bit

Debian GNU/Linux 8.5.0 64bit

Debian GNU/Linux 8.4.0 64bit

Debian GNU/Linux 8.2.0 64bit

Fedora

Fedora 42 64bit

Fedora 41 64bit

Fedora 40 64bit

Fedora 39 64bit

Fedora 38 64bit

Fedora 37 64bit

Fedora 36 64bit

Fedora 35 64bit

Fedora 34 64bit

Fedora 33 64bit

Fedora 32 64bit

Fedora 31 64bit

Fedora 30 64bit

Fedora 29 64bit

Fedora 28 64bit

Fedora 27 64bit

Fedora 26 64bit

Fedora 25 64bit

Fedora 24 64bit

Fedora 23 64bit

Fedora 22 64bit

EulerOS

EulerOS 2.12 64bit

EulerOS 2.11 64bit

EulerOS 2.10 64bit

EulerOS 2.9 64bit

EulerOS 2.8 64bit

EulerOS 2.7 64bit

EulerOS 2.5 64bit

EulerOS 2.3 64bit

EulerOS 2.2 64bit

EulerOS 2.1 64bit

openEuler

openEuler 25.03 64bit

openEuler 24.03 SP3 64bit

openEuler 24.03 SP2 64bit

openEuler 24.03 SP1 64bit

openEuler 24.03 64bit

openEuler 22.03 SP4 64bit

openEuler 22.03 SP3 64bit

openEuler 22.03 SP2 64bit

openEuler 22.03 SP1 64bit

openEuler 22.03 64bit

openEuler 20.03 SP3 64bit

openEuler 20.03 SP2 64bit

openEuler 20.03 SP1 64bit

openEuler 20.03 64bit

KylinOS

KylinOS V11 64bit

KylinOS V10 SP3 64bit

KylinOS V10 SP2 64bit

KylinOS V10 SP1 64bit

KylinOS V10 64bit

KylinOS Desktop V10 64bit

KylinSec

KylinSec 3.3 64bit

KylinSec 3.5 64bit

HCE OS

HCE OS 2.0 64bit

iSoft

iSoft V5.1 64bit

Liberty

Liberty Basic 64bit

LinxOS

LinxOS 6.0.99 el20.03 sp3 64bit

Huawei Cloud EulerOS

Huawei Cloud EulerOS 2.0 64bit

Huawei Cloud EulerOS 1.1 64bit

Huawei Cloud EulerOS 1.0 64bit

RedFlag

RedFlag Asianux Server Linux V8 64bit

RedFlag Asianux Linux V7.5 64bit

RedFlag Asianux Linux V7.0 64bit

NeoKylin

NeoKylin 7.7 64bit

NeoKylin 7.4 64bit

NeoKylin V7 64bit

NeoKylin Linux Advanced Server release 7.0 U5 64bit

NeoKylin Server release 5.0 U2 64bit

Prerequisites

  • The ECS status is Running.
  • The ECS must have a remaining space of more than 300 MB, and data can be written to its root directory.
  • SELinux affects the password reset plug-in of Linux ECSs. Disable SELinux by referring to Disabling SELinux.
  • ECSs created using a SUSE 11 SP4 image must have 4 GB or a larger memory.
  • DHCP must be enabled for the VPC used by the ECS.
  • Networks of the ECS are normal.
  • The outbound security group rule of the ECS must meet the following requirements:
    • Protocol: TCP
    • Port Range: 80
    • Remote End: 169.254.0.0/16

    If you use the default outbound security group rule, preceding requirements can be met, and the ECS can be initialized. The default outbound security group rule is as follows:

    • Protocol: All
    • Port Range: All
    • Remote End: 0.0.0.0/16

Procedure

  1. Check whether the one-click password reset plug-in has been installed on the ECS.

    1. Log in to the ECS as user root.
    2. Check whether CloudResetPwdAgent has been installed:

      ls -lh /Cloud*

      Figure 1 Checking whether the plug-in has been installed

      Check whether the obtained information is similar to that shown in Figure 1.

      • If yes, the plug-in has been installed.
      • If no, the plug-in has not been installed. Perform the following steps to install it.

  2. Download CloudResetPwdAgent.zip and verify its integrity by referring to Obtaining the One-Click Password Reset Plug-in (Linux).

    There is no special requirement for the directory that stores CloudResetPwdAgent.zip.

  3. Run the command below to decompress CloudResetPwdAgent.zip.

    The package can be decompressed to any directory.

    unzip -o -d decompressed-directory CloudResetPwdAgent.zip

    For example:

    If the plug-in is decompressed to /home/linux/test, run the following command:

    unzip -o -d /home/linux/test CloudResetPwdAgent.zip

  4. Install the one-click password reset plug-in.

    1. Run the following command to open the CloudResetPwdAgent.Linux file:

      cd CloudResetPwdAgent/CloudResetPwdAgent.Linux

    2. Run the following command to add the execute permission for the setup.sh file:

      chmod +x setup.sh

    3. Run the following command to install the plug-in:

      sudo sh setup.sh

      If "cloudResetPwdAgent install successfully." is displayed and "Failed to start service cloudResetPwdAgent" is not displayed, the installation is successful.
      • You can also check whether the plug-in has been installed using the methods provided in 1.
      • If the installation failed, check whether the installation environment meets the requirements and install the plug-in again.

  5. Modify the file permissions of the password reset plug-in.

    chmod 700 /CloudrResetPwdAgent/bin/cloudResetPwdAgent.script

    chmod 700 /CloudrResetPwdAgent/bin/wrapper

    chmod 600 /CloudrResetPwdAgent/lib/*