Elasticsearch:Vérifications préalables à la mise à niveau

Vérification des index fermés

Exécutez la commande suivante pour lister tous les index et leurs statuts :

GET _cat/indices?v

health status index
green  open   .monitoring-es-6-2020.10.29
green  open   .monitoring-logstash-6-2020.10.31
green  open   filebeat-6.7.0-2020.10.31
green  open   .monitoring-kibana-6-2020.10.27
       close  test

La sortie affiche chaque index avec son statut dans la colonne status. Si un index présente le statut close, ouvrez-le avant la mise à niveau :

POST test/_open

Vérification de la disponibilité de la version du noyau

Si vous envisagez de mettre à jour le noyau du cluster lors de la mise à niveau, vérifiez qu'une version ultérieure du noyau est disponible sur la page Basic Information de votre cluster.

Dans la ligne Version, vérifiez la version actuelle de l'instance (par exemple, 7.10.0). Si un lien Upgradable kernel patch available apparaît après le numéro de version, cela signifie qu'un correctif du noyau est disponible.

Vous ne pouvez mettre à jour le noyau que si une version ultérieure est répertoriée.

Vérification de la compatibilité du client

Si un client se connecte au cluster, vérifiez que sa version est compatible avec la version cible du cluster. Pour plus de détails sur la compatibilité des versions, consultez la page Compatibility. Si les versions sont incompatibles, mettez à niveau le client avant de poursuivre.

Division des index multi-types

Les versions V6.X et ultérieures ne prennent pas en charge les index multi-types. Si le cluster contient des index multi-types, l'écriture dans ces index continuera de fonctionner après la mise à niveau, mais la création de nouveaux index multi-types en V6.X générera des erreurs. Divisez chaque index multi-type en index à type unique avant la mise à niveau.

Désactivation de la recherche inter-clusters

Exécutez la commande suivante pour vérifier si la recherche inter-clusters est activée :

GET _cluster/settings

Si search.remote apparaît dans le résultat avec une valeur non nulle, la recherche inter-clusters est activée. Désactivez-la avant la mise à niveau :

PUT _cluster/settings
{
  "persistent": {
    "search.remote.*": null
  },
  "transient": {
    "search.remote.*": null
  }
}

Après la mise à niveau, vous pourrez réactiver la recherche inter-clusters.

GET _cluster/settings
GET */_settings?flat_settings=true

Configurations au niveau du cluster

Désactivez les configurations incompatibles au niveau du cluster en définissant leurs valeurs sur null.

Paramètres de snapshot :

PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.snapshot.relocation_enabled": null
  },
  "transient": {
    "cluster.routing.allocation.snapshot.relocation_enabled": null
  }
}

Paramètres de limitation du stockage :

PUT _cluster/settings
{
  "persistent": {
    "indices.store.throttle.type": null,
    "indices.store.throttle.max_bytes_per_sec": null
  },
  "transient": {
    "indices.store.throttle.type": null,
    "indices.store.throttle.max_bytes_per_sec": null
  }
}

Configurations au niveau de l'index

Désactivez les configurations incompatibles au niveau de l'index en définissant leurs valeurs sur null. Remplacez test_index par le nom de votre index.

Les paramètres de similarité nécessitent la fermeture préalable de l'index. Les index fermés ne peuvent ni être lus ni écrits. Rouvrez l'index après avoir effectué les modifications.

Fermez l'index :

POST test_index/_close

Mettez à jour le paramètre :

PUT test_index/_settings
{
  "index.similarity.base.*": null
}

Ouvrez l'index :

POST test_index/_open

Paramètres de réplica shadow :

PUT test_index/_settings
{
  "index.shared_filesystem": null,
  "index.shadow_replicas": null
}

Paramètres de stockage d'index :

PUT test_index/_settings
{
  "index.store.type": null
}

Paramètres de limitation du stockage :

PUT test_index/_settings
{
  "settings": {
    "index.store.throttle.type": null,
    "index.store.throttle.max_bytes_per_sec": null
  }
}

Configurations au niveau du modèle d'index

L'exemple suivant montre comment corriger les configurations incompatibles dans un modèle d'index nommé test_template.

1. Récupérez le modèle actuel :

   GET _template/test_template

   Le résultat affiche les configurations incompatibles — dans cet exemple, les paramètres de stockage d'index, _all et include_in_all :

   {
     "test_template": {
       "order": 0,
       "template": "test_*",
       "settings": {
         "index": {
           "store": {
             "throttle": {
               "max_bytes_per_sec": "100m"
             }
           }
         }
       },
       "mappings": {
         "test_type": {
           "_all": {
             "enabled": true
           },
           "properties": {
             "test_field": {
               "type": "text",
               "include_in_all": true
             }
           }
         }
       },
       "aliases": {}
     }
   }

2. Supprimez les configurations incompatibles et mettez à jour le modèle :

   PUT _template/test_template
   {
      "order": 0,
      "template": "test_*",
      "settings": {
      },
      "mappings": {
        "test_type": {
          "properties": {
            "test_field": {
              "type": "text"
            }
          }
        }
      },
      "aliases": {}
   }