Étapes de mise à niveau pour les utilisateurs de Profiling et d'Index de recherche

Remarque : Ce processus prolonge le temps de mise à niveau, car tous les index existants sont mis à niveau vers une version plus récente. Ce temps dépend des données stockées dans Index de recherche.

Vous devez commencer par exporter vos index avant d'effectuer la mise à niveau vers cette version, puis importer ces index après la mise à niveau. Des scripts sont fournis pour vous aider avec les étapes manuelles. Vous devez utiliser un processus semi-manuel pour migrer vos index afin de maintenir la compatibilité avec la version actuelle d'Elasticsearch.

Remarque : Les étapes manuelles (basées sur des scripts) nécessitent que le serveur ou le cluster soit opérationnel. N'arrêtez pas le serveur avant le stade indiqué dans ce processus.

Scripts fournis

Les scripts Delete, Export et Import se trouvent dans le dossier Utilitaires où se trouve le programme d'installation Spectrum.

Fonction	Nom de script ou de fichier
Supprimer les index	Unix/Linux - delete-all-indexes.sh Windows - delete-all-indexes.bat
Exporter les index	Unix/Linux - export.sh Windows - export.bat
Importer les index	Unix/Linux - import.sh Windows - import.bat

Prérequis pour ces mises à niveau

Le répertoire d'exportation doit être vide et il ne doit pas inclure de fichiers masqués.
La variable d'environnement JAVA_HOME doit être définie.

Migrer vos index

Remarque : Il est obligatoire d'appliquer toutes les mises à jour de produit disponibles pour le module Advanced Matching pour les versions 11.1, 12.2 et 12.2.1 avant d'utiliser ces utilitaires. Pour mettre à niveau la version 10.1, reportez-vous à la section Étapes supplémentaires pour Spectrum™ Technology Platform version 10.1

Suivez ces étapes pour définir la variable nécessaire et effectuer la mise à niveau, puis réimporter vos index actuels.

Définissez la variable d'environnement JAVA_HOME pour qu'elle pointe vers un JDK8 Java ou une version ultérieure.
Remarque : Si vous ne définissez pas cette variable, vos actions d'exportation ou de suppression d'index risquent d'échouer.
Exportez tous les index existants à l'aide du script export.
Exemple Unix/Linux :
```
sh export.sh <spectrum_dir> <export_dir>
```
Exemple Windows :
```
export.bat <spectrum_dir> <export_dir>
```
où :
- spectrum_dir est le chemin d'accès complet à l'installation Spectrum : cet emplacement comprend les répertoires /server, /index et /repository.
- export_dir est le chemin d'accès complet au répertoire vers lequel les index seront exportés.
Cela extrait tous les index actuellement stockés dans Elasticsearch et les écrit dans un répertoire local accessible par l'un des serveurs. Dans un environnement en cluster, effectuez cette opération sur un seul nœud.
Une fois que votre script Export s’exécute sans erreur, exécutez le script delete-all-indexes pour effacer tous les index de l’instance en cours d’Elasticsearch.
Exemple Unix/Linux :
```
sh delete-all-indexes.sh <spectrum_dir> <export_dir>
```
Exemple Windows :
```
delete-all-indexes.bat <spectrum_dir> <export_dir>
```
où :
- spectrum_dir est le chemin d'accès complet à l'installation Spectrum.
- export_dir est le chemin d'accès complet au répertoire vers lequel les index ont été exportés.
Une fois que l’étape Delete est correctement effectuée, vous pouvez arrêter votre nœud ou cluster Spectrum en toute sécurité.
Exécutez le processus de mise à niveau du logiciel comme vous le feriez avec les versions précédentes de Spectrum™ Technology Platform.
Remarque : Le processus de mise à niveau recherche les index existants. Si des index sont trouvés, le programme d'installation génère un message d'erreur et arrête le processus de mise à niveau.
Une fois la mise à niveau terminée, redémarrez le serveur.
Importez de nouveau les index à l'aide du script import. Dans un environnement en cluster, cette opération ne doit être effectuée que sur un seul nœud.
Exemple Unix/Linux :
```
sh import.sh <spectrum_dir> <import_dir>
```
Exemple Windows :
```
import.bat <spectrum_dir> <import_dir>
```
où :
- spectrum_dir est le chemin d'accès complet à l'installation Spectrum.
- import_dir est le chemin d'accès complet au répertoire à partir duquel les index Spectrum seront importés.

Étapes supplémentaires pour Spectrum™ Technology Platform version 10.1

Suivez ces étapes lors de la mise à niveau de la version 10.1 vers la dernière version :

Remarque : Arrêtez le serveur Spectrum™ Technology Platform avant d’effectuer la première étape mentionnée ci-dessous.

Définissez le paramètre http.enabled sur true dans le fichier Elasticsearch. Il est défini sur false par défaut. Ce fichier se trouve dans : <SpectrumLocation>\server\modules\searchindex\elasticsearch.yml.
Démarrez le serveur Spectrum™ Technology Platform.
Accédez à searchIndex en exécutant un job SEARCH. Cela initialise le moteur de recherche.
Exportez les index 10.1 à l'aide de l'utilitaire fourni et expliqué ci-dessus.
Mettez à niveau depuis la version 10.1 vers la dernière version.