Windows
This guide describes the installation process for a Confire Agent on Windows 10 (22H2). Please install one agent for each network you want to manage.
Installing the Agent - On Windows
Note
Administrator rights are required to install the Confire Cloud Agent on Windows.
Prerequisites¶
- Before starting the installation, ensure your system meets the minimum requirements:
Component | Specification |
---|---|
Processor | Intel® Celeron® Processor N3450 or higher |
Chipset | Integrated |
RAM | 4GB (1x DDR3L-1600MHz) |
Storage | mSATA 128GB SSD |
Operating System | Windows 10/11 22H2 or later |
- You will also need a Windows account with administrator rights.
Installation Steps¶
Download Software¶
-
Log in to a Windows account with administrator rights.
-
Download the file confirecloud.agent.zip.
-
Extract the file confirecloud.agent.zip to the folder
C:\confirecloud.agent\
.
Configure Production File¶
-
Open the file
C:\confirecloud.agent\appsettings.Production.json
in a text editor. -
Under
ScanIpAddresses
, specify the IP range the agent should scan, e.g.,172.19.114.255
. -
Under
RabbitMQ
, enter the credentials you received via email. These should includeHost
,VirtualHost
,Username
, andPassword
: -
Save the file.
Register Confirecloud.agent Service¶
-
Run Windows PowerShell as an administrator:
-
Enable script execution (confirm with
[J]
):Set-ExecutionPolicy Bypass
-
Navigate to the production directory:
cd C:\confirecloud.agent
-
Execute the PowerShell script register-confirecloud-agent-exe.ps1:
.\register-confirecloud-agent-exe.ps1
The
confirecloud.agent
service will start:Status Name DisplayName ------ ---- ----------- Stopped confirecloud.agent confirecloud.agent Service registered and started successfully. Finished. Press Enter to exit.:
-
Open
services.msc
and confirm that the confirecloud.agent service is running. Close the Services and PowerShell windows.
Add the Agent to Confire Cloud¶
-
In the left-hand menu, click on
Agents/Networks
: -
Click the three dots in the top-right corner and select
+ Add
: -
Enter a name for the agent and select a tenant:
-
In the file appsettings.Production.json, copy the GUID into the
AgentId
field and save the file: -
Restart the confirecloud.agent service.
Configuration¶
Manual Device Specification¶
Instead of relying on automatic detection via network broadcasts, users can directly specify the IP addresses of the devices that the agent should manage. This is particularly useful in environments where broadcast detection is restricted or devices need to be managed across different subnets.
In the example below, five devices were detected via broadcast:
Instead of using broadcast detection, we now want to detect only two specific devices, DIRECT-Room-001
and DIRECT-Room-002
. To do this, the devices need to be manually entered in the appsettings.Production.json file:
- Under
ScanIpAddresses
, remove the entry"192.168.1.255"
:
- Enter the IP addresses of the desired devices. Make sure the last line does not contain a comma:
- Save the appsettings.Production.json file and restart the confirecloud.agent service:
- Only the two specified devices will now be detected: