|Documentation

Gestion des instances

Déployer une instance

Une instance, c'est votre portail cartographique : un site Lizmap à votre nom, avec son serveur QGIS, sa base PostgreSQL/PostGIS et son espace de fichiers. Vous la créez en une minute ; nous l'installons, la surveillons et la tenons à jour.

La page Instances : une carte par instance, avec son état, son adresse, son plan, sa version de QGIS et la place occupée.
  1. Ouvrez Instances et cliquez sur Déployer une instance. Tant que vous n'avez aucune instance, la page, comme le tableau de bord, propose Créer ma première instance.
  2. Donnez-lui un nom : lettres minuscules, chiffres et tirets. Il se met en forme pendant la saisie : majuscules en minuscules, accents retirés, espaces changés en tirets. Il ne peut ni commencer ni finir par un tiret. Il devient l'adresse de votre portail, affichée sous le champ : https://votre-nom.lizpack.com.
  3. Laissez Versions (optionnels) fermé pour prendre les versions marquées Recommandé, ou choisissez-y une version de QGIS Server et de Lizmap Web Client. Les deux listes ne proposent que des versions compatibles entre elles.
  4. Cliquez sur Déployer.
La fenêtre de déploiement : le nom choisi, l'adresse qu'il donnera, et les versions, repliées par défaut.

Comptez environ quatre minutes. La fenêtre de suivi affiche l'étape en cours. Vous n'avez pas à l'attendre : Continuer en arrière-plan la referme, un bandeau sur la page Instances suit le déploiement et un courriel vous prévient à la fin. Une fois l'instance prête, Voir mon instance ouvre sa fiche.

Quand le déploiement est refusé

Nous vérifions votre abonnement avant de créer quoi que ce soit. Sans abonnement, si vous n'avez jamais eu d'essai, la fenêtre Votre essai gratuit vous attend propose Activer l'essai gratuit : la fenêtre de déploiement s'ouvre aussitôt après ; Voir les offres mène aux plans payants. Si votre plan a atteint son nombre d'instances, la fenêtre Nombre d'instances maximal atteint s'ouvre, avec Mettre à niveau pour changer de plan ; sur la page Instances sans instance, le bouton est alors grisé et la raison écrite dessous. Si votre utilisation dépasse déjà les limites de votre plan, le déploiement attend que vous ayez fait de la place : voir les quotas. Si le serveur ne répond pas, Vérification impossible propose Réessayer.

Le nom ne peut plus être changé après le déploiement. Un nom déjà utilisé, même par une instance supprimée depuis, est refusé ; pour récupérer un ancien nom, écrivez au support.

L'état d'une instance

Chaque carte de la page Instances porte une pastille qui dit où en est l'instance. Le filtre placé à côté de la recherche n'affiche que les instances dans un état donné.

PastilleCe qu'elle signifieCe que vous pouvez faire
ActiveLe portail est en ligne.L'arrêter, la mettre à jour, la supprimer.
InactiveL'instance est arrêtée. Ses projets, ses fichiers et sa base sont conservés.La redémarrer avec Activer, ou la supprimer.
DéploiementL'installation est en cours.Attendre : un courriel annonce la fin.
Échec ou ErreurLe déploiement ou un service n'a pas abouti.Écrire au support, ou supprimer l'instance et recommencer.
Quota dépasséVotre utilisation dépasse les limites de votre plan ; les services de l'instance sont arrêtés. Au survol, la pastille dit quelle limite est en cause : nombre d'instances, stockage des fichiers ou des bases.Faire de la place ou changer de plan (voir les quotas, plus bas).
Abonnement expiréVotre abonnement n'est plus actif ; l'instance est arrêtée.Renouveler l'abonnement depuis Abonnements.
SuspendueL'instance a été suspendue par notre équipe.Écrire au support.

Pendant une action, la pastille la nomme : Démarrage…, Arrêt… ou Suppression…. Elle reprend son état normal dès que l'action est terminée.

Démarrer, arrêter, supprimer

Les gestes courants se font depuis la carte de l'instance, sur la page Instances. Gérer ouvre sa fiche ; le menu des trois points propose le reste.

  • Désactiver arrête l'instance : le portail est hors ligne, rien n'est effacé.
  • Activer la redémarre.
  • Supprimer l'efface, après confirmation.

Sur la fiche de l'instance, un seul bouton s'affiche selon l'état : Démarrer tout quand l'instance est arrêtée, Arrêter tout quand elle est en marche. Pour redémarrer une instance d'un seul geste, utilisez le bouton Redémarrer de la liste Mes instances, sur le tableau de bord. Ces actions s'exécutent sans demander de confirmation, et un courriel vous en informe.

Supprimer une instance

Supprimer demande le mot de passe de votre compte, puis Supprimer définitivement. L'instance, ses projets QGIS, ses fichiers et sa base sont effacés, et son nom ne pourra plus servir. Le suivi dure une minute environ ; vos quotas sont recalculés à la fin.

