From 5cdcbeee2c85072836d3ae77aab7b7998ae7253d Mon Sep 17 00:00:00 2001 From: sys4 Date: Sun, 28 Apr 2019 22:43:57 +0200 Subject: [PATCH] Ajout doc au format MarkDown --- README.md | 5 ++ doc/mtsatellite.md | 134 +++++++++++++++++++++++++++++++++++++++ doc/mtsatellite.org | 2 +- doc/planSauvegarde.md | 139 +++++++++++++++++++++++++++++++++++++++++ doc/planSauvegarde.org | 2 + install.sh | 2 + shutdown.sh | 2 + upgrade.sh | 2 + 8 files changed, 287 insertions(+), 1 deletion(-) create mode 100644 doc/mtsatellite.md create mode 100644 doc/planSauvegarde.md diff --git a/README.md b/README.md index f76ca58..ed45ee9 100644 --- a/README.md +++ b/README.md @@ -6,3 +6,8 @@ Les fichiers pour installer le serveur NALC. Lancer le script ./install.sh Pour l'aide : ./install.sh --help + +------------------------------------------------------------------------------- +*Licence : GPL v3* + +*Copyright: Sys4* diff --git a/doc/mtsatellite.md b/doc/mtsatellite.md new file mode 100644 index 0000000..263c72f --- /dev/null +++ b/doc/mtsatellite.md @@ -0,0 +1,134 @@ +
+

Table of Contents

+
+ +
+
+ +# Mise en place de MTSatellite pour un serveur déjà en place + +## Résumé des étapes + +- Installation des outils pour compiler MTSatellite (Gentoo) +- Création d'un deuxième serveur Minetest en parallèle du premier avec un backend en postgresql. +- Restauration de la BDD du premier serveur pour le second (map et players) +- Restauration des données de la map de l'ancienne instance +- Conversion de la map de la seconde instance vers levelDB +- Mise en place de MTSatellite (plusieurs étapes) + - + +## Installation des outils pour compiler MTSatellite (Gentoo) + +Nous sommes logué en tant que root sur notre serveur + + -- Installation des packages nécessaires + # emerge -av go leveldb mercurial + +Se loguer en tant qu'utilisateur minetest sur notre serveur + + $ cd + $ go get -u bitbucket.org/s_l_teichmann/mtsatellite/cmd/mtdbconverter + $ go get -u bitbucket.org/s_l_teichmann/mtsatellite/cmd/mtredisalize + $ go get -u bitbucket.org/s_l_teichmann/mtsatellite/cmd/mtseeder + $ go get -u bitbucket.org/s_l_teichmann/mtsatellite/cmd/mtwebmapper + + $ ls /home/minetest/go/bin + mtdbconverter mtredisalize mtseeder mtwebmapper + +## Création d'un deuxième serveur Minetest + +Nous sommes logué en tant qu'utilisateur minetest sur notre serveur + + -- Récupération des sources du serveur nalc + $ cd + $ git clone --depth 1 https://sys4.fr/gitea/nalc/nalc-server.git nalc-1 + + -- Installation du serveur + $ cd nalc-1 + $ ./install.sh --postgresql 0.4 + (Suivez les instructions pour créer un nouveau serveur) + +## Restauration de la BDD du premier serveur pour la nouvelle instance + +Nous sommes logué en tant qu'utilisateur minetest sur notre serveur + + -- Restauration de la dernière sauvegarde de la première instance (nalc-server-0.4.17-r1) vers la seconde (nalc-1) + $ cd + $ mkdir nalc-1/dumps + $ cd nalc-1/dumps + $ tar -xvf ~/nalc-server-0.4.17-r1/backup/data/dump_sql.tar + -- Efface les BDD créé par l'installation de la nouvelle instance + -- Dans le cas où vous vous êtes logué en jeux au moins une fois + $ dropdb nalc-1 + $ dropdb players-nalc-1 + -- Création de BDD vierges + $ createdb nalc-1 + $ createdb players-nalc-1 + -- Restauration des BDD de l'ancienne instance dans la nouvelle + -- (vérifiez que vous ayez assez d'espace disque dans /var) + $ su - postgres + $ pg_restore -d nalc-1 /home/minetest/nalc-1/dumps/nalc-0.4.17.dump + $ pg_restore -d players-nalc-1 /home/minetest/nalc-1/dumps/players-nalc-0.4.17.dump + $ logout + $ cd + $ rm -rf nalc-1/dumps + +## Restauration des données de la map de l'ancienne instance + +Cela dépendra du contexte, deux cas majeurs peuvent se présenter : +- Soit la nouvelle instance n'apporte pas de changements majeurs dans les fichiers de votre world (même version du serveur ou mise à jour très légère). +- Ou bien des changements majeurs sont apportés à l'occasion de l'installation d'une version plus récente de votre serveur. + +### Premier cas (même version) + +Vous pouvez copier directement le dossier world ou bien la dernière sauvegarde de l'ancienne instance dans la nouvelle. + + $ cd /home/minetest/nalc-1/minetest/worlds/nalc-1 + $ cp -r /home/minetest/nalc-server-0.4.17-r1/minetest/worlds/nalc/* . + $ -- recréer le lien symbolique du world.mt qui vient d'être effacé + $ ln -s /home/minetest/nalc-1/world.mt + +### Deuxième cas (version mise à jour) + +Il vous faudra procéder d'une façon différente. +Tout d'abord renommez le world de la nouvelle instance : + + $ cd /home/minetest/nalc-1/minetest/worlds + $ mv nalc-1 nalc-1-old + +Ensuite recréez un dossier vierge avec le même nom qu'avant renommage puis faites l'opération du premier cas. + + $ mkdir nalc-1 + $ cd nalc-1 + $ cp -r /home/minetest/nalc-server-0.4.17-r1/minetest/worlds/nalc/* . + $ -- recréer le lien symbolique du world.mt qui vient d'être effacé + $ ln -s /home/minetest/nalc-1/world.mt + +Ensuite ne copiez que les nouveaux fichiers et dossiers contenues dans le dossier renommé précédemment (nalc-1-old) vers votre dossier actuel (nalc-1) si ils n'y figurent pas déjà. + +## Migration de la map de la seconde instance vers levelDB + +Nous sommes logué en tant qu'utilisateur minetest sur notre serveur + + $ cd + $ cd nalc-1/minetest/bin + $ ./minetestserver --migrate leveldb --world /home/minetest/nalc-1/minetest/worlds/nalc-1 + +## TODO Mise en place de MTSatellite diff --git a/doc/mtsatellite.org b/doc/mtsatellite.org index 6da977b..a5cf54c 100644 --- a/doc/mtsatellite.org +++ b/doc/mtsatellite.org @@ -96,4 +96,4 @@ $ cd nalc-1/minetest/bin $ ./minetestserver --migrate leveldb --world /home/minetest/nalc-1/minetest/worlds/nalc-1 #+END_EXAMPLE -** Mise en place de MTSatellite +** TODO Mise en place de MTSatellite diff --git a/doc/planSauvegarde.md b/doc/planSauvegarde.md new file mode 100644 index 0000000..85dd713 --- /dev/null +++ b/doc/planSauvegarde.md @@ -0,0 +1,139 @@ +
+

