Skip to main content

Installation Guide for MotaAgent

The MotaAgent installation enables device-level monitoring and data collection. Agents are installed on individual devices, such as servers and workstations, to gather essential performance data.

The communication between the MotaAgent and the Motadata AIOps server is secured, with all exchanges encrypted by encryption model AES 256 for enhanced security.

Supported OS versions​

Windows​

OSVersion
Windows Server2012, 2016, 2019, 2022
Windows Client OS8, 10, 11

Linux​

OSVersion
CentOS7, 8, 9
Ubuntu18, 20, 22, 24
RHEL7, 8, 9
IBM-AIX7.X
SUSE Linux15.6
Debian Linux11, 12, 13
Operating SystemVersionLink
LinuxAllDownload
WindowsAllDownload
IBM-AIX7.xDownload

Agent-based monitoring setup​

This page describes how to install Motadata AIOps agent into your device to enable agent-based monitoring. The installation package and steps vary based on the operating system of your device as follows:

  • MotaAgent Installation for Windows
  • MotaAgent Installation for Linux
  • Bulk MotaAgent Installation for Windows
  • Bulk MotaAgent Installation for Linux

MotaAgent Installation for Windows​

Before we get started on the installation steps, let us discuss the prerequisites for the same.

Prerequisites​

  • Supported OS: Check if the OS installed on your device is supported by Motadata AIOps for agent-based monitoring.
  • Unique Hostname: The hostname of the device on which you want to install the MotaAgent should be unique. This means:
  • A device with the same hostname should not already be registered for agent-based monitoring.
  • A device with the same hostname should not be discovered in Motadata AIOps for agentless monitoring.
  • Port: Check if port 9449, 9445, 9444, 9450, 9441, and 9440 are open on the Motadata Master and are reachable via MotaAgent.
  • Minimum 8 Core CPU.
  • Minimum 8 GB RAM.
Important

Motadata Agent – Antivirus Whitelist Guidelines

Prerequisites

Before configuring antivirus or endpoint protection tools, ensure the following:

  • You have administrator/root access on the system.

  • Antivirus/endpoint protection console allows custom exclusions for files, folders, and ports.

  • A system backup or restore point is taken before applying whitelist changes.

Whitelisting Steps

  1. Whitelist Folders: Add the following folder to the antivirus exclusion list:

C:\Program Files\Motadata

  1. Whitelist Executables: Allow all executables to follow the motadata-* pattern.

Common examples: 


motadata-agent.exe 

motadata-manager.exe 

motadata-upgrade.exe 

motadata-manager_m.exe 

motadata-log-agent.exe 

motadata-metric-agent.exe

  1. Allow Required Ports (Inbound/Outbound): Open the following ports on the Motadata Master and ensure they are reachable from the Motadata Agent:

9449, 9445, 9444, 9450, 9441, 9440

Also, make sure to exclude the listed folders and executables from both real-time scanning and scheduled scans and verify that firewalls or endpoint protection tools allow continuous communication over the specified ports. Then, apply these rules consistently across on-premise deployments as well as remote/endpoint devices running Motadata Agents.

Installation steps​

  1. Download the .exe file for installation of the Windows agent as per your OS version.

  2. Right-click on the Motadata Agent file, then select Run as Administrator.

  3. Select Run to move forward with the installation.

  4. The MotaAgent Setup appears for installation of certain prerequisites. Select Next to move to the next step.

  5. Make sure all the checkboxes are checked and then select Next.

  6. Once the prerequisite installation is complete, the installation moves to the main agent installation in the next step.

  7. The MotaAgent installation wizard now shows up. Select Next to move to the next step.

  8. Specify the IP address of the server where the Motadata AIOps is installed. The values for event.sub.Port and event.pub.Port are setup as 9449 and 9450, respectively by default. Select Next to move to the next step.

  9. Select Install to start the installation process.

  10. The installation process now starts. Kindly wait for the installation to finish. This might take several minutes.

  11. Select Finish to complete the installation process.

  12. The MotaAgent is now successfully registered on the Motadata AIOps server. You can check the same on Settings-> Monitor Settings-> Agent Monitor Settings.

Multi-Master Registration​

note

If the multimaster key is updated via the import/export functionality, the agent upgrade should be performed through the primary server first pointed in the configuration. Otherwise, an agent restart will be required from the backend.

Agents support multi-master registration to connect with multiple master servers for better resiliency, scalability, and multi-tenancy.

If you want to register your single agent to master server then follow the below steps:

  • Update agent.json (C:\Program Files\Motadata\Motadata Agent\motadata\config\agent.json for Windows, /motadata/motadata/config/agent.json for Linux) to include event.publisher.hosts and event.subscriber.hosts arrays with required master IPs.

  • Bulk configuration import available via Master UI (run separately for Linux and Windows agents). To bulk import you just need to first Export Agent Configuration and then apply the below mentioned command to the .json file.

    Example:

    "event.publisher.hosts" : [ "172.16.10.98", "172.16.8.168", "172.16.15.199", "172.16.15.152", "172.16.13.50" ],

    "event.subscriber.hosts" : [ "172.16.10.98", "172.16.8.168", "172.16.15.199", "172.16.15.152", "172.16.13.50" ]

    After that, select multiple monitors to which you want to import the agent in bulk and import the agent configurations.

note

You need to be cautious while selecting the monitor as the selected monitors should be of same type.