Une suppression ne se rattrape pas. Récupérez d'abord vos projets et vos données, depuis Fichiers et depuis la base.

La fiche d'une instance

Gérer ouvre la fiche de l'instance. En tête, son nom, son adresse et ses boutons ; dessous, des onglets : Aperçu, Composants, Modules, Sauvegardes, Fichiers, qui ouvre le gestionnaire de fichiers, et Paramètres, qui règle les protections, les courriels, l'adresse et la maintenance de l'instance. Chaque onglet a sa propre adresse : on peut la partager ou y revenir par le bouton retour du navigateur. L'Aperçu donne trois compteurs, le nombre de Projets, la place prise par vos fichiers (Stockage) et celle de votre Base de données, les chiffres que nous comparons aux limites de votre plan ; puis le nombre de Composants actifs et les versions de Lizmap et de QGIS Server.

La fiche d'une instance : son nom et ses boutons, ses onglets, puis l'aperçu et ses chiffres.

Les boutons de l'en-tête : Mettre à jour quand une version plus récente existe, puis Démarrer tout ou Arrêter tout selon l'état de l'instance. Les fichiers s'ouvrent par l'onglet Fichiers. Sous les compteurs de l'onglet Aperçu, le bloc Liens donne l'adresse du portail et de son administration, puis, pour chaque projet publié dans Lizmap, l'adresse de la carte et celles des services WMS, WFS et WMTS, à copier dans QGIS ou un autre client. Un projet y figure dès que son dossier est un répertoire Lizmap et qu'il a sa configuration Lizmap (.qgs.cfg) ; la liste se met à jour avec les relevés de l'instance, toutes les cinq minutes environ.

Une carte par service

L'onglet Composants donne une carte par service de l'instance, avec sa version et son état : Actif, Inactif ou Dégradé. Cliquez sur une carte pour la déplier.

CarteCe qu'elle contient une fois dépliée
Portail cartographiqueL'adresse publique de vos cartes et, sous Accès Administrateur, le lien Ouvrir vers l'administration Lizmap, avec son identifiant et son Mot de passe initial.
Lizmap Web ClientLe nombre de projets actifs.
PostgreSQL / PostGISLa place occupée et, sous Informations de connexion, la base, l'utilisateur, le mot de passe, l'hôte et le port à saisir dans QGIS. Ces paramètres sont réservés au plan Pro et au-delà.
QGIS ServerL'adresse du service et les protocoles servis : WMS, WFS, WMTS, WCS.
Cache RedisLe cache qui accélère l'affichage des tuiles et les sessions.

Les mots de passe sont masqués : l'œil les affiche, l'icône voisine les copie. Un service Inactif ou Dégradé alors que l'instance est démarrée est à nous signaler : la panne est de notre côté.

Modules

L'onglet Modules ajoute des fonctionnalités à votre portail Lizmap. Activer installe un module en moins d'une minute, sans interrompre le portail ; Désactiver le retire. L'instance doit être démarrée.

Changez le mot de passe d'administration Lizmap dès votre première connexion : celui qui s'affiche au départ est le même pour toutes les instances.

Les paramètres d'une instance

L'onglet Paramètres de la fiche réunit ce que vous réglez vous-même sur une instance. Les réglages sont réservés au propriétaire et aux membres de l'équipe qui ont le droit de déployer et de supprimer les instances.

L'onglet Paramètres : les protections, le serveur d'envoi des courriels de Lizmap et la maintenance en libre-service.

Protections

  • Protection contre la suppression : tant qu'elle est active, l'instance ne peut être ni supprimée ni désinstallée, et aucun de ses fichiers ou dossiers ne peut être supprimé, renommé ou déplacé, ni depuis le gestionnaire de fichiers ni depuis l'extension QGIS. Les envoyer, les remplacer et les copier reste possible. Retirez-la d'abord pour supprimer l'instance ou faire du ménage dans ses fichiers.
  • Protéger les projets QGIS : les fichiers .qgs et .qgz ne se téléchargent plus, pour personne, ni seuls ni dans une archive. Ils contiennent les mots de passe des bases. Les envoyer et les publier reste possible. Dans le gestionnaire de fichiers, ils portent alors un cadenas et la mention Protégé, et Télécharger est désactivé avec son motif ; l'en-tête de la fiche affiche Projets QGIS protégés.

Courriels de Lizmap

Votre portail Lizmap envoie des courriels : mot de passe oublié, création de compte, formulaires. Choisissez Serveur de LizPack (par défaut) : les courriels partent de notre serveur, sans rien à régler. Ou Mon serveur : indiquez le serveur d'envoi de votre messagerie (serveur SMTP, port, sécurité, compte et mot de passe, adresse et nom d'expéditeur). Cliquez ensuite sur Enregistrer et appliquer. Lizmap redémarre quelques secondes pour prendre le réglage. Débrancher le retire.

Le mot de passe n'est jamais réaffiché : laissez le champ vide pour garder celui qui est enregistré.

