moctl: Guía de gestión de servicios locales

---

El servidor de identidad local miniOrange incluye una utilidad de línea de comandos llamada moctl que ayuda a los administradores a gestionar y operar la plataforma de identidad de forma más eficiente.

Esta guía está dirigida a equipos de TI y administradores de sistemas que tengan miniOrange 5.0.0 instalado en un servidor o que deseen realizar una instalación limpia de moctl. Cubre la implementación, la administración del servicio, los registros, el diagnóstico y la resolución de problemas.

Requisitos previos

Aquí tienes una lista de los elementos que necesitarías antes de la instalación, el despliegue y las operaciones.

Los entornos esperados que necesitaría son:

• Acceso root o sudo
• Ruta del producto accesible en /opt/tomcat/latest
• servicios systemd en mo-idp-*.service formato
• Configuración de tiempo de ejecución en /etc/mo-idp-server.env (Configuración principal en servidores desplegados)

Instalación, configuración y operaciones

1. Instalación e implementación

• If moctl aún no está en el servidor, transfiera e instale el paquete:

Transfiera el paquete

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

Extraer e instalar

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




Nota:

install-moctl.sh lee /etc/mo-idp-server.env Si existe, actualiza la configuración de tiempo de ejecución en consecuencia.

El usuario está configurando lo siguiente:

• Ejecutable: /usr/local/bin/moctl
• Archivos de soporte: /opt/miniorange/moctl
• Configuración de tiempo de ejecución: /etc/mo-idp-server.env (creado o actualizado)

2. Validación del paquete instalado

• Confirma que los archivos estén en su lugar.

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

• Confirme que la herramienta responde correctamente.

          
            moctl version
            moctl service status
            moctl diagnose full
          
        

3. Gestión de servicios

• El siguiente paso es comprobar el estado.

          moctl service status
        




Estado	Significado
Correr	El servicio es activo y saludable.
Registro de	Activo y gestionado por Eureka, aún en proceso de registro. Espere entre 30 y 60 segundos.
Detenido	El servicio está inactivo.
Fallidos	El servicio ha fallado. Revise los registros inmediatamente.

Nota:

en 5.0.0 servidor eureka y mininaranja Correrán fuera de Eureka. Aparecerán corriendo, pero nunca se registrarán.



• Iniciar / Detener / Reiniciar

Comando	¿Qué hace?
inicio del servicio moctl	Inicie todos los servicios en el orden correcto.
parada de servicio moctl	Detenga todos los servicios en orden inverso.
Reinicio del servicio moctl	Reinicia todos los servicios.
moctl service start gatekeeper	Inicie un único servicio con nombre.
Reiniciar el servicio moctl miniorange	Reiniciar un único servicio con nombre.




Nota:

Los servicios principales comienzan primero: configserver → eurekaserver → gatekeeper → miniOrangeLos servicios secundarios se ejecutan automáticamente. Al ejecutar moctl service o moctl diagnose sin un subcomando, se muestran sugerencias.

4. Acceso y monitorización de registros

Comando	¿Qué hace?
Registro de moctl miniorange	Inicie todos los servicios en el orden correcto.
moctl log miniorange -f Seguir	Siga los registros en directo (Ctrl+C para detener).
moctl log miniorange -n 500	Mostrar las últimas 500 líneas.
moctl log miniorange --since 1h	Mostrar registros de la última hora.
moctl log gatekeeper --since 30min	Mostrar registros para cualquier servicio especificado.

5. Diagnósticos

• En este paso, puede realizar una verificación completa.

          moctl diagnose full
        



• Comprobaciones: estado del servicio, puertos principales, memoria, disco, Nginx, Java, archivo de entorno y enlace simbólico.

Comando	¿Qué hace?
servicios de diagnóstico moctl	Solo estados de servicio.
puertos de diagnóstico de moctl	Disponibilidad del puerto principal.
Recursos de diagnóstico de moctl	Uso de memoria y disco.
diagnóstico moctl deps	Nginx, dependencias de Java.
diagnóstico de moctl	Muestra los subcomandos disponibles y la ayuda de uso.

6. Inspección del sistema y de la JVM

Comando	¿Qué hace?
memoria del sistema moctl	Mostrar uso de memoria
sistema moctl cpu	Mostrar el uso de la CPU
disco del sistema moctl	Mostrar el uso del disco
moctl jvm miniorange	Versión de JVM, montón, indicadores, subprocesos, descriptores de archivo

7. Flujos de trabajo recomendados

• Verificación rutinaria durante los inicios de sesión.

          
            moctl diagnose full
            moctl service status
          
        



• Investigando un problema de servicio.

          
            moctl service status
            moctl log miniorange --since 30min  
          
        



• Reinicie el servicio afectado y, a continuación, confirme que se ha solucionado.

          
            moctl service restart gatekeeper
            moctl service status
            moctl diagnose services  
          
        




Nota:

Siempre que sea posible, prefiera reiniciar un solo servicio en lugar de reiniciarlo por completo.

8. Solución de problemas

Para solucionar cualquier problema, esto es lo que puede hacer:

• No se encontró moctl

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



• Si no aparece, vuelva a ejecutar el instalador.

            
            sudo bash install-moctl.sh
          



• Servicios no detectados

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



• Nombres de servicio previstos:
• servicio mo-idp-configserver
• servicio mo-idp-eurekaserver
• servicio mo-idp-gatekeeper
• servicio mo-idp-miniorange.
• Si la ruta del producto es incorrecta

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




Corrige la ruta en /etc/mo-idp-server.env y vuelva a ejecutar el instalador.

• El servicio se ha quedado atascado en el registro.

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




Comprobación: Disponibilidad de Eureka, credenciales en /etc/mo-idp-server.envy errores de inicio en los registros.

Nota:

En la versión 5.0.0, Scheduler y miniOrange no se gestionan mediante Eureka; por lo tanto, nunca mostrarán el estado de registro. Si ve que estos servicios se están registrando, indica un problema de visualización o de configuración.



• Falta el archivo de entorno o el enlace simbólico.

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




Corrija el valor que falla y vuelva a ejecutar el instalador. La configuración de tiempo de ejecución en /etc/mo-idp-server.env es la fuente autorizada.