Upgrade-Schritte für Profilerstellungs- und Suchindexbenutzer

Anmerkung: Dieser Vorgang fügt dem Upgrade einige Zeit hinzu, da alle vorhandenen Indizes auf eine neuere Version hochgestuft werden. Diese Zeit hängt von den Daten ab, die im Suchindex gespeichert sind.

Sie müssen Ihre Indizes zuerst exportieren, bevor Sie ein Upgrade auf diese Version durchführen können. Importieren Sie diese Indizes nach dem Upgrade. Skripte werden bereitgestellt, um die manuellen Schritte zu unterstützen. Sie müssen einen halbmanuellen Prozess verwenden, um Ihre Indizes zu migrieren, um die Kompatibilität mit der aktuellen Version von Elasticsearch zu gewährleisten.

Anmerkung: Für die manuellen (skriptbasierten) Schritte muss der Server oder Cluster betriebsbereit sein. Fahren Sie den Server erst herunter, wenn es in diesem Prozess angegeben wird.

Mitgelieferte Skripte

Die Skripte Delete, Export und Import befinden sich im Ordner utilities, in dem sich das Spectrum-Installationsprogramm befindet.

Funktion	Skript- oder Dateiname
Indizes löschen	Unix/Linux: delete-all-indexes.sh Windows: delete-all-indexes.bat
Indizes exportieren	Unix/Linux: export.sh Windows: export.bat
Indizes importieren	Unix/Linux: import.sh Windows: import.bat

Voraussetzungen für diese Upgrades

Das Exportverzeichnis muss leer sein und darf keine versteckten Dateien enthalten.
Die Umgebungsvariable JAVA_HOME muss gesetzt sein.

Ihre Indizes migrieren

Anmerkung: Es ist obligatorisch, alle für das Advanced Matching-Modul verfügbaren Produktaktualisierungen für die Versionen 11.1, 12.2 und 12.2.1 vor Verwendung dieser Dienstprogramme zu installieren. Informationen zum Upgrade der Version 10.1 finden Sie unter Zusätzliche Schritte für die Spectrum™ Technology Platform-Version 10.1.

Führen Sie die folgenden Schritte aus, um die erforderliche Variable und das Upgrade festzulegen. Importieren Sie anschließend wieder Ihre aktuellen Indizes.

Stellen Sie die Umgebungsvariable JAVA_HOME ein, die auf ein Java-JDK8 oder höher verweist.
Anmerkung: Wenn Sie diese Variable nicht festlegen, schlagen Ihre Aktionen zum Exportieren und Löschen von Indizes fehl.
Exportieren Sie alle aktuellen Indizes mithilfe des Exportskripts.
Unix/Linux-Beispiel:
```
sh export.sh <spectrum_dir> <export_dir>
```
Windows-Beispiel:
```
export.bat <spectrum_dir> <export_dir>
```
Dabei gilt:
- spectrum_dir Der vollständige Pfad zur Spectrum-Installation: Dieser Speicherort enthält die Verzeichnisse /server, /index und /repository.
- export_dir Der vollständige Pfad zu dem Verzeichnis, in das die Indizes exportiert werden.
Dadurch werden alle derzeit in Elasticsearch gespeicherten Indizes extrahiert und in ein lokales Verzeichnis geschrieben, auf das einer der Server zugreifen kann. Führen Sie dies in einer Cluster-Umgebung nur für einen Knoten durch.
Wenn Ihr Export fehlerfrei ausgeführt wird, führen Sie das Skript delete-all-indexes aus, um alle Indizes aus der aktuell ausgeführten Instanz von Elasticsearch zu löschen.
Unix/Linux-Beispiel:
```
sh delete-all-indexes.sh <spectrum_dir> <export_dir>
```
Windows-Beispiel:
```
delete-all-indexes.bat <spectrum_dir> <export_dir>
```
Dabei gilt:
- spectrum_dir Der vollständige Pfad zur Spectrum-Installation
- export_dir Der vollständige Pfad zu dem Verzeichnis, in das die Indizes exportiert wurden.
Sobald der Schritt Delete erfolgreich abgeschlossen wurde, können Sie Ihren Spectrum-Knoten oder -Cluster sicher herunterfahren.
Führen Sie den Software-Upgrade-Prozess wie bei früheren Versionen von Spectrum™ Technology Platform aus.
Anmerkung: Der Upgrade-Prozess sucht nach vorhandenen Indizes. Wenn Indizes gefunden werden, generiert das Installationsprogramm eine Fehlermeldung und stoppt den Upgrade-Prozess.
Starten Sie den Server nach Abschluss des Upgrades neu.
Importieren Sie die Indizes mit dem Skript import zurück. In einer Cluster-Umgebung sollte dies nur für einen Knoten erfolgen.
Unix/Linux-Beispiel:
```
sh import.sh <spectrum_dir> <import_dir>
```
Windows-Beispiel:
```
import.bat <spectrum_dir> <import_dir>
```
Dabei gilt:
- spectrum_dir Der vollständige Pfad zur Spectrum-Installation
- import_dir Der vollständige Pfad zu dem Verzeichnis, aus dem die Spectrum-Indizes importiert werden.

Zusätzliche Schritte für die Spectrum™ Technology Platform-Version 10.1

Führen Sie die folgenden Schritte aus, während Sie ein Upgrade von Version 10.1 auf die neueste Version durchführen:

Anmerkung: Stoppen Sie den Spectrum™ Technology Platform-Server, bevor Sie den ersten unten genannten Schritt ausführen.

Setzen Sie die Einstellung http.enabled in der Elasticsearc-Datei auf true. Sie ist standardmäßig auf false eingestellt. Diese Datei befindet sich unter <SpectrumLocation>\server\modules\searchindex\elasticsearch.yml.
Starten Sie den Spectrum™ Technology Platform-Server.
Greifen Sie auf searchIndex zu, indem Sie einen beliebigen SEARCH-Auftrag ausführen. Dadurch wird die Such-Engine initialisiert.
Exportieren Sie die 10.1-Indizes mit dem oben beschriebenen und erläuterten Dienstprogramm.
Führen Sie ein Upgrade von Version 10.1 auf die neueste Version durch.