From 8431888b9c6b0c9c193f4d90958ae3d5232e0c22 Mon Sep 17 00:00:00 2001 From: jo Date: Wed, 1 Feb 2023 20:13:13 +0100 Subject: [PATCH] docs: check logs before checking services status --- docs/admin-manual/troubleshooting.md | 56 ++++++++++++++-------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/admin-manual/troubleshooting.md b/docs/admin-manual/troubleshooting.md index 65486a674..687a9ce40 100644 --- a/docs/admin-manual/troubleshooting.md +++ b/docs/admin-manual/troubleshooting.md @@ -5,36 +5,9 @@ sidebar_position: 90 This guide walk you though the steps required to troubleshoot LibreTime. -## Services status - -When facing a problem with LibreTime the first reflex is to verify whether the services are running. - -In the web interface, go to **Settings** > **Status** to see the state of the services. - -![](./troubleshooting-status-page.png) - -Or directly from a terminal: - -```bash -sudo systemctl --all --plain | egrep 'libretime|nginx|php.*-fpm' -``` - -If a service isn't running, you should search for details using the tool running those services. -On a common setup, you should use the systemd service status: - -```bash -sudo systemctl status libretime-worker -``` - -:::note - -Be sure to replace the service name with the problematic one. - -::: - ## Logs -The next place to search for details on potential errors are the log files. +The first place to search for details on potential errors are the log files. The `/var/log/syslog` file contains most of the system logs combined. This log file may contain information that the application logger wasn't able to log, such as early startup errors. You can follow the logs using: @@ -61,6 +34,33 @@ sudo -u libretime libretime-analyzer --config /etc/libretime/config.yml --log-le The `/var/log/nginx/libretime.error.log` file contains logs from the web server. +## Services status + +The next reflex is to verify whether the services are running. + +In the web interface, go to **Settings** > **Status** to see the state of the services. + +![](./troubleshooting-status-page.png) + +Or directly from a terminal: + +```bash +sudo systemctl --all --plain | egrep 'libretime|nginx|php.*-fpm' +``` + +If a service isn't running, you should search for details using the tool running those services. +On a common setup, you should use the systemd service status: + +```bash +sudo systemctl status libretime-worker +``` + +:::note + +Be sure to replace the service name with the problematic one. + +::: + ## Test the stream inputs To test or debug your input streams, you can use the [`tools/test-stream-input.py`](https://github.com/libretime/libretime/blob/main/tools/test-stream-input.py) script to send a test sound to your stream inputs.