.. _platform_user_password_recovery_procedure:

Platform User Password Recovery Procedure
-----------------------------------------

.. _12.5(1)|DOC-156:
.. _19.1|DOC-156:


The steps below describe how to reset the VOSS Automate platform user password if
you forget the password and you are not able to access the CLI via
platform user.

#. Log in to VMWare and choose the VOSS Automate Virtual Machine (VM).
#. Right-click the VM and choose **Edit Settings**.
#. Disconnect the network adapter by un-checking the **Connected** check box.
   This ensures that transactions are not lost.
#. Click the **VM Options** tab, **During the next boot, force entry into the BIOS setup screen**
   check-box is checked.
#. Click the **OK** button to apply the settings.
#. Open the VOSS Automate display (**Launch Virtual Machine Console**).
#. Under the **Power** menu option, click the reboot button (**Restart Guest**).
#. In the VM console, press F10 and **YES** to exit the BIOS (Do not make any changes in the BIOS).
   The next step needs to be performed quickly before the VOSS Automate system boots.
#. While the cursor highlights the first GRUB console entry (Ubuntu), press e.
   For username, enter: ``platform`` and password = boot password configured during setup.
#. Navigate to the second to the last line which starts with ``linux``
   and ends with ``fsck.repair=yes``.
#. Navigate to the end of the line after ``=yes``, add a space and add ``init=/bin/bash``.
#. Press Ctrl-x in order to boot the system.
#. When the system has booted, on the console at the ``root@(none):/#`` prompt, enter commands as follows:
  
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``mount -o remount,rw /``                    |                                                                    |
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``passwd platform``                          | Type in and confirm a new password. Check for the success message. |
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``mount -o rw /var/log``                     | Allow counters to be reset.                                        |
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``/sbin/pam_tally2 --reset --user platform`` | Reset the failed password attempt counter.                         |
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``sync``                                     | Force a file system sync.                                          |
   +----------------------------------------------+--------------------------------------------------------------------+
   | ``exit``                                     | Exit the console.                                                  |
   +----------------------------------------------+--------------------------------------------------------------------+

#. Reconnect the VM network adapter under the **Edit Settings** option.
#. Power off the VM and power on the VM again.
#. When the system boots, choose the default highlighted GRUB entry (not recovery mode).
#. Allow the disk checks to complete if they do run.
#. You can now log in as platform user with the password set above.