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 for enhanced security.

Supported OS versions

Windows

OS	Version
Windows Server	2012, 2016, 2019, 2022
Windows Client OS	8, 10, 11

Linux

OS	Version
CentOS	7, 8
Ubuntu	16, 18, 20, 22, 24
RHEL	7, 8

Latest MotaAgent Installation Links

Operating System	Version	Link
Ubuntu	14, 16, 18, 20, 22, 24	Download
RHEL & CentOS	7, 8	Download
Windows	Client OS 8 or Server OS 2012	Download
Windows	Client OS 10, 11 or Server OS 2016, 2019, 2022	Download

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

Windows

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.

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 path on your device where you want to install the MotaAgent and then select Next.

   

9. 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.

   

10. Select Install to start the installation process.

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

12. Select Finish to complete the installation process.

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

Linux

MotaAgent Installation for Linux

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

Prerequisites

• Supported OS: Check if the OS version 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.
• User Access: The user should have Sudo access to be able to install the MotaAgent.
• Minimum 4 Core CPU.
• Minimum 4 GB RAM.

Installation steps

1. Move the installation package you downloaded to a specific directory in your system.

2. The installation package MOTADATA-AGENT-UBUNTU.tar.gz is now available in the directory.

   

3. Extract the installation package you downloaded using the following command:

   sudo tar -zxvf MOTADATA-AGENT-UBUNTU.tar.gz

   The extraction process will start and run for a few seconds and then you will be able to see the extracted contents as shown below.

   

4. Move to the directory where you just extracted the MotaAgent installation package using the following command:

   cd MOTADATA-AGENT

   

5. Start installation of the MotaAgent by running the installation script as follows:

   ./motadata-agent-install.sh

6. Next, the installation will ask you to enter the IP of the Motadata AIOps server. Provide the IP and press Enter.

7. Next, the installation will ask for Subscriber Port, Publisher Port. They will be set up as 9444 and 9449, respectively by default.

8. The installation is now complete.

9. Next, you have to start the MotaAgent Service using the following command:

sudo service motadata start

10. Now, check the status of the MotaAgent Service using:

sudo service motadata status

You can see the status of the service as shown below.

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

    

Windows Bulk Install

Prerequisites

• Supported OS: Ensure you are running an OS version on your device which 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.
• Active Directory Domain: All Windows devices that you wish to install the MotaAgent on should be on on same active directory domain.
• Minimum 8 Core CPU on each device.
• Minimum 8 GB RAM on each device.

Download Bulk Agent Installation Package

note

Ensure that you download the Agent Installation Package on the domain server since you will need to run the script on it.

• Installation Agent Package for Client OS.
• Installation Agent Package for Server OS.

Prepare Package for Installation

note

Ensure that you prepare the installation package on the domain server.

1. Extract all the files from the downloaded package.

2. Copy PSTools, server-hosts.txt, and Motadata_agent_installation.ps1 files in one specfic directory and copy its path.

3. Now, navigate and open the Motadata_agent_installation.ps1 file. Locate the $sourcefile variable and paste the copied directory inside quotation marks.

4. Then, locate the Start-Process command and replace the \\$computer -h -d winrm.cmd quickconfig -q -force" –Verbose portion with PUBPORT=9449 SUBPORT=9444 URL=<motadata server URL>.

note

Replace the <motadata server URL> with the actual URL of the server in the below command. Also, ensure to change PORT values in case you are using custom port values.

5. Finally, locate and open the server-hosts file. Enter all the Windows hostnames on which you wish to install the agent. Separate each hostname in a new line.

Run Script to Bulk Install Agent

1. Finally, run Motadata_agent_installation.ps1 using Terminal on the domain server with administrator right and MotaAgent will be installed on all the hosts you mentioned in the server-hosts file.

No input is required from your side. Once the script finishes executing, you will receive a succes message on the screen.

Linux Bulk Install

Prerequisites

• Supported OS: Ensure you are running an OS version on your device which 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.
• User Access: The user should have Sudo access to be able to complete the installation steps.
• SSH Pass package should be installed on each Linux system you wish to install the agent.
• Minimum 4 Core CPU on each device.
• Minimum 4 GB RAM on each device.

Download Bulk Agent Installation Package

• Bulk Agent Installation for RHEL/CentOS : [Download Package for RHEL/CentOS].

Preparing the Package for Installation

Perform the below mentioned steps before you run the script:

1. Extract the contents of the Bulk Agent Installation package that you downloaded.
2. Navigate and open the hosts file. Then, enter IP addresses of all the systems you wish to install the agent on. Mention each IP address in a new line.

3. Next, provide username and password for the agent in the ansible_user=<agent_username> and ansible_ssh_pass=<agent password> field respectively.

note

Replace the <agent_username> and <agent_password> with the actual username and password.

4. Mention the IP address where the Motadata Server is installed in the motadata_ip_address field. In case you are using custom ports also update the sub_endpoint and pub_endpoint fields for subscriber port and published port respectively with applicable port numbers.

note

Perform Step 5 only if you have changed the default name of “MOTADATA-AGENT-UBUNTU.tar.gz” folder.

5. In the hosts file, change the value of agent_tar variable to the changed MotaAgent folder name.

Run Script to Bulk Install Agent

Once you have prepared the package for installation, you now only need to run the script to bulk install the agents on all the sytems on the network.

1. Using Terminal, move to the Files directory and run the installation file by executing the following command

ansible-playbook -i hosts playbook.yml

No need for manual intervention, script will automatically handle installation of agent on all the systems. Once completed, you will receive a ‘Success’ message on screen.