Sistemi IBM Open Power e IBM xseries

Transcript

1 Sistemi IBM Open Power e IBM xseries ACG Express Applicazioni Contabili Gestionali Guida Applicativa Console Amministrativa Questo documento è pubblicato sul seguente indirizzo si consiglia di verificare periodicamente la pubblicazioni di aggiornamenti

2 Copyright IBM Corp. 2005, 2006 Questa guida si riferisce alla Versione 3 Rilascio 8 livello di modifica 0 ACG Express Console Amministrativa. Java and all Java-based trademarks are trademarks of Sun Microsystem, Inc. in the United States, other counties, or both. Il software "Caravel Core Classes" e la tecnologia Caravel che vengono installati come parte del prodotto ACG Express, sono proprietà della TransTOOLS, S.A., sono protetti dal corrispondente Copyright. 2

3 Indice 1. INTRODUZIONE CARATTERISTICHE GENERALI AVVIAMENTO DI ACG EXPRESS Avvio della Console in ambiente Windows Avvio della Console in ambiente Linux Deployment dell applicazione Registrazione della licenza della framework e inserimento parametri WebSphere Application Server Impostazioni relative alla memoria utilizzata da Websphere Creazione del database DB2 e Application Server sulla stessa macchina DB2 e Application Server su macchine diverse DB2 in ambiente Windows DB2 in ambiente Linux Ripristino dei database Passo 1: parametri di connessione al database Passo 2: ripristino dei database applicativo e di sistema LE ALTRE FUNZIONALITÀ DELLA CONSOLE AMMINISTRATIVA Login Configurazione del client della Framework di sistema Client Configuration Viewer Configurazione del Server della Framework di sistema Server Configuration Viewer Locazione del modello del database di prodotto (directory Data) Utente per la connessione Azione di Login Restore dei database (Restore DB) Restore dei database iniziali Restore di una singola libreria applicativa Restore di un singolo oggetto applicativo Salvataggio dei database (Salva DB) Salvataggio dei database del prodotto Salvataggio di una libreria applicativa Salvataggio di un singolo oggetto applicativo

4 4.4 Creazione Libreria Applicativa Creazione struttura multi azienda (Librerie Dati) Password Installazione delle correzioni (PTF) Migrazione Menu della Console Amministrativa COMMENTI E COMUNICAZIONI

5 1. Introduzione Lo scopo di questa guida è descrivere le principali caratteristiche applicative e operative del prodotto ACG Express Console Amministrativa versione 3 rilascio 8 livello di modifica 0. La guida potrà essere utilizzata sia per completare l installazione del prodotto ACG Express che per eseguire alcune funzionalità di supporto al suo funzionamento. La guida contiene due capitoli fondamentali: Avviamento di ACG Express: dove sono descritti i passi da effettuare per poter rendere operativo il prodotto (deployment, creazione e caricamento dei database, codici di autorizzazione) Le altre funzionalità della Console Amministrativa: dove sono descritte le funzioni che sono necessarie per poter utilizzare il prodotto (creazione di ambienti applicativi, caricamento delle correzioni, atc.). 5

