The Lumu Agent is available for Linux-based operating systems. In this article, you will find the installation procedures, both automatic and manual, for all the supported distributions. 

To get started with agents, access Introduction to Lumu Agents.

Supported Distributions

These are the distributions supported by the Lumu Agent for Linux as well as the supported versions of each. If you are using a version or distribution not found on this list, it will be under your own responsibility, as Lumu will only provide official support to the ones listed in this article:

Installer Setup

You can quickly set up the Lumu Agent for Linux using the provided installer. This is the fastest and easiest way to use the Lumu Agent on your Linux environments. It is the recommended installation method. 

Before installing the Lumu Agent, make sure you create a group in the Lumu Portal. Remember that an internet connection is required for the Lumu Agent activation.

1. First, download the installer from the Lumu Portal. Open the ‘Collectors’ drop-down, and select ‘Agents’. Once there, click on ‘Download for’ and select Linux. You will see a menu that will allow you to download the installer. 

2. Once downloaded, you must carry out some preparations before running the installer. First, you must set it to executable mode. To do so, run the following commands in the terminal: 

3. Now, you must run the installer. This is the first screen you will see once you run the agent:

A basic installation procedure must make use of the ‘install’ or ‘license’ options. 

4. Enter -i or --install . This will install the Lumu Agent on your Linux-based system. 

• Optionally, you can install and activate the agent with a single command. To do so, enter -l LICENSE or --license LICENSE as shown in the menu. LICENSE being the activation code found in the Lumu Portal.Once activated, the Lumu Agent for Linux will be running on your system.
  

Manual Installation - Ubuntu

This is the manual installation procedure of the Lumu Agent for Linux in supported Ubuntu environments. 

Install using the apt repository

1. Update the apt package index and install packages to allow apt to use a repository over HTTPS:

2. Add Lumu’s official GPG key:

If you get an error stating that “no alternative certificate subject name matches target host name” and “curl failed to verify the legitimacy of the server and therefore could not establish a secure connection to it” it is due to a bug occurring on cURL between versions 7.12.0 to 8.0.1 that doesn’t allow requests to TLS domains with wildcard certificates. You can learn more about this bug on cURL’s official statement.  We suggest using Wget as a workaround. To do so, use the following command:

wget -q -O - https://packages.lumu.io/ubuntu/ubuntu.pub.key | sudo gpg --dearmor -o /etc/apt/keyrings/lumu.gpg 

4. Update the apt package index and install the lumu-linux-agent package.

Manual Installation - Debian

This is the manual installation procedure of the Lumu Agent for Linux in supported Debian environments. 

Install using the apt repository

1. Update the apt package index and install packages to allow apt to use a repository over HTTPS:

2. Add Lumu’s official GPG key:

3. Use the following command to set up the repository:

4. Update the apt package index and install the lumu-linux-agent package.

Manual Installation - RHEL

This is the manual installation procedure of the Lumu Agent for Linux in supported RHEL environments. 

Install using the rpm repository

1. Install the yum-utils package (which provides the commands to manage your YUM repositories), and set up the repository. 

 If your system language is set to Spanish, please add LANG=C.UTF-8 to every yum-related command, e.g. LANG=C.UTF-8 sudo dnf config-manager --add-repo ...

2. Install the Lumu Linux Agent.

Manual Installation - Fedora

This is the manual installation procedure of the Lumu Agent for Linux in supported Fedora environments. 

Install using the rpm repository

1. Install the dnf-plugins-core package (which provides the commands to manage your DNF repositories) and set up the repository.

2. Install the Lumu Linux Agent.

Manual Installation - OpenSUSE

This is the manual installation procedure of the Lumu Agent for Linux in supported OpenSUSE environments. 

Install using the rpm repository

1. Install the Lumu repository using zypper.

2. Install the Lumu Linux Agent.

Activate the Lumu Agent for Linux

Once you have installed the agent, you must activate it. This step is identical for all distributions. 

To do so, you will need an activation code which you will find in the Lumu Portal after creating an installation group. 