Maintenance

  • Réparer la liaison : si les cartes ne s'affichent plus (erreur 504) alors que l'instance est démarrée, ses services sont reconstruits dans un réseau neuf. Une à deux minutes d'interruption ; cartes, projets et base sont conservés.
  • Redéployer : l'instance est reconstruite à neuf (services, configuration, routage). Quelques minutes d'interruption ; vos données sont conservées.

Ces deux opérations demandent une confirmation, ne se lancent que sur une instance démarrée, et pas deux fois en dix minutes. L'onglet indique l'opération en cours, puis le résultat de la dernière, parmi celles que vous ou votre équipe avez lancées ; les interventions de notre support n'y figurent pas.

L'adresse d'une instance

Dans l'onglet Paramètres de la fiche, la section Adresse de l'instance montre l'adresse à laquelle répond votre instance et permet de la remplacer par un domaine à vous, par exemple carto.mairie.bj à la place de agoe.lizpack.com. Le changement est payant, réglé une fois par changement ; le retour à l'adresse d'origine est gratuit. Il est réservé au propriétaire et aux membres de l'équipe qui ont le droit de déployer et de supprimer les instances, et l'instance doit être démarrée. La section n'apparaît que lorsque l'option est proposée.

Préparer le domaine

  • Pour un sous-domaine (carto.mairie.bj) : chez votre fournisseur de domaine, créez un enregistrement CNAME vers la valeur indiquée dans l'onglet.
  • Pour un domaine sans sous-domaine (mairie.bj) : créez un enregistrement A vers l'adresse IP indiquée.
  • Désactivez tout proxy sur cet enregistrement : le domaine doit pointer directement vers notre serveur.

La prise en compte peut prendre de quelques minutes à quelques heures. Les valeurs à saisir se copient d'un clic depuis l'onglet.

Vérifier, payer, appliquer

Saisissez le domaine sous Nouvelle adresse, puis cliquez sur Vérifier : rien n'est payé tant que le domaine ne pointe pas vers votre instance. Une fois le domaine vérifié, l'onglet affiche le prix ; choisissez Carte bancaire ou Mobile Money, puis Payer et appliquer. Le changement prend quelques minutes et l'onglet se met à jour seul. Si l'application échoue, votre paiement reste acquis : Relancer la reprend sans payer de nouveau.

Anciennes adresses et projets

Après un changement, l'ancienne adresse redirige vers la nouvelle pendant une durée limitée, indiquée sous Anciennes adresses redirigées ; Arrêter la redirection y met fin plus tôt. Les projets QGIS qui citent encore l'ancienne adresse sont listés sous Projets à corriger : ils fonctionnent tant que la redirection dure, mettez-les à jour avant sa fin. Revenir à l'adresse d'origine rétablit gratuitement l'adresse en lizpack.com.

Mettre à jour une instance

Le bouton Mettre à jour, à côté du nom de l'instance sur sa fiche, s'active dès qu'une version plus récente de QGIS Server ou de Lizmap Web Client est disponible.

  1. Cliquez sur Mettre à jour. La fenêtre rappelle les versions actuelles.
  2. Choisissez la nouvelle version de chaque composant, ou gardez la version actuelle. La version conseillée porte la mention Recommandé.
  3. Cliquez sur Lancer la mise à jour.

La mise à jour prend deux minutes environ. Vos projets, vos fichiers et votre base ne sont pas touchés : seuls les logiciels changent. Les services mis à jour redémarrent, le portail est donc brièvement indisponible. Si quelque chose échoue, l'instance revient d'elle-même à ses versions précédentes. Un courriel vous donne le résultat.

La mise à jour est incluse dans les plans Pro et Enterprise. Sur les autres plans, elle coûte 10 USD par composant mis à jour, réglés dans la même fenêtre par carte bancaire, par Mobile Money ou avec une Clé de mise à jour.

Quotas : ce qui se passe en cas de dépassement

Votre plan fixe trois limites : la place de vos fichiers, la taille de vos bases et le nombre d'instances. Nous mesurons votre utilisation après chaque déploiement ou dépôt de fichiers, et la revérifions régulièrement.

Si vos fichiers ou vos bases dépassent la limite, les services web de vos instances s'arrêtent (portail, QGIS Server, cache) et leur pastille passe à Quota dépassé. La base reste accessible, Fichiers aussi : de quoi faire de la place. D'ici là, déployer, démarrer et mettre à jour sont bloqués.

Si vous avez plus d'instances que votre plan n'en permet, seules les plus récentes en surnombre sont arrêtées, entièrement, base comprise. Les autres continuent de tourner. Supprimer une instance reste toujours possible.

Dès que votre utilisation repasse sous les limites, tout redémarre de soi-même, en quelques minutes. Pour lever le blocage tout de suite, changez de plan depuis Abonnements.

N'ajoutez ni fichiers ni données tant que le quota est dépassé : l'accès aux Fichiers et à la base serait bloqué à son tour, et il ne resterait que la suppression d'instances.