Manuale di Configurazione del modulo xCrossWay

Introduzione

La configurazione del modulo xCrossWay avviene per mezzo di un file xcrwl.conf.xml che deve trovarsi nella solita directory conf che ospita tutti i files di configurazione. Il suo contenuto è facilmente riconducibile ai comuni files INI tipici di Windows pur avendo una conformazione XML.

La configurazione del modulo interessa i seguenti aspetti:

1. Confiugrazione del Proxy
2. Configurazione degli automatismi di Scansione

Confiugrazione del Proxy

Quando il server che ospita l'applicazione xCrossWay si trova alle spalle di un Proxy esso va dichiarato nell'apposita sezione proxy. All'interno di tale sezione devono essere indicati obbligatoriamente l'indirizzo IP (o l'indirizzo logico) della macchina che fa da proxy nella voce di configurazione address ed il numero di porta socket che esso utilizza nella voce di configurazione port. Se previsti possono essere indicati anche l'utente e la password con la quale qualificarsi nelle voci di configurazione usr e pwd.

Vediamo un esempio dell'aspetto che avrebbe il file di configurazione:

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE xwconf SYSTEM "http://www.3di.it/extraway/xwconf_20031128.dtd">
<xwconf>
   <!-- Eventuali altre sezioni -->
   <section name="proxy">
      <profile type="address" value="10.17.61.1"/>
      <profile type="port" value="3128"/>
      <profile type="usr" value=""/>
      <profile type="pwd" value=""/>
   </section>
   <!-- Eventuali altre sezioni -->
</xwconf>

Date

2005/11/23 12:38:45

Torna Introduzione

Configurazione degli automatismi di Scansione

Una volta che l'archvio di xCrossWay è stato alimentato con gli opportuni Target è possibile automatizzare la scansione degli stessi configurando opportunamente alcune sezioni del file di configurazione xcrwl.conf.xml.

In primo luogo si deve creare un elenco di jobs, ovvero lavori di scansione da compiere. Per farlo ci si avvale della sezione agent.jobs entro la quale viene introdotta una voce di configurazione numerica, a partire da 1, il cui valore rappresenta il nome dato al job.

In secondo luogo si creeranno tante sezioni, ognuna avente il nome prescelto nel punto precedente, e si imposteranno le varie caratteristiche di scansione. Esse sono:

• Cosa vogliamo scandire: Indica se intendiamo scandire l'intero archivio, un gruppo di target o un target in particolare. La voce di configurazione è job.mode ed i valori leciti sono all, group o target.
• Identificazione di quello che si intende scandire: Se il precedente valore è stato imposato a group oppure target, questo valore indica il nome del gruppo o del target da scandire. Voce di configurazione job.id
• Su quale archivio vogliamo eseguire la scansione: Tipicamente esiste un solo archivio per l'applicazione xCrossWay ma nulla vieta che si creino due o più archivi (di identica struttura XML) dedicati a target diversi. Ne consegue che con questo parametro si può indicare il nome logico dell'archivio su cui operare. Voce di configurazione job.arcname, valoe di default xcrossway.
• Temporizzazione della scansione: La scansione può essere effettuata ogni X minuti o ad un orario prestabilito della giornata, una volta al giorno.
  Per la prima modalità la voce di configurazione è scan.every ed il valore da impostare è il numero di minuti tra una scansione e la successiva.
  Per la seconda modalità la voce di configurazione è scan.at ed il valore da impostare è il numero dell'ora (ed ventualmente dei minuti nell'ora, separati da un carattere ':') in cui si vuole che quotidianamente abbia luogo la scansione.
• Scansione Forzata: Indica se vogliamo che la scansione avvenga aggiornando, nei Target coinvolti i documenti rilevati anche se essi non risultano aggiornati dall'ultima scansione effettuata. Voce di configurazione scan.forced, accetta tutti i valori booleani positivi (true, si, yes, y, 1) e tutti i valori negativi (false, no, n, 0).

Vediamo un esempio:

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE xwconf SYSTEM "http://www.3di.it/extraway/xwconf_20031128.dtd">
<xwconf>
   <!-- Eventuali altre sezioni -->
   <section name="agent.jobs">
      <profile type="1" value="Global"/>
      <profile type="2" value="Normativi"/>
      <profile type="3" value="Gazzetta"/>
   </section>

   <section name="global">
      <profile type="job.mode" value="all"/>
      <profile type="scan.at" value="00:15"/>
   </section>

   <section name="Normativi">
      <profile type="job.mode" value="group"/>
      <profile type="job.id" value="Normativa"/>
      <profile type="scan.at" value="20:30"/>
   </section>

   <section name="Gazzetta">
      <profile type="job.mode" value="target"/>
      <profile type="job.arcname" value="xcross_gazzetta"/>
      <profile type="job.id" value="Gazzetta Ufficiale"/>
      <profile type="scan.every" value="180"/>
      <profile type="scan.forced" value="true"/>
   </section>

   <!-- Eventuali altre sezioni -->
</xwconf>

Nell'esempio vengono configurati 3 .
Il primo causa la scansione naturale di tutto l'archivio xcrossway ogni giorno a mezzanotte ed un quarto.
Il secondo causa la scansione nell'archivio xcrossway di tutti i Target del gruppo denominato Normativa ogni giorno alle 20:30.
Il terzo causa la scansione del solo Target denominato Gazzetta Ufficiale nell'archivio xcross_gazzetta ogni 3 ore a partire dal momento in cui il servizio viene avviato. La scansione avviene in modo forzoso.

La configurazione delle scansioni automatizzate può essere modificata in qualsiasi momento ed il server si adeguerà. Il comportamento esatto è il seguente:

• Se in partenza del server il file di configurazione xcrwl.conf.xml è assente, la procedura che automatizza le scansioni non parte.
• Se all'atto della partenza del server il file di configurazione xcrwl.conf.xml è presente ma al suo interno non ci sono Jobs configurati o quelli presenti contengono degli errori di configurazione, la procedura che automatizza le scansioni non parte.
• Una volta partita la procedura automatica, avendo trovato almeno un Job correttamente configurato da eseguire, ogni volta che il file di configurazione xconf.stat.xml viene modificato il server ne ricarica in contenuto e quindi più aggiungere, togliere o semplicemente cambiare la configurazione dei Jobs in esso contenuti. Se viene introdotto un errore di configurazione o vengono rimossi tutti i Jobs la procedura automatica rimane attiva ma non operativa. In altri termini attende che venga nuovamente modificato il file di configurazione e ci siano nuovi (o corretti) Jobs da fare. Se però il servizio viene interrotto, in questo caso si torna ad uno dei due punti precedenti.

La corretta partenza della procedura di automatizzazione viene loggata nel file xw.log. Ogni lavoro che viene svolto viene loggato in forma sintetica nel Log Giornale ed in forma estesa nel file xcrwl.log. Ovviamente, tracce di questo si trovano anche nel file xw.log. Questi stessi files vanno consultati, al cambio della configurazione, per verificare che essa sia stata correttamente ricaricata.

Autore:

Tirabassi Roberto

Date

2005/11/23 12:38:45

Torna Introduzione