Page Comparison

Verfügbare Builds

...

Available builds

The installation package for Connect Server contains four different builds for Windows:

Hinweise zur Plattformunabhängigen Version

...

Notes on the platform-independent version

The platform independent build "portable" requires the previous installation of .NET 6 incl. ASP.NET Core voraus. Die aktuelle Version wird von Microsoft unter folgendem Link bereitgestellt. The current version is provided by Microsoft at the following link:

...

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. “CWe recommend using the "Hosting Bundle" provided by Microsoft, as this contains all the required components.

The advantage of the platform-independent version is that you can install updates for the .NET Framework independently of the Connect software. In the event of security-critical errors in the Microsoft .NET Framework, they can thus react immediately and do not have to wait for the delivery of an update of the Connect Server. In addition, the identical installation files can be used for all supported operating systems.

Notes on the platform-specific versions

These builds are already compiled for the corresponding target platform and contain all files required for execution. This eliminates the need to install additional software. An update of the included software components is only possible by installing an update of the Connect Server.

Installation

Create an empty folder (e.g. "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 server") and copy all files of the desired Connect Server version into this folder.

Configuration

The Connect Server is delivered with a ready-to-run configuration. The integrated web server is available on port 80 after startup and responds to HTTP requests. For more information about customizing the configuration, please refer to chapter Konfiguration (Connect 2022).

...

Starting the Connect

...

Server (as a console application)

Der The 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 eincan be operated directly as a console application. This scenario is recommended for test scenarios and possibly for smaller proof of concept projects. Note that in this scenario, the Connect Server is terminated by closing the console as well as by the user logging off. Disconnecting a remote desktop connection (without logging off) does not affect the running Connect Server.

To start the Connect Server as a console application, change to the folder with the Connect Server and start the executable file named "GalileoGroup.Connect.Server.exe". Alternatively, you can start the Connect Server via Windows Explorer by double-clicking on the file "GalileoGroup.Connect.Server.exe".

Exiting the Connect Server (as a console application)

Activate the console window with the Connect Server and terminate the Connect Server by pressing the key combination Ctrl + C. Closing the console window directly is not recommended, as this cannot ensure that all running communication processes are terminated properly.

Operation as Windows service

In Windows-based production environments, it is recommended to operate the Connect Server as a Windows service. In this scenario, log output is to the Windows event log. The one-time setup is described below:

Creating a local user to run the service

To create the local user, enter the following commands in a PowerShell with administrator privileges:

$AccountName        = "Connect"
$AccountDescription = "Connect Service User"

New-LocalUser -Name $AccountName -Description $AccountDescription

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 “CAfter The user has been successfully created, it must be assigned the authorization to log in as a Windows service. Press Win + R keys and type "secpol.msc" in the following input window. Now a window will be displayed with a tree structure on the left side. There, open the "Local Policies" node and then click on the "Assign User Rights" node. In the right half of the screen, select the "Log on as service" entry via double-click.

In the following dialog window, click the "Add user or group" button and select the newly created local user. If the user is not found, restrict the search path to the local computer name.

Now the new user must be allowed access to the folder where the application was installed. In this example, the folder "C:\Program Files\Galileo Group\Connect\server” verwendet. Geben Sie hierfür folgende Kommandos in eine PowerShell mit Administratorrechten einserver" is used. To do this, enter the following commands in a PowerShell with administrator privileges:

$BasePath    = "C:\Program Files\Galileo Group\Connect\server"
$AccountName = "Connect"

$User = Get-LocalUser -Name $AccountName

if ($User -ne $Null) {
  $acl = Get-Acl $BasePath -ea Stop
  $FileSystemRights = [System.Security.AccessControl.FileSystemRights]"Modify"
  $AccessControlType = [System.Security.AccessControl.AccessControlType]::Allow
  $InheritanceFlags = [System.Security.AccessControl.InheritanceFlags]"ContainerInherit, ObjectInherit"
  $PropagationFlags = [System.Security.AccessControl.PropagationFlags]"InheritOnly"

  $AccessRule = New-Object System.Security.AccessControl.FileSystemAccessRule ($User.SID, $FileSystemRights, $InheritanceFlags, $PropagationFlags, $AccessControlType)
  $acl.AddAccessRule($AccessRule)
    
  Set-Acl -Path $BasePath -AclObject $acl -ea Stop
    
  Write-Host ("Permission granted for {0}" -f $BasePath)
}

Registrierung des Connect Servers als Windows Dienst

...

Registering the Connect Server as a Windows service

The registration can also be accomplished with the help of PowerShell. Here is an example which can be used as a template:

$BasePath           = "C:\Program Files\Galileo Group\Connect\server"
$ExePath            = "$BasePath\GalileoGroup.Connect.Server.exe"
$BaseSettingsPath   = "$BasePath\appsettings.Default.json"
$CustSettingsPath   = "$BasePath\appsettings.json"

$HostName           = [System.Net.Dns]::GetHostName()
$AccountName        = "Connect"

$ServiceName        = "ConnectServer"
$ServiceDescription = "Connect Server"
$ServiceUser        = "$HostName\$AccountName"

$CommandLine        = """$ExePath"" --settings=""$BaseSettingsPath""? --settings=""$CustSettingsPath""?"

New-Service -Name ConnectServer -BinaryPathName $CommandLine -Credential $ServiceUser -DisplayName $ServiceName -Description $ServiceDescription -StartupType Manual

...

Deregistering the Windows

...

service

Soll der Windows Dienst wieder entfernt werden, so kann dies mit folgendem Kommando in einer PowerShell mit Administrator-Berechtigung bewerkstelligt werdenIf the Windows service is to be removed again, this can be done with the following command in a PowerShell with administrator privileges:

$ServiceName = "Connect Server"

cmd /c csc delete $ServiceName

Sofern auf dem entsprechenden System bereits die PowerShell 7 im Einsatz ist, kann die Deregistrierung auch über das Cmdlet “Remove-Service” erfolgenIf PowerShell 7 is already in use on the corresponding system, deregistration can also be performed using the Remove-Service cmdlet.