Skip to main content

Forzar el restablecimiento o la reinstalación de un agente Medulla

Aplicable a: Servidor Medulla
Versión: 5.6.4 y superiores
Entorno: On-Premise
Categoría: Agente / Diagnóstico / Mantenimiento

A partir de la versión 5.6.4 de Medulla, es posible solicitar al servidor Medulla que fuerce el restablecimiento de un agente.

Esta operación puede utilizarse, en particular, cuando un agente presenta un fallo persistente, por ejemplo, cuando deja de actualizarse correctamente.

El restablecimiento se solicita añadiendo el JID de la máquina en la tabla:

xmppmaster.reset_machine

Importante:
Las operaciones descritas en esta documentación actúan directamente sobre la base de datos de Medulla. Deben realizarse con precaución y únicamente por parte de un administrador de la plataforma.


1. Identificar el JID de la máquina

Para solicitar el restablecimiento de una máquina, debe disponer de su JID de Medulla.

El JID puede consultarse directamente en la tabla xmppmaster.machines.

Por ejemplo, para buscar una máquina a partir de una parte de su nombre:

SELECT jid
FROM xmppmaster.machines
WHERE jid LIKE '%NOMBRE_DE_LA_MAQUINA%';

Ejemplo de JID:

spo-w11-1.o68@spo-ars01/bc241109f61e

Nota:
Utilice siempre el JID completo proporcionado por Medulla para identificar con precisión la máquina en cuestión.


2. Forzar el restablecimiento de un agente

Para solicitar el restablecimiento de un agente concreto, añada su JID a la tabla xmppmaster.reset_machine.

Ejemplo:

INSERT INTO xmppmaster.reset_machine (jid, reason)
VALUES ('spo-w11-1.o68@spo-ars01/bc241109f61e', 'Unstable agent');

El campo reason permite indicar el motivo por el que se ha solicitado el restablecimiento.

Se recomienda utilizar una descripción que permita identificar fácilmente el motivo de la operación.

Por ejemplo:

INSERT INTO xmppmaster.reset_machine (jid, reason)
VALUES ('JID_DE_LA_MAQUINA', 'Agent update issue');

3. Comprobar la solicitud de restablecimiento

Tras la inserción, puede comprobar si la solicitud figura en la tabla:

SELECT *
FROM xmppmaster.reset_machine
WHERE jid = 'spo-w11-1.o68@spo-ars01/bc241109f61e';

Esta comprobación permite confirmar que la solicitud de restablecimiento se ha registrado correctamente.


4. Forzar el restablecimiento de todos los agentes

También es posible solicitar el restablecimiento de todos los agentes de tipo machine inscritos en Medulla.

Antes de realizar esta operación, se recomienda encarecidamente comprobar la lista de máquinas afectadas:

SELECT jid
FROM xmppmaster.machines
WHERE agenttype = 'machine';

A continuación, para solicitar el restablecimiento de todos estos agentes:

INSERT INTO xmppmaster.reset_machine (jid, reason)
SELECT jid, 'Reset all agents'
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Atención:
Este comando afecta a todos los agentes de tipo machine inscritos en Medulla. No debe utilizarse para resolver una incidencia aislada en un único puesto de trabajo.


5. Comprobar el número de máquinas antes de un restablecimiento global

Antes de realizar un restablecimiento global, puede comprobar el número de agentes afectados mediante:

SELECT COUNT(*)
FROM xmppmaster.machines
WHERE agenttype = 'machine';

También puede visualizar exactamente los datos que se utilizarán para alimentar la tabla de restablecimiento:

SELECT jid, 'Reset all agents' AS reason
FROM xmppmaster.machines
WHERE agenttype = 'machine';

Recomendación:
Ejecute siempre esta consulta de control antes del comando INSERT ... SELECT para verificar el alcance de la operación.


6. Casos de uso

El restablecimiento de un agente puede utilizarse, en particular, en las siguientes situaciones:

  • un agente ya no se actualiza correctamente;
  • un agente permanece en un estado incoherente a pesar de las operaciones habituales de diagnóstico;
  • el servicio de asistencia de Medulla solicita explícitamente forzar el restablecimiento del agente;
  • una operación de mantenimiento requiere el restablecimiento de un conjunto de agentes.

Importante:
El restablecimiento de un agente no debe constituir la primera medida de diagnóstico. En caso de mal funcionamiento de un agente, se recomienda comenzar por identificar el origen del problema y, si es necesario, utilizar la herramienta de diagnóstico de Medulla.


7. ¿Restablecimiento de un agente o restablecimiento global?

Necesidad Método recomendado
Problema en una sola máquina Añadir únicamente el JID de la máquina en xmppmaster.reset_machine
Agente que ya no se actualiza Restablecimiento individual tras el diagnóstico
Se han identificado varias máquinas Introducir únicamente los JID de las máquinas afectadas
Restablecimiento de todo el parque Utilizar INSERT ... SELECT tras verificar el ámbito de aplicación

8. Buenas prácticas

  • dar prioridad al restablecimiento de una sola máquina cuando se trate de un incidente aislado;
  • comprobar el JID antes de introducir la solicitud de restablecimiento;
  • indicar un motivo explícito en el campo reason;
  • comprobar el número de máquinas antes de realizar cualquier operación global;
  • no utilizar el restablecimiento global para resolver un problema que afecte únicamente a unas pocas máquinas;
  • realizar un diagnóstico del agente antes de solicitar su restablecimiento cuando se desconozca el origen del problema.

Recomendación:
En caso de problema en un agente Medulla, opte siempre por un restablecimiento selectivo a partir del JID de la máquina en cuestión. El restablecimiento global de todos los agentes debe ser una operación excepcional y controlada.