6 2. Caratteristiche generali L installazione della Console Amministrativa sul sistema avviene contestualmente alla prima fase d installazione di ACG Express eseguita dal CD fornito da IBM. Il prodotto ACG Express Console Amministrativa contiene un insieme di funzionalità che hanno l obiettivo di gestire l installazione dei database del prodotto e di fornire all utente le funzioni di amministrazione comuni ai vari moduli applicativi. Vale la pena, a questo punto, fare un breve accenno all architettura di ACG Express, per poter spiegare perché è necessario fornire certe informazioni durante la fase di avviamento del prodotto. ACG Express si basa su una Framework di sistema costruita con il software Caravel Core Classes e la tecnologia Caravel. E possibile definire il comportamento a run time della Framework impostando alcuni parametri di configurazione attraverso le funzionalità messe a disposizione dalla Console Amministrativa. La Framework, in generale, consente di impostare un architettura Client-Server nella quale più parti client chiedono servizi ad un unica parte server, dove le parti client e le parti server potrebbero risiedere su processi separati oppure coesistere nello stesso processo. E per questo che nella Console Amministrativa i parametri di configurazione sono suddivisi tra parte client e parte server. In particolare, nel caso di questo rilascio di ACG Express il processo client e il processo server della Framework coesistono nello stesso processo. Le funzioni messe a disposizione dell utente con ACG Express Console Amministrativa sono le seguenti: Deployment dell applicazione web: consiste nell installazione dell applicazione web all interno dell Application Server IBM WebSphere Impostazione dei parametri di configurazione delle parti client e server della Framework di sistema: consente di modificare le informazioni presenti nei relativi file xml attraverso un interfaccia grafica Database: consiste nella dichiarazione dell istanza del database che dovrà essere utilizzata per la creazione dei database Creazione dei database dell applicazione: consiste nella creazione dei database indicati nel file di configurazione della Framework. Di default per ACG Express vengono creati i database di sistema e applicativo: LEOSYS e LEONARDO Ripristino dei database dell applicazione: consiste nel popolamento dei database creati precedentemente, ovvero nella creazione delle tabelle e nel caricamento di una serie di dati Installazione del database di demo: ACG Express distribuisce un database con un insieme di dati di prova che possono essere usati dall utente per effettuare prove di utilizzo Inserimento codice di autorizzazione dei prodotti applicativi: ogni modulo applicativo che fa parte di ACG Express ha bisogno di un codice di autorizzazione per poter andare in esecuzione. Tale funzionalità consente di caricare sul sistema i codici di autorizzazione forniti da IBM per ciascun modulo Salvataggio/Esportazione del database dell applicazione o di sue tabelle/librerie: consente di effettuare un salvataggio su disco dell intero database, di una singola libreria o di oggetti singoli del database Creazione di una libreria applicativa : consiste nella creazione di uno schema di database che conterrà le Azioni e i Menu di Modulo Base (vedi la corrispondente Guida 6

7 Applicativa) dell ambiente applicativo relativo. Tale libreria potrebbe essere utilizzata anche per contenere i dati aziendali Creazione di una struttura multi azienda: consiste nella definizione di una terna ordinata di schema che rappresentano, nell ordine, i dati di un azienda (libreria aziendale), i dati comuni a più aziende (libreria comune), i dati che possono contenere contemporaneamente dati di più aziende (libreria di gruppo) Installazione di correzioni/aggiornamenti di prodotto (PTF): consiste nell installazione degli aggiornamenti di ACG Express. Installazione di singoli prodotti: consiste nell installazione di singoli prodotti rilasciati successivamente. 7

8 3. Avviamento di ACG Express Questa parte della guida deve essere consultata da chi ha appena eseguito la prima fase di installazione di ACG Express da CD (si veda la guida all installazione) e deve eseguire la seconda fase di installazione, che indicheremo come fase di avviamento. Anche se i passi di avviamento sono descritti in dettaglio nei paragrafi che seguono nella Guida, viene riportata una tabella riassuntiva di tali passi. NOTA: la tabella si riferisce al caso più semplice in cui il DB2 sia installato sulla stessa macchina in cui è installato WebSphere (e quindi l applicazione web ACG Express): 8

