This guide walks you through installing the Infrastructure Agent (Infra Agent) on a Linux machine. These instructions can also be found on the Installation page in the Middleware application.

We offer two install scripts based on your operating system. Please note that not all Linux machines are supported. A list of supported machines can be found under Prerequisites.

​

Prerequisites

​

Install

​

Step 1: Access Linux Installation

Log in to Middleware, navigate to the Installation Page in the bottom left corner and select Linux-Based from the Infrastructure section

​

Step 2: Run Linux Install Command

Copy the appropriate installation command based on your machine’s operating system. Copying the command directly from the Installation page ensures your API key and UID are inserted accurately.

• DEB
• RPM

MW_API_KEY=<xxxxxxxxxx> MW_TARGET=https://<uid>.middleware.io:443 bash -c "$(curl -L https://install.middleware.io/scripts/deb-install.sh)"

​

Step 3: Add Host Tags [Optional]

Create filterable custom tags by adding the MW_HOST_TAGS environment variable to the installation command as comma-separated key-value pairs. Use the tag name to create an alias for the host (e.g. production).

MW_HOST_TAGS=key1:value1,key2:value2,... MW_API_KEY=...

​

Step 4: Verify Installation

Run the following command to verify the status of the Infra Agent:

sudo systemctl status mw-agent

sudo systemctl status mwservice

A successful installation will return the following Infra Agent Status report:

​

Troubleshooting

Once the Infra Agent is installed metrics should begin appearing in the Middleware application within a few minutes. If metrics do not appear, confirm that the machine has access to the internet, either directly or through a proxy, and that only one Infra Agent is running per node.

​

Uninstall

To uninstall the MW agent, use one of the following commands:

• DEB
• RPM

bash -c "$(curl -L https://install.middleware.io/scripts/deb-uninstall.sh)"