Skip to content

Commit

Permalink
Clarify initial troubleshooting steps (#589)
Browse files Browse the repository at this point in the history
* Account for the case where systemd will not issue an immediate error after sc4s service startup
  • Loading branch information
mbonsack authored and GitHub committed Jul 28, 2020
1 parent 56dacef commit 446e29b
Showing 1 changed file with 3 additions and 2 deletions.
5 changes: 3 additions & 2 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,13 @@ running out of systemd, you may see this at startup:
[root@sc4s syslog-ng]# systemctl start sc4s
Job for sc4s.service failed because the control process exited with error code. See "systemctl status sc4s.service" and "journalctl -xe" for details.
```
A better command than `journalctl -xe` is the following,
In other cases, there may be nothing untoward after starting with systemd, but the container is not running at all
after checking with `podman logs SC4S` or `podman ps`. A more informative command than `journalctl -xe` is the following,
```
journalctl -b -u sc4s | tail -100
```
which will print the last 100 lines of the system journal in far more detail, which should be sufficient to see the specific failure
(syntax or runtime) and guide you in troubleshooting.
(syntax or runtime) and guide you in troubleshooting why the container exited unexpectedly.

As an alternative to launching via systemd during the initial installation phase, you may wish to test the container startup outside of the
systemd startup environment. The following commmand will launch the container directly from the CLI. This command assumes the local mounted
Expand Down

0 comments on commit 446e29b

Please sign in to comment.