Di seguito riportiamo l'elenco dei componenti che devono risultare già installati prima di procedere con il caricamento di AGO Infinity:

Transcript

1 Note di installazione v Il le di installazione contiene il prodotto AGO Innity 2010 Edition, i le di congurazione per l'accesso al database (DBCong) e le Tabella Estimi Catastali e Tabella Nomenclature Instrastat. Le operazioni di installazione di AGO Innity 2010 devono essere effettuate da un utente autorizzato ad eseguire i comandi <Start>/ <Stop> dell'application Server e con diritti di scrittura nella cartella <..\..\webapps che conterrà l'applicazione> (Es. Windows: C:\AGO\Tomcat6\webapps\... - Es. Linux : es.: /opt/ago/tomcat6/webapps/...). Di seguito riportiamo l'elenco dei componenti che devono risultare già installati prima di procedere con il caricamento di AGO Innity: JVM: Java Development Kit (JDK) SOFTWARE PERCORSO DOWNLOAD GRATUITO Application Server :TOMCAT * Data base server : PostgreSQL (+ JDBC) * Data base server : Microsoft SQL 2005 Express Edition (+JDBC) * Data base server : Microsoft SQL 2008 R2 Express Edition (+JDBC) (*) scelta alternativa Per maggior dettagli in merito: - alle versioni dei componenti da installare consultare My Zucchetti \ Area tecnica \Documentazione \ Requisiti HW/SW \ Ago Innity 2010 Edition Caratteristiche tecnico-funzionali; - al contenuto della versione consultare il documento Contenuti_AGO2010.pdf presente nella cartella <NOTE> dell'installazione. OPERAZIONI PRE-CARICAMENTO POSTGRESQL SQL (SCELTA( ALTERNATIVA A MICROSOFT SQL) - Vericare che sia stato installato il linguaggio pl/pgsql nel database template1 (opzione proposta di default). - Vericare che NON esistano un database con nome AGO2010 ed una cartella tsago2010 all'interno della cartella <data> nel percorso di installazione di PostgreSQL. - Creare una cartella tsago2010 all'interno della cartella <data> nel percorso di installazione di PostgreSQL. - Creare una tablespace TSAGO2010 associata alla cartella <tsago2010>. - Creare un nuovo database AGO2010 collegato alla tablespace TSAGO2010 assicurandosi che la codica sia UTF8. - Vericare che nel le postgresql.conf presente nella cartella <data> nel percorso di installazione di PostgresSQL i seguenti parametri siano impostati come di seguito indicato: escape_string_warning = on standard_conforming_strings = off NOTA: Se la riga relativa al parametro risulta commentata (riga che inizia con il carattere # "cancelletto") indica che il valore è già impostato di default, quindi corretto. shared_buffers = 1GB work_mem = 160MB max_connections = 100 # consigliato il 25% della memoria totale # consigliato il 4% della memoria totale # # Congurazione logs # log_destination = 'stderr' logging_collector = on log_lename = 'postgresql-%y-%m-%d_%h%m%s.log' log_rotation_age = 1d log_rotation_size = 10MB Ns.Rif.:CT/AGO284_Installazione/rv 1/6

