Help Center/ Elastic Cloud Server/ User Guide/ Passwords and Key Pairs/ One-Click ECS Password Reset Plug-in/ Updating the One-Click Password Reset Plug-in for an ECS
Updated on 2024-10-18 GMT+08:00

Updating the One-Click Password Reset Plug-in for an ECS

You can reset the password for logging in to an ECS with just a few clicks if you forgot the password or the password expires.

This section describes how to update the one-click password reset plug-in for an ECS.

Notes

  1. The one-click password reset plug-in can be updated only after an EIP is bound to the ECS.
  2. By default, the one-click password reset plug-in has been installed on ECSs created using public images by default. Before updating the plug-in, uninstall it first.

Prerequisites

  • The available space in drive C of a Windows ECS is greater than 300 MB, and data can be written to it.
  • The available space in the root directory of a Linux ECS is greater than 300 MB, and data can be written to it.
  • For Linux ECSs, disable SELinux if it has been enabled.
  • One-click password reset can be used on the ECSs created using SUSE 11 SP4 only if their memory capacity is greater than or equal to 4 GiB.
  • DHCP is enabled in the VPC which the ECS belongs to.
  • The ECS network connectivity is normal.
  • The NIC has been set to DHCP so that the ECS can dynamically obtain an IP address.

    For details about how to set the NIC to DHCP for a Linux ECS, see Setting the NIC to DHCP.

    For details about how to set the NIC to DHCP for a Windows ECS, see Setting the NIC to DHCP.

  • The ECS security group rule in the outbound direction meets the following requirements:
    • Protocol: TCP
    • Port Range: 80
    • Remote End: 169.254.0.0/16

    If you use the default security group rules for the outbound direction, the preceding requirements are met, and the ECS can be initialized. The default security group rules for the outbound direction are as follows:

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

Updating the One-Click Password Reset Plug-in on a Linux ECS

  1. Uninstall the plug-in.

    1. Log in to the ECS.
    2. Run the following commands to switch to the bin directory and delete cloudResetPwdAgent:

      cd /CloudrResetPwdAgent/bin

      sudo ./cloudResetPwdAgent.script remove

    3. Delete the plug-in.

      sudo rm -rf /CloudrResetPwdAgent

    4. Check whether CloudResetPwdUpdateAgent exists. If it exists, go to the bin directory and delete the cloudResetPwdUpdateAgent service.

      cd /CloudResetPwdUpdateAgent/bin

      sudo ./cloudResetPwdUpdateAgent.script stop

      sudo ./cloudResetPwdUpdateAgent.script remove

    5. Delete the plug-in.

      sudo rm -rf /CloudResetPwdUpdateAgent

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

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

  3. Run the following command to decompress CloudResetPwdAgent.zip:

    There is no special requirement for the directory that stores the decompressed CloudResetPwdAgent.zip. Use 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 {Plug-in decompressed directory}/CloudResetPwdAgent/CloudResetPwdAgent.Linux

      For example:

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

      cd /home/linux/test/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 password reset plug-in has been installed using the methods provided in 1.
      • If the installation failed, check whether the installation environment meets 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/*

Updating the One-Click Password Reset Plug-in on a Windows ECS

  1. Uninstall the plug-in.

    1. Uninstall and delete CloudResetPwdAgent.
      1. Switch to the C:\CloudResetPwdAgent\bin folder.
      2. Double-click UninstallApp-NT.bat.
      3. Delete the file in C:\CloudResetPwdAgent.
    2. (Optional) Uninstall and delete CloudResetPwdUpdateAgent.
      The plug-in varies depending on the Windows version. Check whether CloudResetPwdUpdateAgent exists. If it exists, perform the following operations to uninstall and delete it. If it does not exist, skip this step.
      1. Go to the C:\CloudResetPwdUpdateAgent folder.
      2. Double-click UninstallApp-NT.bat.
      3. Delete the file in C:\CloudResetPwdUpdateAgent.

        If the deletion fails, delete CloudResetPwdUpdateAgent from Task Manager first and then delete the file in C:\CloudResetPwdUpdateAgent.

  2. Download the plug-in package CloudResetPwdAgent.zip and verify its integrity by referring to Obtaining the One-Click Password Reset Plug-in and Verifying Its Integrity (Windows).

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

  3. Decompress CloudResetPwdAgent.zip.

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

  4. Install the plug-in.

    1. Double-click setup.bat in CloudResetPwdAgent.Windows.

      The password reset plug-in starts to be installed.

    2. View the Task Manager and check whether the installation was successful.

      If cloudResetPwdAgent is displayed in the Task Manager, as shown in Figure 1, the installation was successful. Otherwise, the installation failed.

      Figure 1 Successful plug-in installation

      If the installation failed, check whether the installation environment meets requirements and install the plug-in again.

Follow-up Procedure

  • After the one-click password reset plug-in is updated, you can add it to the startup items if it cannot automatically start upon ECS startup. For details, see What Do I Do If the One-Click Password Resetting Plug-In Failed to Start?
  • After the one-click password reset plug-in is updated, do not delete the CloudResetPwdAgent process. Otherwise, one-click password reset will not be available.
  • If you have updated the one-click password reset plug-in, newly created ECSs work in PIPE mode by default to prevent the plug-in from using service ports. Existing ECSs still work in AUTO mode, in which the plug-in selects an idle port with the smallest port number from 31000 to 32999.