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