Document toolboxDocument toolbox

Vorgehen beim Update des Backend-Setup

Owned by Dennis Pries
Last updated: 09.12.2020
2 min read

Das Backend-Setup muss mit den folgenden Schritten aktualisiert werden:

  • Backend-Setup deinstallieren

  • In Windows unter “Programme und Features” prüfen ob die folgenden Setups deinstalliert wurden:

    • RabbitMQ Server

    • Erlang OTP

  • In der Registry folgenden Eintrag löschen, falls dieser existiert:

    • HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\Erlang\ErlSrv\1.1\RabbitMQ

  • Prüfen ob folgenden Services gelöscht wurden:

    • RabbitMQ

    • IO 1 - Search Service

    • IO 1 - Database Server

  • Falls nicht, die Services stoppen und auf einer Administrator-Kommandozeile (CMD, NICHT POWERSHELL!) folgende Befehle ausführen:

    • sc delete RabbitMQ

    • sc delete IoDatabaseServer

    • sc delete IoSearchService

  • In das Installationsverzeichnis der Datenbank wechseln (z.B. C:\ECM\ACTIWARE\IO 1\Server\Database) und dort das Verzeichnis “data” nach “data.bkp” umbenennen.

Nun sollte sich das neue Backend-Setup installieren lassen. Nach der Installation muss die Datenbank noch wieder hergestellt werden:

  • Den Service “IO 1 - Database Server” stoppen

  • In das Installationsverzeichnis der Datenbank wechseln (z.B. C:\ECM\ACTIWARE\IO 1\Server\Database) und dort das Verzeichnis “data” löschen und “data.bkp” wieder nach “data” umbenennen.

  • Den Service “IO 1 - Database Server” wieder starten

Mögliche Probleme

Fehler “Source file not found”

Dieser Fehler tritt auf einigen Systemen auf und ist darauf zurückzuführen, dass der Windows Installer das Setup Paket nicht komplett entpackt. Um das Setup zu entpacken, muss dies über “IO - Backend.exe /extract:dir” aufgerufen werden. Die fehlenden Dateien werden nun in das aktuelle Verzeichnis entpackt und können nun an den Ort kopiert werden, an welchem das Setup die jeweilige Datei erwartet (siehe Fehlermeldung des Setups).

Fehler “There is a problem with this Windows Installer package”

Hier hängt es davon ab, in welchem Status das Setup gerade ist. Dazu die Fehlermeldung beiseite schieben und den Statustext betrachten.

Status “InitializeDatabase”

Das Verzeichnis “data” der Datenbank existiert bereits. Sicherstellen, dass alle oben genannten Schritte durchgeführt wurden.

Status “InstallSearchService”

Der Service “IO 1 - Search Service“ ist bereits vorhanden. Sicherstellen, dass alle oben genannten Schritte durchgeführt wurden.

Report Service zeigt keine Reports mehr

Es ist möglich, dass der Report Service nun keine Reports mehr anzeigt. Dazu folgende Schritte ausführen:

  • Report Service stoppen

  • Solr stoppen und das Verzeichnis “server\solr\reports\data” im Search Service Installationsverzeichnis löschen (z.B.: C:\ECM\ACTIWARE\IO 1\Server\SearchService\server\solr\reports\data)

  • Solr wieder starten

  • Im Solr-Admin die Feld-Definitionen für den Core “reports” öffnen (Direktlink: http://localhost:30004/solr/#/reports/schema)

  • Dort müsste es das Feld “*” geben:

  • Falls nicht, auf “Add Copy Field” klicken und folgendes eingeben:

  • “Add CopyField” klicken und den Report Service den Index neuaufbauen lassen: http://localhost:30011/api/v1/index/rebuild

  • Der Status des Rebuild kann unter dem folgendem link eingesehen werden:http://localhost:30011/api/v1/index/rebuild/progress