Reset Management Console Password for Okta Access Gateway

The password is no longer known when accessing the Okta Access Gateway (OAG) Management console, so the user is locked out. The password can be reset by booting the server into single-user mode and changing the password via the command line. This solution is only available on VMware systems.

• Okta Access Gateway (OAG)
• Secure Shell (SSH)
• Okta Classic Engine
• Okta Identity Engine (OIE)

This happens when the password is lost or no longer known.

How is the Okta Access Gateway management console password reset on VMware systems?

NOTE: This solution applies exclusively to VMware systems.

Reset the management console password on VMware systems by rebooting the server, accessing the shell configuration, and executing the password reset command by following these steps.

1. Gain console access.
2. Reboot the server (Keep console access up).

3. Once the screen below is seen, press the Spacebar (this will stop the screen from proceeding after 5 seconds). 

4. Select the key e to edit the configuration.
5. Move the cursor with the arrows to the end of the line starting with Linux (It takes up 3 lines as the text wraps). Type the text below, as seen in the screenshot.

   init=/bin/bash rw

   

6. Press the Ctrl key and x at the same time, and the system will now boot into the shell.
7. Change the password with the command below: 

   passwd oag-mgmt

8. Reboot the server using one of the following methods.

• • From the command line:

    echo b > /proc/sysrq-trigger

8. • From the VMware console (reboot, shutdown, power on).
     • Select the Ctrl+Alt+Delete button.
9. Now SSH to the server and log in with the password entered in step 7.