Windows

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

Prerequisites

GUI Install

Step 1: Download Infra Agent Installer

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

Download the Infra Agent Installer

Step 2: Run & Complete Install Wizard

Right-click the Installer, select Run as administrator, and complete the Install Wizard.

Step 3: Verify Installation

Verify the Infra Agent has been successfully installed with one of the following methods:

Windows Service Manager

Search for the Middleware Agent in your Windows Service Manager.

The Middleware Agent should be in Running status.

Powershell

Verify the Infra Agent has been successfully installed with the following command:

Shell

shell

Get-Service -Name mw-windows-agent

The mw-windows-agent should be in Running status

Powershell Install

To install using PowerShell, run these commands:

Invoke-WebRequest -Uri "https://github.com/middleware-labs/mw-agent/releases/latest/download/mw-windows-agent-setup.exe" -OutFile mw-windows-agent-setup.exe -UseBasicParsing
Start-Process -FilePath "mw-windows-agent-setup.exe" -ArgumentList "/S /MW_API_KEY='your-initial-token' /MW_TARGET='your-initial-uid'" -Wait

Then verify the installation by running:

Get-Service -Name mw-windows-agent

Troubleshooting

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

Uninstall

To uninstall the Infra Agent on a Windows machine, follow these steps: