Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di_riservata:docway4:xway2elastic [2017/06/27 12:58] – [Mapping su Elasticsearch] mbernardini
+++ documentazione_3di_riservata:docway4:xway2elastic [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== Integrazione fra eXtraWay ed Elasticsearch ======
-<WRAP center round important 60%>
-Versione Elasticsearch supportata: **5.2.2** (//o superiore se mantenuta la major version//) con **JAVA 8**\\
-</WRAP>
-===== Caratteristiche integrazione =====
-  * L'integrazione fra eXtraWay ed Elasticsearch è gestita a livello applicativo (strato broker)
-  * Per ogni archivio eXtraWay (che deve essere indicizzato su Elasticsearch) deve essere creato uno specifico indice su Elasticsearch (relazione 1-1 fra archivi eXtraWay ed indici di Elasticsearch, ad ogni archivio su eXtraWay corrisponde un indice su Elasticearch)
-  * Su eXtraWay vengono mantenuti tutti gli indici primari e i seriali, mentre ogni altro dato da indicizzare viene lasciato ad Elasticsearch
-  * Tutte le scritture su eXtraWay vengono replicate sull'indice Elasticsearch (tramite specifico componente sul broker)
-    * In caso di errore in scrittura sull'indice di Elasticsearch viene registrato un file di errore sul file system
-    * Ogni minuto un processo verifica la presenza di eventuali file di errore e ritenta l'operazione indicata (in modo da mantenere l'allineamento fra i dati memorizzati su archivio eXtraWay e quelli presenti sull'indice di Elasticsearch)
-  * Le ricerche vengono realizzate:
-    * Su eXtraWay se i filtri di ricerca riguardano solo campi seriali indicizzati su eXtraWay
-    * Su Elasticsearch in ogni altro caso
-  * Ogni ricerca in formato eXtraWay ricevuta dal broker viene opportunamente parsata e, se deve essere rediretta su Elasticsearch, convertita in formato JSON
-  * **N.B.**: Non esiste più il concetto di selezione conosciuto in eXtraWay. La paginazione dei risultati di una ricerca su Elasticsearch comporta una nuova esecuzione della stessa (possono quindi variare anche il numero totale di risultati) -> __Questo porta a differenze di comportamento a livello di interfaccia dell'applicativo__
-  * L'integrazione è stata inclusa sulle seguenti applicazioni:
-    * DocWay4 (DocWay4-service)
-    * 3diWS
-    * MailArchiver (MSA)
-===== Creazione dell'indice su Elasticsearch =====
-Per creare un nuovo indice su Elasticsearch e popolarlo con i dati contenuti in un archivio eXtraWay occorre procedere nel modo seguente:
-  - Creare l'indice su Elasticsearch (indicando il json di mapping per l'archivio). Si consiglia di chiamare l'indice con un nome del tipo '//[nome_archivio]_ddMMyyyy//', in modo da poter gestire il reindex senza dover stoppare Elasticsearch.
-  - Assegnare all'indice creato '//[nome_archivio]_ddMMyyyy//' l'alias '//[nome_archivio]//'. In questo modo sarà possibile accedere all'indice tramite '//[nome_archivio]//'
-  - Lanciare la procedura di importazione dati da eXtraWay
-==== Mapping su Elasticsearch ====
-L'operazione di mapping consiste nel definire tutte le risorse e i campi (con relativa modalità di indicizzazione) da gestire su Elasticsearch per uno specifico archivio.
-Alla pagina corrente sono stati allegati due esempi di file di mapping (relativi agli archivi DocWay e ACL):
-  * File Mapping DocWay
-  * File Mapping ACL
-Esempio di comando di creazione indice su Elasticsearch:
-<code>
-curl --user elastic:password -XPUT "http://localhost:9200/xdocwaydoc_20170627?pretty=true" -d @xdocwaydoc-mapping.json
-</code>
-==== Assegnazione Alias ====
-==== Importazione dati da eXtraWay ====
-===== Configurazione dell'integrazione sul broker =====
-===== Indicizzazione di Files =====
-<WRAP center round todo 100%>
-**TODO**
-</WRAP>