Installer sur Pelican

En bref. Tu importes dans ton panel Pelican l'œuf d'Agora (le fichier qui explique au panel comment installer Agora), tu crées un serveur avec cet œuf, et tu le démarres. Tu n'as aucune base de données à préparer : Agora fournit et gère sa propre base dans le serveur, tu laisses simplement la variable « Base de donnees » vide. Le premier démarrage prend quelques minutes.

Avant de commencer #

• Un panel Pelican dont tu es administrateur. Tu n'es pas sûr que ce soit Pelican, ou tu n'as pas le menu Administration ? Lis d'abord Reconnaître Pelican ou Pterodactyl. Chez un hébergeur qui ne te laisse pas importer d'œuf, passe plutôt par un serveur Node.js.
• Ta clé de licence (elle commence par AGORA-). L'œuf téléchargé depuis ton espace la contient déjà. Pas de clé ? L'essai gratuit en est une vraie : voir L'essai gratuit de 14 jours.
• Les ressources du serveur : 2 Go de mémoire conseillés (1,5 Go au minimum) et 5 Go de disque (10 Go sont plus confortables), parce que le serveur fait tourner Agora et sa base de données. Avec moins, le panel risque d'arrêter le serveur en pleine activité.
• Une allocation de port : c'est l'adresse IP et le port que le panel réserve à ce serveur. C'est sur eux que tu ouvriras ton site.
• Une sortie vers Internet en HTTPS depuis le serveur (voir Prérequis).
• Les mots panel, œuf, allocation et base de données sont dans le glossaire ; les deux bases d'Agora sont distinguées dans Les deux bases d'Agora.

Tu as déjà importé l'œuf d'Agora il y a longtemps ? L'ancien œuf déclarait la variable « Base de donnees » obligatoire : le panel refusait de créer un serveur sans elle. Le nouvel œuf la rend facultative. Réimporte l'œuf depuis ton espace avant de créer un nouveau serveur. Les serveurs déjà créés avec l'ancien œuf continuent de marcher tels quels. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre) ; comment réimporter sur un panel qui a déjà l'ancien œuf (créer un second œuf puis supprimer l'ancien, ou mettre à jour l'œuf existant) : à vérifier sur le banc Pelican -->

Étapes #

1. Ouvre la page d'installation de ton espace. Sur agorapanel.com, va à Installer sur mon panel (Mon espace → Installer sur mon panel). Sans clé, clique sur Obtenir ma clé d'essai gratuite.

   <!-- CAPTURE C-047 -->

2. Télécharge l'œuf Pelican. Clique sur Œuf pour Pelican. Le fichier agora-egg-pelican.json contient déjà ta clé : le site demande donc d'abord de vérifier ta session (voir Activer ou changer de clé), puis tu cliques de nouveau.

3. Importe-le dans Pelican. Dans le panel, ouvre l'Administration, puis la liste des Eggs, clique sur Import et envoie le fichier. <!-- À CONFIRMER : libellés exacts de l'import d'œuf sous Pelican (menu Eggs, bouton Import), vérification banc -->

   <!-- CAPTURE C-048 -->

4. Crée le serveur. Toujours dans l'administration, ouvre Servers et crée un serveur. Choisis le nœud (la machine qui fait tourner les serveurs du panel), l'œuf Agora, une allocation libre, 2048 Mo de mémoire et 10240 Mo de disque. <!-- À CONFIRMER : libellés et unités du formulaire de création de serveur Pelican (Mo/Gio), vérification banc -->

   <!-- CAPTURE C-049 -->

5. Regarde les variables du serveur. Elles s'affichent à la création, puis dans l'onglet Startup du serveur. Les noms sont en français et sans accents, c'est normal :

   • Cle de licence (AGORA_KEY) : doit contenir ta clé. Si tu as pris l'œuf public sans clé, colle-la ici ;
   • Base de donnees (DATABASE_URL) : laisse-la vide. Vide veut dire « utilise ta base intégrée » ;
   • Canal de mise a jour et Mettre a jour au demarrage : laisse les valeurs par défaut (stable et 0).

   <!-- CAPTURE C-050 -->

6. Ignore l'onglet Databases. Cet onglet du serveur sert à créer la base de ton serveur de jeu (MySQL), jamais celle d'Agora. Même si ton panel y propose du PostgreSQL, ne l'utilise pas ici. <!-- À CONFIRMER : l'onglet Databases de Pelican propose-t-il PostgreSQL ? (Administration → Database Hosts, vérification banc) -->

   <!-- CAPTURE C-051 -->

7. Démarre le serveur. Clique sur Start et suis la console. Le premier démarrage prend quelques minutes : Agora télécharge sa base de données (une vingtaine de Mo) puis lui-même. Ne clique ni sur Stop ni sur Kill pendant ce temps. Tu verras défiler les étapes [1/6] Identité, [2/6] Licence, [3/6] Version, [4/6] Téléchargement, [5/6] Base de données, [6/6] Démarrage, puis la ligne ✓ Ready in …. <!-- À CONFIRMER : durée réelle du premier démarrage avec la base intégrée (mesure banc Pelican, BASE-INTEGREE §6) -->

   <!-- CAPTURE C-052 -->