2 MICROSOFT SQL (SCELTA ALTERNATIVA A POSTGRESQL) SQL) ICROSOFT SQL ( - Vericare che NON esista un database con nome AGO Dalla Gestione congurazione SQL Server selezionare <Protocolli per SQLEXPRESS> e abilitare il protocollo di TCP/IP. - Compilare le proprietà dell'<indirizzo IP> come segue, mantenendo invariato il valore <indirizzo IP>: - Vericare di aver installato per Microsoft SQL Server anche Microsoft SQL Server Management Studio Express. - Creare un nuovo database AGO2010. APACHE TOMCAT (SISTEMI WINDOWS) - Vericare i parametri java selezionando dal menu Start\Programmi\Apache Tomcat 6.0\Congure Tomcat la voce Java, ed eventualmente aggiungere: java Options: -XX:PermSize=128m -XX:MaxPermSize=256m -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=true Initial memory pool: 128 Maximum memory pool: 768 SOLO PER UTENTI Sistemi 32 bit Startup: Mode: Java Ns.Rif.:CT/AGO284_Installazione/rv 2/6

3 SOLO PER UTENTI Sistemi 32 bit Shutdown: Mode: Java APACHE TOMCAT (SISTEMI LINUX) - Vericare i seguenti parametri presenti nel le catalina.sh: export JAVA_OPTS="-Xms1024m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=256m -Dle.encoding=ISO Duser.language=it -Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=true" -Djava.awt.headless=true NOTA: 1, La voce JAVA_OPTS continua sulla riga successiva per logici motivi di stampa, accertarsi che tutto sia sulla stessa riga(il simbolo $ in fondo alla riga indica che la stessa prosegue oltre lo schermo ). 2, Nella voce JAVA_OPTS il parametro Xmx=1024m può essere variato per allocare la quantità di memoria dedicata al Tomcat a discrezione dell'utente (es. Xmx=2048m). Se si eccede con il valore su sistemi a 32 bit, il servizio potrebbe non avviarsi o diventare instabile. SCRIPT AVVIO NOTA: Normalmente il servizio Tomcat non viene eseguiti come utente root, ma ne viene creato uno apposito utente per ragioni di sicurezza (noi useremo l utente agouser ). - Creare un utente agouser. - Creare il le /etc/init.d/tomcat e compilarlo come segue (è possibile eseguire il copia/incolla dal presente documento PDF): #!/bin/bash # # tomcat # # chkcong: # description: Apache Tomcat 6 service. Zucchetti S.p.a. # Source function library.. /etc/init.d/functions CATALINA_USER=agouser CATALINA_HOME="/usr/local/AGO/tomcat6" JAVA_HOME="/usr/local/AGO/java" TOMCAT_PID=`pidof $JAVA_HOME/bin/java` case "$1" in start) if [ "$TOMCAT_PID" = '' ]; then if [ -f $CATALINA_HOME/bin/startup.sh ]; then echo $"Checking permissions..." chown -R $CATALINA_USER.$CATALINA_USER $CATALINA_HOME/ chmod -R 755 $CATALINA_HOME echo $"Starting Tomcat..." su $CATALINA_USER -c "$CATALINA_HOME/bin/startup.sh" else echo 'Tomcat server already started! Process PID' $TOMCAT_PID ;; stop) if [ "$TOMCAT_PID" = '' ]; then echo Apache Tomcat Server is not running! else if [ -f $CATALINA_HOME/bin/shutdown.sh ]; then echo $"Stopping Tomcat..." Ns.Rif.:CT/AGO284_Installazione/rv 3/6

4 su $CATALINA_USER -c "$CATALINA_HOME/bin/shutdown.sh" pkill -u $CATALINA_USER echo $"Cleaning Work Folder..." rm -rf $CATALINA_HOME/work/* ;; *) echo $"Usage: $0 {start stop}" exit 1 ;; esac exit 0 - Assegnare allo script i permessi di esecuzione (chmod +x /etc/init.d/tomcat). - Congurare lo script come servizio di sistema (dalla cartella /etc/init.d/ digitare: chkcong --add tomcat). - Inserire lo script fra i servizi in auto start all avvio della macchina (chkcong tomcat on). - Vericare che il servizio venga avviato in automatico (chkcong --list tomcat): tomcat 0:off 1:off 2:on 3:on 4:on 5:on 6:off vericare che almeno i valori 3 e 5 siano on UTENTE MANAGER - Editare il le di congurazione Tomcat../tomcat6/conf/tomcat-users.xml. - Sostituire il contenuto del le come segue: <?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager"/> <user username="admin" password="admin" roles="manager"/> </tomcat-users> NOTA: La creazione dell'utente manager richiede l'inserimento delle voci username= e password= da utilizzare per accedere a Tomcat manager dal browser. Nella presente documentazione vengono utilizzati username: admin e password: admin. INSTALLAZIONE PRODOTTI Salvare il le AGO284_INST.zip contenente l'installazione del prodotto AGO Innity 2010 Edition ed eseguirne l'unzip salvando il contenuto in un apposito percorso. INSTALLAZIONE - Eseguire lo Stop del servizio Tomcat utilizzando le funzioni previste dal sistema. - Copiare il le ago2010.war in una cartella temporanea di appoggio (Es. Windows: C:\tmp\ Es. Linux: /usr/tmp/). - Vericare che NON esista la cartella <..\..\webapps\ago2010> (Es. Windows: C:\AGO\Tomcat6\webapps Es. Linux: /usr/local/ago/tomcat6/webapps). - Cancellare il contenuto della cartella WORK situata nel percorso di installazione di Tomcat (Es. Windows: C:\AGO\Tomcat6\Work Es. Linux: /usr/local/ago/tomcat6/work). - Creare la cartella <..\..\webapps\ago2010> (Es. Windows: C:\AGO\Tomcat6\webapps\AGO2010 Es. Linux: /usr/local/ago/tomcat6/webapps/ago2010). - Posizionarsi nella cartella appena creata (Es. Windows: cd C:\AGO\Tomcat6\webapps\AGO2010 Es. Linux: cd /usr/local/ago/tomcat6/webapps/ago2010). - Scompattare il le ago2010.war presente nella cartella temporanea utilizzando il comando jar (Es. Windows: C:\Programmi\Java\jdk1.6.0_21\bin\jar -xf C:\tmp\ago2010.war Es. Linux: /usr/local/ago/tomcat6/bin/jar -xf /usr/tmp/ago2010.war) - Copiare il le di licenza ricevuto via nel percorso: <..\..\webapps\ago2010\web-inf\cfg> (Es. Windows: C:\AGO\Tomcat6\webapps\AGO2010\WEB-INF\cfg Es. Linux: /opt/ago/tomcat6/webapps/ago2010/web-inf/cfg). CONNESSIONE AL DATABASE - Copiare la libreria di connessione JDBC (PostgreSQL oppure Microsoft SQL) nella cartella <..\..\webapps\ago2010\web-inf\lib> (Es. Windows: C:\AGO\Tomcat6\webapps\AGO2010\WEB\INF\lib Es. Linux: /opt/ago/tomcat6/webapps/ago2010/web-inf/lib). Ns.Rif.:CT/AGO284_Installazione/rv 4/6

5 - Copiare il le di congurazione, presente nella cartella DBCong dell'installazione (Postgres, SQL2005, SQL2008) nella cartella <..\..\webapps\ago2010\web-inf\classes> (Es. Winodws: C:\AGO\Tomcat6\webapps\AGO2010\WEB-INF\classes Es. Linux: /opt/ago/tomcat6/webapps/ago2010/web-inf/classes). - Editare il le <..\..\webapps\ago2010\web-inf\classes\dbcong> inserendo i parametri di connessione al database. (Es. Winodws: C:\AGO\Tomcat6\webapps\AGO2010\WEB-INF\classes\DBcong Es. Linux: /opt/ago/tomcat6/webapps/ago2010/web-inf/classes/dbcong). - Eseguire lo Start del servizio Tomcat utilizzando le funzioni previste dal sistema. AMMINISTRAZIONE DATABASE - Da un client windows con Internet Explorer 8 (requisito fondamentale), aprire il browser e digitare il seguente indirizzo (dove <ipserver> corrisponde all IP del server linux su cui stiamo installando es.: - Cliccare la voce Run Database Administration e attendere il successivo dialogo. NOTA: Non selezionare MAI e per nessuna ragione Generate JSP Files! - Scorrere i dati proposti no alla ne e premere <Chiudi>. - Premere <Procedi>. CARICAMENTO TABELLE - Salvare il le nomintrastat.zip presente nell'installazione, in una cartella temporanea (Es. Windows: C:\TMP Es. Linux: /tmp/). - Accedere all'applicazione con un utente con diritti di amministrazione (es.: admin). - Selezionare da PANNELLO DI CONTROLLO la seguente voce di menu: Impostazioni/Sistema/Avanzate/Import/Export/Tabella/Procedura di Import. - Impostare nel campo Sorgente package l'opzione File System Locale. - Utilizzare il campo Seleziona package per specicare il percorso del le nomintrastat.zip (Es. Windows: C:\TMP\ nomintrastat.zip Es. Linux: /tmp/nomintrastat.zip). - Premere il link Elabora e attendere l'esito dell'importazione (n.b.: l'elaborazione potrebbe durare diversi minuti). Ns.Rif.:CT/AGO284_Installazione/rv 5/6

6 - Vericare che nel dettaglio dell'elaborazione non siano presenti errori. - Ripetere tutte le operazioni eseguite utilizzando il le estimicatastali.zip presente nell'installazione. CARICAMENTO PATCH - Assicurarsi che nessun utente stia utilizzando il prodotto; - Impostare il sistema in modalità "Manutenzione" selezionando Pannello di controllo\impostazioni\sistema\applicazione - Modalità Operativa=Manutenzione; - Da PANNELLO DI CONTROLLO\Impostazioni\Sistema\Avanzate\Gestione aggiornamenti pannello Patch installabili premere Carica patch e selezionare il le presente nella cartella PATCH dell'installazione; - Visualizzare il contenuto della versione cliccando l'icona ; - Dal pannello Patch installabili selezionare la prima patch in elenco e successivamente Installa selezionate; ATTENZIONE: Le patch devono essere necessariamente installate singolarmente selezionando nel presente pannello sempre la prima patch disponibile in elenco. - Nel dialogo "Aggiornamenti selezionati" premere il bottone Installa; - Al termine appare un dialogo che riporta l'esito dell'installazione. La patch gura nel pannello Patch in installazione; - Eseguire Stop/Start del servizio relativo all'application Server (es. Tomcat) utilizzando le funzioni previste dal sistema; - Vericare la presenza della patch selezionata nel pannello Patch installate; - Vericare nel pannello Procedure di conversione che tutte le conversioni siano in stato Eseguita=SI (vericare colonna Ese). - Impostare il sistema in modalità "Normale" selezionando Pannello di controllo\impostazioni\sistema\applicazione - Modalità Operativa=Normale. - Proseguire installando tutte le patch presenti nel pannello Patch installabili. AO2P IN OMNIA INSTALLAZIONE AO2P IN OMNIA Per eseguire l'esportazione documenti da OMNIA è necessario installare nell'ambiente APRI la funzione AO2P disponibile in MY Zucchetti\Area tecnica\pianicazione e Rilasci\Aggiornamenti e Patch\. PUBBLICAZIONE Per la pubblicazione dell'applicativo Ago Innity consigliamo l'utilizzo di Apache Web Server (Linux) o IIS (Windows). NOTA: Si sconsiglia per la pubblicazione l'utilizzo di Apache Tomcat. Ns.Rif.:CT/AGO284_Installazione/rv 6/6