Skip to main content

Installation Guide for Collector Deployment

Overview​

This installation guide provides step-by-step instructions for installing Motadata AIOps in a Single-Box deployment covering the installation process for the following components:

  • Motadata Master with DB

The installation process begins with common steps for all the scenarios, followed by deployment-specific steps. It is crucial to follow the instructions carefully to ensure a successful installation.

Minimum System Requirements for Motadata AIOps Server​

Before installing and running Motadata AIOps, please ensure that your server meets the following minimum system requirements to ensure optimal performance and functionality. Refer Hardware Sizing document for detailed information for the same.

Prerequisites​

Before starting the installation, ensure the following prerequisites are met:

  • Configure servers based on the sizing requirements of the chosen component.
  • Download the Motadata AIOps installation ISO.
  • Network Port should be open in Network Firewall and respective servers as defined below:
Port NamePort NumberPort TypeDirectionPort To Be Opened AtPurpose
TCP Log Listener5140TCPBidirectionalApplication Server or CollectorUsed to ingest logs into Motadata in an encrypted format for secure data transfer. Ensure this port is open on the collector if logs need to be ingested at the collector level.
UDP Log Listener514UDPInboundApplication Server or CollectorUsed to ingest logs into Motadata. Ensure this port is open on the collector if logs need to be ingested at the collector level.
Flow Listener (netflow)2055UDPInboundApplication Server or CollectorUsed to ingest flow data into Motadata. Ensure this port is open on the collector if flow data needs to be ingested at the collector level.
Flow Listener (sflow)6343UDPInboundApplication Server or CollectorUsed to ingest flow data into Motadata. Ensure this port is open on the collector if flow data needs to be ingested at the collector level.
Important

Motadata AIOps (APP, DB, Collector) – Antivirus Whitelist Guidelines

Motadata does not recommend applying Antivirus on Application (APP), Datastore (DB) or Collector components. However, in cases where client compliance mandates Antivirus installation, please carefully follow the guidelines below.

General Considerations

  1. Resource Utilization: Installing antivirus on Motadata components will significantly add resource overhead which may lead to abnormal monitoring activity. Consider increasing resources to compensate this overhead.

  2. VM Snapshot: Before applying Antivirus, take a VM snapshot of all components: APP, DB, and Collector.

  3. Monitoring: Keep the environment under observation after applying the Antivirus with the below prerequisites configured.

Folders & Files to Whitelist

Whitelist the following directory and executables from real-time and scheduled Antivirus scans:

Directory Path: \Motadata

Executables (whitelist all matching 'motadata-*'):

  • motadata-agent.exe
  • motadata-manager.exe
  • motadata-upgrade.exe
  • motadata-manager_m.exe
  • motadata-log-agent.exe
  • motadata-metric-agent.exe
  • motadatadb
  • nfacctd
  • sfacctd
  • datastorebroker
  • aiopsengine
  • gopluginengine

Also, make sure to exclude all listed directory and executables from both real-time scanning and scheduled scans and ensure security agents/firewalls allow continuous communication over the specified ports. Then, apply these rules for both on-premises deployments and remote/endpoint devices running Motadata Agents.

Installation Steps​

  1. Create a virtual machine (VM).

  2. Map the downloaded ISO to the VM datastore.

  3. Boot the VM from the ISO to initiate the installation process.

  4. Obtain sudo permissions by running the following command:

    sudo su

  5. Navigate to the opt folder using the following command:

    cd /opt

  6. Check for the existence of the installation script (post-install.sh) using the following command:

    ls

  7. Run the installation script:

    ./post-install.sh

    After you run the installation script, you will be asked to select the Deployment Type out of the following:

    1. Single-Box
    2. Distributed
    3. Collector

8. Select the deployment type 3. Collector and then follow the steps further as demonstrated below.

9. Change the root password, providing and confirming a new password.

10. Configure the static IP address, default gateway, and DNS servers. You can change the default DNS servers as per your requirement.

11. Configure the hostname.

12. Configure the timezone by selecting the region and the timezone where you are installing the Collector.

13. Enter Application server IP (Standalone)/ Primary Server IP (Distributed) / Virtual IP (HA)/ FQDN (HA over WAN) to establish the connection between the Collector and the Application Server.

14. Once the installation process is complete, the Collector will be visible in the Collector Settings section in Motadata AIOps.

15. Detach the ISO from the virtual machine to complete the installation.

If you see a system alert banner at the top of the screen, resolve it first—it won’t auto-dismiss until the underlying issue is fixed.