1. Home
  2. StayLinked Administrator
  3. Reset the Master Administrator Account

Reset the Master Administrator Account

The StayLinked Administrator master administrator account can become locked and prevent access to the StayLinked Server.

The master account can be reset by placing a special blank file on your StayLinked Server and restarting the server process. This will end all active sessions on the server and would typically be scheduled for a time that would impact the fewest possible users.

Create an empty file name resetadmin.xml and place it in the config subdirectory of your server. Once the file is in place, stop and start the server process and the file should be automatically deleted. Once the file is automatically cleaned up, you will be able to log in to the administrator account with the default password of esp. For iSeries systems, this file would be placed in the IFS directory \QIBM\UserData\Stay-Linked\Config. Windows Servers would have the file in \Program Files\Stay-Linked\Config.

We recommend that you create alternative accounts and set the password expiration interval to your desired duration. Setting the value to 0 will prevent account passwords from expiring.

Note: Placing the file in the Stay-Linked Administrator directories will have no effect on the Server.

If the default administrator account still has a password of 'esp', but has become disabled, placing the resetadmin.xml file in the Server’s config subdirectory may allow a reset of the account without a restart of the Server process. Attempt to log in with the administrator master account and esp password twice and the reset will take place if allowed.

Instructional Video: Reset the Master Administrator Account

Resetting the entire Administrator User Account Database

In rare cases, you may need to reset the entire database. This can be done by replacing the entire 'devices' subdirectory of StayLinked on the StayLinked Server. The server process must be stopped to copy in or out this folder. Attempting to copy or replace contents of this folder while the server process is running can cause issues with the integrity of the database.

A fresh, default copy of this database can be found here.

Updated on October 24, 2023

Related Articles