Installation

Um die Re-Indexierung zu starten, starten Sie die aktuelle Version des ELO Server Setups.

Wählen Sie auf der Startseite des ELO Server Setups Upgrade Index aus.

Existing ELO installation: Pfad im Dateisystem zur vorhandenen ELO Installation.

Index destination: Pfad im Dateisystem, wohin das System zum Indexaufbau installiert werden soll. Zwecks der Übersichtlichkeit und des Aufräumens nach Abschluss der Re-Indexierung empfiehlt es sich, hier einen von der ELO Installation unterschiedlichen Pfad anzugeben.

Application Server Port: Port für den Tomcat des Indexservers. Dieser darf nicht schon belegt sein durch einen anderen Dienst des Betriebssystems. Dies schließt ELO Dienste mit ein.

Upgrade Index: Konfiguriert das System für die Re-Indexierung, es wird zunächst auf eine Zusammenfassung weitergeleitet, von dort kann die eigentliche Installation dann gestartet werden.

Uninstall: Deinstalliert das bei Upgrade Index installierte System. Dies ist nach Abschluss der Re-Indexierung durchzuführen. Es werden die Dienste und Programme entfernt, die für die Re-Indexierung installiert worden sind. Währenddessen produzierte Daten wie die Volltextdatenbank bleiben erhalten und müssen im Anschluss manuell entfernt werden.

Upgrade Index

Durch Auswählen des Buttons Upgrade Index werden Sie auf die Übersichtsseite der Installation weitergeleitet. Die dort zusammengefassten Angaben betreffen nur an relevanten Stellen den Vorgang der Re-Indexierung.

Beachten Sie

Die Funktion Upgrade Index des ELO Server Setups darf ab ELO 12 nicht gegen die Produktivdatenbank durchgeführt werden, da im Laufe des Setups Änderungen an der Datenbank vorgenommen werden, mit denen ein älteres ELO nicht mehr fehlerfrei betrieben werden kann (hat z. B. Auswirkungen auf die Vertretungsregeln).

Möchten Sie die Funktion dennoch verwenden, müssen Sie die Daten der Produktivdatenbank in eine separate Datenbank-Instanz duplizieren. Beim Upgrade Index müssen Sie dann im Tab Database im Feld Host diese separate Datenbank-Instanz angeben.

Der hier angegebene Installationspfad und die Dokumentenpfade müssen den Pfaden der ELO Installation entsprechen.

Beachten Sie

Sie müssen einen aktuellen Lizenzschlüssel verwenden.

Die Pfade (Installation path) unter Servers müssen dem Pfad entsprechen, der zuvor bei Index destination festgelegt wurde. Dies gilt ebenso für den Data Folder unter Application Servers. An dieser Stelle wird nach der Re-Indexierung die Volltextdatenbank der ELO iSearch zu finden sein.

Wählen Sie Install, um die Installation des Upgrade-Systems zu starten.

Das ELO Server Setup installiert das Upgrade-System bestehend aus einem ELO Indexserver und einer Instanz der ELO iSearch.

Information

Dabei werden keine Änderungen am bisherigen System durchgeführt.

Nach dem Abschluss der Installation schließen Sie das ELO Server Setup mit dem Button Finish.

Re-Indexierung im Upgrade-System

Ist die Installation des Upgrade-Systems abgeschlossen, rufen Sie die Seite ELO Elasticsearch Configuration auf (über die Statusseite des neu installierten ELO Indexservers > Configure Options > iSearch config).

Wählen Sie im Drop-down-Menü IX-Instance die Instanz _ALL aus, falls noch nicht ausgewählt.

Prüfen Sie auf dem Tab Settings die Einstellungen für die Instanz _ALL.

Achten Sie besonders darauf, ob im Bereich Language settings die richtigen Sprachen ausgewählt sind.

Speichern Sie die Einstellungen mit Save.

Wählen Sie über das Drop-down-Menü IX-Instance die Instanz des Upgrade-Systems aus.

Prüfen Sie die Einstellungen für die Instanz auf dem Tab Settings.

Im Feld Index name muss der Name des Repositorys (in Kleinbuchstaben) eingetragen sein.

Aktivieren Sie den Schalter build seperate index.

Speichern Sie die Einstellungen mit Save.

Prüfen Sie die Einstellungen auf dem Tab Indexer

Die Felder From object id und To object id müssen mit dem Wert -1 ausgefüllt sein.

Speichern Sie die Einstellungen mit Save.

Starten Sie die Re-Indexierung mit dem Button Create new index.

