All documentation
  • Introduction
  • Connecting to data source
  • Browser compatibility
  • Documentation for older versions
  • Troubleshooting the Data Server

    In this tutorial, you can learn how to troubleshoot issues with Flexmonster Data Server. To check if a solution to your issue already exists, see the Common issues with the Data Server guide.

    Basic troubleshooting

    Start troubleshooting the Data Server with the following steps:

    Step 1. Check the Data Server logs for additional information.

    Step 2. See if your issue is in the list of common issues.

    Step 3. Take a look at our release notes to see if your issue was fixed in one of the newer Data Server versions. If the issue was fixed, update the Data Server.

    Step 4. Search for support tickets with a similar issue.

    Step 5. Completely reinstall the Data Server and check if the issue is still present. See how to uninstall the Data Server as a service, as a console application, or as a DLL.

    Step 6. Report the issue if it occurs after following the previous steps.

    How to report the issue

    If the troubleshooting did not help you resolve the issue, raise a support ticket and provide the following information:

    • The error message. If there is none, provide a screenshot or a video recording of the issue.
    • Instructions on how to reproduce the issue.
    • The operating system on which the Data Server runs.
    • The Data Server version.
    • The Data Server logs.

    How to check the Data Server version

    Learn how to check the Data Server version depending on how the Data Server is used:

    As a Windows/Unix service

    Via the Admin Panel

    If you are using the Data Server and Admin Panel 2.9.53 or later, open the Help tab and find the Data Server version under the Server Version label.

    The Admin Panel 2.9.52 and earlier shows only its version under the Version label. In this case, check the Data Server's version via a browser.

    Via a browser

    Open the Data Server's address (e.g., http://localhost:9500) in the browser, where the Data Server's version will be displayed:

    We show how the Data Server's version will be displayed in the browser

    As a console application

    Open the Data Server's address (e.g., http://localhost:9500) in the browser, where the Data Server's version will be displayed:

    We show how the Data Server's version will be displayed in the browser

    As a DLL

    Via Visual Studio

    1. Right-click the project name and select the Manage NuGet Packages... option:
      How to find the Manage NuGet Packages item
    2. Go to the Installed tab and select the Flexmonster.DataServer.Core package to check its version: Here we show where is the Installed tab and where to check the version of Flexmonster.DataServer.Core package

    Via the console

    1. Open the console and navigate to your project’s directory.
    2. Run the following command:
      dotnet list package
    3. Find the Flexmonster.DataServer.Core and its version in the list of top-level packages: Here we show where the Flexmonster.DataServer.Core and its version are displayed

    How to find the Data Server logs

    The Data Server logs contain diagnostic data that can help identify the cause of the issue. Here is how to find the logs depending on how you use the Data Server:

    As a Windows/Unix service

    The Data Server logs are stored in the logs/ folder. It can be accessed from the Admin Panel:

    1. Open the Admin Panel.
    2. Go to the Diagnostics tab.
    3. Click Open Logs Folder. This will open the logs/ folder in the file manager.

    You can also access this folder directly by going to the flexmonster-data-server/ folder.

    Note If you have been using the Data Server prior to version 2.9.58, another possible location of the logs is the following folder:

    • On Windows — C:/ProgramData/FlexmonsterDataServer/logs/.
    • On macOS and Ubuntu/Linux — ~/.local/share/FlexmonsterDataServer/logs/ (will resolve to /home/[current_user]/.local/share/FlexmonsterDataServer/logs/).

    As a console application

    To access the Data Server logs, go to the flexmonster-data-server/ folder and open the logs/ subfolder.

    Note If you have been using the Data Server prior to version 2.9.58, another possible location of the logs is the following folder:

    • On Windows — C:/ProgramData/FlexmonsterDataServer/logs/.
    • On macOS and Ubuntu/Linux — ~/.local/share/FlexmonsterDataServer/logs/ (will resolve to /home/[current_user]/.local/share/FlexmonsterDataServer/logs/).

    As a DLL

    See also