MirrorHub/construct
0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-25 00:02:34 +01:00
Code Issues Releases Wiki Activity

Updated Troubleshooting problems (markdown)

Jason Volk 2021-08-24 16:30:33 -07:00
parent cda7e1a467
commit 06647e3d5a
1 changed files with 13 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
Troubleshooting-problems.md

@ -12,22 +12,26 @@
Start the daemon with one or more of the following program options to make it
easier to troubleshoot and perform maintenance:
- *-single* will start in "single user mode" which is a convenience combination
of *-nolisten -wa -console* options described below.
- `-debug` increases the logging level to the terminal.
- *-nolisten* will disable the loading of any listener sockets during startup.
- `-single` will start in "single user mode" which is a convenience combination
of `-nolisten -wa -console` options described below.
- *-nobackfill* specifically skips the initial-backfill background task.
- `-safe` is more restrictive than `-single` by denying outbound network requests and background database tasks.
- *-wa* write-avoid will discourage (but not deny) writes to the database. This prevents a lot of background tasks and other noise, making it easier to conduct maintenance (implies *-nobackfill*).
- `-nolisten` will disable the loading of any listener sockets during startup.
- *-slave* allows read-only access to a live database. Only one instance of Construct may have write access to a database at a time; additional instances use this option.
- `-nobackfill` specifically skips the initial-backfill background task.
- *-console* convenience to immediately drop to the adminstrator console
- `-wa` write-avoid will discourage (but not deny) writes to the database. This prevents a lot of background tasks and other noise, making it easier to conduct maintenance (implies `-nobackfill`).
- `-ro` read-only is more restrictive than `-wa` by denying all writes to the database.
- `-slave` allows read-only access to a live database by additional instances of Construct. Only one instance of Construct may have write access to a database at a time; additional instances use this option.
- `-console` convenience to immediately drop to the adminstrator console
after startup.
- *-debug* increases the logging level to the terminal.
##### Recovering from broken configurations
If your server ever fails to start from an errant conf item: you can override