Lumu Agent for Windows

Lumu Agent for Windows

The installation of the Lumu Agent for Windows is simple and straightforward. They could be deployed easily to your entire user population through an IT assets management system, thus facilitating their installation and administration. This document covers the installation and configuration of the Lumu Agent on Windows devices.

Info
For getting started with agents, access Introduction to Lumu Agents.

The Lumu Agent for Windows provides two types of installers:

  1. Online Installer : this installer downloads the latest available files and settings required for installation and keeps the agent updated. Recommended for single installations.
  2. Offline installer : includes all files required for installation, no additional files are downloaded. Recommended for bulk deployments.


Info
For bulk deployments such as when using Group Policy in a Windows Server. Download the installation file according to your IT assets management system’s needs and check out our documentation on  Deploy Lumu Agent using Group Policy (GPO).
Alert
If the deployment is being done using VDI with a master image, you must ensure that the agent isn't activated in said image. Each activation must be unique to each device. This ensures the agent functions properly and is displayed correctly in the Lumu Portal.

Requirements

  1. A device running a Windows operating system. Minimum supported version Windows 10.
  2. Administrator permissions on the local machine.
Alert
Before installing Lumu Agent, make sure you create a group in the Lumu Portal. Remember that an internet connection is required for the Lumu Agent activation.
The Lumu Agent is a lightweight software program, below are some referential information regarding the agent average consumption on Windows devices:
Info
RAM consumption (average*): 20 MB
CPU consumption (average*): < 2%
Bandwidth consumption  (average*): 1 Kbps
Online installer size: 1.05 MB
Agent installed size: 6.7 MB
* CPU, bandwidth, and RAM usage are average estimates and may vary depending on the environment where the agent is installed.

Online Installation

The Online Installer downloads the latest available files and settings required for set-up during installation. It is the most basic installation, used to install an agent on a single user device, in a non-domain environment.

1. To download the agent file for online installation on Windows, go to the  Lumu Portal, navigate to the Agents menu, then click to download agent, select the “Windows” option (1), and then select the online installer (2).

2. Once downloaded, run the installation file, wait for the updated files to be downloaded, and when requested, accept the license agreement and enter the activation code from the group you created previously.
Windows agent set up Windows agent set up
3. After installation, when you see the completion screen, click “ Finish ”.

Completing the Lumu Agent for Windows set up Completing the Lumu Agent for Windows set up

Offline Installation

In the Lumu Portal, you can find the .msi and .exe offline installer files recommended for an offline installation via command prompt.

The offline installer brings all files required for installation; no additional files are downloaded. The offline installer includes two components that allow you to install the Lumu agent or the agent updater independently.

The agent component is the Lumu sensor that collects the network-data, which is presented to your company at the Lumu Portal. The updater is the component in charge of periodically checking the server for the latest version of the agent, downloading and installing it.

Lumu Agent for Windows offline installer Lumu Agent for Windows offline installer

Headless Installation

This procedure will hide the graphical user interface during the installation process. To do so, add the the lines /SP- /VERYSILENT to the .exe installation command and /quiet to the .msi installation command as shown in the command line examples below:
  1. .exe installer:
lum_agent_offline.exe /SP- /VERYSILENT /activationcode="[ActivationCode]" /acceptlicense="true"
  1. .msi installer:
"C:\Windows\System32\msiexec.exe" /i lum_agent_offline.msi /quiet WRAPPED_ARGUMENTS="/activationcode=""code"" /acceptlicense=""true"""
The following parameters can be used during the installation procedure to configure the agent according to the needs of your organization:

Parameter
Mandatory
Version added
Description
activationcode
Yes
1.0.0.0
Activation code obtained from the Lumu Portal .
acceptlicense
Yes
1.0.0.0
< true/false > value. Must be set to true  to guarantee that the license has been accepted by the user. 
COMPONENTS
No
1.0.0.0
The offline installer allows you to install specific components and manage updates manually.
You can set it to ‘agent’ to install only the Lumu Agent or ‘updater’ to install the updater by itself.
By default, the offline installer installs both components.
  1. COMPONENTS Examples:  
    1. .exe: 
lum_agent_offline.exe /SP- /VERYSILENT /activationcode="[ActivationCode]" /acceptlicense="true" /COMPONENTS="updater"
  1. .msi:
"C:\Windows\System32\msiexec.exe" /i lum_agent_offline.msi /quiet WRAPPED_ARGUMENTS="/activationcode=""code"" /acceptlicense=""true"" /COMPONENTS=agent"
changeactivationcode
No
2.1.0.1
This parameter must be used to notify the agent that a new activation
is required when the product has already been activated.
  1. Changeactivationcode Examples: 
    1. .exe: 
lumu_agent_offline.exe /SP- /VERYSILENT /activationcode="[ActivationCode]" /acceptlicense="true"/changeactivationcode
  1. .msi:
"C:\Windows\System32\msiexec.exe" /i lum_agent_offline.msi /quiet WRAPPED_ARGUMENTS="/activationcode=""[ActivationCode]"" /acceptlicense=""true"" /changeactivationcode"

askcredentials
No
2.1.0.3
This parameter can be used to allow or deny to show the popup asking for proxy credentials.
  1. Askcredentials Examples:
    1. .exe:                     
lum_server_agent_offline.exe /SP- /VERYSILENT /activationcode="[ActivationCode]" /acceptlicense=true / askcredentials=true
    1. .msi
      "C:\Windows\System32\msiexec.exe" /i lum_server_agent_offline.msi /quiet WRAPPED_ARGUMENTS="/activationcode=""code"" /askcredentials=""false"" /acceptlicense=""true"""

Command Quick Reference for Agent Support

The Lumu Agent includes an application for support purposes. You can use this application to troubleshoot and get agent information from devices.

The table below lists the available support commands for the Lumu Agent. You should run the commands in the Lumu installation path (e.g. C:/Program Files (x86)/Lumu/Agent ) using Command Prompt or Windows PowerShell with admin privileges.

lumu-agent-support [argument]

Argument

Description

-h or --help

Print all the available commands with their description.

--show_status

Print agent’s last status information, including its status, version, and settings.

--activation_code [arg]

Reset the activation code to the provided argument [ arg ]. This command is intended for correcting an activation code that is invalid or to reactivate an agent that was deleted by mistake. This will not change the activation code for an already successfully activated agent. To do so, you’ll need to delete it first from the portal and wait for the agent to disable itself or uninstall it. Command example:

lumu-agent-support --activation_code 5FDHjJWI

--proxy_list [arg]

Set the proxy configuration to the provided argument [arg]. The argument should be a colon-separated list of elements in the following format:

http://[<username>:<password>@]<ip address>:<port>

Command example:

lumu-agent-support --proxy_list http://user1:123@10.5.8.5:8080/
--ask_credentials [arg]
Use this option to allow/avoid [true/false] the user popup asking proxy credentials

--check

Perform checks and print if the agent is running.

-v or --version

Show the support application version.

Repair, Update, or Reinstall Agent

The Lumu Agent installer (version 2.0+) brings the ability to repair, update, or reinstall the Windows agent.

Repair

To manually repair a Lumu Agent, simply run the installer that is the same agent version of the installed agent on the machine. The installer will prompt the following screen:
Lumu Agent repair window Lumu Agent repair window

The repair feature returns the agent to its default installation state. This feature should be used in cases such as when any file or registry was erased as the repair will retrieve the missing files. The repair process keeps the current agent configuration and activation code.

Update

To update a Lumu Agent, run an installer from a more recent version of the installed agent on the machine. A screen with the new update option will display. This new feature allows you to upgrade your agent manually to a newer version.
Info
The update also will repair any missing files or registries on the user machine.

Lumu Agent update window Lumu Agent update window

Reinstall

In both the repair and update process, you also have the option to reinstall a Lumu Agent.

Alert
The reinstall process will cause the current agent configuration and information to be deleted. 

To reinstall an agent, you will need to enter the same or a different activation code.

Lumu Agent reinstall window Lumu Agent reinstall window
Alert
When reinstalling a Windows Lumu Agent you may encounter two registered agents (duplicated) with different last sync times in the Lumu Portal. Consult our FAQ  for more details and help.

Uninstall Agent

In case you want to uninstall the Lumu Agent from a Windows device, go to the Control Panel > Programs and Features, choose Lumu from the list, and select "Uninstall".

You can choose to uninstall the agent using Command Prompt or Windows PowerShell with admin privileges. To do so, go to the Lumu installation path (e.g. C:/Program Files (x86)/Lumu/Agent ) and run the uninstaller file unins000.exe .


    Still can’t find an answer?
    Send a message to our experts.
    Contact Us

        • Related Articles

        • Deploy Lumu Agent using Group Policy (GPO)

          The installation of the Lumu Agent for Windows is simple and straightforward. This article describes how to deploy the Windows Agent quickly to your entire user population through Group Policy Objects (GPO) in a Windows Server. For getting started ...

        • Lumu Agent Collector for Windows Server

          Up until now, the Lumu Agent has been an endpoint software program installed on a user's machine which enables the detection of adversarial activity; however, the compromise detection capabilities of the Lumu Agent are now available for Windows ...

        • Lumu Agent Deployment via Kaseya VSA

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows  and macOS   ...

        • Lumu Agent Deployment Via ConnectWise Automate RMM

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows [add link] and ...

        • Lumu Agent Deployment via NinjaOne RMM

          The Lumu Agent can be deployed remotely in corporate environments using an array of tools such as Remote Monitoring and Management software (RMM). This article describes the remote installation procedure of the Lumu Agent for Windows and macOS using ...