Windows

Diese Anleitung beschreibt die Installation eines Confire Cloud Agenten auf Windows 10 (22H2). Bitte installieren Sie einen Agenten für jedes Netzwerk, das Sie verwalten möchten:

Voraussetzungen¶

• Bevor Sie mit der Installation des Agenten beginnen, überprüfen Sie bitte die Mindestanforderungen für den Rechner:

Installation¶

Agent in Confire Cloud anlegen¶

• Klicken Sie im linken Bereich auf Agenten/Netzwerke:

• Klicken Sie auf die drei Punke oben rechts, anschließend wählen Sie + Add:

• Geben Sie einen Namen für den Agenten ein und wählen Sie einen Mandanten aus:

• Klicken Sie auf OK. Die angezeigte Agent-ID benötigen Sie später bei der Konfiguration des Agenten.

Agent-Software installieren¶

1. Melden Sie sich bei einem Windows-Account mit Administratorrechten an.

2. Klicken Sie in Confire Cloud im Menü auf der linken Seite auf Agenten/Netzwerke:

   

   Klicken Sie auf die drei Punke oben rechts, anschließend wählen Sie Agent herunterladen: Windows:

   

3. Entpacken Sie die Datei confirecloud.agent.zip in den Ordner C:\confirecloud.agent\

   

   

Produktionsdatei anpassen¶

• Laden Sie die neueste appsettings.Production.json Datei in den Ordner C:\confirecloud.agent\ herunter.

• Öffnen Sie die Datei C:\confirecloud.agent\appsettings.Production.json in einem Texteditor.

• Geben Sie unter ScanIpAddresses die IP-Adressen oder Broadcast-Adressen an, die der Agent durchsuchen soll, z. B. "192.168.1.255":

• Kopieren Sie die im vorherigen Schritt erstellte GUID in das Feld AgentId:

• Unter Broker → RabbitMQ → Endpoint tragen Sie die RabbitMQ-Zugangsdaten aus dem Abschnitt „Installation des Confire Cloud Agents“ der E-Mail „Confire Cloud – Zugangsdaten“ ein:

  • Host: mq.confire.cloud (für alle Instanzen identisch, nicht ändern)
  • Port: 32672 (nicht ändern)
  • VirtualHost: Ihr RabbitMQ Virtual Host
  • Username: Ihr RabbitMQ-Benutzername
  • Password: Ihr RabbitMQ-Passwort

  Ändern Sie ausschließlich die Werte für VirtualHost, Username und Password.

• Speichern Sie die Datei ab.

Dienst confirecloud.agent registerieren¶

• Führen Sie Windows PowerShell als Administrator aus:

• Aktivieren Sie die Ausführung von Skripten (Bestätigen Sie mit [J]):

Set-ExecutionPolicy Bypass

• Navigieren Sie zum Produktionsverzeichnis:

cd C:\confirecloud.agent

• Führen Sie das PowerShell-Skript register-confirecloud-agent-exe.ps1 aus:

.\register-confirecloud-agent-exe.ps1

Der Service confire.agent wird gestartet:

Status   Name               DisplayName
------   ----               -----------
Stopped  confirecloud.agent confirecloud.agent
Service registered and started successfully.
Finished. Press Enter to exit.:

• Öffnen Sie services.msc und überprüfen Sie, ob der Dienst confirecloud.agent läuft. Schließen Sie nun die Fenster Dienste und PowerShell.

Konfiguration¶

Manuelle Gerätespezifikation¶

Anstatt sich auf die automatische Erkennung über Netzwerk-Broadcasts zu verlassen, können Benutzer die IP-Adressen der Geräte, die der Agent verwalten soll, direkt angeben. Dies ist besonders nützlich in Umgebungen, in denen die Broadcast-Erkennung eingeschränkt ist oder Geräte über verschiedene Subnetze hinweg verwaltet werden müssen.

Im untenstehenden Beispiel wurden fünf Geräte per Broadcast-Erkennung erkannt:

Anstatt die Broadcast-Erkennung zu verwenden, möchten wir jetzt nur zwei spezifische Geräte, DIRECT-Raum-001 und DIRECT-Raum-002 erkennen. Dann müssen die Geräte manuell in der Datei appsettings.Production.json eingetragen werden:

• Unter ScanIpAddresses löschen Sie den Eintrag "192.168.1.255":

• Tragen Sie die IP-Adressen der gewünschten Geräte ein. Stellen Sie sicher, dass die letzte Zeile kein Komma enthält:

• Speichern Sie die Datei appsettings.Production.json und starten Sie den Dienst confirecloud.agent neu:

• Es werden nun nur die zwei angegebenen Geräte erkannt:

Upgraden¶

Um von allen neuen Funktionen von Confire Cloud zu profitieren, stellen Sie bitte sicher, dass Ihre Agenten die neueste Softwareversion verwenden.

1. Melden Sie sich mit Administratorrechten am Agenten an.

2. Klicken Sie in Confire Cloud im linken Menü auf Agenten/Netzwerke:

   

   Klicken Sie oben rechts auf die drei Punkte und wählen Sie Agent herunterladen: Windows:

   

3. Entpacken Sie die Datei confirecloud.agent.zip in Ihren Downloads-Ordner.

4. Offnen Sie services.msc und starten Sie den Dienst confirecloud.agent:

   

5. Ersetzen Sie die Datei C:\confirecloud.agent\confirecloud.agent.exe durch die Version aus dem Downloads-Ordner:

   

6. Offnen Sie services.msc und starten Sie den Dienst confirecloud.agent: