Skip to main content

Erreur 404 lors du téléchargement par un agent Medulla

S'applique à : Agents Medulla Linux
Version : Toutes versions
Environnement : Serveur Medulla On-Premise
Catégorie : Installation / Agents

Contexte

Lors de l'installation de Medulla, les packages d'installation des agents sont générés automatiquement à partir de la configuration définie sur le serveur.

Dans certains cas, les agents peuvent tenter de télécharger leurs fichiers de configuration depuis une URL incorrecte, empêchant la finalisation de leur installation.

Symptôme

L'installation de l'agent échoue lors du téléchargement du fichier startupdate.ini.

Exemple de logs :

https://agents.medulla-tech.io/downloads/config/startupdate.ini
Résolution de agents.medulla-tech.io (agents.medulla-tech.io)… xx.xx.xx.xx
Connexion à agents.medulla-tech.io (agents.medulla-tech.io)|xx.xx.xx.xx|:443… connecté.
requête HTTP transmise, en attente de la réponse… 404 Not Found
erreur 404 : Not Found.

Cause

Les packages agents sont générés à partir des options définies dans le fichier :

/var/lib/pulse2/clients/.generation_options

Lors de la génération des agents, l'option permettant de définir l'URL de téléchargement n'était pas renseignée.

En conséquence, l'agent tente d'utiliser une URL qui ne correspond pas à l'infrastructure du serveur Medulla.

Résolution

1. Vérifier les options de génération des agents

Afficher le contenu du fichier :

cat /var/lib/pulse2/clients/.generation_options

2. Ajouter l'URL du serveur Medulla

Ajouter la ligne suivante en adaptant le nom d'hôte à votre environnement :

--base-url=http://medulla.mon-domaine.fr/downloads

Exemple :

echo "--base-url=http://medulla.mon-domaine.fr/downloads" >> /var/lib/pulse2/clients/.generation_options

3. Régénérer les packages agents

Une fois la modification effectuée, régénérer les packages d'installation des agents afin que la nouvelle configuration soit intégrée.

Vérification

Après correction, l'agent doit télécharger ses fichiers directement depuis le serveur Medulla.

Exemple de logs attendus :

http://medulla.mon-domaine.fr/downloads/config/startupdate.ini
Résolution de medulla.mon-domaine.fr (medulla.mon-domaine.fr)… xx.xx.xx.xx
Connexion à medulla.mon-domaine.fr (medulla.mon-domaine.fr)|xx.xx.xx.xx|:80… connecté.
requête HTTP transmise, en attente de la réponse… 200 OK
Taille : 668
Enregistré : 'startupdate.ini'

Le téléchargement doit retourner un code HTTP :

200 OK

Pourquoi ce paramètre est-il important ?

Le paramètre --base-url est utilisé lors de la génération des packages agents.

Il indique aux agents où récupérer :

  • Les fichiers de configuration ;
  • Les composants de mise à jour ;
  • Les éléments nécessaires à leur initialisation.

Sans ce paramètre, l'agent peut tenter d'utiliser une URL qui ne correspond pas à votre infrastructure.

Vérifications complémentaires

Vérifier la présence du paramètre

cat /var/lib/pulse2/clients/.generation_options

Vérifier l'accès HTTP depuis un poste client

wget http://medulla.mon-domaine.fr/downloads/config/startupdate.ini

Le téléchargement doit réussir et retourner :

200 OK

Bonnes pratiques

Après toute modification :

  • Du nom DNS du serveur ;
  • Du reverse proxy ;
  • De la configuration HTTP/HTTPS ;
  • Des certificats TLS ;

Il est recommandé de vérifier les paramètres de génération des agents et de régénérer les packages d'installation afin de garantir que les nouveaux agents utilisent les bonnes URL de téléchargement.

Valeurs par défaut

Élément Valeur
Fichier de configuration /var/lib/pulse2/clients/.generation_options
Option concernée --base-url
Exemple de valeur http://medulla.mon-domaine.fr/downloads
Fichier téléchargé startupdate.ini

Résultat attendu

Après ajout de l'option :

--base-url=http://medulla.mon-domaine.fr/downloads

Les agents téléchargent correctement leurs fichiers de configuration depuis l'infrastructure Medulla du client et l'installation se termine normalement.

Back to top