Skip to main content

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.