¶ JOIN - Zoekfunctie update Elastic
Op deze pagina vindt u informatie over de update naar Elastic versie 7.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).
¶ Before installation
- Stop the Decos backgroundservices
- in JOIN Config Editor, change setting “Filter bar behavior” from ALWAYS to NEVER.
¶ Uninstall Elastic 7.x
- Go to the Elasticsearch folder (Default: Decos\apps\Elastic\elasticsearch-7.X.X)
- Create a copy of the CONFIG\ElasticSearch.YML file and paste it in Decos\apps\Elastic
- Open command prompt (CMD) and go to the bin folder of Elastic 7 ( by default: Decos\apps\Elastic\elasticsearch-7.x.x\bin)
- Uninstall the Elastic service with the command:
elasticsearch-service remove - Delete folder: DECOS\apps(Elastic)\elasticsearch-7.x.x and kibana-5.x.x-windows-x86
¶ Install Elastic 7.x
- Download from Elastic website
- Unblock the zip and extract
- Move folders to DECOS\apps\Elastic
- Paste the copy of the old ElasticSearch.YML file in DECOS\Apps\Elastic\elasticsearch-7.x.x\config and overwrite the file
- Change JAVA_HOME in the environment variables to ES_JAVA_HOME with location: [driveletter]:\Decos\apps\Elastic\elasticsearch-7.x.x\jdk
- Start a command prompt with administrator privileges, go to the bin directory of ElasticSearch and install ElasticSearch as a Windows Service using the following command:
elasticsearch-service install - Open the elastic manager throught the same command prompt by using the following command:
elasticsearch-service manager - Change startup type to Automatic (see image below)
- Change memory to 6 GB using the elastic manager (see image below)
- Change the temp directory (see image below)
- Check if Elastic Service is running and is pointing to Elastic 7.x
- Start the Decos backgroundservices
¶ Create new search index
this is only required when updating to major version of Elastic! Please check with Decos Support when you have doubts
- Run the bulkindexer.exe. The old index will be removed automatically (location: \decosadmin\bulkindexer\ )
- Wait until the index has been fully created.
- In JOIN Config Editor, change setting “Filter bar behavior” from NEVER back to ALWAYS.
Important note: Elastic 7 has a new feature where the index goes into automatic lock-mode when the available disk space for index has reached 90%. When it exceeds this treshold the Elastic Index will automatically go into lock mode. The effect on JOIN is that events can not be written to the index and “disappear” (since we display lists from the index and not from database). So please check the available disk space after installation of Elastic and running bulkindexer. If disk space is less then 10%, first add some more space and run bulkindexer again.