ElasticSearch minor versie updaten

Een minor versie van ElasticSearch is te herkennen aan het 2de nummer in het versie nummer. Bijvoorbeeld: bij 7.17.1 is '17' de minor versie. Op deze pagina zie je hoe je (vrij gemakkelijk) een ElasticSearch instantie update naar een nieuwe minor versie. Deze pagina legt uit hoe je een major versie update.

Stap 1: Voorbereiding

Het begint natuurlijk bij het downloaden van de nieuwe versie ElasticSearch. In dit voorbeeld gaan we van versie 7.16.1 naar 7.17.1 vanwege een security melding.

https://discuss.elastic.co/t/elastic-stack-7-17-1-security-update/298447 

Pak het archiefbestand uit. Navigeer naar de draaiende ES instantie. Deze kun je als volgt vinden.

1. Ga naar Start en tik in 'Services'.
2. Zoek in de lijst naar een service genaamd 'Elasticsearch x.xx.x (elastic-service-x64)'.
3. Rechtermuis op de service -> Properties.
4. Onder 'Path to executable' staat waar de draaiende ES instantie woont.

Noteer het pad en stop de ES service, als deze draait.

Download de 'ingest-attachments' plugin voor de nieuwe ES versie. Versienummer van de plugin moet overeen komen met de versie van de nieuwe ES.

Per versie publiceert ES een pagina met release notes. Hierin staan eventuele breaking changes. Lees deze dus goed door voordat je begint met de migratie. Bijvoorbeeld: https://www.elastic.co/guide/en/elasticsearch/reference/7.17/release-notes-7.17.1.html 

Stap 2: Migratie

Migreer de 'data' map naar de nieuwe ES instantie. Met map en al kopieren en plakken dus. De map 'data' bevat de bestaande index.

Migreer de settings. Een standaard ES instantie heeft alleen settings in elasticsearch.yml staan, maar controleer dit goed.

Installeer de 'ingest-attachments' plugin in de nieuwe ES instantie.

Stap 3: Service updaten

Eerst moeten we de oude service verwijderen. Dit doen we door het volgende commando uit te voeren:

<PAD NAAR OUDE ES INSTANTIE>\bin\elasticsearch-service.bat remove

Daarna installeren we de nieuwe service door het volgende commando uit te voeren, maar dan voor de nieuwe ES instantie.

<PAD NAAR NIEUWE ES INSTANTIE>\bin\elasticsearch-service.bat install

Stap 4: Service starten

Ga terug naar Services en vind je nieuwe ES service (zou een vergelijkbare naam moeten hebben, maar dan met een ander versienummer). Start de service. Stel naar smaak de startup options in.

Als de instellingen in de .yml hetzelfde zijn gebleven hoef je KIM niet te updaten. Start KIM en controlleer of alles werkt. Voer een aantal test indexaties uit, zie deze pagina.