Table of Contents
1 Guide détaillé de l'utilisation du serveur NALC
Ce guide explique comment installer et utiliser les scripts du serveur NALC pour sa gestion au quotidien par les administrateurs du serveur. En dernière partie le guide explique les bonnes pratiques à adopter pour contribuer au développement du serveur NALC.
1.1 Architecture et fichiers principaux du serveur
Avant de commencer, voici une illustration de l'architecture du serveur une fois installé.
Ne prenez pas peur par la complexité apparente du schéma, la pluspart des opérations que vous aurez à gérer se feront à travers les scripts qui vous faciliterons la tâche.
Nous reviendrons plus en détail sur certaines parties au moment opportun.
1.2 Installation
1.2.1 Pré-requis
- Système d'exploitation : GNU/Linux avec interpréteur BASH,
- git,
- Librairies et dépendances de Minetest : Consulter les pré-requis sur cette page : https://github.com/minetest/minetest/blob/master/README.md
1.2.2 Ce que je recommande pour avoir de bonnes performances
- PostgreSQL pour le backend de la MAP et des Utilisateurs.
- Redis pour le backend de la MAP est une bonne alternative, mais elle ne sera pas traitée dans ce guide. Cependant j'avais fait une vidéo d'installation d'un serveur Minetest avec le backend Redis disponible ici : https://www.youtube.com/watch?v=cz_-Q0Uct1c
- Utiliser les librairies fournis par le système plûtot que celle incluse avec Minetest, comme Luajit par exemple.
1.2.3 Créer un utilisateur dédié
Je recommande de créer un utilisateur dédié que nous nommerons "minetest" dans ce guide. Cela permettra une meilleure organisation ; et du point de vue sécurité c'est pas mal aussi.
Lancez un Terminal en root et entrez les commandes suivantes :
# useradd -m -U minetest -s /bin/bash minetest # passwd minetest
Maintenant vous pouvez suivre le reste du guide avec l'utilisateur minetest.
1.2.4 Télécharger les sources du serveur
Depuis un terminal nous allons rapatrier le code source du serveur avec git :
cd ~ git clone --depth 1 https://sys4.fr/gitea/nalc/nalc-server.git
Après un court laps de temps, vous devriez avoir le répertoire /home/minetest/nalc-server créé dont le contenue est le suivant :
total | 136 | |||||||
-rwxr-xr-x | 1 | sys4 | sys4 | 1101 | 7 | déc. | 14:33 | backup.sh |
drwxr-xr-x | 3 | sys4 | sys4 | 4096 | 8 | déc. | 14:14 | doc |
-rwxr-xr-x | 1 | sys4 | sys4 | 9650 | 8 | déc. | 01:14 | install.sh |
-rw-r–r-- | 1 | sys4 | sys4 | 34570 | 7 | déc. | 14:33 | LICENSE |
-rw-r–r-- | 1 | sys4 | sys4 | 10388 | 7 | déc. | 14:33 | minetest-1.0.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10509 | 7 | déc. | 14:33 | minetest-1.1.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10579 | 7 | déc. | 14:33 | minetest-dev.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10509 | 7 | déc. | 14:33 | minetest-stable.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 261 | 7 | déc. | 14:33 | README.md |
-rwxr-xr-x | 1 | sys4 | sys4 | 1468 | 7 | déc. | 14:33 | shutdown.sh |
-rw-r–r-- | 1 | sys4 | sys4 | 691 | 7 | déc. | 14:33 | start.sh.example |
-rwxr-xr-x | 1 | sys4 | sys4 | 7589 | 8 | déc. | 01:14 | upgrade.sh |
drwxr-xr-x | 2 | sys4 | sys4 | 4096 | 7 | déc. | 14:33 | world |
-rw-r–r-- | 1 | sys4 | sys4 | 62 | 7 | déc. | 14:33 | worldmt-1.0.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 85 | 7 | déc. | 14:33 | worldmt-1.1.conf |
1.2.5 Installer le serveur
Maintenant il nous faut mettre en place tout le nécessaires pour avoir un serveur fonctionnel comme illustré dans l'image 1 et dont le contenu doit ressembler à ça :
total | 172 | |||||||
-rwxr-xr-x | 1 | sys4 | sys4 | 1101 | 7 | déc. | 17:25 | backup.sh |
drwxr-xr-x | 2 | sys4 | sys4 | 4096 | 7 | déc. | 17:25 | doc |
-rwxr-xr-x | 1 | sys4 | sys4 | 11301 | 8 | déc. | 00:30 | install.sh |
-rw-r–r-- | 1 | sys4 | sys4 | 34570 | 7 | déc. | 17:25 | LICENSE |
drwxr-xr-x | 2 | sys4 | sys4 | 4096 | 7 | déc. | 17:51 | logs |
drwxr-xr-x | 23 | sys4 | sys4 | 4096 | 8 | déc. | 00:31 | minetest |
-rw-r–r-- | 1 | sys4 | sys4 | 10388 | 7 | déc. | 17:25 | minetest-1.0.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10509 | 7 | déc. | 17:25 | minetest-1.1.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10579 | 7 | déc. | 17:25 | minetest-dev.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 10515 | 8 | déc. | 00:46 | minetest-stable.conf |
drwxr-xr-x | 5 | sys4 | sys4 | 4096 | 7 | déc. | 23:48 | nalcgame |
drwxr-xr-x | 144 | sys4 | sys4 | 4096 | 7 | déc. | 23:49 | nalc-server-mods |
-rw-r–r-- | 1 | sys4 | sys4 | 261 | 7 | déc. | 17:25 | README.md |
-rwxr-xr-x | 1 | sys4 | sys4 | 1498 | 7 | déc. | 17:35 | shutdown.sh |
-rwxr–r-- | 1 | sys4 | sys4 | 729 | 7 | déc. | 18:08 | start.sh |
-rwxr–r-- | 1 | sys4 | sys4 | 722 | 7 | déc. | 17:53 | start.sh~ |
-rw-r–r-- | 1 | sys4 | sys4 | 691 | 7 | déc. | 17:25 | start.sh.example |
-rwxr-xr-x | 1 | sys4 | sys4 | 7589 | 8 | déc. | 00:12 | upgrade.sh |
drwxr-xr-x | 2 | sys4 | sys4 | 4096 | 7 | déc. | 17:25 | world |
-rw-r–r-- | 1 | sys4 | sys4 | 8028 | 8 | déc. | 00:41 | world.mt |
-rw-r–r-- | 1 | sys4 | sys4 | 62 | 7 | déc. | 17:25 | worldmt-1.0.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 85 | 7 | déc. | 17:25 | worldmt-1.1.conf |
-rw-r–r-- | 1 | sys4 | sys4 | 85 | 8 | déc. | 00:41 | world.mt.bak |