Administrer
Résoudre les problèmes
Messages d'erreur fréquents, leur cause et la solution.
Installation
| Message | Cause | Solution |
|---|---|---|
| Serveur ZokasTech injoignable | Réseau ou proxy | Réseau et proxy… › Tester la connexion. Voir Installer derrière un proxy. |
| HTTP 407 | Le proxy demande une authentification | Renseignez identifiant et mot de passe du proxy. |
| Certificat non reconnu | Le proxy inspecte le HTTPS | Installez le certificat racine de l'entreprise dans le trousseau du système. |
| Port(s) déjà utilisé(s) : 17880 | Un autre service occupe le port | Arrêtez le conteneur indiqué, puis relancez l'installation de l'Orchestrator. |
| l'Orchestrator ne démarre pas : … | Erreur Python au chargement (message affiché après le texte) | Relancez l'installation avec la dernière version ; joignez logs/orchestrator.log (dossier de l'Orchestrator, voir Où sont installés les fichiers) à votre demande d'assistance. |
| l'Orchestrator ne répond pas sur http://localhost:17880 | Démarrage trop long ou bloqué par un antivirus | Attendez une minute, puis ouvrez http://localhost:17880/health ; sinon consultez le journal de l'Orchestrator. |
| Python 3.10+ est requis | Python absent et installation automatique impossible | Installez Python 3.12 depuis python.org (option « pour moi uniquement », sans droits d'administrateur), puis relancez l'installation. |
| catalogue non signé / signature du catalogue invalide | L'installateur ne correspond pas au Hub (clé différente) | Téléchargez ZokasTech Setup à jour depuis la page Téléchargement. |
| Cette version de l'Orchestrator ne contient pas les sources Python | Archive ancienne sur le Hub | Choisissez Podman ou Docker dans Options avancées…, ou attendez la publication d'une version récente. |
| WSL 2 vient d'être activé ou a été refusé | Mode Podman sous Windows | Redémarrez Windows et relancez l'installation, ou revenez au mode Local · Python (sans droits d'administrateur). |
Exécution
| Message | Cause | Solution |
|---|---|---|
| Échec à « … » : élément introuvable | Cible absente ou page pas encore chargée | Précisez la cible, ajoutez une attente, ou utilisez ui.image. |
| valeur vide pour … | Variable non renseignée | Renseignez la variable au lancement. |
| programme « npm » introuvable sur … | Node.js absent du robot | Installez Node.js, ou réglez ZOKAS_SHELL_PATH. Voir cmd.run. |
| programme « X » non autorisé | Hors liste blanche | Ajoutez-le à ZOKAS_SHELL_ALLOW sur le robot. |
| sous-processus introuvable | Processus non publié ou renommé | Publiez-le ; vérifiez le nom exact. |
| IA non configurée | Pas de moteur IA | ZOKAS Agent › Moteur IA › Tester. |
| Licence ZOKAS Orchestrator requise (402) | Licence absente ou expirée | ZOKAS Agent › Orchestrator › Licence. |
Format du fichier
| Message | Cause | Solution |
|---|---|---|
| format zokas.package/1 attendu | Champ format absent ou différent | Ajoutez "format": "zokas.package/1". |
| Étape inconnue : … | Type inexistant ou mal orthographié | Voir le Catalogue des étapes. |
| propriétés ignorées … | Propriété inconnue pour ce type | Retirez-la ou corrigez son nom. |
Pour valider un fichier avant l'import, utilisez le Schéma JSON.
Mis à jour le 28 octobre 2026