¿Cómo forzar la reconfiguración de los agentes de Medulla?
Aplicable a: Medulla – Servidor
Versión: Todas las versiones
Entorno: On-Premise
Categoría: Agente de Medulla / Reconfiguración
Este procedimiento permite forzar la reconfiguración de los agentes de Medulla.
Cuando un agente está marcado con need_reconf=1, este realiza automáticamente las siguientes acciones:
- 1. Vuelve a solicitar la configuración al evaluador sustituto
El agente vuelve a solicitar su configuración completa al evaluador sustituto para recuperar los parámetros actualizados. - 2. Nuevo registro del agente
El agente se conecta al relé XMPP proporcionado por el evaluador y, a continuación, realiza un nuevo registro. - 3. Envío de un inventario completo
El agente inicia automáticamente un inventario completo del equipo y lo envía al servidor Medulla.
Se trata exactamente del mismo mecanismo que utiliza la «Acción rápida» «Reconfigurar máquina del agente», disponible en la interfaz de Medulla.
Elegir el método de reconfiguración adecuado
Caso 1: reconfiguración de un único equipo
Para reconfigurar un único equipo, se recomienda utilizar la acción rápida «Reconfigurar equipo del agente».
- Buscar el equipo en cuestión
- Abrir las «Acciones rápidas» (Quick Actions)
- Hacer clic en «Reconfigurar máquina del agente»
- Comprueba que el equipo se vuelva a registrar correctamente y envíe un inventario
Este método es el más sencillo y seguro para una necesidad puntual.
Caso 2: reconfiguración de un grupo de equipos
Si tiene que reconfigurar un número limitado de equipos, se recomienda:
- Crear un grupo de Medulla que contenga los equipos en cuestión
- A continuación, aplicar la «Acción rápida» «Reconfigurar equipo de agente» al grupo
Este método permite controlar con precisión el ámbito afectado antes de llevar a cabo una operación de mayor envergadura.
Caso 3: Reconfiguración global de todos los equipos
Para reconfigurar todo el parque informático, es posible utilizar una actualización en la base de datos MariaDB.
Importante:
Antes de cualquier ejecución global en la base de datos, se recomienda encarecidamente realizar una prueba en una sola máquina mediante la acción rápida «Reconfigurar máquina agente» para validar el comportamiento esperado.
Copia de seguridad recomendada:
Antes de realizar cualquier modificación en la base de datos MariaDB, realiza un volcado de la base de datos o una Copia de seguridad completa del servidor Medulla.
Paso 1: Realizar una copia de seguridad de la base de datos MariaDB
1. Conéctate por SSH al servidor Medulla
ssh root@IP_DEL_SERVIDOR
2. Crear una carpeta de Copia de seguridad (opcional)
mkdir -p /root/backup_medulla
3. Realizar una copia de seguridad completa de MariaDB
mysqldump --all-databases > /root/backup_medulla/backup_medulla_$(date +%F).sql
4. Comprobar la copia de seguridad
ls -lh /root/backup_medulla/
Comprueba que el archivo .sql está presente antes de continuar.
Paso 2: Acceder a MariaDB
1. Abrir la consola de MariaDB
mysql
Deberías ver un indicador similar a este:
MariaDB [(none)]>
2. Comprobar la base de datos xmppmaster
show databases;
Paso 3: forzar la reconfiguración global de los agentes
Ejecuta el siguiente comando:
update xmppmaster.machines
set need_reconf=1
where agenttype='machine';
Este comando fuerza la reconfiguración de todos los agentes de tipo «machine».
Paso 4 – Salir de MariaDB
exit
¿Cuándo se verán los cambios?
- La reconfiguración de las máquinas en línea se realiza por lotes de 240 máquinas cada 60 segundos de forma predeterminada.
- Las máquinas apagadas o fuera de línea aplicarán automáticamente la reconfiguración la próxima vez que se conecten al servidor Medulla.
- Dependiendo del número total de equipos afectados, la actualización completa de los inventarios puede tardar varias horas.
- Tras la reconfiguración, cada agente:
- Solicitará de nuevo su configuración al evaluador suplente
- Se vuelve a conectar al relé XMPP y se vuelve a registrar
- Enviará un inventario completo