Applies To:
Foxtrot Administrator — All Editions

Summary:
When attempting to log into the Foxtrot Administrator, you receive an error message that the user database is missing, inaccessible, or corrupt.
database-missing-or-corrupt

Reasons for receiving this error message can include:
1. The license path previously defined in the Foxtrot Administrator has changed, is misspelled, or does not exist
2. The user does not have the appropriate permissions to the license path previously defined in the Foxtrot Administrator
3. The user does not have the appropriate permissions to the Foxtrot Suite folder
4. The user has the proper permissions to the Foxtrot Suite folder, but may not have the required permissions to the FTConfiguration.mdb file (located in the Foxtrot Suite directory)

Commonly, this will occur after reconfiguring the “Security Path”, which is the location of the FTConfiguration.mdb file, containing login information. After closing the Foxtrot Administrator, then attempting to login again, if one of the four permissions above are not properly configured, Foxtrot cannot access the tables needed to obtain the login information; thus causing the error message.

Resolution:

Depending on the version of Foxtrot installed and the operating system, you will need to verify permissions in the following directories and their files created by Foxtrot. The user should have read, write, and modify permissions to the paths and files that apply below:
1. Locate the FTSessionControl.cfg file, which in most standard installations will be in one of these 3 directories

  • C:\ProgramData\Foxtrot Suite

*For users running Foxtrot Suite v8.6.1 or higher

  • C:\Program Files (x86)\Foxtrot Suite

*For 64-bit machines

  • C:\Program Files\Foxtrot Suite

*For 32-bit machines

2. Open the “FTSessionControl.cfg” file using Notepad, and locate the entries:

  • “Server= server directory”
  • “UsersPath= user directory”
  • “MachinePath= machine directory”
  • “MessagePath= message directory”

3. Inspect for possible spelling errors

4. Verify that you have read, write, and modify permissions to the paths above – you should be able to navigate to them manually

  • Copy the UsersPath and paste it into the Windows file browser. This should open the directory that contains the “FTConfiguration.mdb” file
  • If any warnings or error messages are displayed, make adjustments as necessary

5. Locate the FTConfiguration.mdb file and view the file properties, by right clicking and selecting properties. Select the Security tab, and verify that the file has read, write, and modify permisions.

To set the folder permissions:

  • Navigate out to the correct path (above) and right click on the folder
  • Select Properties
  • Select the Security Tab
  • Set the users group permissions to read, write and modify

User Permissions

If permission levels are set appropriately, and you continue to receive the error, please contact EnableSoft support at 800-658-1147, or by email at support@enablesoft.com.

Last Modified 03/12/2015