Quellcode durchsuchen

Update maintenance-and-troubleshooting.md: create sections "Maintenance" and "Troubleshooting"

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
pull/4027/head
Suguru Hirahara vor 1 Jahr
Ursprung
Commit
bd794e8c2c
Es konnte kein GPG-Schlüssel zu dieser Signatur gefunden werden GPG-Schlüssel-ID: E4F9743DAB4B7B75
1 geänderte Dateien mit 22 neuen und 18 gelöschten Zeilen
  1. +22
    -18
      docs/maintenance-and-troubleshooting.md

+ 22
- 18
docs/maintenance-and-troubleshooting.md Datei anzeigen

@@ -1,6 +1,24 @@
# Maintenance and Troubleshooting # Maintenance and Troubleshooting


## How to see the current status of your services
## Maintenance

### Remove unused Docker data

You can free some disk space from Docker by removing its unused data. See [docker system prune](https://docs.docker.com/engine/reference/commandline/system_prune/) for more information.

```sh
ansible-playbook -i inventory/hosts setup.yml --tags=run-docker-prune
```

The shortcut command with `just` program is also available: `just run-tags run-docker-prune`

### Postgres

See the dedicated [PostgreSQL Maintenance](maintenance-postgres.md) documentation page.

## Troubleshooting

### How to see the current status of your services


You can check the status of your services by using `systemctl status`. Example: You can check the status of your services by using `systemctl status`. Example:


@@ -12,7 +30,7 @@ sudo systemctl status matrix-synapse
Active: active (running) since Sun 2024-01-14 09:13:06 UTC; 1h 31min ago Active: active (running) since Sun 2024-01-14 09:13:06 UTC; 1h 31min ago
``` ```


## How to see the logs
### How to see the logs


Docker containers that the playbook configures are supervised by [systemd](https://wiki.archlinux.org/title/Systemd) and their logs are configured to go to [systemd-journald](https://wiki.archlinux.org/title/Systemd/Journal). Docker containers that the playbook configures are supervised by [systemd](https://wiki.archlinux.org/title/Systemd) and their logs are configured to go to [systemd-journald](https://wiki.archlinux.org/title/Systemd/Journal).


@@ -26,7 +44,7 @@ Available service names can be seen by doing `ls /etc/systemd/system/matrix*.ser


We just simply delegate logging to journald and it takes care of persistence and expiring old data. We just simply delegate logging to journald and it takes care of persistence and expiring old data.


### Enable systemd/journald logs persistence
#### Enable systemd/journald logs persistence


On some distros, the journald logs are just in-memory and not persisted to disk. On some distros, the journald logs are just in-memory and not persisted to disk.


@@ -43,7 +61,7 @@ RateLimitBurst=0
Storage=persistent Storage=persistent
``` ```


## How to check if services work
### How to check if services work


The playbook can perform a check to ensure that you've configured things correctly and that services are running. The playbook can perform a check to ensure that you've configured things correctly and that services are running.


@@ -58,17 +76,3 @@ The shortcut command with `just` program is also available: `just run-tags self-
If it's all green, everything is probably running correctly. If it's all green, everything is probably running correctly.


Besides this self-check, you can also check whether your server federates with the Matrix network by using the [Federation Tester](https://federationtester.matrix.org/) against your base domain (`example.com`), not the `matrix.example.com` subdomain. Besides this self-check, you can also check whether your server federates with the Matrix network by using the [Federation Tester](https://federationtester.matrix.org/) against your base domain (`example.com`), not the `matrix.example.com` subdomain.

## Remove unused Docker data

You can free some disk space from Docker by removing its unused data. See [docker system prune](https://docs.docker.com/engine/reference/commandline/system_prune/) for more information.

```sh
ansible-playbook -i inventory/hosts setup.yml --tags=run-docker-prune
```

The shortcut command with `just` program is also available: `just run-tags run-docker-prune`

## Postgres

See the dedicated [PostgreSQL Maintenance](maintenance-postgres.md) documentation page.

Laden…
Abbrechen
Speichern