Service - CSharp

Allgemein

Installation erfolgt pro Server

Lieferumfang des Installationspaketes

Ordner/Datei	Beschreibung
Services/%ServiceName%/Service.exe	ausführbare Anwendung
Services/%ServiceName%/appsettings.json oder /config.json	Konfigurationsdatei der Anwendung für Logging und Dienst Installation
RegServices*.xml	Registrierungsdatei genesisWorld
Database/%ServiceName%.xml	Importdatei für die Datenbank (optional)

Voraussetzungen

.NET Hosting Bundle

Unsere Anwendungen basieren auf dem ASP.NET Core Framework von Microsoft. Damit diese korrekt ausgeführt werden können, ist die Installation des .NET Hosting Bundle zwingend erforderlich.

Wir empfehlen die Installation der aktuellsten LTS-Version (Long-Term Support) des .NET Hosting Bundles. LTS-Versionen bieten langfristigen Support durch Microsoft und sind daher ideal für stabile Produktionsumgebungen.

Download:

Sie können das offizielle .NET Hosting Bundle direkt von der Microsoft-Website herunterladen. Die aktuelle LTS-Version ist dort deutlich gekennzeichnet.

Allgemeiner Download-Link: Microsoft .NET Download-Seite

Wählen Sie auf der verlinkten Seite unter der Überschrift "ASP.NET Core Runtime" den passenden "Hosting Bundle"-Installer für Windows aus der Sektion für die LTS-Version.

Anwendungsbereitstellung

Unsere Anwendungen werden als Framework-abhängige Bereitstellungen (Framework-Dependent) kompiliert. Dies bedeutet:

Die Anwendung selbst enthält nicht die .NET-Laufzeitumgebung. Dies hält die Installationspakete klein und effizient.
Die Anwendung verlässt sich darauf, dass eine kompatible Version des .NET Hosting Bundle auf dem Zielsystem bereits installiert ist.

Datenbankanpassungen

Mögliche Änderungen an der Datenbank sind in der entsprechenden Komponenten-Dokumentation beschrieben. Diese könnten neue Datensatz-Typen mit entsprechenden Feldern oder zusätzliche Felder für vorhandene Datensatz-Typen umfassen.

Service installieren

Navigieren Sie zum Ordner "Server" auf dem System, auf dem genesisWorld installiert ist.
```
C:\Program Files (x86)\Common Files\CAS-Software\Server
```
Kopieren Sie den Inhalt aus dem Installationspaket in den Ordner.
Öffnen Sie die Eingabeaufforderung (CMD) als Administrator

Führen Sie nun nachfolgenden Befehl aus:

cd "C:\Program Files (x86)\Common Files\CAS-Software\Server\Services\"

Navigieren Sie nun in den Serviceordner, für welchen Sie die Installation durchführen wollen mittels nachfolgenden Befehl:
```
cd .\ServiceName
```
Nun wird der Service mit folgendem Befehl installiert:
```
ServiceName.exe /install
```
INFO

Zur Deinstallation des Service führen Sie nachfolgenden Befehl aus:
ServiceName.exe /uninstall
Ausführung des Service als "Local System" mit Enter bestätigen. Sofern der Service unter einem anderen Benutzer ausgeführt werden soll, muss dieser hinterlegt und mit Enter bestätigt werden.
Fertig! Der Dienst wurde nun erfolgreich installiert.
INFO
Sie können im Server-Manager überprüfen, ob dieser Dienst aktiv ist. Zudem haben Sie dort die Möglichkeit, den Dienst zu starten oder zu stoppen.

Beachten Sie: Sollte der Dienst im Server-Manager nicht angezeigt werden, ist es erforderlich, den Server-Manager ordnungsgemäß zu schließen und anschließend erneut zu öffnen.

Service konfigurieren

Die spezifische Anleitung zur Konfiguration finden Sie in der jeweiligen Dokumentation des Service.