Upgrade Elasticsearch z 7.17.28 na 8.19.12¶

TeskaLabs LogMan.io v26.12 dodává Elasticsearch 7.17.28 ve výchozím stavu a podporuje upgrade na 8.19.12. Tento návod popisuje rolling upgrade: jedna instance po druhé, tier po tieru.

Důležitá upozornění

Upgrade je nevratný. Po přechodu na Elasticsearch 8.19.12 nelze vrátit nižší verzi.
Všechny instance musí běžet na stejné verzi Elasticsearch. Smíšené verze v clusteru nejsou podporované. Každá instance musí být nakonec na 8.19.12.

Předpoklady¶

Je potřeba LogMan.io v26.12 nebo novější. Starší verze LogMan.io neběží s Elasticsearch 8.19.12.
Výchozí verze Elasticsearch v LogMan.io v26.12 je 7.17.28. Přepisujete ji v model.yaml. Změna verze z modelu je popsána zde.

Před startem¶

Před začátkem zkontrolujte zdraví clusteru.

Sběr logů není přerušen během upgradu.
Logy se nezapisují do Elasticsearch, dokud je stav clusteru red. Mezitím bufferuje Kafka.
Před startem ověřte, že Kafka nemá velké lagy.
Stav Elasticsearch clusteru musí být green.

Postup upgradu¶

1. Omezení alokace shardů¶

Těsně před upgradem omezte alokaci shardů. V Kibana otevřete Dev Tools a spusťte:

PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": "primaries"
  }
}

2. Upgrade instancí Elasticsearch, po jedné¶

Upgradujte instance tier po tieru. V model.yaml najděte sekci elasticsearch s pojmenovanými instancemi. Vyberte první cold instanci a přidejte version: 8.19.12:

services:
  elasticsearch:
   instances:
     cold-1:
       version: 8.19.12
       node: lmio-server-1

Vpravo vyberte uzel, kde instance běží, a klikněte Apply.

3. Sledování každé instance¶

Restart a novou verzi ověříte v Maintenance → Services. Další metriky jsou v Monitoring v Kibana. Uvidíte restart uzlu a že ještě nemusí mít všechny shardy. Pokračujte, až cluster přejde na yellow.

4. Další tiery¶

Když je cluster yellow, upgradujte další instanci ve stejném tieru (např. cold-2) stejným způsobem. Pokračujte v pořadí:

cold
warm
hot
master

5. Mezera v monitoringu na hot uzlech¶

Při upgradu hot uzlů nebudou dostupná monitoring data na nich uložená. Pokračujte upgradem všech tierů včetně master, i když monitoring v té fázi nefunguje. Monitoring se vrátí po dokončení upgradu.

6. Upgrade Kibana¶

Upgradujte i Kibana na stejnou verzi. Starší Kibana nekomunikuje s novým Elasticsearch.

services:
  kibana:
   instances:
     1:
       version: 8.19.12
       node: lmio-server-1

7. Obnovení alokace shardů¶

Až Kibana běží, monitoring je zpět a cluster je yellow, obnovte alokaci v Kibana Dev Tools:

PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.enable": null
  }
}

Cluster by měl krátce poté přejít z yellow na green.