Skip to main content

Error 404 when downloading via a Medulla agent

Applies to: Medulla Linux Agents
Version: All versions
Environment: On-Premise Medulla Server
Category: Installation / Agents

Background

During Medulla installation, agent installation packages are automatically generated based on the configuration defined on the server.

In some cases, the agents may attempt to download their configuration files from an incorrect URL, preventing their installation from completing.

Symptom

The agent installation fails while downloading the startupdate.ini file.

Example logs:

https://agents.medulla-tech.io/downloads/config/startupdate.ini
Resolving agents.medulla-tech.io (agents.medulla-tech.io)… xx.xx.xx.xx
Connecting to agents.medulla-tech.io (agents.medulla-tech.io)|xx.xx.xx.xx|:443… connected.
HTTP request sent, waiting for response… 404 Not Found
Error 404: Not Found.

Cause

The agents packages are generated based on the options defined in the file:

/var/lib/pulse2/clients/.generation_options

When the agents were generated, the option to define the download URL was not specified.

As a result, the agent attempts to use a URL that does not match the Medulla server infrastructure.

Resolution

1. Check the agent generation options

Display the contents of the file:

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

2. Add the Medulla server URL

Add the following line, adjusting the hostname to match your environment:

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

Example:

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

3. Regenerate the agent packages

Once the change has been made, regenerate the agent installation packages so that the new configuration is incorporated.

Verification

After the correction, the agent should download its files directly from the Medulla server.

Example of expected logs:

http://medulla.my-domain.fr/downloads/config/startupdate.ini
Resolving medulla.my-domain.fr (medulla.my-domain.fr)… xx.xx.xx.xx
Connecting to Medulla.my-domain.fr (Medulla.my-domain.fr)|xx.xx.xx.xx|:80… connected.
HTTP request sent, waiting for response… 200 OK
Size: 668
Saved: 'startupdate.ini'

The download must return an HTTP status code:

200 OK

Why is this parameter important?

The --base-url parameter is used when generating agent packages.

It tells the agents where to retrieve:

  • Configuration files;
  • Update components;
  • The elements needed for their initialization.

Without this parameter, the agent may attempt to use a URL that does not match your infrastructure.

Additional Checks

Check for the presence of the parameter

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

Check HTTP access from a workstation

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

The download should succeed and return:

200 OK

Best Practices

After any changes:

  • The server's DNS name;
  • The reverse proxy;
  • The HTTP/HTTPS configuration;
  • TLS certificates;

It is recommended that you verify the agent generation settings and regenerate the installation packages to ensure that the new agents use the correct download URLs.

Default values

Element Value
Configuration file /var/lib/pulse2/clients/.generation_options
Relevant option --base-url
Example value http://medulla.mon-domaine.fr/downloads
Downloaded file startupdate.ini

Expected result

After adding the option:

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

The agents successfully download their configuration files from the client's Medulla infrastructure, and the installation completes normally.

Back to top