ReadMe_migrazione_121380

Migrazione ACG Express dalla versione 1.2.1 alla 3.8.0
(Ultimo aggiornamento: 3 Ottobre 2008)
Introduzione
In questo documento sono descritte le principali caratteristiche della procedura di migrazione di
ACG Express che porta il prodotto dalla versione 1.2.1 alla versione 3.8.0.
NOTA IMPORTANTE: il livello di PTF della versione di partenza deve essere quello
corrispondente alle PTF GAJ121004. L’installazione di tali PTF porta il database ad un livello
identificato con “V01R02M013”, informazione presente nell’area dati RELMIG delle tre librerie
del Sistema Informativo. Questa informazione sarà comunque visualizzata automaticamente prima
di avviare la procedura di migrazione.
Come per ogni altra migrazione del database si fornisce un’informazione fondamentale:
L’adeguamento delle libreria dei dati dal livello 1.2.1 al livello 3.8.0 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.
Note sul livello di DB2
L’utente che migra ACG Express da 1.2.1 a 3.8.0 non ha la necessità di installare la nuova
versione del DB2 9.5, ma potrà rimandare tale operazione ad un momento successivo.
Non occorre pertanto tenere conto del prerequisito indicato per ACG Express 3.8.0 che si
intende rivolto a nuove installazioni.
Passi per l’adeguamento di livello
Il passaggio dalla versione 1.2.1 alla versione 3.8.0 implica l’installazione della nuova applicazione
ACG Express 3.8.0. Il database verrà adeguato con la procedura di seguito descritta.
o Installazione di ACG Express 3.8.0 (installazione da CD) in una cartella diversa da quella della
versione 1.2.1. Per questo seguire quanto indicato sulla guida all’installazione
o Applicazione della PTF COJ380001 (che contiene alcune modifiche necessarie alla migrazione)
o Sostituzione del driver jdbc per la versione 8.x del DB2 nella Console:
quando si installa il prodotto da CD si può notare che nella cartella “Database\libs” esistono
altre due sottocartelle che contengono i driver jdbc del DB2 per la versione 9.5 e la versione 8.x.
Poiché in questa fase si vuole lavorare ancora con il driver jdbc della versione 8.x del DB2 è
necessario sostituire gli oggetti relativi al driver per la 9.5 con quello della 8.x. Per tale
operazione eseguire i seguenti passi:
1

o
o
o
o
o
o
o
Entrare nella cartella “Database\libs” della cartella di installazione della nuova Console
di Amministrazione ACG Express 3.8.0
 Eliminare i file così denominati: “db2jcc.jar” e “db2jcc_license_cu.jar”
 Entrare nella cartella “db2_driver_8.2”
 Copiare il file “db2jcc.jar” nella cartella “Database\libs”
Avvio della nuova Console
Deployment di una nuova applicazione web 3.8.0 (con un nome diverso da quello usato per la
1.2.1)
Sostituzione del driver jdbc, analogamente a quanto fatto per la console (all’interno del percorso
<WEB_APPLICATION>/WEB-INF/lib (dove WEB_APPLICATION è il percorso
dell’applicazione web appena installata)
Effettuare la configurazione del system.xml.properties della nuova applicazione web indicando i
parametri di connessione al database con l’apposito tool di configurazione messo a disposizione
dalla Console (il file system.xml.properties non va sostituito con quello della 1.2.1) .
Prevedendo di effettuare una migrazione si dovranno indicare le informazioni relative al
database da migrare; tipicamente l’indirizzo IP della macchina in cui risiede il database, la
relativa porta, utente e password di accesso al db.
Si consiglia di impostare a “Debug” il parametro “Default trace level” nella pagina “logging”.
Ciò permetterà di individuare meglio eventuali anomalie da comunicare al supporto nella fase di
migrazione
NOTA: Una volta terminata e verificata la migrazione sarà opportuno impostare tale parametro
a “Error”
Tramite la nuova Console applicare la PTF GAJ380001 che contiene alcuni oggetti utili alla
migrazione
Applicare della PTF ACJ380001 (che contiene una versione più aggiornata della framework
Caravel™)
A questo punto si può effettuare la migrazione attenendosi a quanto indicato del paragrafo
“Dettagli relativi alla migrazione”
Dettagli relativi alla migrazione
Per quanto riguarda la migrazione si fornisce anche in questa sede un’informazione fondamentale:
L’adeguamento delle libreria dei dati dal livello 1.2.0 al livello 1.2.1 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, dopo aver eseguito i passi di adeguamento descritti in precedenza,
occorre eseguire i seguenti passi:
o back-up dei database utilizzati con la versione 1.2.1 del prodotto (utilizzare le apposite funzioni
di DB2) che si vogliono migrare
o Avvio della Console di Amministrazione 3.8.0. Nella pagina di login indicare
2

Percorso di “caravel.xml.properties” e system.xml.properties” relativi all’applicazione a
versione 3.8.0 appena installata associata al database da migrare
 Percorso della cartella “data” all’interno della nuova Console 3.8.0 appena installata e
aggiornata (dove sono presenti le strutture necessarie alla creazione del nuovo database)
 Effettuare l’operazione di “Login” e attendere il messaggio di accesso avvenuto. A
questo punto sarà disponibile la pagina “Migrazione”
o 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ò o deve essere
migrato.
NOTA: verranno indicati come migrabili solo i database che hanno il livello V01R02M013. I
Sistemi Informativi non migrabili dovranno essere aggiornati seguendo i passi delle precedenti
migrazioni pubblicate per la 1.2.1, utilizzando la relativa Console 1.2.1
o Usare il bottone di avvio della procedura di migrazione e tenere presenti i messaggi
eventualmente visualizzati dalla procedura
o 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 le seguenti azioni:
o caricamento delle librerie di migrazione (MIG e MIG121380)
o lettura del file MIG_FLUSSO per la migrazione di tutti i file modificati
o esecuzione del programma FILUPDATE che esegue alcune particolari operazioni direttamente
sui dati già migrati
Principali oggetti e concetti utilizzati dalla procedura


L’elenco degli archivi oggetto di migrazione si trova sul file MIG_FLUSSO (utilizzato dalla
procedura) ed è consultabile nella cartella Database\data\MIG121380\df\data della
Console
Oltre alla migrazione del database intesa come modifica delle strutture degli archivi e
ripristino dei vecchi dati, vengono effettuate alcune operazioni di seguito elencate:
 File tabelle (ASTA300F e ANTA300F): vengono aggiunte a quelle preesistenti le tabelle
nuove della 380
 Exit (AEXT200F): vengono aggiunte a quelle preesistenti le tabelle nuove della 380
 Aggiornamento di alcune Aree dati
 Azioni, Menu e Kpjbu: vengono sostituiti i record modificati e aggiunti i nuovi
La migrazione effettua inoltre le seguenti operazioni:
 Sostituzione della libreria ACG_OBJV3 con le DS del prodotto e il dizionario dati
DIZACGV3 (l’operazione richiede alcuni minuti)
 Sostituzione delle librerie APPL, IVALP330002
 Sostituzione dei file messaggi ACGMSG e GAAMSG
 Caricamento del file IPROD00F con il nuovo elenco dei moduli presenti in ACG
Express 380
3