FadenDocumentation
Demo PLEN

Administration

Troubleshooting and support

Admin window: installation status, health checks and a diagnostic archive for support.

Address in the app: /admin/support

The Troubleshooting & support window shows installation details and health checks. It also generates a diagnostic archive to send to support. Only administrators can open it.

The archive holds diagnostics, not business documents or a backup. Backups are in the Backups window.

What the window looks like

/admin/support
The window with installation details, health checks and archive options.

Parts of the window

  1. Installation

    Application version, build time, deployment, runtime, license ID and status, and the paid support status.

  2. Health checks

    The table lists each check with its status (ok, warning, error) and details, such as free disk space. The button runs the checks again.

  3. Creating the archive

    Five options: health checks, non-secret configuration, application logs, pseudonymized audit activity and license. Each has a description of what it contains.

  4. Generating

    Starts building the archive in the background. The current stage appears below, followed by the work and log folders on the server.

  5. Latest archive

    Date and size, SHA-256 sum and the Download latest .tar.gz button. The section appears once a completed archive exists.

How to

  1. Check the installation

    Review the Installation section and the Health checks table. Choose Run health checks to check again.

  2. Choose what to include

    In Create support archive tick or untick the options. All are ticked by default. With nothing ticked the archive cannot be generated.

  3. Generate the archive

    Choose Generate support archive. The current stage appears below the button. While it runs, the options and the button are locked.

  4. Download the archive

    When it finishes, choose Download latest .tar.gz in Latest completed support archive.

Good to know

  • The latest archive shows its date, size and SHA-256 sum. On an error a support code appears next to the message: give it to support.
  • Review the content before sending: dates and activity patterns may still point to your installation.

Limitations

  • Only administrators can download. A new completed archive invalidates the previous link.
  • Work folders and old archives are not deleted automatically: the administrator cleans them up. They are not part of application backups.
  • When paid support or the license has expired, the window shows a warning. You can still generate and download the archive.

See also