Préparer l’installation
Ce guide s’adresse à l’installateur d’un nouveau système MaxiPBX. Il décrit l’assistant en cinq étapes proposé par la page /setup. Demandez à votre intégrateur l’adresse exacte de l’assistant servi par votre installation : l’écran d’amorçage dédié peut différer de cette page. Si le système fonctionne déjà, utilisez Connexion.
Préparez le nom de domaine, la clé fournie pour cette installation, les adresses réseau validées par votre intégrateur, le pays, le fuseau et le compte administrateur. Un nom de domaine complet, appelé FQDN, est une adresse telle que telephone.example.test, sans https:// ni chemin. Le DNS est le service qui relie ce nom à une adresse réseau.
À l’ouverture, Vérification de l’état de l’installation… précède le formulaire. Recharger relance la page. Si le système est reconnu comme configuré, la page vous renvoie à la connexion. Pendant Vérification…, les champs sont désactivés : ne relancez pas plusieurs demandes.
Étape 1 — FQDN
| Champ | À quoi ça sert | Valeurs possibles | Exemple |
|---|---|---|---|
| Nom de domaine complet (FQDN) | Adresse du système ; obligatoire | Nom complet, au plus 253 caractères, sans protocole ni chemin | telephone.example.test, exemple à remplacer par votre domaine |
- Saisissez le nom validé avec votre intégrateur.
- Cliquez sur Continuer.
- Corrigez la saisie si le format est refusé.
Le contrôle de format ne confirme pas que le nom pointe vers le serveur. La configuration du certificat et l’accessibilité seront vérifiées lors de l’application finale.
Étape 2 — Clé de licence
| Champ | À quoi ça sert | Valeurs possibles | Exemple |
|---|---|---|---|
| Clé de licence | Autorise l’installation et ouvre les étapes suivantes | La clé remise pour cette installation ; ne pas en fabriquer une | Collez la clé reçue de votre fournisseur |
| Nouvelle clé de licence, si proposée | Charge la licence associée à une clé d’installation hors ligne | Clé de licence compatible fournie par votre intégrateur | Collez la seconde clé reçue |
- Collez Clé de licence.
- Cliquez sur Continuer et attendez sa vérification.
- Si une seconde clé est demandée, saisissez-la, faites-la vérifier puis lisez le récapitulatif des clients, des quantités et de l’expiration avant de continuer.
La présentation peut accepter des séparateurs dans une clé classique ; le contrôle détecte une frappe incorrecte avant l’envoi. Une clé bien formée peut néanmoins être refusée par le service de licences.
Ne publiez pas la clé dans une capture ou un message. En cas de réponse incertaine après application, faites vérifier l’état de l’installation et de la licence avant de recommencer.
Étape 3 — Acceptation du CLUF
Le CLUF est le contrat de licence utilisateur final.
- Cliquez sur Lire le CLUF — version {version} ; la version affichée est celle reçue du service. Le contrat s’ouvre dans un autre onglet.
- Lisez cette version.
- Si vous l’acceptez, cochez J’ai lu et j’accepte cette version du CLUF..
- Cliquez sur Continuer.
La case est décochée au départ. Sans version disponible ou sans acceptation explicite, l’étape ne peut pas être validée. Précédent retourne à la licence.
Étape 4 — Réseau et localisation
NAT désigne ici une installation derrière un routeur qui traduit les adresses. Utilisez les paramètres confirmés par votre intégrateur.
| Champ | À quoi ça sert | Valeurs possibles | Exemple |
|---|---|---|---|
| Mode réseau | Indique comment le serveur est accessible ; obligatoire | NAT — derrière un routeur ; Sans NAT — accès public ; Sans NAT — réseau local | NAT — derrière un routeur |
| Adresse IP de l’interface de la box | Adresse locale d’écoute ; obligatoire | Adresse IPv4 ou IPv6 valide | 192.0.2.10, exemple documentaire |
| Adresse IP publique du routeur | Adresse annoncée à l’extérieur ; affichée en mode NAT | Adresse IP valide ; obligatoire en NAT | 198.51.100.10, exemple documentaire |
| Pays de l’installation | Fixe le plan de numérotation ; obligatoire | Un pays de la liste reçue du serveur | Le pays réel de votre installation |
| Fuseau horaire du client | Date les horaires d’ouverture ; obligatoire | Un fuseau proposé pour le pays choisi | Europe/Zurich si proposé pour votre pays |
- Choisissez le mode réseau ; Choisir correspond à une absence de sélection.
- Saisissez l’adresse de l’interface et, en NAT, celle du routeur.
- Choisissez le pays. Le champ de fuseau apparaît ensuite.
- Choisissez le fuseau. S’il n’en existe qu’un pour le pays, il est sélectionné automatiquement. Changer le pays efface le choix précédent, sauf si un fuseau unique peut être proposé.
- Cliquez sur Continuer.
Le mode réseau local utilise une autorité de certification interne. Le format des adresses ne prouve pas leur accessibilité. Précédent revient au contrat sans appliquer la configuration.
Étape 5 — Création de l’administrateur
| Champ | À quoi ça sert | Valeurs possibles | Exemple |
|---|---|---|---|
| Nom d'utilisateur administrateur | Identifie le compte initial ; obligatoire | 3 à 64 caractères ; lettres, chiffres, point, tiret ou soulignement ; premier caractère lettre ou chiffre ; pas de @ | camille.admin |
| Mot de passe | Secret demandé par cette version de l’assistant | 12 à 1 024 caractères | Une phrase personnelle confidentielle |
| E-mail de notification (facultatif) | Adresse de notification | Adresse simple valide, au plus 254 caractères, ou champ vide | camille@example.test |
- Renseignez l’identité du compte.
- Contrôlez les étapes précédentes avec Précédent si nécessaire.
- Cliquez sur Valider et appliquer une seule fois.
- Attendez la réponse. Toutes les étapes sont revérifiées et une saisie invalide peut vous renvoyer à l’étape concernée.
L’application configure le réseau et le certificat, vérifie la licence et enregistre le consentement. Si le service exige une activation par courriel alors que cet écran demande un mot de passe, faites vérifier la compatibilité de l’assistant par votre intégrateur. N’essayez pas de contourner le refus.
Vérifier le résultat et utiliser le lien de secours
Après confirmation, vous rejoignez normalement la connexion. Si Installation terminée, mais le courriel d’activation n’est pas parti. apparaît, ouvrez immédiatement le lien de secours affiché pour choisir votre mot de passe. Ce lien est à usage unique et le texte annonce une validité de trente minutes, avec l’échéance lorsqu’elle est disponible.
- Ouvrez le lien de secours et terminez l’activation.
- Revenez à l’assistant.
- Cliquez sur J’ai choisi mon mot de passe — aller à la connexion après avoir effectivement choisi votre mot de passe.
Ne quittez pas cet écran avant d’avoir utilisé ou transmis le lien de façon confidentielle. S’il a expiré, demandez une nouvelle activation à l’intégrateur.
Si cela ne fonctionne pas
| Message affiché | Solution |
|---|---|
| « Saisissez un FQDN complet, sans protocole ni chemin, dont vous maîtrisez le DNS. » | Corrigez le nom de domaine et retirez le protocole et le chemin. |
| « Clé invalide : vérifiez la saisie ou demandez une clé à votre fournisseur. » | Recopiez la clé fournie pour cette installation ou faites-la vérifier. |
| « Clé expirée : demandez son renouvellement à votre fournisseur. » | Demandez le renouvellement. |
| « Consultez le CLUF fourni et acceptez explicitement cette version pour continuer. » | Revenez au contrat, lisez-le et cochez son acceptation si vous l’acceptez. |
| « Saisissez l’adresse IP de l’interface de cette box. » | Faites confirmer l’adresse puis corrigez ce champ. |
| « Choisissez le fuseau horaire du client : c’est lui qui datera ses horaires d’ouverture. » | Sélectionnez un fuseau dans la liste après avoir choisi le pays. |
| « Le mot de passe administrateur doit contenir de 12 à 1024 caractères. » | Respectez la longueur demandée dans cet écran. |
| « Installation non confirmée : faites vérifier l’état de la box avant de réessayer. » | Arrêtez les tentatives et demandez une vérification à l’intégrateur. |
Un message concernant un service de configuration absent, un délai dépassé, un contrat indisponible ou une réponse illisible doit être transmis à l’intégrateur, sans la licence ni le lien d’activation. Certains diagnostics contiennent des noms techniques propres au serveur : conservez le message original dans votre échange privé.