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 ObserveOps 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 SystemVersionLinkMD5 Checksum
LinuxAllDownload3202859618549296e09b4bf327f2d2e3
WindowsAllDownloadf3039f63d146e0a88e4c763ff7b2e025
IBM-AIX7.xDownload3f08ae21435461a992ef7b9382514c8d

MotaAgent Installation Method​

It describes how to install Motadata ObserveOps agent on your device to enable agent-based monitoring. Two installation methods are available:

  • Automatic — Generate a lightweight installer from the ObserveOps UI. The command embeds the server address and port so no manual configuration is needed on the host.
  • Manual — Download the installer, run it on the host, and provide the server IP and ports during setup. Supports Windows, Linux, IBM-AIX, bulk Windows deployments via PowerShell or utility, and bulk Linux deployments via Ansible.

MotaAgent Installation using Download Agent​

The Download Agent flow generates a lightweight installer directly from the ObserveOps UI. The command includes the server address, publisher and subscriber ports, so the agent registers itself the moment it starts. Use this when you want to roll out agents without editing config files or passing IPs to the installer by hand.

Prerequisites​

  • Supported OS: Confirm the host OS is listed in the Supported OS versions table above.
  • 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 ObserveOps for agentless monitoring.
  • Ports: Check it port 443, 9449, 9445, 9444, 9450, 9441, and 9440 between the host and the ObserveOps server are open.
  • User Access: User should have rights and privileges to install the agent.
  • Minimum 4 Core CPU and 4 GB RAM for Linux hosts, 8 Core CPU and 8 GB RAM for Windows hosts.

Generate the Install Command​

  1. In ObserveOps, go to Menu > Settings > Monitor Settings > Agent Monitor Settings.

  2. Click Download Agent in the toolbar. The Download Agent dialog opens.

  3. Choose the target Operating System: Linux or Windows. The install command and the installer package update to match the selection.

  4. Review the command under Install Using Command. It contains:

    • The ObserveOps server address (read from your current browser URL).
    • The publisher and subscriber ports.
  5. Click Copy to copy the command.

note

The install command uses the same ObserveOps address shown in your browser URL. If your browser reaches ObserveOps through a proxy server, make sure both the target host and the ObserveOps server allow traffic through that proxy.

Run the Install Command on the Host​

  1. Open a terminal on the target host.

  2. Paste the copied command and run it.

  3. The installer:

    • Downloads the MotaAgent package from the ObserveOps server.
    • Installs the agent binary and registers it as a system service.
    • Writes the server address and ports into the agent configuration.
    • Starts the agent service automatically.
  4. Wait for the installer to print a success message.

Alternative: Download the Installer Package​

If you do not have the terminal or command line access then click Download Agent at the bottom of the dialog to download the OS-specific installer package. Transfer the package to the targeted host and run it manually, then follow the on-screen prompts to supply the server address and ports shown in the dialog.

Verify the Agent​

  1. Return to Settings > Monitor Settings > Agent Monitor Settings.
  2. Confirm the new host appears in the list with Status as Running.
  3. Click View Details under Configuration to review and tune the metric groups the agent collects. See Agent Monitor Settings for the full field reference.

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.