:orphan:

********************************************
Password recovery for appliance How to guide
********************************************

""""""""""
Overview
""""""""""

This document outlines how to reset the admin password back to factory defaults for a Swivel hardware or VM appliance.

""""""""""""""""""""""""""
Prerequisites
""""""""""""""""""""""""""

Swivel Appliance 2.x, 3.x, 4.x

""""""""""""""""""""""""""""""""""""""""""""""""""""""
Admin Console Password Reset Procedure using Sysresccd
""""""""""""""""""""""""""""""""""""""""""""""""""""""

This procedure can be used when the Webmin cannot be logged into.

**Boot from sysrescue CD**

See `System Rescue CD <Appliance_fails_to_boot_after_power_outage.html>`_

**Mount file system**

Mount the root partition. Note: If sda2 is not found then try sdb2 instead.

.. code-block:: text

     mkdir /root/temp

.. code-block:: text

    mount /dev/sda2 /root/temp

.. code-block:: text

    export SHELL=/bin/bash

.. code-block:: text

    chroot /root/temp

This will take you to a different prompt. Then run the following command:

.. code-block:: text

    passwd admin

Type in the default password. You will be asked to confirm it.

**Known Issues**

When trying to the above step of "passwd admin" and you are present with the error "Unknown user 'admin'" then vi /etc/passwd and add the following line to the list:

admin:x:0:0::/home/admin:/bin/bash

"""""""
Testing
"""""""

Login with the default username and password.