Déménager Agora sur une autre machine

En bref. Un déménagement, c'est une sauvegarde complète d'un côté et une restauration de l'autre. Trois choses comptent : la base, les fichiers (pièces jointes) et le secret de session. La licence, elle, se reprend en un clic.

Avant de commencer #

• Prévois un moment calme : le site sera indisponible pendant la bascule.
• Garde l'ancienne installation arrêtée mais intacte jusqu'à ce que la nouvelle fonctionne.
• Prépare la nouvelle machine ou le nouveau serveur de panel avec la même clé de licence : voir Installer avec Docker, Installer sur Pelican, Installer sur Pterodactyl ou Installer sur un serveur Node.js.
• Le déménagement se fait avec l'administration d'Agora : il faut être propriétaire de l'installation pour restaurer. Les mots (dump, SFTP, secret de session) sont dans le glossaire.

Étapes #

Sur l'ancienne machine #

1. Administration → Agora → Sauvegardes → Télécharger un dump maintenant.

   <!-- CAPTURE C-070 -->

2. Copie les fichiers de données :

   • Docker (install.sh) : docker cp agora:/app/.data ./agora-fichiers (pièces jointes, fichiers du MDT, fonds de carte, sauvegardes) ;
   • panel : télécharge le dossier app/.data/ par SFTP ou par le gestionnaire de fichiers ;
   • serveur Node.js : télécharge le dossier data/ (sauf data/pg, qui est la base elle-même).

3. Note le secret de session :

   • Docker : la ligne AUTH_SECRET de /opt/agora/.env ;
   • panel : il est dans .agora/, fermé au gestionnaire de fichiers. Si tu ne peux pas le récupérer, tu ressaisiras les secrets (voir plus bas).

4. Arrête l'ancienne installation.

Sur la nouvelle machine (Docker) #

1. Crée /opt/agora/ et copie-y l'ancien .env (il garde la clé, le secret de session et le mot de passe de la base).

2. Lance install.sh : il garde ce .env et installe le reste.

3. Arrête Agora (docker stop agora), restaure le dump :

   Copier

   docker exec -i agora-db psql -U agora -v ON_ERROR_STOP=1 --single-transaction agora < dump.sql

4. Recopie les fichiers : docker cp ./agora-fichiers/. agora:/app/.data/, puis cd /opt/agora && docker compose up -d (le démarrage rend les fichiers à l'utilisateur d'Agora).

Sur le nouveau serveur de panel ou Node.js #

Sur un panel, tu n'as pas de terminal pour restaurer la base : tu passes par l'administration d'Agora.

1. Installe le nouveau Hub avec l'œuf (ou agora.mjs) et la même clé, variable « Base de donnees » vide (voir Installer sur Pelican), et démarre-le jusqu'à ✓ Ready in ….
2. Ouvre-le dans ton navigateur et fais la mise en route (voir Faire la mise en route) pour devenir administrateur. Ce compte est temporaire : la restauration le remplacera par ceux de la sauvegarde.
3. Dans Administration → Agora → Sauvegardes, Importer un fichier avec ton dump, coche la case de confirmation et valide. Si le dump dépasse 12 Mo, dépose-le dans le dossier de sauvegardes du serveur (app/.data/backups) par le gestionnaire de fichiers, puis clique sur Restaurer : voir Sauvegardes et restauration.
4. Dépose les fichiers : envoie le contenu de ton ancien app/.data/ dans le nouveau dossier app/.data/, par SFTP ou le gestionnaire de fichiers.
5. Redémarre le serveur.

<!-- À CONFIRMER : DEM-1, voie panel vers panel non éprouvée : (1) la mise en route à refaire avant la restauration, (2) la connexion Discord après restauration quand le secret de session (AUTH_SECRET) du nouveau serveur diffère de l'ancien (secrets chiffrés illisibles), (3) dépôt de app/.data/ par le gestionnaire de fichiers, et dossier à copier sur un serveur Node.js (data/ hors data/pg ?). Test banc à faire. -->

Reprendre la licence #

Une clé correspond à une installation. La nouvelle machine est vue comme une nouvelle installation :

• dans Administration → Agora, bloc Licence, clique sur Libérer l'ancien siège et réessayer ;
• sur un panel, tu peux aussi mettre Reprendre le siege à 1 le temps d'un démarrage.

<!-- CAPTURE C-071 -->

<!-- CAPTURE C-072 -->

Voir Libérer un siège de licence.

Tu sais que c'est réussi quand… #

• Le site s'ouvre sur la nouvelle machine avec tes membres, ton forum et tes réglages d'avant.
• Administration → Agora affiche ta licence active, sans message de siège pris.
• La ressource FiveM se reconnecte : Serveur → Joueurs reçoit son signal.

Si ça ne marche pas #

Pour aller plus loin #

Si l'adresse du site change #

1. Mets la nouvelle adresse dans Administration → Configuration → Ressource Agora, champ Adresse publique du Hub (le site n'en affiche qu'un résumé en lecture seule dans Administration → Configuration → Identité du site).
2. Ajoute la nouvelle URL de rappel dans ton application Discord.
3. Redéploie la ressource FiveM : l'adresse y est embarquée. Voir Installer la ressource FiveM agora.

Si le secret de session a changé #

Tout le monde doit se reconnecter, et les secrets enregistrés deviennent illisibles. Ressaisis-les : mot de passe de la base du jeu (Serveur → Base de données), token du bot (Administration → Configuration → Connexion Discord), PayPal, panel et SFTP. Régénère le secret de la tablette et redéploie la ressource.

Passer d'une base intégrée à une base externe (ou l'inverse) #

Le principe est le même qu'un déménagement : sauvegarde Agora, changement de la variable Base de donnees, redémarrage, restauration. Les étapes sont dans Dépanner la base intégrée du Hub, section « Passer à une base PostgreSQL externe ». <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre), BASE-INTEGREE §5 : procédure non éprouvée sur le banc -->

Changer de type d'installation #

Le dump d'Agora est un fichier PostgreSQL ordinaire : il se restaure de la même façon que tu passes de Docker à un panel, d'un panel à Docker, ou d'un panel à un autre. Seule l'étape « installer le nouveau Hub » change. <!-- À CONFIRMER : restauration d'un dump entre Docker et panel, non éprouvée -->