MirrorHub/construct
0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-22 01:41:41 +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 Start the daemon with one or more of the following program options to make it
easier to troubleshoot and perform maintenance: easier to troubleshoot and perform maintenance:
- *-single* will start in "single user mode" which is a convenience combination - `-debug` increases the logging level to the terminal.
of *-nolisten -wa -console* options described below.
- *-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. after startup.
- *-debug* increases the logging level to the terminal.
##### Recovering from broken configurations ##### Recovering from broken configurations
If your server ever fails to start from an errant conf item: you can override If your server ever fails to start from an errant conf item: you can override