Linee guida per l'esecuzione dei backup.

Autore:: Tirabassi Roberto

Introduzione

L'esecuzione di un backup valido e fruibile � uno degli aspetti cardine della salvaguardia dei dati di qualsiasi applicazione. eXtraWay, ovviamente, non fa eccezzione in tal senso.

Le applicazioni eXtraWay vanno viste sotto due aspetti:

L'archivio vero e proprio completo di tutte le sue componenti a corredo.
La configurazione dell'ambiente Server nel quale viene usato l'archivio.
L'applicazione Java che ne consente l'utilizzo.

Questa documentazione si prefigge di descrivere solo i primi due punti esposti, indicando come sia opportuno operare per grantirsi di compiere backup corretti e completi.

Prima di scendere nel dettaglio di come vada compiuto il backup di un archivio vale la pena ricordare come vengono normalmente distribuiti i files delle installazioni eXtraWay.

Esiste una directory principale che � quella dove vengono posizionati gli eseguibili. Essa � l'unica per la quale non � indicato un nome obbligatorio ma solitamente assume il nome bin o prg.
Parallelamente ad essa appaiono una serie di altre directory che sono (in grasetto quelle sempre presenti):

collect: Directory che contiene le raccolte, globali e private, generate su tutti gli archivi da parte di tutti gli utenti.
conf: Directory che contiene la configurazione del software usato e degli utenti registrati.
context: Directory che contiene le informazioni di contesto sulla struttura organizzativa che amministra i dati negli archivi.
db: Directory candidata a contenere gli archivi. Essi, in realt�, possono essere dislocati altrove.
logs: Directory dove il server registra i propri logs.
tmp: Directory ove il server scrive i files temporanei in assenza di una valida configurazione delle variabili ambientali TEMP e TMP.
wd: Directory utilizzata dalla procedura automatica di acquisizione documenti negli archivi. Spesso dislocata in altra posizione.

Nota:: Per essere certi che il backup che viene fatto � pienamente affidabile, oltre a definirne i contenuti sulla base dei restanti capitoli, � necessario che il modulo eXtraWay Server sia inattivo in modo da garantirsi che non ci siano disallineamenti tra i files salvati.
Esiste una modalit� di Backup a caldo che non viene attualmente trattata in questo documento.

Il Backup dell'archivio e dell'ambiente server.

Per Backup dell'archivio possiamo intendere quindi la salvaguardia di tutto quello che serve per poter fruire dell'archivio integralmente ma anche quanto necessario per fare operazioni di ripristino o recupero del pregresso.

Abbiamo quindi delle informazioni specifiche del singolo archivio ed altre che si applicano, invece, a tutti gli archivi gestiti da questa particolare installazione del server.

Le informazioni indipendenti dall'archivo

Le informazioni legate all'archivio ma da esso, in qualche modo, indipendenti possono essere viste secondo il seguente schema:

Tutti i files presenti nella directory collect se l'archivio del quale si intende fare un backup prevede l'uso di raccolte. Questo perch� � indisinguibile, dal solo nome della raccolta, a quale archivio essa faccia riferimento. Solo accedendo al contenuto di tali files � possibile conoscere se essi sono pertineti, o meno, l'archivio che ci si accinge a salvaguardare.
Il file xw.ini dalla directory conf. Tale file va salvaguardato perch� in esso, sino a variazione che � in corso di sviluppo, sono indicate informazioni sui separatori utilizzati in indicizzazione che valgono per tutti gli archivi ma al variare delle quali gli indici realizzati per un determinato archivio potrebbero risultare non corretti.
Anche i files con estensione .stp vanno salvaguardati in quanto usati dalle applicazioni come Stop List in fase di ricerca. Dal momento che non hanno un reale impatto sui contenuti degli archivi e che possono cambiare nel tempo senza modificare il comportamento del server (sono meri correttori del comportamento in ricerca) il loro salvataggio non � indispensabile, solo suggerito.
In generale, comunque, � buona norma tenere traccia di tutti i files di questa directory perch� � grazie ad essi viene regolata la vita e l'utilizzo di tutte le componenti che concorrono alle attivit� che possono interessare l'archivio. Ad esempio il file xwwd.conf.xml indica, per ogni archivio, se le procedure di acuisizione documenti debbano prevedere la modalit� update o meno, il file xwgl.conf.xml regola l'avviamento e lo spegnimento di servizi a corredo del server come il File Conversion Agent che consente, unitamente ad un altro servizio, l'indicizzazione dei contenuti testuali degli allegati congiuntamente al documento.
Il contenuto della directory context in quanto descrivono lo stato della struttura organizzativa che gestisce i dati degli archivi.
I files xreg<annomese>.log dalla directory logs. Questi files contengono la storia dettagliata di tutte le operazioni compiute su ogni archivio e consentono, nel tempo, di ricostruire lo stato di qualsiasi documento in ogni sua precedente forma, sino a risalire alla sua forma originaria.
L'iportanza della tutela di questi files � evidente al di l� della decisione di compiere backup di un singolo archivio.

I files dell'archivio

Come annunciato precedentemente, la directory db � quella candidata solitamente a contenere i singoli archivi o insiemi organizzati di archivi.
In realt� nulla vieta che gli archivi vengano dislocati altrove quindi, per sapere esattamente in quale punto l'archivio debba essere cercato, � buona norma consultare il file xw.ini, dalla directory conf, nella sua sezione [Archivi]. In essa pu� essere presente una voce corrispondente al nome logico assegnato all'archivio di nostro interesse e ad essa sar� associato il percorso del file .stat.xml dell'archivio in esame cos� da poter identificare dove esso si trovi.
In assenza di questa dichiarazione, il percorso dato all'archivio, partendo dal suo nome logico �:

<Directory di insallazione programmi>/db/<nome logico archivio>/<nome logico archivio>.stat.xml

Una volta indentificato dove si trova l'archivio ci si deve predisporre a compiere un backup di tutta la directory che lo contiene seguendo le regole ed accorgimenti seguenti.

Esistono archivi che vivono nell'ambito di realt� applicative pi� ampie e complesse e per i quali un backup ha senso se esso viene svolto comprendendo tutti gli archivi coinvolti. In tal caso quanto detto in questo documento va necessariamente preso in considerazione per ogni archivio ed il backup � completo e significativo se compiuto come unico salvataggio di tutti gli archivi identificati.
Esistono esclusioni ed inclusioni all'elenco di files che pu� essere salvato partendo dalla directory. Prima di predisporre un elenco vale la pena di verificare questi aspetti.

Files che possono essere ignorati

La realizzazione di un backup d'archivio pu� prevedere le seguenti esclusioni:

In presenza di una directory <nomearchivio>.chk il suo contenuto pu� essere ignorato. Questi files sono registrazioni temporanee che il server utilizza per sapere quali documenti siano stati impegnati dai vari utenti.
Questi files possono essere integralmente ignorati.
Gli archivi che prevedono degli allegati possiedono, normalmente, una directory <nomearchivio>.file. Essa contiene dei files ed altre directory.
I files presenti direttamente in tale directory sono considerati in parcheggio, quindi in attesa di essere assegnati ad un documento ma non ancora riportati in alcuno di essi. Questi files possono essere ignorati ed anzi possono essere rimossi specie se vetusti. Pu� essere buona norma mantenere in essere quelli pi� recenti perch� potenzialmente in attesa di essere assegnati a qualche documento ancora in fase di salvataggio.
Ogni altro file contenuto nelle directory presenti in quella indicata devono appartenere al backup.

Files che devono essere aggiunti

La ricerca dei files che possono, anzi devono essere aggiunti al backup � un po' pi� delicata, particolare, ma � presto detta.

Un archivio pu� avvalersi di uno o pi� Thesaurus di termini in relazione tra loro. Solitamente questo file viene denominato <nomearchivio>.ths o <nomearchivio>.thv ma non � infrequente che il file venga condiviso con altre applicazioni e quindi trovi posto in una posizione diversa. Il file <nomearchivio>.conf.xml ci mostra dove si trovi tale file.
L'esempio che segue mostra un file .ths collocato nella directory a monte di quella che contiene l'archivio. Anche questo file dovr� far parte del backup.
```
   <thesaurus>
      <th_file th_filename="../common.ths" th_type="ths">
      ...
   </thesaurus>
```
Un archivio pu� aver bisogno di un'estensione rappresentata da una libreria dinamica alla quale richiedere l'esecuzione di speciali operazioni in alcuni momenti della vita utile dell'archivio. Se � vero che solitamente questa libreria si trova assieme all'archivio, in alcune altre occasioni, specie se usata da pi� archivi, essa trova posto in altra directory.
L'esempio che segue mostra un file di configurazione che indica una libreria dinamica dislocata in una directory parallela a quella dell'archivio.
```
   <addon_so path="../bin/nif32"
          cat_init="nifAllocEK"
          cat_add="nifAddEK"
          cat_get="nifGetEK"
          cat_end="nifFreeEK"
          load_doc_filter="nifLoadDoc"
          search_translator="nifSearchTranslator"/>
```
Nota:
In questi casi gli eventuali files a corredo della libreria dinamica (files di configurazione e simili) si trovano tutti nella stessa directory della libreria. Essi vanno quindi inclusi nel backup ma in casi simili pu� essere buona norma richiedere a 3D indicazioni di dettaglio per quella specifica libreria dinamica.
Un archivio pu� essere progettato per avere tutti gli XML che compongono i suoi dati in una unica directory (solitamente quella che si trova nella directory che contiene l'archivio e che ne porta lo stesso nome). In tal caso si � ragionevolmente certi che il backup della directory dell'archivio, ed ovviamente di tutte le subdirectories, comprende automaticamente tutti i dati.
Se per� l'archivio in esame non ha questa caratteristica perch� � stato creato componendo il catalogo con files dispersi sul disco in altre posizioni oppure si ha un qualche regionevole dubbio che almeno un file non sia nella posizione canonica, � opportuno fare una verifica per mezzo del Viewer. Essa pu� essere eseguita accedendo alla ricerca sull'archivio e consultando il vocabolario del canale di ricerca noto come
```
UD,/xw/FileId/@FileName 
```
. Questo vocabolario, solitamente, contiene dei percorsi di files che sono relativi alla directory descritta precedentemente, quindi tutti percorsi che devono iniziare senza uno dei caratteri '/' o '\' anche se preceduti da uno o pi� punti. In altre parole, valutando il contenuto di questo vocabolario di dovrebbe comprendere se ci sono files che non rispettano la distribuzione standard ed includere le directory cos� identificate nel backup.
Quando detto per il files XML che componogo l'archivio pu�, pu� sovente, applicarsi agli allegati. Essi si trovano nelle directory dell'archivio secondo una distribuzione articolata che varia al variare della versione del server ma possono trovarsi anche altrove. Identificare tutte le possibilit� richiede due verifiche.
La prima verifica va fatta sul contenuto del vocabolario del canale
```
XML,//<nome_primary_node>//xw:file/@name 
```
che dev'essere alimentato con semplici id di allegato o con percorsi relativi o assoluti. La radice dei percorsi relativi � la directory <nomearchivio>.file contenuta in quella che contiene gli archivi quindi, se i percorsi relativi sono espressi con prefisso './' essi possono essere ignorati. Vanno quindi identificate tutte le directory non comprese in quelle dell'archivio prendendo in esame i percorsi relativi ed ancor pi� i percorsi assoluti.
La seconda verifica consiste nel nel verificare se esistono directory alternative ove cercare gli allegati. Esse vanno ricercate nel file di configurazione. La questione � di una certa complessit� ed ha subito modifiche nel corso del tempo per cui si suggerisce di prendere visione del documento Trattamento degli Allegati che descrive nel dettaglio come possono essere distribuiti gli allegati di un archivio e come identificare di conseguenza le directory che pu� essere necessario comprendere nell'elenco dei files di cui fare backup.

Date: 2007/01/30 12:13:07

Back to Indice delle voci