diff --git a/doc/ADMIN.md b/doc/ADMIN.md index 8ac83cc..6cb69e2 100644 --- a/doc/ADMIN.md +++ b/doc/ADMIN.md @@ -4,7 +4,7 @@ ## Update -**`screen` (or `tmux`) can be used to make sure your session is not interrupted in case of connection problems.** +**`screen` (or `tmux`) can be used to make sure your session is not interrupted in case of connection problems.** See [tutorial](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) for more background information. ```bash @@ -14,7 +14,7 @@ sudo yunohost app upgrade mastodon ## Backups -First of all: Mastodon uses a local cache to save media (such as posted images, videos etc.). This cache can grow huge. +First of all: Mastodon uses a local cache to save media (such as posted images, videos etc.). This cache can grow huge. You could consider cleaning up your local cache first as otherwise your backup will be very big and you might run out of disk space: To check your space usage, on a command line run: @@ -23,7 +23,9 @@ To check your space usage, on a command line run: sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage ``` -If your cache is too big to backup, you can run the following command to clean up Attachments (the first line). Substitute X by the number of days you want to keep, e.g. 1 day. All older images will be deleted but will be refetched from the original server if necessary. +If your cache is too big to backup, you can run the following command to clean up Attachments (the first line). +Substitute X by the number of days you want to keep, e.g. 1 day. +All older images will be deleted but will be refetched from the original server if necessary. First dry-run to see how much space is freed up (without actually removing): @@ -44,9 +46,9 @@ Check [the official documentation](https://docs.joinmastodon.org/admin/tootctl/# Before definitively uninstalling Mastodon, you have to run `tootctl self-destruct` to broadcast your users and instance deletion to the federation. Otherwise your data will remain in federation cache for ever. -⚠️ Make sure you know exactly what you are doing before running this command. -⚠️ This operation is NOT reversible, and it can take a long time. -⚠️ The server will be in a BROKEN STATE after this command finishes. +⚠️ Make sure you know exactly what you are doing before running this command. +⚠️ This operation is NOT reversible, and it can take a long time. +⚠️ The server will be in a BROKEN STATE after this command finishes. ⚠️ A running Sidekiq process is required, so do not shut down the server until the queues are fully cleared. ```bash diff --git a/doc/ADMIN_fr.md b/doc/ADMIN_fr.md index 47fd673..91125ba 100644 --- a/doc/ADMIN_fr.md +++ b/doc/ADMIN_fr.md @@ -4,7 +4,7 @@ ## Mise à jour -**`screen` (ou `tmux`) peut être utilisé pour vous assurer que votre session n'est pas interrompue en cas de problème de connection.** +**`screen` (ou `tmux`) peut être utilisé pour vous assurer que votre session n'est pas interrompue en cas de problème de connection.** Consultez ce [tutoriel](https://www.howtogeek.com/662422/how-to-use-linuxs-screen-command/) pour plus de détails. ```bash @@ -14,7 +14,7 @@ sudo yunohost app upgrade mastodon ## Sauvegardes -Tout d'abord : Mastodon utilise un cache local pour sauvegarder les médias (comme les images, vidéos, etc). Ce cache peut devenir énorme. +Tout d'abord : Mastodon utilise un cache local pour sauvegarder les médias (comme les images, vidéos, etc). Ce cache peut devenir énorme. Vous devriez réfléchir à vider votre cache local avant de faire une sauvegarde, qui pourrait être énorme et vous pourriez manquer d'espace de stockage. Pour vérifier l'utilisation du stockage, en ligne de commande utilisez : @@ -23,7 +23,9 @@ Pour vérifier l'utilisation du stockage, en ligne de commande utilisez : sudo cd /var/www/mastodon/live && sudo -u mastodon RAILS_ENV=production PATH=/opt/rbenv/versions/mastodon/bin bin/tootctl media usage ``` -Si le cache est trop gros pour être sauvegardé, vous pouvez lancer la commande suivante pour en supprimer les médias attachés. Changez `X` par le nombre de cache à conserver, par ex. 1 jour. Tous les médias plus anciens seront supprimés, mais ils pourront être rechargé du serveur d'origine si nécessaire. +Si le cache est trop gros pour être sauvegardé, vous pouvez lancer la commande suivante pour en supprimer les médias attachés. +Changez `X` par le nombre de cache à conserver, par ex. 1 jour. +Tous les médias plus anciens seront supprimés, mais ils pourront être rechargé du serveur d'origine si nécessaire. En premier faite un essai à blanc pour voir combien de place sera libérée (sans rien supprimer): @@ -44,9 +46,9 @@ Consulter [la documentation officielle](