Wymagania

1. Wymagana jest usługa Elasticsearch w wersji 7 (uruchamiana w poniższej sekcji Konfiguracja i punkcie 3). Usługa w wyższej wersji nie jest wspierana.

Konfiguracja

1. Wymagana jest instalacja Dockera wraz z Docker Compose. 
2. W repozytorium kodu (lub docker-compose.yml) plusworkflow/plusworkflow-core znajduje się docker-compose.yml do uruchomienia elastica i Kibany lokalnie.

3. Będąc w lokalizacji powyższego pliku docker-compose.yml należy wywołać:

   docker compose up

4. Trzeba ustawić flagę w experimental.properties:

   elasticProcessSearch=true

5. Dodać plik w katalogu domowym w configu: elastic.properties o zawartości:

   elastic.hostname=localhost
   elastic.port=9200
   elastic.username=elastic
   elastic.password=elastic

6. Włączyć parametr systemowy ElasticEnabled (jeśli istnieje)
7. Dodać zadanie zaplanowane o nazwie: Indeksowanie procesów zadań. Po jego uruchomieniu zastaną zaindeksowane wszystkie procesy i zadania.

Obsługa Kibany

1. Kibana uruchomiona z powyższej konfiguracji dostępna jest pod adresem: http://localhost:5601/ Dane dostępowe takie jak w elastic.properties powyżej.

2. Przy pierwszym uruchomieniu Kibany trzeba ustawić patterny dla indeksów (process* dla procesów i activity* dla zadań).

3. Zaindeksowane dokumenty przeglądamy w zakładce Discovery.
4. W przypadku problemów ze zgodnością danych w elasticu (np. po zmianie typu jakiegoś indeksowanego pola) należy przejść do:
   

   Management -> Stack Management -> IndexManagement

   zaznaczyć wszystko (Include rollup indices i Include hidden indices muszą być odznaczone) i wybrać delete indices. Następnie trzeba przeindeksować wszystkie dokumenty zadaniem zaplanowanym.