9 Passo Azione Istruzioni/Commenti 1 Avviare la console Windows : Console da Start/Programmi/ACGExpress Linux: Lancio dello script./console_acgj.sh 2 Avviare l Application Server WebSphere 3 Deployment (pagina Applicazioni della Console). Consiste nell installazione dell applicazione all interno dell Application Server 4 Avviare l applicazione web appena installata dalla console di WebSphere 5 (W) Creazione dei database di ACG Express in ambiente Windows: Consiste nella creazione dei database LEONARDO (applicativo) e LEOSYS (di sistema) 5 (L) Creazione dei database di ACG Express in ambiente Linux: Consiste nella creazione dei database LEONARDO (applicativo) e LEOSYS (di sistema) 6 Restore DB. Consiste nella creazione delle tabelle, delle viste e degli indici propri di ACG Express nei database creati nei passi precedenti 7 Login alle funzioni della Console Amministrativa 8 Immissione delle password dei moduli applicativi Immettere: il nome che si vuole dare all applicazione ACG Express che verrà installata la locazione del file acg-express.war (che si trova nella directory di installazione di ACG Express) la home directory di WebSphere il nome dell Application Server il nome del nodo dell Application Server e attendere il messaggio di completamento. Se necessario, creare un istanza di DB2 utilizzando il comando db2icrt Prendere nota di Nome dell istanza del DB2 Nome dell utente associato all istanza e la sua password Disco su cui si trova l istanza Utilizzare la pagina DB2 della Console Amministrativa, dove vanno utilizzati alcuni dei dati annotati Se necessario, creare un istanza di DB2 utilizzando il wizard grafico del DB2 (lanciare lo script $DB2DIR/instance/db2isetup da root) Prendere nota di Nome dell istanza del DB2 Nome dell utente associato all istanza e la sua password (Es. db2acgj) Nome del gruppo di appartenenza (Es. db2grp) Nome della home directory (Es. /db2home/db2acgj) Numero della porta su cui è in ascolto l istanze del DB2 creata, l utente, la password Utilizzare la pagina DB2 della Console Amministrativa, dove vanno utilizzati alcuni dei dati annotati Pagina Login: Selezionare caravel.xml.properties Selezionare system.xml.properties Configurare di system.xml.properties Selezionare directory Data Pagina Restore DB Selezionare DB applicativo e DB di sistema Lanciare tasto Restore DB Attendere messaggio di fine Dalla pagina di Login, utilizzare il tasto Login per rendere operative le altre funzionalità della Console Amministrativa Richiedere a IBM i codici di autorizzazione all uso: verranno forniti con un file di testo Dalla pagina Passwords indicare la locazione del file di testo 9

10 3.1 Avvio della Console in ambiente Windows In ambiente Windows la prima fase dell installazione crea il meanu ACG Express nel menu Start/Programmi di Windows Da questa voce è possibile selezionare la sottovoce Console che consente di utilizzare tutte le funzionalità messe a disposizione da ACG Express Console Amministrativa. Verrà visualizzato il pannello principale dell applicazione. 3.2 Avvio della Console in ambiente Linux In ambiente Linux la console (che è un tool grafico) deve essere avviata attraverso i seguenti passi: Effettuare il login come utente root Verificare il contenuto della variabile LANG con il comando: echo $LANG Se il contenuto della la variabile differisce dal valore en_us.utf-8 ed è installato un sistema operativo in inglese, eseguire il comando: export LANG=en_US.UTF-8 se invece è installato un sistema operativo in italiano, eseguire il comando: export LANG=it_IT.UTF-8 Posizionarsi nella directory di installazione di ACG Express (il comando di default è: cd /opt/acgexpress ) Lanciare la console con il comando:./console_acgj.sh Verrà visualizzato il pannello principale dell applicazione. NOTA: Qualora vi fossero problemi con l esecuzione dello script verificare i relativi permessi di esecuzione dello script a livello di sistema operativo. 10

11 3.3 Deployment dell applicazione Questo passo costituisce l installazione del prodotto all interno dell Application Server IBM WebSphere che, come precisato nel documento che riguarda la prima fase dell installazione, costituisce un prerequisito di ACG Express. AVVERTENZA: Prima di procedere con il deployment dell applicazione web sotto Websphere, verificare che l Application Server sia stato avviato. Il pannello che viene visualizzato con l avvio della console amministrativa, mostra una cartella con più pagine. La prima pagina visualizzata è quella dal titolo Login e consente di accedere a tutte le funzioni della Console Amministrativa che utilizzano i database. Poiché si sta effettuando una prima installazione e i database non sono popolati,le altre funzioni della Console non sono accessibili. La prima operazione che deve essere fatta a questo punto è il deployment dell applicazione in IBM Websphere Application Server. Questa operazione è possibile dalla pagina intitolata Applicazioni. 11

