Sistemi IBM Open Power e IBM xSeries ACG Express Applicazioni Contabili Gestionali Guida alla Procedura di Installazione Questo documento è pubblicato sul seguente indirizzo http://express.acginfo.it/documentazione_express.asp si consiglia di verificare periodicamente la pubblicazioni di aggiornamenti © Copyright IBM Corp. 2005, 2006 Questa guida si riferisce alla procedura di installazione dei prodotti ACG Express. Java and alla 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 e sono protetti dal corrispondente Copyright. Pagina 2 di 18 Indice 1. AVVERTENZE............................................................................................... 4 2. Introduzione ................................................................................................. 5 3. Caratteristiche comuni agli ambienti Windows™ e Linux ....................... 9 3.1 Le fasi di installazione.....................................................................................................................9 3.2 Requisiti di memoria e spazio disco ...............................................................................................9 3.3 Componenti esterne.........................................................................................................................9 3.4 Parte client .....................................................................................................................................10 3.5 Prerequisiti software .....................................................................................................................10 4. Installazione in ambiente Windows ™ ..................................................... 12 4.1 Prerequisiti di macchina e Sistema Operativo............................................................................12 4.2 Installazione del prodotto ACG Express.....................................................................................12 5. Installazione in ambiente Linux ................................................................ 14 5.1 Prerequisiti di macchina e Sistema Operativo............................................................................14 5.2 Installazione del prodotto ACG Express.....................................................................................14 6. Avviamento di ACG Express .................................................................... 15 7. Login con le applicazioni “ACG Express”............................................... 16 8. Rimozione del prodotto ACG Express (Windows).................................. 16 Commenti e comunicazioni ................................................................................ 18 Pagina 3 di 18 1. AVVERTENZE Il prodotto ACG Express è disponibile secondo i seguenti raggruppamenti, ognuno composto da moduli applicativi diversi: o o o o o o o o o o o o o o o o o o Modulo Base Gestione Archivi Contabilità aziendale Ritenuta d’Acconto Tesoreria Gestione Provvigioni Contabilità Analitica Controllo Aziendale - Bilancio Controllo Aziendale - Flussi Controllo Aziendale - Budget Vendite Magazzino Acquisti Co.nai Produzione avanzata Distinta Base e Costi Lavorazione presso Terzi Gestione Commesse di Produzione L’installazione di ACG Express installa di fatto tutti moduli applicativi componenti., ma il funzionamento di ciascun modulo è legato ad un codice di autorizzazione che consente l’esecuzione dei programmi. Questo significa che, una volta installato anche solo uno dei raggruppamenti, per poter eseguire i moduli di un qualunque altro raggruppamento è sufficiente richiederne il codice di autorizzazione, in quanto i moduli risultano già installati. A titolo informativo si fa presente che il prodotto installa la propria Java Virtual Machine, eliminando ogni eventuale problema di compatibilità con versioni diverse di Java Virtual Machine che fossero presenti sulla macchina. Pagina 4 di 18 2. Introduzione Lo scopo di questa guida è descrivere i passi di installazione del prodotto ACG Express . Per l’esecuzione di alcuni passi si dovrà fare riferimento ad ad altri documenti: - Manuale di installazione di IBM WebSphere Manuale di installazione di IBM DB2 Manuale di gestione della configurazione di ACG Express Console Amministrativa Si consiglia pertanto di avere a disposizione tutto il materiale necessario prima di iniziare l’installazione. ACG Express può essere installato su macchine IBM xSeries e su macchine IBM Open Power. A seconda della macchina utilizzata il sistema operativo potrà essere Windows ™ e/o Linux. Di seguito viene mostrata una tabella che indica, per ogni macchina, il sistema operativo di riferimento: Linux IBM System p (processore Power) IBM System x (processore Intel) Windows SLES 9 o 10 32bit (SUSE Linux Enterprise Server) (*) SLES 9 o 10 64bit (SUSE Linux Enterprise Server) (**) SLES 9 o 10 32bit (SUSE Linux Enterprise Server) (*) SLES 9 o 10 64bit (SUSE Linux Enterprise Server) (**) Windows™ 2003 Server (*) Windows ™ 2000 Server (***) Windows™ XP Professional (***) NOTA: Per tutti i sistemi citati nella tabella installare gli ultimi aggiornamenti disponibili. - (*) Sistemi operativi sui quali ACG Express è supportato in ambiente di produzione fino a 30 utenti. - (**) Sistemi operativi sui quali ACG Express è supportato in ambiente di produzione oltre 30 utenti. - (***) Sistemi operativi sui quali ACG Express è supportato solo per ambienti di test, demo, sviluppo. Poiché la procedura d’installazione differisce a seconda del sistema operativo, questa guida riporterà le istruzioni di installazione in due capitoli distinti, uno per l’ambiente Windows ™ e uno per l’ambiente Linux. Di seguito una tabella riassuntiva dei passi necessari per installare ACG Express, che può essere utilizzata come riferimento durante l’installazione. Pagina 5 di 18 Passo Descrizione Indicazioni particolari Fase 1: istruzioni nel presente documento Verifica dei 1 prerequisiti hardware Verifica dei 2 prerequisiti di Sistema Operativo Reperimento dei WebSphere 6.0 (o superiori) prerequisiti software DB2 9.5 reperibili al seguente link attenedosi ai seguenti passi: 3 - Eseguire login inserendo userid e password; - Andare sulla voce Prodotti e tool poi Download prodotti nel menù a sinistra del vostro schermo; - Scegliere nel menù a tendina il prodotto ACG Express; - Cercare la voce Prerequisiti software per ACG Express e cliccare sù LINK ; - Scegliere il software interessato (WebSphere e DB2) in base al vostro sistema operativo ------------------------------------------------Componenti esterne open source reperibili al seguente link attenendosi ai seguenti passi: - Eseguire login inserendo userid e password; - Andare sulla voce Prodotti e tool poi Download prodotti nel menù a sinistra del vostro schermo; - Scegliere nel menù a tendina il prodotto ACG Express; - Cercare la voce Prerequisiti software per ACG Express e cliccare sù LINK ; - Cercare la voce ACG Express open source e cliccarci inserendo, successivamente, utenza e password (come specificato nella pagina webpage stessa) - Cercare la voce ACG Express libraries e cliccare sù Version 380 - Procedere con il download del file open_source.zip e salvarlo in C:\ e ricordare la locazione del file. Pagina 6 di 18 Installazione WebSphere 4 Per procedere all’installazione attenersi alla procedura guidata o al manuale di installazione che si trova nella cartella del prodotto scaricato in precedenza. Pagina 7 di 18 Installazione DB2 e Per procedere all’installazione attenersi creazione di un’istanza alla procedura guidata o al manuale di installazione che si trova nella cartella del prodotto scaricato in precedenza. Durante l’installazione prendere nota dell’utente, la password, la porta utilizzata per l’istanza creata. (Se DB2 era già installato utilizzare il DB2 Control Center per recuperare tali informazioni) 5 6 Preparazione delle componenti esterne Viene richiesto di indicare la directory in cui installare il prodotto e la locazione del file open_source.zip Fase 2: istruzioni nella Guida della Console Amministrativa Deployment 8 dell’applicazione Creazione e 9 popolamento dei database del prodotto Immissione delle 10 password 7 Installazione guidata di ACG Express Pagina 8 di 18 3. Caratteristiche comuni agli ambienti Windows™ e Linux La procedura d’installazione ed i requisiti hardware e software del prodotto ACG Express sono indipendenti dal sistema operativo sul quale il prodotto si installa e vengono di seguito esplicitati. 3.1 Le fasi di installazione L’installazione di ACG Express si suddivide in due fasi principali: 1. la prima fase è descritta in questa guida e consiste nell’installazione dei prerequisiti del prodotto e nell’installazione guidata dei componenti del prodotto dal CD 2. la seconda fase è descritta nella guida ACG Express Console Amministrativa e consiste in una serie di passi di avvio dell’applicazione: deployment, creazione e popolamento dei database, immissione dei codici di autorizzazione, etc. 3.2 Requisiti di memoria e spazio disco Memoria consigliata: 4 GB minimo Spazio disco: ACG Express (installazione da CD) 670 MB ACG Express (applicazione web) 300 MB Database iniziale (DB2) 500 MB 3.3 Componenti esterne Prima di avviare l’installazione, indipendentemente dal sistema operativo, è necessario reperire in Internet una serie di componenti (Open Source e non). Per poter avere informazioni aggiornate su quali componenti scaricare, come scaricarli e come utilizzarli, si deve consultare il sito dedicato ad ACG Express attenendosi ai seguenti passi: - Eseguire login inserendo userid e password; - Andare sulla voce Prodotti e tool quindi Download prodotti nel menù a sinistra del vostro schermo; - Scegliere nel menù a tendina il prodotto ACG Express; - Cercare la voce Prerequisiti software per ACG Express e cliccare sù LINK ; Verranno visualizzati tutti i prodotti necessari per installare correttamente ACG Express. Pagina 9 di 18 3.4 Parte client L’accesso alle applicazioni di ACG Express avviene tramite il browser Microsoft Internet Explorer 7.0 3.5 Prerequisiti software Di seguito sono elencati i prerequisiti software del prodotto ACG Express. IBM Websphere Application Server, versione 6.0 (o successivi) Base o Express Edition Nel caso in cui WebSphere 6.0 non sia già installato si deve far riferimento alla documentazione di installazione ufficiale IBM che accompagna il prodotto. Per avere ulteriori informazioni si suggerisce il sito: http://www-306.ibm.com/software/websphere/ Database management system: IBM DB2 UDB 9.5 (con ultimi aggiornamenti disponibili) - Nel caso in cui DB2 non sia già installato si deve far riferimento alla documentazione di installazione ufficiale IBM che accompagna il prodotto. Per avere ulteriori informazioni si suggerisce il sito: IBM DB2 Si fa osservare che non è obbligatorio che il DB2 sia installato sulla stessa macchina in cui si trova l’Application Server ma potrebbe essere installato/presente anche su un’altra macchina in rete (in ambiente Windows ™ oppure Linux). Conviene sottolineare che nella fase di avviamento di ACG Express sarà necessario indicare: Il nome di un’istanza di database esistente Il nome dell’utente associato all’istanza e la sua password La locazione dell’istanza Pertanto, qualora si volessero utilizzare istanze già create o ne venissero create in fase di installazione del DB2, conviene annotare tali informazioni per averle a disposizione al momento opportuno. Componenti esterni Pagina 10 di 18 I componenti esterni al prodotto (Open Source ed altro), elencati precedentemente in questa guida, devono essere scaricati e gestiti secondo quanto indicato al seguente link seguendo le istruzioni precedentemente descritte oppure attenendosi alle seguenti istruzioni: - Eseguire login inserendo userid e password; - Andare sulla voce Prodotti e tool quindi Download prodotti nel menù a sinistra del vostro schermo; - Scegliere nel menù a tendina il prodotto ACG Express; - Cercare la voce Prerequisiti software per ACG Express e cliccare sù LINK ; - Cercare la voce ACG Express open source e cliccarci inserendo, successivamente, utenza e password (come specificato nella pagina webpage stessa) - Cercare la voce ACG Express libraries e cliccare sù Version 1.2.1 - Procedere con il download del file open_source.zip e salvarlo in C:\ e ricordare la locazione del file. NOTA: Si mette in evidenza il fatto che, alla fine di questo passo, si deve avere a disposizione il file open_source.zip, che verrà utilizzato durante la fase di installazione di ACG Express. Pagina 11 di 18 4. Installazione in ambiente Windows ™ 4.1 Prerequisiti di macchina e Sistema Operativo In questo capitolo vengono descritti i prerequisiti hardware e software di ACG Express in ambiente Windows ™. Hardware Un sistema IBM xSeries - Sistema Operativo certificato e supportato in produzione (max 30 utenti): Windows™ 2003 Server (service pack 1 o successivi) - Sistema Operativo certificato per ambienti demo, sviluppo e test: Windows ™ 2000 Server (Service Pack 4 o successive) oppure Windows™ XP Professional (service pack 2 o successivi) 4.2 Installazione del prodotto ACG Express Questo capitolo descrive i passi per eseguire l’installazione del prodotto ACG Express su una macchina server xSeries con sistema operativo Windows ™, dopo aver eseguito i passi di installazione dei prerequisiti indicati nel paragrafo 3.5: Effettuare il login come utente amministratore. Inserire il CD d’installazione e visualizzare il contenuto utilizzando Esplora Risorse Visualizzare il contenuto della directory ACGExpress_setup_win32\disk1 Avviare la procedura di installazione lanciando il file eseguibile (doppio click) acgexpress_setup.exe Verrà eseguita la procedura grafica di installazione del prodotto nella quale, in particolare, verrà chiesto all’utente di indicare: la directory di installazione del prodotto (che per default sarà C:\Programmi\ACG-Express). EVITARE DI SELEZIONARE DIRECTORY NEL CUI NOME CI SIANO SPAZI il file open_source.zip con il relativo percorso che è stato preparato nel passo di installazione dei componenti esterni. Il programma di Pagina 12 di 18 installazione verifica la correttezza del nome del file e successivamente lo espande nella directory di installazione del prodotto. Al termine della procedura verificare che nella directory d’installazione del prodotto siano state create le seguenti directory: Database Documentazione Repository _jvm _uninst log AVVERTENZA: Si raccomanda di non modificare il nome e la struttura delle directory create durante l’installazione del prodotto. Pagina 13 di 18 5. Installazione in ambiente Linux 5.1 Prerequisiti di macchina e Sistema Operativo In questo capitolo vengono descritti i prerequisiti hardware e software di ACG Express in ambiente Linux. - Hardware Un sistema IBM xSeries oppure IBM Open Power - Sistema Operativo certificato e supportato in produzione (max 30 utenti): SLES 9 32bit (SUSE Linux Enterprise Server) o superiore. - Sistema Operativo certificato e supportato in produzione (oltre 30 utenti): SLES 9 64bit (SUSE Linux Enterprise Server) o superiore 5.2 Installazione del prodotto ACG Express Questo capitolo descrive i passi per eseguire l’installazione del prodotto ACG Express su una macchina server xSeries oppure Open Power a 32 o 64 bit con sistema operativo Linux, dopo aver eseguito i passi di installazione dei prerequisiti indicati nel paragrafo 3.5 Prerequisiti: Effettuare il login come utente root Inserire il CD d’installazione ed eseguire il mount del CDROM per gli ambienti Suse Linux (Es. il comando potrebbe essere mount /media/cdrom Posizionarsi nella directory di mount (Es.: il comando potrebbe essere cd /media/cdrom Lanciare la procedura di installazione in base all’architettura hardware della macchina in cui dsi deve installare il prodotto: Per Open power: - posizionarsi nella directory con il comando: cd ACGExpress_setup_ppc/disk1 - quindi lanciare l’installazione con il comando: ./ acgexpress_setup_ppc.bin Per xSeries: - posizionarsi nella directory con il comando: cd ACGExpress_setup_x86/disk1 Pagina 14 di 18 - quindi lanciare l’installazione con il comando: ./ acgexpress_setup.bin Verrà avviata la procedura grafica di installazione del prodotto nella quale, in particolare, verrà chiesto all’utente di indicare: la directory di installazione del prodotto il file open_source.zip con il relativo percorso che è stato preparato nel passo di installazione dei componenti esterni. Al termine della procedura verificare che nella directory d’installazione del prodotto siano state create le seguenti directory: Database Documentazione Installation_scripts Repository _jvm _uninst log AVVERTENZA: Si raccomanda di non modificare il nome e la struttura delle directory create durante l’istallazione del prodotto. 6. Avviamento di ACG Express A questo punto dell’installazione si hanno a disposizione tutti gli elementi per poter completare il processo che rende operativo il prodotto. In particolare sarà necessario: fare il deployment dell’applicazione, ovvero installare l’Applicazione web nell’ambiente Websphere creare i database caricare i dati necessari per poter avviare il prodotto immettere i codici di autorizzazione all’uso …. Questi passi sono eseguibili utilizzando l’applicazione “ACG Express Console Amministrativa” installata durante con il prodotto ACG Express. In particolare, in ambiente Windows verrà aggiunta una voce all’elenco dei programmi (Start/Programmi) ed un’icona sul Desktop dalle quali potrà essere lanciata la Console Amministrativa. In ambiente Linux la Console Amministrativa si potrà avviare lanciando lo script console_acgj.sh presente nella directory di installazione di ACG Express. Pagina 15 di 18 Per la Console Amministrativa è stata redatta una guida applicativa nella quale è possibile reperire i passi per completare l’installazione. In particolare questi passi sono descritti nella guida al capitolo “Avviamento di ACG Express”. 7. Login con le applicazioni “ACG Express” Una volta eseguiti anche i passi di avviamento di ACG Express attraverso la Console Amministrativa, sarà possibile operare con le funzioni applicative accedendo al prodotto attraverso il browser Internet Explorer: nel campo Indirizzo digitare la stringa per accedere al menu principale, che sarà del tipo: http://xxx.xxx.xxx.xxx:pppp/aaaaa/index.html dove xxx.xxx.xxx.xxx è l’indirizzo IP del sever in cui è installato l’application server Websphere e l’applicaiozne web (per esempio: 9.87.22.159) pppp è la porta assegnata all’application server Websphere, (per esempio 9080 è la porta assegnata di default ) aaaaa è il nome assegnato all’applicazione in fase di deployment In fase di installazione vengono creati due profili utente di default: DEMO_A con medesima password è l’utente per l’ambiente di demo DEMO_B con medesima password è l’utente per l’ambiente di demo ACGJUSER senza password è l’utente di default dell’ambiente produttivo 8. Rimozione del prodotto ACG Express (Windows) In ambiente Windows Per disinstallare il prodotto si deve lanciare l’eseguibile uninst.exe che si trova nella directory _uninst della directory di installazione del prodotto. La disinstallazione deve essere effettuata da un utente di tipo administrator. Pagina 16 di 18 In ambiente Linux Per disinstallare il prodotto si deve lanciare l’eseguibile uninst.ebin che si trova nella directory _uninst della directory di installazione del prodotto. La disinstallazione deve essere effettuata da utente root. Durante questa fase seguire le indicazioni fornite dai pannelli guida. Si vuole sottolineare quanto segue: la procedura non rimuove i database (consultare la documentazione del db2) La procedura potrebbe non rimuovere alcune directory relative all’installazione del prodotto. In tal caso dopo la procedura di disinstallazione rimuoverle manualmente. Per completare la disinstallazione, aprire la console di amministrazione di WebSphere Application Server e rimuovere l’applicazione relativa ad ACG Express. Pagina 17 di 18 Commenti e comunicazioni Per eventuali commenti e/o comunicazioni volte al miglioramento dell’utilizzo della Guida si prega di fare riferimanto al sito internet ACGINFO.IT nella sezione “Contattaci”. Pagina 18 di 18