ReadMe_integrazione_380380A

Migrazione ACG Express per Cespiti
(Ultimo aggiornamento: 28 Gennaio 2010)
Introduzione
In questo documento sono descritte le principali caratteristiche della procedura di migrazione di
ACG Express che esegue una serie di modifiche alle tabelle usate dal modulo Cespiti le cui
modifiche sono nella PTF CE380001.
Occorre installare le PTF legate a questa migrazione nel seguente ordine:
COJ380009
GAJ380010 (l’installazione di questa PTF esegue automaticamente l’installazione anche di
CE380001 e ACJ380007.
A questo punto sarà possibile eseguire i passi di migrazione indicati di seguito in questo
documento.
NOTA IMPORTANTE: si presume che sia installato il prodotto ACG Express 380 pubblicato il
26 Febbraio 2009.
Dettagli relativi alla migrazione
Per quanto riguarda la migrazione si fornisce anche in questa sede un’informazione fondamentale:
La migrazione dei dati può essere eseguita soltanto se l’utente effettua il back-up del database
di partenza utilizzando le funzioni proprie del DB2.
La procedura di migrazione avverte l’utente chiedendo se abbia effettuato il back-up dei dati
ma NON ESEGUE ALCUNA OPERAZIONE AUTOMATICA DI SALVATAGGIO.
L’operazione di back-up dei dati è dunque fondamentale anche perchè la procedura di
migrazione non recupera i dati precedenti in caso di malfunzionamento.
Nel caso si venga a creare una situazione di errore durante la procdeura di migrazione, una
volta individuate le cause del malfunzionamento e dopo aver effettuato le correzioni dovute, la
procedura dovrà essere chiamata di nuovo a partire dal database salvato in precedenza.
Per effettuare la migrazione occorre eseguire i seguenti passi:
o Come già detto eseguire il back-up del database da migrare (utilizzare le apposite funzioni di
DB2)
o Assicurarsi che nessun utente utilizzi l’applicazione
o Nel file log4j.properties che si trova all’interno della cartella di installazione della Console di
Amministrazione ACG Express, fare in modo che risulti: log4j.threshold=[All]
o Avvio della Console di Amministrazione 3.8.0 dalla quale è stata effettuata l’installazione delle
PTF. Nella pagina di login:
 Impostare il percorso di “caravel.xml.properties” e system.xml.properties”. Si consiglia
di effettuare la configurazione del file system.xml.properities modificando, per la sola
fase di migrazione, l’impostazione “Debug” nei campi in cui viene richiesto il tipo di
log da produrre: uno si trova nella pagina Logging a livello delle impostazioni di
sistema; l’altro si trova nella pagina Logging relativa alle impostazioni dell’applicazione
 Percorso della cartella “data” all’interno della Console Express
1

o
o
o
o
Effettuare l’operazione di “Login” e attendere il messaggio di accesso avvenuto. A
questo punto sarà disponibile la pagina “Migrazione”
Nella pagina “Migrazione” sarà visualizzato l’elenco dei Sistemi Informativi (ognuno con la
propria terna di librerie) presenti sul database: selezionare uno di quelli che può e deve essere
migrato.
NOTA: verranno indicati come migrabili solo i database che hanno il livello V03R08M005
oppure V03R08M006 e non superiori. (Eventuali Sistemi Informativi non migrabili, con livelli
di adeguamento minori, potranno essere aggiornati seguendo i passi delle precedenti migrazioni,
affinchè il livello della terna sia V03R08M006)
Usare il bottone di avvio della procedura di migrazione e tenere presenti i messaggi
eventualmente visualizzati dalla procedura
Il tempo richiesto per la migrazione dipende dal tipo di macchina utilizzata e dalla quantità di
dati presenti nel database
La procedura di migrazione effettua a grandi linee le seguenti azioni:
 caricamento delle librerie di migrazione (MIG e MIG380380A)
 lettura del file MIG_FLUSSO per la migrazione di tutti i file modificati. In particolare:
 Salva i dati presenti nelle tabelle da migrare in formato ixf
 Cancella e ricrea le tabelle: ADDALDAT, FABOOKPTOT, FARECODE,
DUALPURPAT, STORPROM (tabella nuova)
 Ripristina i dati precedentemente salvati, nelle nuove tabelle create
 aggiornamento delle aree dati RELMIG delle librerie migrate con il valore
V03R08M00A
Si informa che i log relativi alla migrazione possono essere reperiti in varie locazioni a seconda del
tipo di informazione che si vuole avere: nelle cartelle “log” e “Database\errors” all’interno della
cartella di installazione di ACG Express (Console di Amministrazione), e nella cartella indicata
nell’apposita sezione del system.xml.properties dell’applicazione usata per lanciare la migrazione.
Qualora la migrazione avvenisse con esito negativo sarà opportuno utilizzare i log prodotti come
documentazione da inviare al supporto ACG Express, all’atto dell’apertura della segnalazione di
errore, qualora non sia stato possibile risalire al problema.
Si consiglia di migrare un Sistema Informativo alla volta e di uscire dalla Console di ACG Express
ogni volta che si conclude la migrazione di un Sistema Informativo.
E necessario effettuare sempre e comunque anche la migrazione della terna di librerie DAT, COM e
GRP.
Se usate, dovranno essere migrate anche le terne di librerie di demo.
2