Installation d'un cluster

Remarque : Cette procédure explique comment installer plusieurs serveurs dans un cluster. Suivez cette procédure uniquement si vous souhaitez installer un cluster et non un serveur individuel. Installation d'un cluster pour le module Informations sur les emplacements.

L'installation d'un cluster implique la configuration d'un seul serveur Spectrum™ Technology Platform à la fois. Chaque fois que vous ajoutez un serveur, vous devez le pointer vers un serveur existant servant de nœud « seed ». Un nœud seed est un serveur comportant une copie des données de configuration Spectrum qu'il peut copier dans un nouveau nœud de sorte à synchroniser la configuration de ce dernier avec celle des autres nœuds du cluster. Les figures suivantes illustrent ce processus.

Après avoir installé le premier nœud, vous obtenez en effet un cluster comportant un seul nœud :



Lorsque vous installez le second nœud, ce dernier doit pointer vers le premier nœud servant de nœud seed. Cette opération permet au second nœud de recevoir une copie de la base de données de configuration du premier nœud, créant ainsi un cluster comportant deux nœuds dont les informations de configuration sont synchronisées.



À mesure que vous ajoutez des nœuds, ceux-ci peuvent pointer vers n'importe lequel des nœuds existants servant de nœud seed. Vous devez également configurer le premier nœud de sorte qu'il pointe vers au moins un autre nœud du cluster, de sorte que, s'il tombe en panne, il puisse tout de même rejoindre le cluster.



Avant de commencer, installez un équilibreur de charge. Vous pouvez sélectionner l'équilibreur de charge de votre choix. Lors de l'installation, suivez les procédures décrites dans la documentation de l'équilibreur de charge.

Remarque : L'équilibreur de charge doit être configuré pour autoriser les barres obliques codées. Si l'équilibreur de charge n'autorise pas les barres obliques codées, vous risquez obtenir des erreurs HTTP 404 lors de l'utilisation du cluster. Par exemple, si vous utilisez un équilibreur de charge Apache, vous pouvez le configurer pour qu'il autorise les barres obliques codées en ouvrant le fichier httpd.conf et en spécifiant la propriété suivante : AllowEncodedSlashes On. Pour connaître les autres types d'équilibreur de charge, reportez-vous à la documentation de l'équilibreur de charge.

Une fois que vous avez installé votre équilibreur de charge, procédez comme suit pour installer les nœuds du cluster.

  1. Installez Spectrum™ Technology Platform sur un serveur sur lequel vous souhaitez héberger un nœud. Pour obtenir des instructions, reportez-vous à la section Installation d'un nouveau serveur.
    Important : Ne démarrez pas le serveur une fois l’installation terminée. Vous devez effectuer les étapes suivantes avant de démarrer le serveur.
  2. Configurez les fichiers de propriétés.
    1. Modifiez les propriétés du fichier server/app/conf/spectrum-container.properties comme décrit à la section Propriétés du cluster.
    2. Enregistrez et fermez le fichier spectrum-container.properties.
    3. Certains modules disposent de paramètres spécifiques au module que vous devez configurer pour permettre au module de fonctionner dans un cluster.
      Module Paramètres de configuration du cluster
      Module Advanced Matching Ces paramètres configurent la mise en cluster des index de recherche de texte complet. Si vous n’utilisez pas les index de recherche de texte complet, vous n’avez pas besoin de configurer ces paramètres.

      Ouvrez ce fichier dans un éditeur de texte :

      SpectrumFolder\server\modules\searchindex\es-container.properties

      Configurez ces propriétés :

      es.index.default_number_of_replicas
      Saisissez le nombre de copies supplémentaires à créer pour chaque index de recherche. Ce nombre doit être le nombre de nœuds de votre cluster, moins 1. Par exemple, si votre cluster comporte cinq nœuds, vous devez saisir la valeur « 4 » dans cette propriété.
      es.index.default_number_of_shards
      Saisissez le nombre de partitions que vous souhaitez que votre index contienne dans l'environnement distribué. Plus votre cluster contient de nœuds, plus ce nombre doit être élevé.

      Enregistrez et fermez es-container.properties lorsque vous avez terminé la modification de ces propriétés.

      Remarque : Les index de recherche créés avant Spectrum™ Technology Platform 10.0 ne prennent pas en charge la mise en cluster. Pour activer la mise en cluster pour les index créés avant la version 10.0, vous devez recréer l’index de recherche à l’aide de l'API 10.0 après avoir modifié le fichier es-container.properties.
      Module Data Hub Ouvrez ce fichier dans un éditeur de texte :

      SpectrumFolder\server\modules\hub\hub.properties

      Configurez ces propriétés :

      hub.models.path.base
      Spécifie le dossier dans lequel les modèles sont stockés. Par défaut, chaque modèle est placé dans un sous-répertoire dans le dossier SpectrumFolder\server\modules\hub\db. Si vous souhaitez stocker les modèles à un emplacement différent, décommentez cette propriété et spécifiez le dossier dans lequel vous souhaitez stocker les modèles.
      hub.neo4j.database.type
      Remplacez la valeur de cette propriété par ha. La valeur par défaut embedded est destinée aux installations sans cluster.
      hub.servers.per.cluster
      Décommentez cette ligne. Définissez la valeur de cette propriété sur le nombre de serveurs Spectrum™ Technology Platform du cluster.

      Enregistrez et fermez hub.properties lorsque vous avez terminé la modification de ces propriétés.

      SpectrumFolder\server\modules\hub\db\neo4j.properties contrôle la manière dont les bases de données graphiques sont configurées, à l'aide de Neo4j Enterprise. Ce fichier est utilisé comme modèle pour chaque modèle. Si nécessaire, chaque modèle peut être configuré séparément en plaçant une copie de ce fichier de propriétés dans le répertoire de stockage de ce modèle.

      Module Machine Learning Ouvrez ce fichier dans un éditeur de texte :

      SpectrumFolder\server\modules\machinelearning/java.vmargs

      Configurez ces propriétés :

      -Xmx
      Spécifie l’allocation de mémoire maximale. Nous vous recommandons de dimensionner votre cluster du module Machine Learning de sorte qu'il fasse environ quatre fois la taille de vos données et que tous les nœuds reçoivent la même quantité de mémoire. Pour éviter le remplacement, assurez-vous que l'allocation - Xmx ne dépasse pas la mémoire physique sur aucun nœud.
  3. Démarrez le serveur. Pour démarrer le serveur, remplacez le répertoire de travail par le répertoire Spectrum™ Technology Platform du serveur bin, recherchez le fichier de configuration, puis saisissez la commande suivante : ./server.start.
  4. Répétez cette procédure pour installer des nœuds supplémentaires sur le cluster.
  5. Après l’installation de tous les nœuds, revenez au premier nœud et ajoutez les autres nœuds comme nœuds seed.
    1. Sur le premier nœud que vous avez installé, ouvrez le fichier de propriétés server/app/conf/spectrum-container.properties.
    2. Dans la propriété spectrum.cluster.seeds, ajoutez le nom d’hôte ou l’adresse IP des autres nœuds du cluster, en séparant chacun par une virgule.
    3. Enregistrez et fermez le fichier spectrum-container.properties. Vous n'avez pas besoin de redémarrer le serveur.