.. _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-4-UC 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-4-UC 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-4-UC 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-4-UC system boots.
#. While the cursor highlights the first GRUB console entry (Ubuntu), press e.
#. 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** to type in and confirm a new password. Check for the success message.
   
   **mount -o rw /var/log** to allow counters to be reset.
   
   **/sbin/pam_tally2 --reset --user platform** to reset the failed password attempt counter.
   
   **sync** to force a file system sync.
   
   **exit** to 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.