Deinstallation des Upgrade-Systems

Nachdem der Re-Indexierungsprozess abgeschlossen ist, können Sie das Upgrade-System deinstallieren. Der erstellte Index bleibt dabei erhalten.

Starten Sie dazu erneut das ELO Server Setup.

Wählen Sie auf der Startseite des ELO Server Setups Upgrade Index.

Die Seite Upgrade Index erscheint. Die Pfadangaben sollten dem zuvor erstellten Upgrade-System entsprechen.

Wählen Sie Uninstall aus.

Das Upgrade-System wird deinstalliert.

Nach dem Abschluss der Deinstallation schließen Sie das ELO Server Setup mit dem Button Finish.

Update auf neue ELO Version

Ist das Upgrade-System erfolgreich deinstalliert, können Sie nun den eigentlichen ELO Server updaten.

Führen Sie dazu erneut das ELO Server Setup aus.

Aktualisieren Sie den ELO Server wie gewohnt (nähere Informationen finden Sie in der Dokumentation ELO Server) über die Funktionen Standard Configuration/Update oder Advanced Configuration/Update.

Nach dem Abschluss der Installation schließen Sie das ELO Server Setup mit dem Button Finish.

Migration der Daten

Haben Sie die neue ELO Version erfolgreich installiert, können Sie den vom Upgrade-System erstellten Index ins Produktivsystem übernehmen.

Stoppen Sie den Dienst für die ELO iSearch.

Navigieren Sie im Dateisystem zu folgendem Ordner:

<Installationspfad des Upgrade-Systems>/data/ELO-Upgrade-ISearch/

Kopieren Sie den Order index.

Navigieren Sie im Dateisystem zu folgendem Ordner:

<Installationspfad des ELO Servers>/data/

Fügen Sie den kopierten Ordner ein und ersetzen Sie den vorhandenen Ordner index.

Starten Sie den Dienst der ELO iSearch.

Prüfen Sie die Einstellungen auf der Seite ELO Elasticsearch Configuration.

Achten Sie darauf, dass für keine Instanz der Schalter build separate index aktiviert ist.

Testen Sie die ELO iSearch über einen ELO Client.

War die Migration erfolgreich, können Sie die verbliebenen Daten des Upgrade-Systems löschen.

Upgrade Index auf getrenntem Server

Die Re-Indexierung benötigt sehr viele CPU-Ressourcen und kann einen Server stark auslasten. Zum einen kann durch Reduktion der Prozesspriorität der Einfluss auf das Produktivsystem reduziert werden, zum anderen durch Ausführen der Re-Indexierung auf einem getrennten Server.

Das Setup benötigt beide Konfigurationsdateien (%HOMEPATH%\.elosetup.conf sowie <ELO>\config\serversetup2\elosetup.conf), um die Funktion Upgrade Index auf einem anderen Server auszuführen. Der Ordner <ELO>\config\serversetup2\ ist dabei anzulegen, der Pfad muss dem des produktiven Systems gleichen. Weitere Ordner wie z. B. <ELO>\archive oder <ELO>\data werden nicht benötigt.

Im Anschluss kann die Funktion wie in Upgrade Index beschrieben ausgeführt werden.

Upgrade Index bei Migration von ELO 9

Die Volltextdatenbank kann auch bei einem Wechsel von ELO 9 auf ELO 10.1 oder neuer mit diesem Verfahren vorbereitet werden. Durch das Ausrollen des Indexservers 10 wird auch die Datenbank aktualisiert. Daher ist bei ELO 9 mindestens Version 9.16.110 des Indexservers Voraussetzung. Ein Update von ELO 8 auf ELO 10.1 wird nicht unterstützt.

Wie in Upgrade Index auf getrenntem Server beschrieben, benötigt das Setup für die Funktion Upgrade Index zwei Konfigurationsdateien, die es bei ELO 9 Systemen noch nicht gibt. Diese müssen zuvor erzeugt werden. Das Setup legt die beiden Dateien bei einem Upgrade an.

Achtung

Das Upgrade darf nicht vollständig durchgeführt werden. Nach der Erfassung des existierenden Installationspfades sowie des Lizenzschlüssels müssen Sie nach der Analyse des Systems mit der Auswahl von Configure Upgrade oder Review Upgrade die Upgrade-Prozedur abbrechen. Es darf nicht installiert werden!

Im Anschluss sind die benötigten Dateien vorhanden. Nun kann mit Punkt Upgrade Index oder Upgrade Index auf getrenntem Server fortgefahren werden.