Installation unter Windows (Connect 2024)

Verfügbare Builds

Das Installationspaket für den Connect Server enthält vier unterschiedlich Builds für Windows:

Hinweise zur Plattformunabhängigen Version

Der plattformunabhängige Build “portable” setzt die vorherige Installation von .NET 8 inkl. ASP.NET Core voraus. Die aktuelle Version wird von Microsoft unter folgendem Link bereitgestellt:

Wir empfehlen die Verwendung des von Microsoft bereitgestellten “Hosting Bundles”, da dies alle benötigten Komponenten enthält.

Der Vorteil der plattformunabhängigen Version liegt darin, dass sie Aktualisierungen für das .NET-Framework unabhängig von der Connect Software installieren können. Im Fall von sicherheitskritischen Fehlern im Microsoft .NET Framework können sie somit sofort reagieren und müssen nicht auf die Auslieferung eines Updates des Connect Servers warten. Darüber hinaus können die identischen Installationsdateien für alle unterstützten Betriebssysteme verwendet werden.

Hinweise zu den plattformspezifischen Versionen

Diese Builds enthalten sind bereits für die entsprechende Zielplattform kompiliert und enthalten alle zur Ausführung benötigten Dateien. Somit entfällt die Installation zusätzliche Software. Eine Aktualisierung der enthaltenen Softwarekomponenten ist nur durch die Installation eines Updates des Connect Servers möglich.

Installation

Legen Sie einen leeren Ordner an (z. B. “C:\Program Files\Galileo Group\Connect\server”) und kopieren Sie alle Dateien der gewünschten Version des Connect Servers in diesen Ordner.

Konfiguration

Der Connect Server mit bereits mit einer lauffähigen Konfiguration ausgeliefert. Der integrierte Web­server steht nach dem Start an Port 80 zur Verfügung und reagiert auf HTTP-Anforderungen. Nähre Informationen zum Anpassen der Konfiguration entnehmen Sie bitte dem Kapitel Konfiguration (Connect 2024).

Start des Connect Servers (als Konsolenapplikation)

Der Connect Server kann direkt als Konsolenapplikation betrieben werden. Dieses Szenario empfiehlt sich für Testszenarien und unter Umständen für kleinere Proof of Concept Projekte. Beachten Sie, dass der Connect Server in diesem Szenario durch das Schließen der Konsole sowie durch die Abmeldung des Benutzers beendet wird. Das Trennen einer Remote Desktopverbindung (ohne Abmeldung) hat keine Auswirkungen auf den laufenden Connect Server.

Um den Connect Server als Konsolenapplikation zu starten, wechseln Sie in den Ordner mit dem Connect Server und starten Sie die ausführbare Datei namens “GalileoGroup.Connect.Server.exe”. Alternativ können Sie dern Connect Server über den Windows Explorer durch Doppelklick auf die Datei “GalileoGroup.Connect.Server.exe” starten.

Beenden des Connect Servers (als Konsolenapplikation)

Aktivieren Sie das Konsolenfenster mit dem Connect Server und beenden Sie den Connect Server durch die Tastenkombination Strg + C. Das direkte Schließen des Konsolenfensters wird nicht empfohlen, da hierbei nicht sichergestellt werden kann, dass alle laufenden Kommunikationsvorgänge ordnungsgemäß beendet werden.

Betrieb als Windows Dienst

In Windows-basierten Produktivumgebungen empfiehlt sich der Betrieb des Connect Servers als Windows Dienst. Die Protokollausgaben erfolgen in diesem Szenario in das Windows Ereignisprotokoll. Die einmalige Einrichtung wird im Folgenden beschrieben:

Anlegen eines lokalen Benutzers für die Ausführung des Diensts

Zum Anlegen des lokalen Benutzers geben Sie folgende Kommandos in eine PowerShell mit Administratorrechten ein:

Nachdem Der Benutzer erfolgreich angelegt wurde, muss ihm die Berechtigung für die Anmeldung als Windows Dienst zugewiesen werden. Drücken Sie die Tasten Win + R und geben Sie im folgenden Eingabefenster “secpol.msc” ein. Nun wird ein Fenster wird mit einer Baumstruktur auf der linken Seite dargestellt. Öffnen Sie dort den Knoten “Lokale Richtlinien” und klicken Sie anschließend den Knoten “Zuweisen von Benutzerrechten” an. In der rechten Bildhälfte den Eintrag “Anmelden als Dienst” via Doppelklick auswählen.

Klicken Sie im nachfolgenden Dialogfenster auf die Schaltfläche „Benutzer oder Gruppe hinzufügen“ und wählen Sie den neu angelegten lokalen Benutzer aus. Falls der Benutzer nicht gefunden wird, schränken Sie den Suchpfad auf den lokalen Computernamen ein.

Nun muss dem neuen Benutzer der Zugriff auf den Ordner gestattet werden, in dem die Anwendung installiert wurde. In diesem Beispiel wird den Ordner “C:\Program Files\Galileo Group\Connect\server” verwendet. Geben Sie hierfür folgende Kommandos in eine PowerShell mit Administratorrechten ein:

Registrierung des Connect Servers als Windows Dienst

Die Registrierung kann ebenfalls mit Hilfe einer PowerShell mit Administratorrechten bewerkstelligt werden. Hier ein Beispiel, welches als Vorlage verwendet werden kann:

Deregistrierung des Windows Diensts

Soll der Windows Dienst wieder entfernt werden, so kann dies mit folgendem Kommando in einer PowerShell mit Administrator-Berechtigung bewerkstelligt werden:

Sofern auf dem entsprechenden System bereits die PowerShell 7 im Einsatz ist, kann die Deregistrierung auch über das Cmdlet “Remove-Service” erfolgen.