12 Immettere le informazioni richieste come segue: Nome applicazione web: indicare il nome che si intende dare all applicazione all interno dell Application Server (il nome deve essere univoco). Il nome dato creerà la cartella Nome_applicazione.ear, all interno della quale verrà installata l applicazione vera e propria Percorso dell applicazione (file.war): indicare il percorso in cui è reperibile il file acg-express.war (ovvero l applicazione web da installare) Di default viene caricato il percorso dell applicazione contenuta nella directory Repository della directory di installazione del prodotto ACG Express. Per selezionare un altro eventuale percorso utilizzare il pulsante Cerca. HOME directory dell Application Server: indicare la directory di installazione dell Application Server (per esempio C:\Programmi\IBM\WebSphere). Per selezionare la directory utilizzare il pulsante Cerca. (Prima di selezionare il percorso verificare che l Application Server sia stato avviato) Nome del server: viene visualizzato il nome dell Application Server. Qualora esistessero più Application Server allora verrebbe reso operativo il pulsante che consente di selezionare un altro server Nome del nodo: viene visualizzato il nome del nodo in cui risiede l applicazione web.. Qualora esistessero più nodi allora verrebbe reso operativo il pulsante che consente di selezionare un altro nodo Dopo aver riempito i campi del pannello è possibile utilizzare il pulsante Deploy per avviare il deployment dell applicazione. Tale operazione potrà richiedere qualche minuto di tempo. Attendere il messaggio di completamento. Dando l OK verrà visualizzato il log delle operazioni effettuate per fare una verifica del suo corretto completamento. NOTA: una volta effettuato il deployment dell applicazione sarà possibile avviarla dalla console di WebSphere. 3.4 Registrazione della licenza della framework e inserimento parametri WebSphere Application Server Dopo aver eseguito il deployment dell applicazione web occorre registrare la licenza della framework, il numero e la chiave della licenza vanno richiesti utilizzando la procedura presente sul sito sezione password. cliccare sull icona che si trova nel pannello di Login della console, affianco al bottone Configura relativo al file system.xml.properties. 12

13 Verrà visualizzato il seguente pannello: LA REGISTRAZIONE PUO AVVENIRE IN DUE MODALITA : ON-LINE (CON CONNESSIONE AD INTERNET) OPPURE OFF-LINE. PARAMETRI OBBLIGATORI NECESSARI PER ENTRAMBE LE MODALITA DI REGISTRAZIONE Cartella di output indica la cartella/directory in cui verranno generati i file relative alla licenza, utilizzare il bottone Sfoglia per selezionarla. Licenza nr indica il numero di licenza ricevuto a seguito della richiesta. Chiave nr indica la chiave della licenza ricevuta a seguito della richiesta. Azione selezionare REGISTER per la prima registrazione. Qualora ci siano future modifiche alla framework che comportino il rilascio di una nuova versione sarà necessario eseguire l aggiornamento della licenza della framework selezionado UPDATE anzichè register. Nel caso si voglia annuallare una registrazione selezionare la voce UNREGISTER. L installazione di piu applicazioni web sullo stesso server comporta una sola registrazione. 13

14 Se si desidera eseguire la registrazione on-line premere Bottone OK ed attendere il messaggio di completamento. NOTA: Si consiglia di mantenere i dati relativi alla licenza (numero e chiave) per poter eseguire in futuro operazioni di aggiornamento o reinserimento della licenza stessa. SI CONSIGLIA DI UTILIZZARE LA MODALITA ON-LINE Qualora la registrazione on-line non fosse possibile utilizzare la modalità off-line selezionando la checkbox Reg. off-line. La checkbox Reg. off-line consente di eseguire la registrazione della licenza off-line (senza connessione ad internet) in due fasi, abilitando questa voce vengono visualizzati altri due parametri: PRIMA FASE o o o o Impostare il campo Cartella di output come indicato sopra. Impostare il campo Licenza nr. come indicato sopra. Impostare il campo Azione come indicato sopra. Output file con codice licenza: impostare il path della cartella in cui verrà generato il file code.txt contenente i dati necessari per la registrazione della licenza e premere OK. Ottenuto questo file sara necessario allegarlo alla chiamata per richiesta password che occorrera aprire attraverso il sito RICEVUTO IL FILE (key.txt ) CON LA CHIAVE DI REGISTRAZIONE PASSARE ALLA SECONDA FASE 14