8. Ouvre ton site. Dans l'onglet Network (ou Réseau) du serveur, repère l'allocation : une adresse IP et un port, par exemple 203.0.113.20:3020 (une adresse d'exemple : la tienne sera différente). Tape http:// devant, dans ton navigateur : http://203.0.113.20:3020. La console affiche aussi cette adresse sur la ligne adresse ; si elle montre une adresse locale (en 10.… ou 192.168.…), utilise celle de l'onglet Network.

   <!-- CAPTURE C-053 -->

9. Fais la mise en route. L'écran qui s'ouvre te guide en trois étapes : voir Faire la mise en route.

   <!-- CAPTURE C-054 -->

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

• La console affiche ✓ base PostgreSQL intégrée prête, puis ✓ schéma à jour, puis ✓ Ready in ….
• Ton navigateur affiche l'écran Mise en route.
• http://IP:PORT/api/health répond "ok": true et "db": "ok".

Si ça ne marche pas #

J'ai importé le mauvais œuf #

1. Arrête le serveur Agora.
2. Importe l'Œuf pour Pelican (voir l'étape 3).
3. Change l'œuf du serveur pour qu'il utilise le bon, sans supprimer le serveur : sa base intégrée vit dans ses fichiers, donc supprimer le serveur la supprime aussi. <!-- À CONFIRMER : comment changer l'œuf d'un serveur existant sous Pelican (menu et libellés) -->
4. Quand plus aucun serveur n'utilise le mauvais œuf, supprime-le de la liste des œufs.

Si tu as quand même recréé le serveur, il repart d'une base vide : restaure ta dernière sauvegarde Agora (voir Sauvegardes et restauration). Un serveur recréé est une nouvelle installation : si la licence dit que le siège est pris, lis Libérer un siège de licence.

Pour aller plus loin #

Ce qu'il ne faut pas changer #

• La commande de démarrage : node /home/container/boot.mjs.
• Les variables réservées à l'administrateur du panel : le « Hub de licences » (AGORA_HUB, ce n'est pas ton Hub mais le serveur de licences d'Agora) et le « Site de l'amorçage » (AGORA_SITE). Laisse aussi vide le « Secret d'authentification » (AUTH_SECRET) : Agora le génère au premier démarrage.
• Rien à modifier dans Wings (le programme du nœud qui exécute les ordres du panel) : la console d'Agora passe par le serveur d'Agora.

Où sont les données #

/home/container/
  boot.mjs      l'amorçage installé par l'œuf
  app/          l'application (retéléchargeable)
  app/.data/    pièces jointes, fichiers du MDT, sauvegardes .sql
  .agora/       identité de l'installation, bail de licence, secret de session,
                et ta base de données intégrée (dossier pg)

La base intégrée vit donc dans les fichiers du serveur. Perdre .agora/ fait passer l'installation pour une nouvelle machine. La copie de fichiers du panel (sauvegarde du serveur, archive, SFTP) n'est pas une sauvegarde de la base : elle copie une base en train de fonctionner, donc incohérente, et souvent inutilisable à la restauration. Seules font foi les sauvegardes d'Agora : voir Sauvegardes et restauration.

Le port de l'onglet txAdmin #

La variable Port de l'onglet txAdmin (AGORA_TXADMIN_PORT, 40121 par défaut) sert à l'onglet Serveur → txAdmin : mets-y le numéro d'une seconde allocation du serveur (la première sert au site). Tu peux l'ignorer si tu n'utilises pas cet onglet : voir txAdmin dans Agora.

Apporter ta propre base PostgreSQL (option avancée) #

Jamais nécessaire. Si tu possèdes déjà un serveur PostgreSQL joignable depuis le conteneur, tu peux coller son adresse dans la variable Base de donnees, de la forme postgresql://utilisateur:motdepasse@hote:5432/base?schema=public. Elle prime alors sur la base intégrée, qui ne démarre plus. Quelques règles :

• C'est du PostgreSQL, pas du MySQL : l'onglet Databases du panel ne convient pas.
• Crée la base et son utilisateur avant de démarrer ; Agora y crée tout le reste.
• Si le mot de passe contient des caractères spéciaux (@, :, /, #…), remplace-les par leur code (@ devient %40).
• 203.0.113.20 est une adresse d'exemple : mets la tienne.

<!-- CAPTURE C-307 -->

<!-- CAPTURE C-311 -->

Pour passer d'une base à l'autre en gardant tes données, voir Déménager Agora sur une autre machine. <!-- À CONFIRMER : œuf tout-en-un (claude/pg-integre), BASE-INTEGREE §5 : procédure intégrée ↔ externe non éprouvée sur le banc -->