💾 Archived View for gmi.alterzorg.fr › informatique › installer_agate.gmi captured on 2022-03-01 at 15:06:24. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Installer / mettre à jour un serveur Agate

   Dernière mise à jour : 26/09/2021

Pré-requis pour moi : avoir un serveur linux sur lequel fonctionne systemd.

Il existe sûrement d'autres solutions, mais c'est réservé à plus compétent que moi ;-)

Pour assurer une sauvegarde du site, je crée tous les répertoires et fichiers en local sur mon ordi, dans un répertoire "gemini" qui lui, est sauvegardé, puis je les recopie sur le serveur avec une commande scp.

=> Créer un serveur chez Gandi

Installer l'exécutable

Se connecter au serveur distant, puis créer 3 répertoires bin, certs et contenu, s'ils n'existent pas.

# ssh USER@MONDOMAINE
USER:~$ mkdir bin
USER:~$ mkdir contenu
USER:~$ mkdir certs

Charger agate, décompresser et rendre exécutable

Vérifier sur le site github, le numéro de la dernière version d'agate, et copier le lien de la dernière version : v3.1.0 le 25/09/2021.

https://github.com/mbrubeck/agate/releases

USER:~$ cd bin
USER:~/bin$ wget <LIEN_VERS_agate.x86_64-unknown-linux-gnu.gz>
USER:~/bin$ gunzip agate.x86_64-unknown-linux-gnu.gz
USER:~/bin$ chmod +x agate.x86_64-unknown-linux-gnu

Certificat autogénéré

Il n'y a plus besoin, sur les dernières versions d'Agate, de générer un certificat. Les clés sont générées dans .certificates au premier lancement.

Lancer manuellement Agate pour test

USER:~$ /home/USER/bin/agate.x86_64-unknown-linux-gnu --content /home/USER/contenu/ \
--addr [::]:1965 --addr 0.0.0.0:1965 --hostname MONDOMAINE \
--lang fr-FR --certs /home/USER/.certificates

On peut ajouter l'option --log-ip pour voir les IP qui appellent.

Ouvrir un client comme Lagrange pour tester, on voit les requêtes apparaître dans la console.

Ne pas oublier de tuer le processus avec un Ctrl-C.

Démarrer le service agate

Il faut être root pour écrire dans le répertoire /etc. Le "sudo" ne fonctionne pas chez Gandi, utiliser "su -".

J'ai créé le fichier agate.service sur mon ordi avant le copier sur le serveur, mais on peut le créer directement avec nano.

Contenu du fichier agate.service

Remplacer USER et MONDOMAINE par les bonnes données.

[Unit]
Description=agate
After=network.target

[Service]
User=USER
Type=simple
ExecStart=/home/USER/bin/agate.x86_64-unknown-linux-gnu \
  --content /home/USER/contenu/ \
  --addr [::]:1965 --addr 0.0.0.0:1965 \
  --hostname MONDOMAINE \
  --lang fr-FR \
  --certs /home/USER/.certificates   

[Install]
WantedBy=default.target

La modification de ce fichier, s'il existait auparavant, nécessite ensuite un "systemctl daemon-reload".

Démarrer le service

su -
root@XXX# mv agate.service /etc/systemd/system
root@XXX# chown root:root /etc/systemd/system/agate.service
root@XXX# systemctl start agate
root@XXX# systemctl enable agate

[..]