Installation & Update

Hierbei handelt es sich um die on-premises Variante der Schnittstelle. On-Premises sind mehr Funktionen verfügbar, allerdings sind diverse Technische und Organisatorische Maßnahmen zur Sicherung des Systems vorzunehmen, da ROINX Datenbank- und System-Zugriff hat.

Voraussetzungen

• .NET 6.0 SDK für Windows x64 installieren: https://dotnet.microsoft.com/en-us/download/dotnet/6.0

Verzeichnis-Installation

1. ROINX ablegen

2. appconfig.json mit Zugangsdaten befüllen

   1. Name + ID ist intern und können frei vergeben werden

   2. Pfad für Versandbestätigung (“ConfirmationPath”) muss immer mit doppelten \ escaped werden

3. Die appconfig.json um die URL erweitern, wenn die API nicht nur unter localhost erreichbar sein soll. Am Ende der Datei “urls” anfügen. Statt * kann auch die IP-Adresse oder die Domain angegeben werden

},
  "AllowedHosts": "*",
  "urls": "http://*:5000"
}

Dienst installieren

Dafür die Powershell als Administrator starten.

Diesen Befehl ausführen:

New-Service -Name Roinx -BinaryPathName "C:\PFAD\zu\Roinx\Roinx.exe --contentRoot C:\PFAD\zu\Roinx\" -Description "Mandantenabgleich" -DisplayName "Roinx" -StartupType Automatic

Den Namen des Dienstes (Parameter “DisplayName") und die Beschreibung des Dienstes (Parameter “Description”) können angepasst werden.

In Dienste-Verwaltung öffnen, z.B. über den Taskmanager, und prüfen, ob der Dienst gestartet ist. Sonst Rechtsklick auf den Dienst und starten.

Dienst löschen

Wenn der Dienst gelöscht werden soll:

in Powershell als Administrator: Remove-Service -Name Roinx

Alternativ in CMD als Administrator: sc delete Roinx

Roinx updaten

1. Beenden Sie den Windows-Dienst oder schließen Sie das Konsolen-Fenster
2. Sichern Sie Ihre Konfigurationsdateien
3. Entpacken Sie das Update-Verzeichnis in das aktuelle Programmverzeichnis
4. Überschreiben Sie alle Dateien
5. Starten Sie Roinx im Konsolen-Fenster indem Sie die roinx.exe ausführen
6. Prüfen Sie Fehler
7. Falls keine Fehler auftreten, schließen Sie das Konsolen-Fenster und starten den Roinx-Dienst