Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Minor updates

...

Info
titleFinding the detailed error message is important!

In DSpace 7, there are two main places where detailed error messages may be found. It is important to locate these detailed error messages in order to debug any issues you are seeing, as the error which displays in a User Interface error popup is usually a generic message.. (The generic error messages that appear in the User Interface do not provide enough information to debug the problem.)

  1. In your web browser's DevTools when running the User Interface - because the v7 User Interface is built with JavaScript (Angular.io), some errors are only visible in your browser (and therefore will never appear in log files). See "Finding the Error Message in the User Interface" below.
  2. In the backend's log files - Some errors (especially 500 responses/errors) will result in the error message being logged to your dspace.log or Tomcat logs. See "Finding error messages in the REST API logs" below.

Once you locate the detailed error, see the section on "Found an error message! Now what?" below.

...

If neither of these resulted in a solution to your error, proceed to "Reporting the error" below.

Reporting the error

There are a few ways you may choose to report this error. However, we ask that you only choose one, depending on which you prefer.

...

MAKE SURE to include the following information:

  1. Your environment: Operating system, version Version of DSpace (most important), operating system, version of Tomcat, Java, Node, etc.
    1. NOTE: on DSpace 4.x or aboveOn the backend, simply running "./dspace version" from the command line will provide much of this information for you.
  2. The exact steps you took to encounter the error, as this will help us in investigating the problem. Often, we need to understand how to replicate the error before we can determine what the underlying cause is.
  3. The error stacktrace / message that you found in your log file or Browser DevTools