Run the following command with the activation code that corresponds to the assigned group.

If the activation was carried out correctly, you should see the following message:

Activation successful! 

Otherwise, please consult the article’s Command Quick Reference for Agent Support section.

Uninstalling the Lumu Agent for Linux

Using the installer

Regardless of whether or not you installed the agent using our installer, you can remove it and its repository from your system through the installer by using the -u or --uninstall option. 

You must run the installer as root:

Debian/Ubuntu Uninstall

This is the manual uninstallation procedure of the Lumu agent, its repository, and key on a system using the APT package manager. Use it if you prefer to uninstall it manually. 

1. Remove the lumu-linux-agent package.

2. Remove the lumu repository file.

3. Remove the lumu repository public GPG key.

4. Finally, update your apt package index.

Fedora/RHEL Uninstall

This is the manual uninstallation procedure of the Lumu agent, repository, and key on a system using the DNF/YUM package manager. Use it if you prefer to uninstall it manually. 

1. Remove the lumu-linux-agent package.

2. Remove the lumu repository file.

3. Remove the lumu repository public GPG key. For this, you must list your rpm gpg keys:

4. Finally, update your dnf/yum package index.

OpenSUSE/SLES Uninstall

This is the manual uninstallation procedure of the Lumu agent, repository, and key on a system using the zypper package manager. Use it if you prefer to uninstall it manually. 

1. Remove the lumu-linux-agent package.

2. Remove the lumu repository file.

3. Remove the lumu repository public GPG key. For this, you must list your rpm gpg keys:

4. Finally, update your zypper package index.

Upgrading the Lumu Agent for Linux

This is the procedure to update the Lumu Agent for Linux. Given that Lumu provides its own repositories for the most common package managers, this process is a very simple process.

 Most distributions require root access to update packages.

Debian/Ubuntu Update Process

To update the Lumu Linux Agent in a Linux distribution that uses the apt package manager, simply execute the following steps:

1. Update your packages database.

2. Upgrade the lumu-linux-agent package.

Ubuntu/Debian Users must consider the following: Due to the new version of OpenSSL being distributed with new versions of Ubuntu and Debian (OpenSSL v3.0.0), it is not possible to switch Lumu repositories between new and old versions of Ubuntu and Debian. Therefore, if your operating system uses an old version of OpenSSL (OpenSSL v1.0.0) and you do a major system update, it is necessary to reinstall the Lumu repository, and therefore, reinstall the agent. To do so, please refer to our installation guide.

Fedora/RHEL Update Process

To update the Lumu Linux Agent in a Linux distribution that uses the dnf and/or the yum package manager, simply run the update command; use the dnf tool if you use Fedora, or yum if you use RHEL.

OpenSUSE Update Process

To update the Lumu Linux Agent in a Linux distribution that uses the zypper package manager, simply run the up command.

Command Quick Reference for Agent Support

The Lumu Agent for Linux includes an application for support purposes. You can use this application to troubleshoot, configure and get agent information. The lumu-agent-support application is available from any part of the system because it is registered in the PATH .

To use the lumu-agent-support application, you must enter an option and, if necessary, an argument for that option. The table below lists the available support options for the Lumu Linux Agent.

Proxy Configuration

This section shows you how to configure the Lumu Linux Agent to use a custom list of HTTP proxies. This can be achieved through the lumu-agent-support application that is installed along with the agent. You can use more than one proxy if it’s required by your business requirements.

Configure a Proxy List

To configure a proxy use the --proxy-list option from the lumu-agent-support application with the following syntax:

 This command must be run as root user.

If you wish to add more than one proxy, separate them using a semicolon as follows:

Remove Proxy Configuration

If you need to remove the proxy configuration from your Lumu Linux Agent settings, use the --clear-proxy-list option from the lumu-agent-support application.

 This command must be run as root user.

Check Agent Status

You can quickly validate that the agent has been installed and activated correctly, and that it is sending traffic to Lumu for analysis. Just run the following commands: 

This is the expected result when the agent is running: