Ajout doc au format MarkDown
This commit is contained in:
parent
8911878a0e
commit
5cdcbeee2c
@ -6,3 +6,8 @@ Les fichiers pour installer le serveur NALC.
|
|||||||
Lancer le script ./install.sh
|
Lancer le script ./install.sh
|
||||||
|
|
||||||
Pour l'aide : ./install.sh --help
|
Pour l'aide : ./install.sh --help
|
||||||
|
|
||||||
|
-------------------------------------------------------------------------------
|
||||||
|
*Licence : GPL v3*
|
||||||
|
|
||||||
|
*Copyright: Sys4*
|
||||||
|
|||||||
134
doc/mtsatellite.md
Normal file
134
doc/mtsatellite.md
Normal file
@ -0,0 +1,134 @@
|
|||||||
|
<div id="table-of-contents">
|
||||||
|
<h2>Table of Contents</h2>
|
||||||
|
<div id="text-table-of-contents">
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1">1. Mise en place de MTSatellite pour un serveur déjà en place</a>
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1-1">1.1. Résumé des étapes</a></li>
|
||||||
|
<li><a href="#sec-1-2">1.2. Installation des outils pour compiler MTSatellite (Gentoo)</a></li>
|
||||||
|
<li><a href="#sec-1-3">1.3. Création d'un deuxième serveur Minetest</a></li>
|
||||||
|
<li><a href="#sec-1-4">1.4. Restauration de la BDD du premier serveur pour la nouvelle instance</a></li>
|
||||||
|
<li><a href="#sec-1-5">1.5. Restauration des données de la map de l'ancienne instance</a>
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1-5-1">1.5.1. Premier cas (même version)</a></li>
|
||||||
|
<li><a href="#sec-1-5-2">1.5.2. Deuxième cas (version mise à jour)</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li><a href="#sec-1-6">1.6. Migration de la map de la seconde instance vers levelDB</a></li>
|
||||||
|
<li><a href="#sec-1-7">1.7. <span class="todo TODO">TODO</span> Mise en place de MTSatellite</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
# Mise en place de MTSatellite pour un serveur déjà en place<a id="sec-1" name="sec-1"></a>
|
||||||
|
|
||||||
|
## Résumé des étapes<a id="sec-1-1" name="sec-1-1"></a>
|
||||||
|
|
||||||
|
- 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)<a id="sec-1-2" name="sec-1-2"></a>
|
||||||
|
|
||||||
|
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<a id="sec-1-3" name="sec-1-3"></a>
|
||||||
|
|
||||||
|
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<a id="sec-1-4" name="sec-1-4"></a>
|
||||||
|
|
||||||
|
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<a id="sec-1-5" name="sec-1-5"></a>
|
||||||
|
|
||||||
|
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)<a id="sec-1-5-1" name="sec-1-5-1"></a>
|
||||||
|
|
||||||
|
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)<a id="sec-1-5-2" name="sec-1-5-2"></a>
|
||||||
|
|
||||||
|
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<a id="sec-1-6" name="sec-1-6"></a>
|
||||||
|
|
||||||
|
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<a id="sec-1-7" name="sec-1-7"></a>
|
||||||
@ -96,4 +96,4 @@
|
|||||||
$ cd nalc-1/minetest/bin
|
$ cd nalc-1/minetest/bin
|
||||||
$ ./minetestserver --migrate leveldb --world /home/minetest/nalc-1/minetest/worlds/nalc-1
|
$ ./minetestserver --migrate leveldb --world /home/minetest/nalc-1/minetest/worlds/nalc-1
|
||||||
#+END_EXAMPLE
|
#+END_EXAMPLE
|
||||||
** Mise en place de MTSatellite
|
** TODO Mise en place de MTSatellite
|
||||||
|
|||||||
139
doc/planSauvegarde.md
Normal file
139
doc/planSauvegarde.md
Normal file
@ -0,0 +1,139 @@
|
|||||||
|
<div id="table-of-contents">
|
||||||
|
<h2>Table of Contents</h2>
|
||||||
|
<div id="text-table-of-contents">
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1">1. Plan de sauvegarde et restauration du serveur NALC</a>
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1-1">1.1. Quelques variables</a></li>
|
||||||
|
<li><a href="#sec-1-2">1.2. Tableau des sauvegardes</a></li>
|
||||||
|
<li><a href="#sec-1-3">1.3. Étapes de restauration des BDD</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
# Plan de sauvegarde et restauration du serveur NALC<a id="sec-1" name="sec-1"></a>
|
||||||
|
|
||||||
|
## Quelques variables<a id="sec-1-1" name="sec-1-1"></a>
|
||||||
|
|
||||||
|
NALC-SERVER=/home/minetest/nalc-server-0.4.17-r1
|
||||||
|
bak=$NALC-SERVER/backup
|
||||||
|
bak<sub>tmp</sub>=/var/tmp/nalc-0.4<sub>dump</sub>
|
||||||
|
log<sub>dir</sub>=$NALC-SERVER/logs
|
||||||
|
|
||||||
|
## Tableau des sauvegardes<a id="sec-1-2" name="sec-1-2"></a>
|
||||||
|
|
||||||
|
<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
|
||||||
|
|
||||||
|
|
||||||
|
<colgroup>
|
||||||
|
<col class="left" />
|
||||||
|
|
||||||
|
<col class="left" />
|
||||||
|
|
||||||
|
<col class="left" />
|
||||||
|
|
||||||
|
<col class="left" />
|
||||||
|
|
||||||
|
<col class="left" />
|
||||||
|
</colgroup>
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th scope="col" class="left">Quoi</th>
|
||||||
|
<th scope="col" class="left">Comment</th>
|
||||||
|
<th scope="col" class="left">Depuis</th>
|
||||||
|
<th scope="col" class="left">Vers</th>
|
||||||
|
<th scope="col" class="left">Quand</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
|
||||||
|
<tbody>
|
||||||
|
<tr>
|
||||||
|
<td class="left">$NALC-SERVER/minetest/minetest.conf</td>
|
||||||
|
<td class="left">cp</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak/data/</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">$NALC-SERVER/start.sh</td>
|
||||||
|
<td class="left">cp</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak/data/</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">$NALC-SERVER/backup.sh</td>
|
||||||
|
<td class="left">cp</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak/data/</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">$NALC-SERVER/minetest/worlds/nalc</td>
|
||||||
|
<td class="left">tar -I pbzip2</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak/data/world.tar.bz2</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">BDD nalc-0.4.17</td>
|
||||||
|
<td class="left">pg<sub>dump</sub> -Fc</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak<sub>tmp</sub>/nalc-0.4.17.dump</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">BDD players-nalc-0.4.17</td>
|
||||||
|
<td class="left">pg<sub>dump</sub> -Fc</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak<sub>tmp</sub>/players-nalc-0.4.17.dump</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">$bak<sub>tmp</sub>/\*.dump</td>
|
||||||
|
<td class="left">tar</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$bak/data/dump<sub>sql</sub>.tar</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
|
||||||
|
|
||||||
|
<tr>
|
||||||
|
<td class="left">$log<sub>dir</sub>/moredebug.log</td>
|
||||||
|
<td class="left">bzip2 && tar</td>
|
||||||
|
<td class="left">$NALC-SERVER/shutdown.sh</td>
|
||||||
|
<td class="left">$log<sub>dir</sub>/moredebug-logs.tar</td>
|
||||||
|
<td class="left">5h00</td>
|
||||||
|
</tr>
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
|
||||||
|
## Étapes de restauration des BDD<a id="sec-1-3" name="sec-1-3"></a>
|
||||||
|
|
||||||
|
$ 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
|
||||||
@ -24,6 +24,8 @@
|
|||||||
$ tar -xvf $bak/data/dump_sql.tar
|
$ tar -xvf $bak/data/dump_sql.tar
|
||||||
$ dropdb nalc-0.4.17
|
$ dropdb nalc-0.4.17
|
||||||
$ dropdb players-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)
|
$ (login as postgresql user)
|
||||||
$ pg_restore -d nalc-0.4.17 $NALC-SERVER/dumps/nalc-0.4.17.dump
|
$ 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
|
$ pg_restore -d players-nalc-0.4.17 $NALC-SERVER/dumps/players-nalc-0.4.17.dump
|
||||||
|
|||||||
@ -1,4 +1,6 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
# Author: Sys4
|
||||||
|
# License: GPLv3
|
||||||
|
|
||||||
# Fonctions
|
# Fonctions
|
||||||
strip() {
|
strip() {
|
||||||
|
|||||||
@ -1,4 +1,6 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
# Author: Sys4
|
||||||
|
# Licence: GPLv3
|
||||||
serverpath=/home/minetest/nalc-stable
|
serverpath=/home/minetest/nalc-stable
|
||||||
world=nalc-stable
|
world=nalc-stable
|
||||||
world_file=all # news|technic|fbn|fbnp|bitchange|christmas|randommsg
|
world_file=all # news|technic|fbn|fbnp|bitchange|christmas|randommsg
|
||||||
|
|||||||
@ -1,4 +1,6 @@
|
|||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
|
# Author: Sys4
|
||||||
|
# License: GPLv3
|
||||||
|
|
||||||
serverpath=$(pwd)
|
serverpath=$(pwd)
|
||||||
UP_MODS=0
|
UP_MODS=0
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user