Agent Installation Guide

Download the Agent App

Before installing the Agent, you must be registered on the InfraSOS Portal. If you still need to register, please, use the signup page to register your company (InfraSOS Signup).

To download the Agent App, you need to be logged in to the InfraSOS Portal. To begin, we need to open the “Download Agent” page, and follow the instructions to download the app:

Tap on the Cogwheel icon to open the Account Management page:

Tap on the Active Directory Settings button to move to the Active Directory settings section:

When the settings page opens, tap on the Download Agent button:

To download the app, tap on the Download button, and the loading installer.zip automatically starts:

The Agent was successfully downloaded.

Check out these basic information about Agent:

System Requirements;

Pre-installation, of the Agent App steps

Check if the user has enough rights to install the Agent as a Windows service;
The Windows Server used to install the Agent has configured DNS to resolve agent.portal.infrasos.com hostname to the following IP addresses 3.123.216.8, 3.67.230.125, 35.157.129.160; This step is important to have connection from Agent to InfraSOS Portal because data exchange between services is carried out using WebSocket connection. For more information about WebSocket uses, see this documentation (link).
Make sure your DNS server is correctly set up for this domain, as well as for the corresponding domain controllers (DCs). Make sure DNS communication from the Windows Server the InfraSOS agent is installed on can communicate with your domain controllers.
Please verify that the Windows Server can successfully ping either the relevant domain or any of the Domain Controllers.
Ensure that the connectivity between this Windows Server and the Domain Controller is not blocked due to Firewall, etc.
Please ensure that DNS (port 53) is accessible for resolving the IP addresses of domain controllers.

To communicate with domain controllers InfraSOS agent uses LDAP protocol (389 port)
To communicate with InfraSOS cloud service the InfraSOS agent uses https (port 443)

Install the Agent App

Notes: The Agent should be installed only on Windows Server 2022 (Windows Server 2019 / 2016 hasn't been tested yet. This testing is planned in our next release.). Once you've downloaded the agent follow these steps:

To start the installation process, extract the installer.zip file;
Open the extracted folder
Run the setup.exe

The install will first check if you have the following pre-requites
1. Visual C++ Runtime Libraries
2. .Net Desktop Runtime
3. If not installed, will ask to install. Select 'Install'
Install pre-requisites
The first wizard step will be displayed. Tap on the Next > button:

Select the location of Agent Service or use the default path. Click Next > when the path is selected:

Read the License Agreement, tap “I Agree”, and Next > button:

There is the last step, after which installation starts. Click Next >:

To run Agent, find it in the Windows Start menu and run StartAgent.bat:

Follow the next guide on onboarding your domain to the InfraSOS portal:

Onboarding a New AD Agent;

Uninstalling the Agent App

To uninstall Agent, select Windows Start → InfraSOS Agent → uninstall.bat

Follow the next guide on onboarding your domain to the InfraSOS portal:

Onboarding a New AD Agent;