Bläddra i källkod

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

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
pull/4027/head
Suguru Hirahara 1 år sedan
förälder
incheckning
bd794e8c2c
Ingen känd nyckel hittad för denna signaturen i databasen GPG-nyckel ID: E4F9743DAB4B7B75
1 ändrade filer med 22 tillägg och 18 borttagningar
  1. +22
    -18
      docs/maintenance-and-troubleshooting.md

+ 22
- 18
docs/maintenance-and-troubleshooting.md Visa fil

@@ -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.

Laddar…
Avbryt
Spara