HAProxy Enterprise Documentation 13.0

Default Password Reset

Warning

This procedure involves editing the Grub bootloader to change how the operating system is loaded into memory. Use it with caution, and only if you have no other means of recovering the administrator password.

If you've lost your password, you can restore the default admin password without resetting all parameters to the factory defaults.

    • Connect to your physical appliance through the serial port, or

    • Connect to your virtual appliance through your hypervisor's graphical console.

  1. To display the Grub menu, press ESC.

       GNU Grub version 0.96 (639K lower / 1047488K upper memory)
    
    +-------------------------------------------------------------------+
    | Image 1 (VGA console)                                             |
    | Image 2 (VGA console)                                             |
    | Maintenance Kernel (serial console)                               |
    | Maintenance Kernel (VGA console)                                  |
    | Reboot                                                            |
    | Halt                                                              |
    +-------------------------------------------------------------------+
  2. Select Image 1, then press e.

       GNU Grub version 0.96 (639K lower / 1047488K upper memory)
    
    +-------------------------------------------------------------------+
    | root (hd0,1)                                                      |
    | savedefault savemap                                               |
    | kernel /sys/active/kernel.img root=/dev/ram0 ro auto quiet panic=1|
    | initrd /sys/active/initrd.img                                     |
    +-------------------------------------------------------------------+
  3. To edit the kernel line, select it, then press e.

    [ Minimal BASH-like line editing is supported. For the first word, TAB
      lists possible command completions. Anywhere else TAB lists the possible
      completions of a device/filename. ESC at any time exits. ]
    
    <t panic=1 flash=sda2 imag=active vmm=kvm console=tty0

    Note

    If you connect to a physical appliance through the serial port, the tty parameter should read ttyS0.

  4. Append INITSHELL=1 to the boot command.

    <t panic=1 flash=sda2 imag=active vmm=kvm console=tty0 INITSHELL=1
  5. Press Enter.

    The Grub menu displays again.

       GNU Grub version 0.96 (639K lower / 1047488K upper memory)
    
    +-------------------------------------------------------------------+
    | root (hd0,1)                                                      |
    | savedefault savemap                                               |
    | kernel /sys/active/kernel.img root=/dev/ram0 ro auto quiet panic=1|
    | initrd /sys/active/initrd.img                                     |
    +-------------------------------------------------------------------+
  6. To boot the kernel line command, select it, then press b.

    You have requested this prompt by appending INITSHELL=1 to the kernel cmd line.
    Entering command line mode : enter one command per line, end with '.'
    OK
    >
  7. To start a Bash shell, enter /bin/sh.

    > /bin/sh
    sh-3.00#
  8. Reset the default password, then exit the Bash console.

    sh-3.00# /sbin/restore-etc
    sh-3.00# cat /usr/share/factory/base-etc/shadow > /etc/shadow
    sh-3.00# /sbin/save-etc
    sh-3.00# exit
  9. To boot the appliance, enter . (a dot) at the new prompt.

    > .
  10. Log in to the appliance as user admin with the admin password.

  11. Change the default password from the Setup tab in the WUI.