Zum Inhalt

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

  1. Log in to a Windows account with administrator rights.

  2. Download the file confirecloud.agent.zip.

  3. Extract the file confirecloud.agent.zip to the folder C:\confirecloud.agent\.

Configure Production File

  1. Open the file C:\confirecloud.agent\appsettings.Production.json in a text editor.

  2. Under ScanIpAddresses, specify the IP range the agent should scan, e.g., 172.19.114.255.

  3. Under RabbitMQ, enter the credentials you received via email. These should include Host, VirtualHost, Username, and Password:

  4. Save the file.

Register Confirecloud.agent Service

  1. Run Windows PowerShell as an administrator:

  2. Enable script execution (confirm with [J]):

    Set-ExecutionPolicy Bypass
    
  3. Navigate to the production directory:

    cd C:\confirecloud.agent
    
  4. 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.:
    
  5. Open services.msc and confirm that the confirecloud.agent service is running. Close the Services and PowerShell windows.

Add the Agent to Confire Cloud

  1. In the left-hand menu, click on Agents/Networks:

  2. Click the three dots in the top-right corner and select + Add:

  3. Enter a name for the agent and select a tenant:

  4. In the file appsettings.Production.json, copy the GUID into the AgentId field and save the file:

  5. 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: