Username & Password Recovery¶
When a user has forgotten their username or password there are both user and administrative tools to recover or reset this information.

If the SMTP Outgoing Mail Server is configured and working properly, users can recover their username or reset their password directly from the login page.
Alternatively the
nim-recovery-tool
is available from the NIM VM command line.
Username Recovery¶
Usernames can be recovered by clicking the FORGOT LOGIN
link at the login screen and entering the associated email address for the user. If a matching user account is found and the SMTP Outgoing Mail Server has been configured an email will be sent to the address with the username.
In the event that there is no available SMTP Outgoing Mail Server, the
nim-recovery-tool
can be used from the NIM VM console.
Password Reset¶
Passwords can be reset by clicking the FORGOT PASSWORD
link at the login screen and entering the username of the password to reset. If a matching account is found and and the SMTP Outgoing Mail Server has been configured an email will be sent with a new password for the user account. It is recommened to update this temporary password upon login.
In the event that there is no available SMTP Outgoing Mail Server, the
nim-recovery-tool
can be used from the NIM VM console.
NIM Recovery Tool¶
To recover a username using the nim-recovery-tool
, login to the NIM VM console.
The nim-recovery-tool script can assist an admin with gaining access to NIM.
The script can:
Reset any NIM user’s password to “password”
List all root users
Find a username associated with a specific email address
List all users
List all enabled users
Enable a user
Disable a user
To see instructions for using the script, enter:
sudo ./nim-recovery-tool
To find a username associated with a known email address:
sudo ./nim-recovery-tool -e "email@addr.ess"
To reset a user’s password:
sudo ./nim-recovery-tool -u username
To list all root users:
sudo ./nim-recovery-tool -r
To list all users:
sudo ./nim-recovery-tool -la
To list enabled users:
sudo ./nim-recovery-tool -le
To enable a user:
sudo ./nim-recovery-tool -eu username
To disable a user:
sudo ./nim-recovery-tool -du username
Note
If the total number of enabled users exceeds the license limit, the most recently enabled users will be disabled automatically.