Error 404 al realizar una descarga a través de un agente de Medulla
Aplicable a: Agentes de Medulla para Linux
Versión: Todas las versiones
Entorno: Servidor Medulla local
Categoría: Instalación / Agentes
Contexto
Durante la instalación de Medulla, los paquetes de instalación de los agentes se generan automáticamente a partir de la configuración definida en el servidor.
En algunos casos, los agentes pueden intentar descargar sus archivos de configuración desde una URL incorrecta, lo que impide que se complete su instalación.
Síntoma
La instalación del agente falla al descargar el archivo startupdate.ini.
Ejemplo de registros:
https://agents.medulla-tech.io/downloads/config/startupdate.ini
Resolución de agents.medulla-tech.io (agents.medulla-tech.io)… xx.xx.xx.xx
Conexión a agents.medulla-tech.io (agents.medulla-tech.io)|xx.xx.xx.xx|:443… conectado.
Solicitud HTTP enviada, a la espera de la respuesta… 404 Not Found
Error 404: Not Found.
Causa
Los paquetes de agentes se generan a partir de las opciones definidas en el archivo:
/var/lib/pulse2/clients/.generation_options
Al generar los agentes, no se había especificado la opción que permite definir la URL de descarga.
En consecuencia, el agente intenta utilizar una URL que no se corresponde con la infraestructura del servidor Medulla.
Solución
1. Comprueba las opciones de generación de los agentes
Mostrar el contenido del archivo:
cat /var/lib/pulse2/clients/.generation_options
2. Añadir la URL del servidor Medulla
Añade la siguiente línea adaptando el nombre de host a tu entorno:
--base-url=http://medulla.mon-domaine.fr/downloads
Ejemplo:
echo "--base-url=http://medulla.mon-domaine.fr/downloads" >> /var/lib/pulse2/clients/.generation_options
3. Regenerar los paquetes de los agentes
Una vez realizada la modificación, regenera los paquetes de instalación de los agentes para que se incorpore la nueva configuración.
Comprobación
Tras la corrección, el agente debe descargar sus archivos directamente desde el servidor Medulla.
Ejemplo de registros esperados:
http://medulla.mon-domaine.fr/downloads/config/startupdate.ini
Resolución de medulla.mon-domaine.fr (medulla.mon-domaine.fr)… xx.xx.xx.xx
Conexión a medulla.mi-dominio.fr (medulla.mi-dominio.fr)|xx.xx.xx.xx|:80… conectado.
Solicitud HTTP enviada, a la espera de la respuesta… 200 OK
Tamaño: 668
Guardado: «startupdate.ini»
La descarga debe devolver un código HTTP:
200 OK
¿Por qué es importante este parámetro?
El parámetro --base-url se utiliza al generar los paquetes de los agentes.
Indica a los agentes dónde obtener:
- Los archivos de configuración;
- los componentes de actualización;
- Los elementos necesarios para su inicialización.
Sin este parámetro, el agente podría intentar utilizar una URL que no se corresponda con su infraestructura.
Comprobaciones adicionales
Comprueba si existe el parámetro
cat /var/lib/pulse2/clients/.generation_options
Comprueba el acceso HTTP desde un equipo cliente
wget http://medulla.mon-domaine.fr/downloads/config/startupdate.ini
La descarga debe completarse con éxito y devolver:
200 OK
Buenas prácticas
Después de cualquier modificación:
- Del nombre DNS del servidor;
- Del proxy inverso;
- De la configuración HTTP/HTTPS;
- De los certificados TLS;
Se recomienda comprobar los parámetros de generación de los agentes y volver a generar los paquetes de instalación para garantizar que los nuevos agentes utilicen las URL de descarga correctas.
Valores por defecto
| Elemento | Valor |
|---|---|
| Archivo de configuración | /var/lib/pulse2/clients/.generation_options |
| Opción correspondiente | --base-url |
| Ejemplo de valor | http://medulla.mon-domaine.fr/downloads |
| Archivo descargado | startupdate.ini |
Resultado esperado
Tras añadir la opción:
--base-url=http://medulla.mon-domaine.fr/downloads
Los agentes descargan correctamente sus archivos de configuración desde la infraestructura Medulla del cliente y la instalación finaliza con normalidad.