Skip to main content

How to deploy a log collector using Orbital on Linux

This guide will walk you through all the steps you need to know to deploy the Orbital Agent as a log collector on Linux

Written by Alan Butcher
Updated today

This deployment requires one of our Enterprise or Advanced packages.

System requirements

Log collectors must be dedicated machines within your environment that have the following system requirements. Please ensure the machine you're deploying as a log collector meets these requirements.

Resources

Requirement

Operating System

Ubuntu 24.04

CPU Cores

Minimum 2

Memory

Minimum 8 GB

Disk Space

Minimum 50 GB

Firewall Rules

Firewall rules are required between all logging agents and the log collector, and between the log collector and Defense.com infrastructure.

Source

Destination

Protocol

Port

Notes

Windows Agents

Collector IP

TCP

5044

Allow Winlogbeat agents to send logs to the collector over TCP.

Linux Agents

Collector IP

TCP

5044

Allow Filebeat agents to send logs to the collector over TCP.

Syslog Devices

Collector IP

UDP

5514

In order for the logs to be encrypted, they will have to be sent to the collector before sending over to the Defense.com SIEM platform.

Collector

31.28.93.148/32

TCP

443

Allow the collector to send logs to Defense.com SIEM platform.

Manual Deployment

Deploying a log collector using the Orbital Agent is super straightforward.

Please do not change the installer filename, as this includes your unique installation key. Doing so will cause the installation to fail.

  1. Log in to your my.defense.com account

  2. Select Endpoints from the navigation on the left-hand side

  3. Click Orbital Agent from the sub-navigation

  4. From the Orbital Agent index page, click Installation Links in the top right-hand corner

  5. You'll then be presented with a modal where you can select the Endpoint Group, and click Download Installer for Linux

  6. Launch Terminal (Ctrl+Alt+T) and navigate to where your Orbital installer is located

  7. Next, make the installer executable using sudo chmod +x orbital-install-[encypted_key]

  8. Run the installer sudo ./orbital-install-[encrypted_key] (replacing encrypted_key with the encrypted key, which is part of the filename, for example orbital-install-[Wjrh5gjrfh5fhryE4ue])

  9. Once you've run the installer, you'll be presented with the installation interface. Click Next to begin the installation

  10. Select your installation folder; this will default to /opt/Defensecom/Orbital

  11. Click Next to continue the installation

  12. From the Select Components section, select the Log Collection and Log Generation components, and click Next

  13. Click Install

  14. Click Finish, and the installation is complete

  15. Contact Defense.com via a support ticket to verify collector installation and log flow. We will also need the public IP address of your log collector(s) for our firewall.

And that's it! You've successfully deployed a log collector on Linux using the Orbital Agent πŸŽ‰

Did this answer your question?