Table of Contents

+
+ +
+
+ +# Plan de sauvegarde et restauration du serveur NALC + +## Quelques variables + +NALC-SERVER=/home/minetest/nalc-server-0.4.17-r1 +bak=$NALC-SERVER/backup +baktmp=/var/tmp/nalc-0.4dump +logdir=$NALC-SERVER/logs + +## Tableau des sauvegardes + + + + +++ ++ ++ ++ ++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
QuoiCommentDepuisVersQuand
$NALC-SERVER/minetest/minetest.confcp$NALC-SERVER/shutdown.sh$bak/data/5h00
$NALC-SERVER/start.shcp$NALC-SERVER/shutdown.sh$bak/data/5h00
$NALC-SERVER/backup.shcp$NALC-SERVER/shutdown.sh$bak/data/5h00
$NALC-SERVER/minetest/worlds/nalctar -I pbzip2$NALC-SERVER/shutdown.sh$bak/data/world.tar.bz25h00
BDD nalc-0.4.17pgdump -Fc$NALC-SERVER/shutdown.sh$baktmp/nalc-0.4.17.dump5h00
BDD players-nalc-0.4.17pgdump -Fc$NALC-SERVER/shutdown.sh$baktmp/players-nalc-0.4.17.dump5h00
$baktmp/\*.dumptar$NALC-SERVER/shutdown.sh$bak/data/dumpsql.tar5h00
$logdir/moredebug.logbzip2 && tar$NALC-SERVER/shutdown.sh$logdir/moredebug-logs.tar5h00
+ +## Étapes de restauration des BDD + + $ cd $NALC-SERVER + $ mkdir dumps + $ cd dumps + $ tar -xvf $bak/data/dump_sql.tar + $ dropdb nalc-0.4.17 + $ dropdb players-nalc-0.4.17 + $ createdb nalc-0.4.17 + $ createdb players-nalc-0.4.17 + $ (login as postgresql user) + $ pg_restore -d nalc-0.4.17 $NALC-SERVER/dumps/nalc-0.4.17.dump + $ pg_restore -d players-nalc-0.4.17 $NALC-SERVER/dumps/players-nalc-0.4.17.dump + $ (logout) + $ rm -rf $NALC-SERVER/dumps diff --git a/doc/planSauvegarde.org b/doc/planSauvegarde.org index c2ecde1..faa6d01 100644 --- a/doc/planSauvegarde.org +++ b/doc/planSauvegarde.org @@ -24,6 +24,8 @@ $ tar -xvf $bak/data/dump_sql.tar $ dropdb nalc-0.4.17 $ dropdb players-nalc-0.4.17 + $ createdb nalc-0.4.17 + $ createdb players-nalc-0.4.17 $ (login as postgresql user) $ pg_restore -d nalc-0.4.17 $NALC-SERVER/dumps/nalc-0.4.17.dump $ pg_restore -d players-nalc-0.4.17 $NALC-SERVER/dumps/players-nalc-0.4.17.dump diff --git a/install.sh b/install.sh index 7725921..71256ab 100755 --- a/install.sh +++ b/install.sh @@ -1,4 +1,6 @@ #!/bin/bash +# Author: Sys4 +# License: GPLv3 # Fonctions strip() { diff --git a/shutdown.sh b/shutdown.sh index 8e86e06..1cddbeb 100755 --- a/shutdown.sh +++ b/shutdown.sh @@ -1,4 +1,6 @@ #!/bin/bash +# Author: Sys4 +# Licence: GPLv3 serverpath=/home/minetest/nalc-stable world=nalc-stable world_file=all # news|technic|fbn|fbnp|bitchange|christmas|randommsg diff --git a/upgrade.sh b/upgrade.sh index ba208b2..1f14bb9 100755 --- a/upgrade.sh +++ b/upgrade.sh @@ -1,4 +1,6 @@ #!/bin/bash +# Author: Sys4 +# License: GPLv3 serverpath=$(pwd) UP_MODS=0