Documentation forDatabase Mapper
Effective February 28, 2024, Database Mapper has reached its end of life and is no longer available or supported. If you liked Database Mapper, consider trying another SolarWinds product.

Database Mapper Troubleshooting

EOL: An end of life announcement has been made for Database Mapper on February 28, 2023. See the Solarwinds End of Life Policy for more information.

Remote Agents

Trouble installing remote agents

If you are having trouble installing the Database Mapper Remote Agent, enter the following command in the command prompt:

C:\Users\<Username>\Downloads>SentryOne.Document.Installer.msi /l*v Installer.log

This command creates a log file at the installer.log location. Proceed through the installation process, and once you reach an error, send the log file to SolarWinds support for further assistance with your installation.

Remote agent log files

The general log file (used during the startup and initialization of remote agents):

%ProgramData%\SentryOne\SentryOneDocumentRemoteAgentLog.log

The main log file, which is specific to the installed remote agent (friendly/service instance name):

%ProgramData%\SentryOne\SentryOneDocumentRemoteAgentLog_{Remote Agent Name}.log

Software (On-Premises)

Log File

A log file for Database Mapper Software can be found under the installation directory:

%PROGRAMFILES(x86)%\SentryOne\SentryOne Document\SentryOneDocumentApi\App_Data\SentryOne.Document.Web.API.log

Logging Level

Logging is set to record any error by default. If you want your log to record more detailed data, you can change the configuration file to debug mode. To adjust the config file, go to:

C:\Program Files (x86)\SentryOne\SentryOne Document Remote Agent\SentryOne.Document.RemoteAgent.exe.config

Note:  This is the config file for all remote agents.

Snapshot Log Files

A log file for a failed snapshot can be found in the Solution's Task History page. Select the button to download the log file.

Database Mapper Solution Task History Download Log File

Solution ID

The Solution can be found in the URL of the Solution's Task History. Provide the Solution ID to support so they can identify the Solution where you are having issues. The Solution ID is in the URL as displayed below:

Database Mapper Solution Task History Solution ID in URL

Data Storage

Important:  The following data stores contain data that is important to the functioning of Database Mapper Software.

SQL Server

After the initial installation, the database is empty. The schema itself is created dynamically, as needed.

File System

Some content is stored to disk in the following location:

%ProgramData%\SentryOne\Document\_blobStorage\

Note:  Full read and write access to this location will be required by the account under which the site is running in IIS.

HTTP Error 401.2 - Unauthorized

You are not authorized to view this page due to invalid authentication headers.

Most likely causes:

  • No authentication protocol (including anonymous) is selected in IIS.
  • Only integrated authentication is enabled, and a client browser was used that does not support integrated authentication.
  • Integrated authentication is enabled and the request was sent through a proxy that changed the authentication headers before they reach the Web server.
  • The Web server is not configured for anonymous access and a required authorization header was not received.
  • The "configuration/system.webServer/authorization" configuration section may be explicitly denying the user access.

HTTP Error 401.2 Unauthorized Description Page

What we've seen this mean:

This error has shown up when the Windows Authentication feature for IIS has been turned off or disabled. Windows Authentication is a requirement for the self-hosted version of Database Mapper. There are some examples below, but always check with the official Microsoft documentation for up-to-date information on these features and settings.

Step 1. Ensure that Windows Authentication is turned on under Windows Features:

Turn Windows features on or off screen

Step 2. Ensure that Windows Authentication is enabled for the Database Mapper API and Database Mapper Host Sites in Internet Information Services (IIS) Manager.

Internet Information Services (IIS) Manager showing Windows Authentication Enabled

Important:  Windows Authentication must be enabled for the Database Mapper  Sites