¶ JOIN - Zoekfunctie update Elastic
Op deze pagina vindt u informatie over de update naar Elastic versie x.x.x (JOIN Zaak & Document 2021.12 en hoger). De beschrijving is in het Engels. We adviseren om onderstaande acties buiten kantoortijden uit te voeren. De meest recent ondersteunde versie van Elastic Search vind je in de Release notes van de geïnstalleerde JOIN versie.
Deze handleiding gaat uit van een installatie van Elastic Search op de applicatieserver van JOIN. Wilt u Elastic installeren op een aparte server, dan vragen wij u om een technisch consultant van Decos in te huren.
Elastic heeft ten minste 6 GB aan geheugen nodig. Daarnaast mag Elastic maximaal 50% van het beschikbare geheugen gebruiken. Is deze 50% van het totaal lager dan de 6 GB, dan dient u het geheugen uit te breiden. Wij adviseren om op de server een geheugen van 16GB aan te houden, waarvan 6GB is toegekend aan Elastic.
Wanneer Elastic “secured” is geconfigureerd met username en password, dan dient na de installatie van de nieuwste versie dit wachtwoord in sommige gevallen opnieuw te worden ingesteld. Voor ondersteuning hierbij adviseren wij de hulp in te schakelen van een Decos-expert (technisch of support consultant).
¶ Vóór de installatie
- Stop de Decos backgroundservices
- Ga in JOIN Admin naar de configuratiepagina: wijzig instelling “Filter bar behavior” van ALWAYS naar NEVER.
¶ Deinstalleer huidige Elastic versie
- Ga naar de Elasticsearch map (Default: Decos\apps\Elastic\elasticsearch-x.X.X)
- Maak een kopie van CONFIG\ElasticSearch.YML en de data map en plak het in: Decos\apps\Elastic
- Open het command prompt (CMD) als Administrator en ga naar de bin folder van Elastic # ( Default: Decos\apps\Elastic\elasticsearch-7.x.x\bin)
- Deinstalleer de elastic service met het volgende commando:
elasticsearch-service remove - Verwijder de mappen: DECOS\apps(Elastic)\elasticsearch-#.x.x en kibana-#.x.x-windows-x86
¶ Installeer Elastic x.x
- Download het bestand van de Elastic website
- Deblokkeer het zip-bestand en pak deze uit
- Verplaats de mappen naar DECOS\apps\Elastic
- Wijzig zowel voor naar JAVA_HOME als ES_JAVA_HOME (in de environment variables) naar met de volgende locatie: [driveletter]:\Decos\apps\Elastic\elasticsearch-8.x.x\jdk
- Open het command prompt (CMD) als Administrator en ga naar de bin directory van de nieuwe ElasticSearch.
- Installeer ElasticSearch als een Windows Service met het volgende commando:
elasticsearch-service install - Plak de kopie van het bestand ElasticSearch.YML in DECOS\Apps\Elastic\elasticsearch-x.x.x\config en overschrijf het bestand
- Open vervolgens het bestand ElasticSearch.YML bestand en voeg de onderstaande regel:
xpack.security.enabled: falseen sla het bestand vervolgens op. - Maak een map aan onder de nieuwe Elastic map
- Kopieer vervolgens de inhoud de oorspronkelijke data map onder nodes\0\ de mappen en bestanden en plaats dit in de de data map.
- Open vervolgens de elastic manager met hetzelfde commando:
elasticsearch-service manager - Wijzig de start-up type naar automatic:
- Database cache legen en de App pools recyclen in JOIN Admin
- Controleer of de Elastic service draait en verwijst naar de juiste versie
- Start de Decos backgroundservice
¶ Creeer een nieuwe zoekindex
Voer deze opdracht alleen uit in overleg met een Decos specialist
- Draai de Bulkindexer.exe. De oude index wordt automatisch verwijderd (locatie: \decosadmin\bulkindexer\ )
- Wacht tot de index is aangemaakt.
- In de configuratie van JOIN wijzigt u de instelling “Filter bar behavior” van NEVER weer terug naar ALWAYS.
BELANGRIJK: vanaf Elastic versie 7 gaat de index automatisch in lock-mode wanneer de beschikbare schijfruimte minder dan 10% is. Deze lock mode zorgt er voor dat JOIN niet meer kan wegschrijven naar de index en de applicatie niet meer volledig functioneert. Zorg voor voldoende schijfruimte en monitoring op deze schijfruimte. Draai de bulkindexer NIET wanneer de schijfruimte onvoldoende is.