15 SECONDA FASE o o o Impostare il campo Cartella di output come indicato sopra. Impostare il campo Azione come indicato sopra. - Input file con chiave di registrazione: Ottenuto il file con la chiave di registrazione (key.txt) e premere il bottone OK ed attendere il messaggio di completamento. Terminata la procedura di registrazione (sia on-line che off-line) occorre riportare il percorso della cartella/directory contente i file con i dati della licenza nel file di configurazione system.xml.properties, potete utilizzare l apposita funzione descritta nel capitolo Configurazione del Server della Framework di sistema (il pannello specifico per tale funzione è il License Validation del tool di configurazione ). 15

16 3.5 Impostazioni relative alla memoria utilizzata da Websphere Si raccomanda di modificare i parametri di WAS relativi alla gestione della quantita di memoria riservata alla JVM (Dimensione di heap massima), come indicato nelle immagini seguenti per evitare di incappare nell errore : Exception in thread "main" java.lang.outofmemoryerror: Java heap space WAS 6.x La dimensione impostata è in relazione alla quantita fisica di memoria installata nella macchina ed in particolare una corretta impostazione della dimensione heap iniziale riduce il sovraccarico della raccolta di dati inutilizzati, migliorando il tempo di risposta e la velocità di elaborazione del server. Se il valore è troppo basso, il server potrebbe fornire scarse prestazioni dovute al sovraccarico di un elevato numero di raccolte di dati inutilizzati minori. Se il valore è troppo elevato, l'utilizzo della memoria verrà sottodimensionato. Una corretta impostazione della dimensione heap massima riduce il sovraccarico della raccolta di dati inutilizzati mentre si controlla la capacità del server di soddisfare la richiesta di realizzazione di nuovi oggetti. Se il server non dispone di ulteriore memoria nell'heap e ciò non è causato da un malfunzionamento, potrebbe essere necessario aumentare questo valore. Se il valore è troppo basso, il server 16

17 potrebbe fornire scarse prestazioni dovute al sovraccarico di un elevato numero di raccolte di dati inutilizzati minori oppure avere spazio insufficiente per soddisfare la richiesta. Se il valore è troppo alto, la JVM (Java Virtual Machine) potrebbe impegnare della memoria che sarebbe meglio utilizzata da altri componenti nel sistema. Salvare le modifiche della configurazione e procedere al riavvio del server WAS. 3.6 Creazione del database Una volta effettuato il deployment dell applicazione si devono creare i database utilizzati da ACG Express. Prima di ciò è necessario avere a disposizione un istanza del DB2 in cui creare i database di ACG Express. Di seguito vengono riportate alcune indicazioni in merito, per gli ambienti Windows e Linux. Fare comunque riferimento alla documentazione del DB2 e alle informazioni presenti sui siti ufficiali IBM per maggiori dettagli. Ambiente Windows Di default in windows viene creata un istanza denominata DB2 qualora si volesse creare una nuova istanza di database è necessario utilizzare la console del DB2 e lanciare il comando db2icrt fornendo in particolare il nome dell istanza da creare, la porta sulla quale tale istanza sarà in ascolto e il nome di un utente. Ambiente Linux In questo caso DB2 mette a disposizione un tool grafico di creazione di un istanza. Questo è attivabile attraverso il lancio dello script $DB2DIR/instance/db2isetup, da root, dove $DB2DIR rappresenta la directory d installazione del DB2 (es. /opt/ibm/db2/v8.2). Durante l esecuzione di questo tool verrà richiesto: Il nome di un utente (per esempio db2acg) Il nome del gruppo di appartenenza (per esempio db2grp) la home directory (per esempio /db2home/db2acg) il numero della porta sulla quale, per quell istanza, è in ascolto il DB2 In entrambi gli ambienti si consiglia di annotare il nome dell istanza, la porta di ascolto, il nome e la password dell utente, la locazione dell istanza (nel caso di Windows il disco sul quale risiede l istanza; nel caso di Linux il percorso dell istanza). Tali informazioni saranno utili nei successivi passi di avviamento di ACG Express. Una volta creata o individuata l istanza del DB2 che dovrà essere considerata, si dovranno creare i database di ACG Express. Per fare questo si potranno usare due metodi diversi a seconda che il DB2 sia installato sulla stessa macchina dell Application Server oppure su una macchina diversa. I paragrafi seguenti entreranno nel dettaglio dei due casi. 17

