1
0
Fork 0
mirror of https://github.com/Kozea/Radicale.git synced 2025-08-07 18:30:54 +00:00

Updated Server Diagnostics Troubleshooting (markdown)

Peter Bieringer 2024-06-06 06:34:04 +02:00
parent 6cfd259762
commit be909d3a08

@ -1,13 +1,16 @@
(work-in-progress, feel free to contribute) (work-in-progress, feel free to contribute)
Assumptions
* the system user is named "radicale"
* the system user "radicale" owns the the configured storage location
# Storage verification # Storage verification
Since 3.0.0 a special command option exists to verify the storage of the collections: Since 3.0.0 a special command option exists to verify the storage of the collections:
``` ```
## as user "radicale" (or the user which "owns" the storage)
# add optional for watching the progress: --logging-level debug # add optional for watching the progress: --logging-level debug
/usr/bin/radicale --verify-storage sudo -u radicale /usr/bin/radicale --verify-storage
``` ```
It should not report any errors, otherwise particular VCF or ICS files have to be fixed manually. It should not report any errors, otherwise particular VCF or ICS files have to be fixed manually.
@ -27,15 +30,19 @@ Solution: check for any folder in <NAME> which itself is a collection and move i
# Verification of start # Verification of start
## Started by systemd
- terminal#1 / watch logs: `journalctl -f -u radicale`
- terminal#2 / start "radicale" service: `systemctl start radicale`
## Manual start ## Manual start
- become "radicale" user: `su - -s /bin/bash radicale` ```
- start "radicale" (here with log-level debug): `/usr/bin/radicale --logging-level debug` # including optional for watching the progress: --logging-level debug
# Terminate with CTRL-C to finish test
sudo -u radicale /usr/bin/radicale --logging-level debug
```
## Start by systemd
- terminal#1 / watch logs: `journalctl -f -u radicale`
- terminal#2 / start "radicale" service: `systemctl start radicale`
# Listen Status # Listen Status