Strumenti Utente

Strumenti Sito


documentazione_3di_riservata:docway4:migrazione_configurazioni

Questa è una vecchia versione del documento!


Introduzione

All'interno della release 4.5.0 di DocWay4 è stato introdotto un nuovo componente: il configuratore (in attesa di trovare un nome più originale). Tale componente si prefigge il compito di fornire un'interfaccia unica di accesso alle configurazioni per i nostri software e, al contempo, la possibilità di specificare degli override alle singole opzioni fuori dall'applicazione.

Funzionamento del configuratore

Il configuratore, nell'attuale versione 1.0.0, ad ogni richiesta di una qualche configurazione da parte dell'applicativo, esegue le seguenti operazioni:

  1. cerca e carica la configurazione dall'interno dell'applicazione (considerandola come opzione di default)
  2. cerca e carica la stessa configurazione in un percorso esterno, sovrascrivendo eventuali valori omonimi caricati al punto precedente

In questo modo, si ha a disposizione un meccanismo di override che permette di separare le opzioni di configurazione personalizzate dall'applicazione stessa, rendendo più agevoli gli aggiornamenti. Dato che fino alla versione 4.4.1 di DocWay4 le configurazioni erano incluse in toto all'interno dell'applicazione, è necessario spostare gli override effettuati manualmente in precedenza nel nuovo percorso di ricerca, in modo da rendere immediati anche i futuri aggiornamenti.

Percorso di ricerca esterno

A seconda del sistema operativo, il percorso di ricerca delle configurazioni esterno all'applicazione è il seguente:

  • /opt/3di.it/conf/NomeApplicazione su Linux
  • X:\3di.it\conf\NomeApplicazione su Windows 1)

È anche possibile specificare una variabile d'ambiente, TREDI_CONF_ROOT, per forzare un override del percorso di ricerca delle configurazioni (non comprendente NomeApplicazione, ovviamente). Nel caso di applicazione ospitata da Tomcat, tale variabile va specificata nel file bin/setenv.(bat|sh) oppure nel pannello di configurazione del servizio su Windows.

Migrazione delle configurazioni

File di property java (.properties)

I file di property vengono cercati in base al loro nome direttamente all'interno della cartella radice della configurazione dell'applicazione. Per esempio, l'eventuale override del file di property it.highwaytech.apps.xdocway.properties presente in DocWay4-service, verrebbe cercato nel percorso /opt/3di.it/conf/DocWay4-service/it.highwaytech.apps.xdocway.properties (Linux) X:\3di.it\conf\DocWay4-service\it.highwaytech.apps.xdocway.properties (Windows) ${TREDI_CONF_ROOT}\DocWay4-service\it.highwaytech.apps.xdocway.properties (se override della variabile)

Sviluppi futuri

1)
dove X: rappresenta il drive contenente l'applicazione che sta usando il configuratore
/data/attic/documentazione_3di_riservata/docway4/migrazione_configurazioni.1438780196.txt.gz · Ultima modifica: 2017/09/08 10:59 (modifica esterna)