Root Login Issues

If you log in as root to the Unified Access Gateway console with the correct username and password and get a "Login incorrect" error, check for keyboard mapping issues and reset the root password.

There are several reasons why a login error occurs:

• the keyboard used does not map certain password characters correctly according to the keyboard definition of Unified Access Gateway
• the password expired. The root password expires 365 days after deploying the OVA file.
• the password was not set correctly when the appliance was deployed. This is a known issue with older versions of Unified Access Gateway.
• the password has been forgotten.

To test that the keyboard is mapping characters correctly, try entering the password in response to the "Login:" username prompt. This allows you to see each password character and may identify where characters are being misinterpreted.

For all other causes, reset the root password of the appliance.

Note: To reset the root password you must:

• have login access to vCenter
• know the vCenter login password
• have permission to access the appliance console

If you have set up a Grub 2 boot loader menu password for the appliance, you will need to enter this as part of this procedure.

Procedure

1. Restart the appliance from vCenter and immediately connect to the console.

2. As soon as the Photon OS splash screen appears, press e to enter GNU GRUB edit menu.

3. In the GNU GRUB edit menu, change the line that starts with linux so that it contains linux /boot/$photon_linux root=$rootpartition rw init=/bin/bash. After changing this line, GNU GRUB edit menu should look exactly like this:

   

   Note: For a FIPS appliance, the line must be linux /boot/$photon_linux root=$rootpartition rw init=/bin/bash fips=1

   Press the F10 key.

4. (Optional) Run this command to check if the account(s) is locked.

   /sbin/faillock --user root
   

   If the account(s) is locked, run this command to unlock the account.

   /sbin/faillock --user root --reset
   

5. Enter passwd to change the password.

   passwd

   New password:

   Retype new password:

   passwd: password updated successfully

6. Reboot the appliancereboot -f

   After the appliance boots, log in as root with the newly set password.