Adding help for wrolpi logs.

docs/index.md

@@ -18,6 +18,7 @@ Information about a WROLPi system.
 
 * [Getting Started](system/getting-started.md)
 * [Getting Help](system/getting-help.md)
+* [Logs](system/logs.md)
 * [Systems](system/index.md)
 * [Recommended Hardware](system/recommended-hardware.md)
 

docs/system/index.md

@@ -8,6 +8,7 @@
     * [Map](#map) (`:8084`)
     * [Zim](#zim) (`:8085`)
     * [Help](#help) (`:8086`)
+* WROLPi services are started and maintained by `systemd`.  [Logs](logs.md) are gathered by `systemd`.
 
 ## Services
 
@@ -36,7 +37,7 @@ the development environment.)
 |-------------------------------------------|----------------------------------------------------------------------|
 | [Postgresql](https://www.postgresql.org/) | Facilitates searching of files, scheduling downloads, and much more. |
 
-### App
+### React App
 
 | Software Project                             | Purpose                                                            |
 |----------------------------------------------|--------------------------------------------------------------------|

docs/system/logs.md

@@ -0,0 +1,45 @@
+# Logs
+
+The following is a simple overview to view the logs of the [WROLPi Services](index.md#services). WROLPi logs are
+gathered by `systemd`.  Logs are viewed using `journalctl`.
+
+You can watch all the logs on your WROLPi:
+
+`journalctl -f`
+
+More detailed logs can be viewed:
+
+`journalctl -f -p debug`
+
+To view logs only from the most recent boot:
+
+`journalctl -f -b`
+
+The above commands use `-f` (follow) which will display logs as soon as they are created.  You can view older logs by
+removing `-f` from the command, but you will need to use your keyboard to navigate the logs.  Use `up`, `down`,
+`page-up` and `page-down` keys.  You can also use `g` to navigate to the top of the log, and `shift-g` to navigate to
+the bottom of the logs.
+
+## API
+
+To watch the API logs:
+
+`journalctl -f -u wrolpi-api`
+
+## React App
+
+To watch the React App logs:
+
+`journalctl -f -u wrolpi-app`
+
+## Map
+
+To watch the Map logs:
+
+`journalctl -f -u renderd`
+
+## Zim
+
+To watch the React App logs:
+
+`journalctl -f -u wrolpi-kiwix`

docs/system/primary-secondary-tertiary.md

@@ -1,6 +1,6 @@
 # Primary, Secondary, Tertiary.
 
-WROLPI attempts to integrate all services in an easy to learn interface. But, if the React app is unavailable, secondary
+WROLPi attempts to integrate all services in an easy to learn interface. But, if the React app is unavailable, secondary
 and tertiary options to use your WROLPi may be available.
 
 | Module   | Primary   | Secondary                                               | Tertiary                                            |

docs/system/systemd.md

@@ -0,0 +1,10 @@
+# Service Control
+
+You can view and control the WROLPi services using these commands:
+
+| Service   | Status                          | Logs                      | Restart                          | Stop                          | Start                          |
+|-----------|---------------------------------|---------------------------|----------------------------------|-------------------------------|--------------------------------|
+| API       | `systemctl status wrolpi-api`   | `journalctl wrolpi-api`   | `systemctl restart wrolpi-api`   | `systemctl stop wrolpi-api`   | `systemctl start wrolpi-api`   |
+| React App | `systemctl status wrolpi-app`   | `journalctl wrolpi-app`   | `systemctl restart wrolpi-app`   | `systemctl stop wrolpi-app`   | `systemctl start wrolpi-app`   |
+| Map       | `systemctl status renderd`      | `journalctl renderd`      | `systemctl restart renderd`      | `systemctl stop renderd`      | `systemctl start renderd`      |
+| Zim       | `systemctl status wrolpi-kiwix` | `journalctl wrolpi-kiwix` | `systemctl restart wrolpi-kiwix` | `systemctl stop wrolpi-kiwix` | `systemctl start wrolpi-kiwix` |