18 Alla fine risulteranno creati i due database denominati LEOSYS e LEONARDO nell istanza del DB2 presa in considerazione DB2 e Application Server sulla stessa macchina Nel caso in cui il DB2 sia sulla stessa macchina dell Application Server si può utilizzare la pagina DB2 della Console Amministrativa: In questa pagina: Selezionare l istanza del DB2 che si vuole usare Immettere il nome dell utente proprietario dell istanza ora selezionata In ambiente Windows: Selezionare il disco sul quale è presente l istanza del DB2 selezionata In ambiente Linux: selezionare il percorso in cui si trova l istanza del DB2 selezionata Utilizzare il tasto Crea DB per procedere alla creazione dei database In questa fase vengono creati due database: LEONARDO, che è il database applicativo LEOSYS che è il database di sistema, ovvero l insieme delle tabelle che memorizzano oggetti di gestione del sistema, quali: code messaggi, code di stampa, code dati, profili utente, etc. 18

19 3.6.2 DB2 e Application Server su macchine diverse Se il DB2 risiede su una macchina diversa da quella dell Application Server è possibile creare i database di ACG Express attraverso delle operazioni che richiedono qualche intervento manuale da parte dell utente, secondo quanto riportato di seguito. Nella directory Database della directory di installazione di ACG Express, sono presenti i seguenti file: Modello_win_createDB.db2 Modello_runCreateDB.bat Modello_linux_createDB.db2 Modello_runCreateDB.sh Questi file devono essere copiati sulla macchina in cui risiede il DB2 e il loro contenuto deve essere modificato a seconda del sistema operativo installato su tale macchina (i dettagli nei paragrafi che seguono) DB2 in ambiente Windows Se il DB2 risiede su una macchina Windows diversa da quella dell Application Server, allora bisogna trasferire su questa macchina i file Modello_win_createDB.db2 Modello_runCreateDB.bat su una directory a scelta dell utente della macchina dove risiede il DB2, dove devono poi essere ridenominati come segue: createdb.db2 runcreatedb.bat E necessario personalizzare il contenuto di questi file modificando alcune informazioni legate all installazione del DB2. In particolare devono essere impostati l utente e la locazione dell istanza del DB2 che si vuole usare. Per fare questo operare come segue: Editare il file createdb.db2 (come un file di testo) Modificare l utente: quello preimpostato nel file è db2admin, dunque bisogna effettuare una ricerca della stringa db2admin e sostituirla con il nome dell utente usato. Questa informazione è presente 4 volte nel file Modificare la locazione dell istanza DB2 che deve essere usata: la locazione preimpostata è C: e per modificarla bisogna effettuare una ricerca della stringa C: e sostituirla con il nome del disco in cui si trova l istanza del DB2 che verrà usata (per esempio D: ). Questa informazione è presente 2 volte nel file. Salvare il file con le nuove informazioni immesse Editare il file runcreatedb.bat (come file di testo) 19

20 Modificare il nome dell istanza del DB2 che si vuole usare: effettuare una ricerca della stringa DB2 e sostituirla con il nome dell istanza che verrà usata. Questa informazione è presente 1 volta nel file lanciare l applicazone runcreatedb.bat Il lancio di questa procedura comporta la creazione dei due database LEOSYS e LEONARDO nell istanza del DB2 associata all utente indicato nei file modificati manualmente DB2 in ambiente Linux Se il DB2 risiede su una macchina Linux diversa da quella dell Application Server, allora bisogna trasferire su questa macchina i file Modello_linux_createDB.db2 Modello_runCreateDB.sh su una directory a scelta dell utente della macchina dove risiede il DB2, dove devono poi essere ridenominati come segue: createdb.db2 runcreatedb.sh E necessario personalizzare il contenuto di questi file modificando alcune informazioni legate all installazione del DB2. In particolare devono essere impostati l utente e la locazione dell istanza del DB2 che si vuole usare. Per fare questo operare come segue: Editare il file createdb.db2 (come un file di testo) Modificare l utente: quello preimpostato nel file è db2admin. Se indichiamo con utente il nome dell utente che si vuole usare, bisogna effettuare una ricerca della stringa USER db2admin e sostituirla con la stringa USER utente. Questa informazione è presente 4 volte nel file Modificare la locazione dell istanza DB2 che deve essere usata: la locazione preimpostata è /db2home/db2admin e per modificarla bisogna effettuare una ricerca della stringa /db2home/db2admin e sostituirla con il nome della locazione usata. Questa informazione è presente 6 volte nel file Salvare il file con le nuove informazioni immesse Editare il file runcreatedb.sh (come file di testo) Modificare il nome della locazione dell istanza del DB2 che si vuole usare. Per modificarla bisogna effettuare una ricerca della stringa /db2home/db2admin e sostituirla con il nome della locazione usata. Questa informazione è presente 1 volta nel file Eseguire il login con l utente proprietario dell istanza del DB (es. su db2acg) Posizionarsi sulla directory dove si trovano i file che si stanno modificando lanciare lo script runcreatedb.sh Il lancio di questa procedura comporta la creazione dei due database LEOSYS e LEONARDO nell istanza del DB2 associata all utente indicato nei file modificati manualmente. 20

