Skip to content

Commit d1d0520

Browse files
WebSocket Debugging Documentation
1 parent ae66f7b commit d1d0520

File tree

2 files changed

+11
-2
lines changed

2 files changed

+11
-2
lines changed

_docs/sysadmin/installation/system_customization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ You may want to back up more of `/var/local/submitty` to save configurations and
3030

3131
To ensure the reliability of the various Submitty services, such as the WebSocket server, their health status is monitored and restarted hourly via the [sbin/repair_services.sh](https://github.com/Submitty/Submitty/blob/master/sbin/repair_services.sh) script run by the submitty_daemon user. This script leverages `systemctl` along with various health-check utility scripts to verify the active state of these core services, triggering a restart if an inactive state is detected.
3232

33-
Service failures can occur for various reasons, including unhandled exceptions, memory leaks, port binding issues, or OS-level disruptions such as resource exhaustion. All failures are logged with their relevant timestamp, source, and last output within the `/var/logs/services` directory for the given day in the format `YYYYMMDD.txt`.
33+
Service failures can occur for various reasons, including unhandled exceptions, memory leaks, port binding issues, or OS-level disruptions such as resource exhaustion. All failures are logged with their relevant timestamp, source, and last output within the `/var/log/services` directory for the given day in the format `YYYYMMDD.txt`.
3434

3535
To disable this auto-repair mechanism, comment out the relevant line in the source `.setup/submitty_crontab` file within your repository. Since the crontab is auto-generated during installation, any changes must be followed by a re-run of `submitty_install` to persist them.
3636

_docs/sysadmin/troubleshooting/system_debugging.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ redirect_from:
4747

4848
```
4949
tail -n 50 /var/local/submitty/site_errors/<TODAYS_DATE>.log
50-
```
50+
```
5151

5252

5353
* Look for errors in the apache log:
@@ -62,6 +62,15 @@ redirect_from:
6262
/var/log/nginx/error.log
6363
```
6464

65+
* Look for errors in the daily service outage log
66+
67+
```
68+
/var/log/services/YYYYMMDD.txt
69+
```
70+
71+
72+
73+
6574
* Check the SSL keys / certificates for apache & nginx.
6675
Look for ssl key & certificate files specified in the enabled
6776
`.conf` files for apache & nginx:

0 commit comments

Comments
 (0)