Password for a local recovery or supervisor user is forgotten

If you cannot log in to Lenovo XClarity Administrator using another supervisor account or if another supervisor account does not exist, you can reset the password for a local user with lxc-recovery or lxc-supervisor authority by mounting an ISO image that contains a configuration file with the new password.

Before you begin

To reset the password using this method, you must have access on the XClarity Administrator host system.

The user name that is being reset must have lxc-recovery or lxc-supervisor authority.

The password must adhere to the same validation rules that XClarity Administrator enforces

After the password is reset, the user is not required to change the password on the first access

Procedure

To create and mount the ISO image, complete the following steps.

  1. Power off the virtual machine.
  2. Create a file named passwordreset.properties that contains the following parameters.
    user=
    password=
    You can use the echo command to create the file, for example:
    ECHO user=admin > ./ passwordreset.properties
    ECHO password=New_Passw0rd >> ./ passwordreset.properties
  3. Create an ISO image that contains the passwordreset.properties file.

    To create an ISO image on Windows, use your favorite ISO software. On Linux, use the mkisofs command, for example

    mkisofs -V passreset -J -o ./passreset.iso ./passwordreset.properties

    where -V is the volume label, -J is for Joliet format, -o is the output file name, and / passwordreset.properties is the file to be included in the ISO image

  4. Upload the ISO image to a suitable location using the Datastore Browser.

  5. Mount the ISO image to the virtual machine.

    • For Citrix:

      1. Mount the configuration .ISO image as a physical CD drive to the virtual machine.

      2. From Citrix , select the XClarity Administrator virtual machine.

      3. Click the Console tab.

      4. Select the physical CD from the drive list.

    • For Nutanix AHV hosts:

      1. Click the Settings menu (Nutanix gear menu icon), and then click Image configuration to display the Image Configuration dialog.

      2. Upload the eth0_config.iso image.

        1. From the Image Configuration dialog, click Upload Image to display the Create Image dialog again.

        2. Specify a name for the ISO image.

        3. Select ISO for the image type.

        4. Select Upload a file, click Choose File, and select the eth0_config.iso image.

        5. Click Save to upload the file.

        6. Click Close to close the Image Configuration dialog.

      3. Wait until the upload processes are completed before continuing with the setup steps. The status circle in the menu indicates when the processes are complete.

      4. Add a disk for the eth0_config.iso image.

        1. From the VM, click Update from the bottom menu bar.

        2. Click the Edit icon for the CDROM disk to display the Edit Disk dialog.

        3. Select Clone from Image Service for the operations.

        4. Select the ISO image that you created earlier from the image list.

        5. Click Update.

        6. Click Save.

    • For RedHat KVM hosts:

      1. From Virtual Machine Manager, select the virtual machine, and then click Add Hardware to display the Add new Virtual Hardware dialog.

      2. Click the Storage tab.

      3. Select Select managed or other existing storage, click Browse, and select the eth0_config.iso image.

      4. Select VirtIO for the device type.

        Note: For XClarity Administrator 1.4.0 and earlier, select IDE for the disk bus.
      5. Select None for the cache mode.

      6. Click Finish.

    • For VMware ESXi hosts:

      The ISO file must reside in the datastore of the ESXi host so that it can be mounted as a CD/DVD drive on the XClarity Administrator virtual machine.

      1. Right click the virtual machine, and click Edit Settings.
      2. Click Add to display the Add Hardware wizard.
      3. Click CD/DVD Drive, and click Next.
      4. Select Use ISO image, and click Next.
      5. Select the ISO image, and click Next.
      6. Select the virtual device node, and click Next.
      7. Click Finish.
    • For Windows Hyper-V hosts:

      Important: The virtual machine must be powered off before mounting the ISO image.
      1. In the Hyper-V Manager window, right-click the virtual appliance, and click Connect to display the Virtual Machine Connection window.

      2. Click Media > DVD Drive > Insert Disk.

      3. Select the ISO image, and click Open.

  6. Power on the virtual machine, and then log in to the XClarity Administrator web interface using the user name and password that is specified in the passwordreset.properties file (see Logging in to Lenovo XClarity Administrator ).

  7. Unmount the drive, and delete the ISO image.

    • For Citrix

      1. From the Citrix hypervisor, select the XClarity Administrator virtual machine.

      2. Click the Console tab.

      3. Clear the physical CD associated with the configuration ISO from the driver list.

    • For Nutanix AHV hosts:

      1. From the VM, click Update from the bottom menu bar.

      2. Click the Edit icon for the CDROM disk to display the Edit Disk dialog.

      3. Click the Eject icon.

      4. Click Save.

    • For VMware ESXi hosts:

      1. Right click the virtual machine, and click Edit Settings.

      2. Select the mounted drive from the list of hardware, and click Remove.

      3. Click OK. The drive is now disconnected.

      4. Right click the virtual machine, and click Edit Settings again.

      5. Select the drive from the list of hardware, and clear the Connect at power on checkbox.

      6. Click OK.

      7. Delete the ISO image from the datastore.

    • For Windows Hyper-V hosts:

      1. In the Hyper-V Manager window, right-click the virtual appliance, and click Connect to display the Virtual Machine Connection window.

      2. Click Media > DVD Drive > Eject iso_image_name.iso.

      3. Delete the ISO image from the datastore.