21 3.7 Ripristino dei database Una volta creati i database è necessario creare le tabelle, le viste e gli indici in base alle informazioni caricate sulla macchina durante la prima fase dell installazione. Alcune di queste tabelle presentano dei dati precaricati. Per fare ciò è necessario: Impostare i parametri di configurazione della Framework di sistema, utili per la connessione ai database, dalla pagina Login della Console Fare il restore dei database dalla pagina Restore DB della Console Passo 1: parametri di connessione al database Questa operazione, possibile dalla pagina Login, serve per impostare i parametri di configurazione della Framework di sistema. In particolare, la configurazione della parte client della Framework si trova nel file caravel.xml.properties, mentre la configurazione della parte server della Framework si trova nel file system.xml.properties. Dalla pagina Login 21

22 devono essere effettuati i seguenti passi: Ricerca del file caravel.xml.properties tramite il bottone Cerca. Esso si trova nella cartella classes\com\ibm\leonardo nel percorso dell applicazione web installata NOTA 1: in questa fase non è necessario effettuare la configurazione del Client in quanto i parametri contenuti sono già impostati in modo corretto per la prima installaizone di ACG Express. NOTA 2: viene proposto di default il file dell ultima applicazione di cui è stato effettuato il deployment. Ricerca del file system.xml.properties tramite il bottone Cerca. Esso si trova nella cartella classes\com\ibm\leonardo\leonardosys nel percorso dell applicazione web installata NOTA 2: viene proposto di default il file dell ultima applicazione di cui è stato effettuato il deployment. Configurazione della parte server della Framework di sistema per la connessione al database del prodotto tramite il bottone Configura che si trova in corrispondenza di system.xml. properties. Per questa operazione fare riferimento al paragrafo Server Configuration Viewer Ricerca della directory Data che si trova all interno della directory Database nella directory di installazione del prodotto. Tale directory contiene il modello del database del prodotto che deve essere creato nel DB2 22

23 3.7.2 Passo 2: ripristino dei database applicativo e di sistema Una volta eseguiti i passi descritti nel paragrafo precedente risulterà operativa la pagina Restore DB. Su questa pagina: Selezionare la voce DB applicativo per popolare il database applicativo del prodotto, di default denominato LEONARDO Selezionare la voce DB di sistema per popolare il database di sistema/amministrativo del prodotto. In questa fase esso è denominato LEOSYS Utilizzare il tasto Restore DB e attendere che l operazione termini. Quest attività potrebbe svolgersi in un tempo relativamente lungo Durante questa fase verrà visualizzato una finestra di log, dove si potrà verificare il corretto esito dell operazione di restore dei database. A questo punto, dalla pagina Login sarà possibile eseguire il login tramite il pulsante Login che consentirà di accedere a tutte le altre funzionalità della Console. In particolare, una volta completate tutte le fasi di in istallazione di ACG Express sarà necessario immettere i codici di autorizzazione dei vari moduli applicativi che fanno parte della suite acquistata, utilizzando la pagina Passwords. Fare riferimento al paragrafo Password 23