moctl : Guide de gestion des services sur site

---

Le serveur d'identité miniOrange On-Premise inclut un utilitaire en ligne de commande appelé moctl qui aide les administrateurs à gérer et à exploiter plus efficacement la plateforme d'identité.

Ce guide s'adresse aux équipes informatiques et aux administrateurs système ayant installé miniOrange 5.0.0 sur un serveur ou souhaitant déployer moctl. Il aborde le déploiement, la gestion des services, les journaux, les diagnostics et le dépannage.

Pré-requis :

Voici une liste des éléments dont vous aurez besoin avant l'installation, le déploiement et l'exploitation.

Les environnements dont vous aurez besoin sont les suivants :

• Accès root ou sudo
• Chemin du produit accessible à /opt/tomcat/latest
• services systemd dans mo-idp-*.service le format
• Configuration d'exécution à /etc/mo-idp-server.env (configuration principale sur les serveurs déployés)

Installation, configuration et exploitation

1. Installation et déploiement

• If moctl n'est pas encore sur le serveur, transférez et installez le paquet :

Transférer le colis

          scp moctl.zip admin@<server-ip>:/opt/
        

Extraire et installer

          
            cd /opt
            ├── unzip moctl.zip
            ├── cd /opt/moctl
            ├── sudo bash install-moctl.sh
          
        




À noter:

install-moctl.sh lit /etc/mo-idp-server.env si elle existe et met à jour la configuration d'exécution en conséquence.

L'utilisateur configure les éléments suivants :

• Exécutable : /usr/local/bin/moctl
• Fichiers d'assistance : /opt/miniorange/moctl
• Configuration d'exécution : /etc/mo-idp-server.env (créé ou mis à jour)

2. Validation du package installé

• Vérifiez que les fichiers sont bien en place.

          
            which moctl
            ls -l /usr/local/bin/moctl
            cat /etc/mo-idp-server.env
        

• Vérifiez que l'outil répond correctement.

          
            moctl version
            moctl service status
            moctl diagnose full
          
        

3. Gestion des services

• L'étape suivante consiste à vérifier le statut.

          moctl service status
        




Statut	Sens
Fonctionnement	Le service est actif et en bonne santé.
Enregistrement	Actif et géré par Eureka, inscription en cours. Veuillez patienter 30 à 60 secondes.
Arrêté	Le service est inactif.
Échoué	Le service a planté. Consultez immédiatement les journaux.

À noter:

In 5.0.0 eurekaserver et miniOrange Ils courront à l'extérieur d'Eureka. Ils montreront la course, sans jamais s'inscrire.



• Démarrer / Arrêter / Redémarrer

Command	Ce qu'il fait
démarrage du service moctl	Démarrez tous les services dans le bon ordre.
arrêt de service moctl	Arrêtez tous les services dans l'ordre inverse.
redémarrage du service moctl	Redémarrez tous les services.
service moctl démarrer le gardien de porte	Démarrez un service unique nommé.
redémarrage du service moctl miniorange	Redémarrez un seul service nommé.




À noter:

Les services de base démarrent en premier : configserver → eurekaserver → gatekeeper → miniOrangeLes services secondaires suivent automatiquement. L'exécution de `moctl service` ou `moctl diagnose` sans sous-commande affiche des suggestions.

4. Journalisation des accès et surveillance

Command	Ce qu'il fait
journal moctl miniorange	Démarrez tous les services dans le bon ordre.
moctl log miniorange -f Suivre	Suivez les logs en direct (Ctrl+C pour arrêter).
moctl log miniorange -n 500	Afficher les 500 dernières lignes.
journal moctl miniorange --depuis 1h	Afficher les journaux de la dernière heure.
moctl log gatekeeper --since 30min	Afficher les journaux de tout service nommé.

5. Diagnostics

• À cette étape, vous pouvez effectuer une vérification complète.

          moctl diagnose full
        



• Vérifications : état du service, ports principaux, mémoire, disque, Nginx, Java, fichier d’environnement et lien symbolique.

Command	Ce qu'il fait
services de diagnostic moctl	États de service uniquement.
moctl diagnostic des ports	Disponibilité du port principal.
ressources de diagnostic moctl	Utilisation de la mémoire et du disque.
diagnostic moctl deps	Dépendances Nginx et Java.
diagnostic moctl	Afficher les sous-commandes disponibles et l'aide à l'utilisation.

6. Inspection du système et de la JVM

Command	Ce qu'il fait
mémoire système moctl	Afficher l'utilisation de la mémoire
processeur système moctl	Afficher l'utilisation du processeur
disque système moctl	Afficher l'utilisation du disque
moctl jvm miniorange	Version de la JVM, tas, options, threads, descripteurs de fichiers

7. Flux de travail recommandés

• Contrôle de routine lors des connexions

          
            moctl diagnose full
            moctl service status
          
        



• Enquête sur un problème de service.

          
            moctl service status
            moctl log miniorange --since 30min  
          
        



• Redémarrez le service concerné, puis confirmez le rétablissement.

          
            moctl service restart gatekeeper
            moctl service status
            moctl diagnose services  
          
        




À noter:

Privilégiez, dans la mesure du possible, le redémarrage d'un seul service plutôt qu'un redémarrage complet.

8. Dépannage

Pour résoudre tous vos problèmes, voici ce que vous pouvez faire :

• moctl introuvable

          
          ls -l /usr/local/bin/moctl  
            echo $PATH
          
        



• Si le programme d'installation est manquant, relancez-le.

            
            sudo bash install-moctl.sh
          



• Services non détectés

          
          systemctl list-unit-files 'mo-idp-*.service'
        



• Noms de service attendus :
• mo-idp-configserver.service
• mo-idp-eurekaserver.service
• mo-idp-gatekeeper.service
• mo-idp-miniorange.service
• Si le chemin du produit est incorrect

          
          cat /etc/mo-idp-server.env
          ls -ld /opt/tomcat/latest
        




Corrigez le chemin dans /etc/mo-idp-server.env et relancez le programme d'installation.

• Le service est bloqué lors de l'enregistrement.

          
          moctl diagnose services  
          moctl log gatekeeper --since 30min  
          curl -u registry_client:'Eureka2025_Client!' http://localhost:8070
        




Vérifier : disponibilité et identifiants Eureka /etc/mo-idp-server.env, et des erreurs de démarrage dans les journaux.

À noter:

Scheduler et miniOrange ne sont pas gérés par Eureka dans la version 5.0.0 ; ils n’afficheront jamais l’état d’enregistrement. Si vous voyez ce message pour ces services, cela indique un problème d’affichage ou de configuration.



• Fichier d'environnement ou lien symbolique manquant

            
            test -f /etc/mo-idp-server.env && echo ok
            test -L /opt/tomcat/latest && readlink -f /opt/tomcat/latest  
          




Corrigez la valeur erronée et relancez le programme d'installation. La configuration d'exécution se trouve à l'emplacement suivant : /etc/mo-idp-server.env est la source faisant autorité.