MANUALE ADIUTO INSTALLAZIONE DEL SISTEMA MANUALE ADIUTO. Guida all Installazione. Giugno 2016 Ver

Transcript

1 MANUALE ADIUTO INSTALLAZIONE DEL SISTEMA MANUALE ADIUTO Guida all Installazione Giugno 2016 Ver

2 GUIDA ALL'INSTALLAZIONE PAG CONTENUTO DEL CD DI INSTALLAZIONE Il CD ROM ADIUTO contiene il software necessario all'installazione dei componenti del sistema, del modulo base e dei moduli aggiuntivi. All interno del CD è presente la documentazione utile all Amministratore per la configurazione e manutenzione del sistema documentale e agli utenti per il suo utilizzo Jm Consulting srl.

3 GUIDA ALL'INSTALLAZIONE PAG INSTALLAZIONE DI ADIUTO Il capitolo descrive la procedura di installazione della piattaforma ADIUTO e delle componenti software necessarie al suo corretto funzionamento. 2.1 INSTALLAZIONE JAVA RUNTIME È consigliabile come primo passo procedere alla installazione della Java Virtual Machine. Il file di installazione della JDK si trova nella cartella SOFTWARE UTILITY\JAVA. Lanciando il file eseguibile presente nella cartella verrà avviata la procedura di installazione. La prima schermata visualizza i termini del contratto di licenza d uso. Per procedere selezionare il pulsante. La schermata che appare mostra lo stato di avanzamento dell installazione Jm Consulting srl.

4 GUIDA ALL'INSTALLAZIONE PAG. 3 L elemento JAVA RUNTIME è necessario per l interpretazione di pagine Web scritte in Java, quindi al funzionamento dell applicazione lato server. Al termine dell installazione apparirà la seguente schermata: Per completare l installazione premere il pulsante. NOTA: è obbligatorio installare JAVA RUNTIME prima di procedere ai passi successivi. 2.2 INSTALLAZIONE WEB SERVER APACHE TOMCAT Nota: L'installazione di Apache Tomcat versione consente l'utilizzo del protocollo HTTPS. A seconda della versione di Tomcat installata è consigliabile utilizzare una versione diversa della Java Virtual Machine come evidenziato nella tabella che segue. INSTALLAZIONE WEB SERVER APACHE TOMCAT Apache Tomcat è un Web Server open source in grado di processare Java Server Pages e Servlet Java. All interno della cartella Software Utility\apache-tomcat-x.x.xx troviamo il file di installazione. Lanciando l eseguibile apparirà la seguente schermata: 2004 Jm Consulting srl.

5 GUIDA ALL'INSTALLAZIONE PAG. 4 Premere per proseguire con l installazione. Presa visone e accettati i termini del contratto di licenza d uso, premendo il pulsante con l installazione. La finestra seguente consente la selezione dei componenti che si desidera installare. si prosegue 2004 Jm Consulting srl.

6 GUIDA ALL'INSTALLAZIONE PAG. 5 Selezionare dal menù a discesa la voce Custom. Sotto Tomcat selezionare le voci Service Startup e Native come mostrato nella figura. È necessario selezionare questa opzione per il corretto funzionamento di Adiuto. Premere per continuare. Apparirà la finestra seguente dove viene chiesto di selezionare la cartella di destinazione (si consiglia di lasciare le impostazione di default). Premere per continuare. Apparirà la schermata seguente: 2004 Jm Consulting srl.

7 GUIDA ALL'INSTALLAZIONE PAG. 6 A questo punto è necessario impostare le opzioni di configurazione di base di Tomcat. Scegliere il PORT di connessione utilizzato dal servizio. Prima di arrivare a questo punto è necessario controllare quali siano i PORT liberi sul server dove viene installato Tomcat. Il PORT 8080 è solitamente libero e non utilizzato. Nel caso non fosse disponibile è consigliato provare con i PORT successivi (8081, 8082, 8083, ). Nota: ricordare il PORT inserito in questa fase poiché sarà necessario più avanti quando di dovrà procedere alla configurazione di Adiuto. Scegliere un nome utente e una password per la configurazione di Tomcat (non è un passaggio obbligatorio, i due campi possono essere lasciati vuoti). Questo passaggio è comunque ininfluente ai fini del corretto funzionamento di Adiuto. Selezionare ora il percorso di installazione della Java Virtual Machine installata in precedenza, premere quindi per continuare: 2004 Jm Consulting srl.

8 GUIDA ALL'INSTALLAZIONE PAG. 7 Attendere che termini la fase di copia dei file su disco e la registrazione del prodotto. A questo punto l installazione è terminata. Deselezionare la casella Show Readme e "Run Apache Tomcat", premere. Prima di avviare il servizio è consigliabile un ultima impostazione. Avviando il Monitor Tomcat (vedi Figura): Apparirà la finestra seguente in cui settare i parametri di memoria: - Initial memory pool: 256 (MB) - Maximum memory pool: 1024 (MB) - Thread stack size: 256 (KB) 2004 Jm Consulting srl.

9 GUIDA ALL'INSTALLAZIONE PAG. 8 Aggiungere le seguenti opzioni Java: -XX:PermSize=128m -XX:MaxPermSize=128m 2.3 INSTALLAZIONE DEL MODULO BASE La procedura guidata di installazione del modulo base si avvia lanciando il file Adijed_v6.4.0.exe che si trova nella cartella \ADIUTO V6.4\MODULO BASE. Apparirà la seguente schermata che permette la scelta della lingua con cui si vuole installare il software. Premere apparirà la schermata che permette di avviare l installazione: 2004 Jm Consulting srl.

10 GUIDA ALL'INSTALLAZIONE PAG. 9 Premendo il bottone d uso. verrà visualizzata la schermata contenente i termini del contratto di licenza Selezionare Accetto i termini del contratto di licenza e premere successiva. per passare alla schermata 2004 Jm Consulting srl.

11 GUIDA ALL'INSTALLAZIONE PAG. 10 Questa schermata permette di scegliere la directory di destinazione dei file. Si consiglia di mantenere la directory predefinita. Premere per continuare. Proseguire premendo il pulsante Jm Consulting srl.

12 GUIDA ALL'INSTALLAZIONE PAG. 11 Scegliere o confermare il nome della cartella che conterrà i collegamenti al programma e premere. A questo punto premendo il pulsante selezionate. i file del programma vengono copiati nelle directory A questo punto i file di ADIUTO sono stati copiati sul Server. Si passa ora all installazione dei componenti software relativi a: Database Server e FTP server Jm Consulting srl.

13 GUIDA ALL'INSTALLAZIONE PAG INSTALLAZIONE DATABASE SERVER ADIUTO per poter funzionare si appoggia ad un database server. Il programma utilizza almeno due database: un META DB che serve per gestire i login degli utenti, e uno o più DATA DB, in relazione al numero di aziende da gestire, per tutte le altre funzionalità. Nel CD di installazione (cartella SOFTWARE UTILITY ), troviamo tre dei database server che possono essere utilizzati con ADIUTO: MICROSOFT SQL EXPRESS 2008 R2, MICROSOFT SQL EXPRESS 2012, MICROSOFT SQL EXPRESS ADIUTO è compatibile inoltre con ORACLE DB. Per l installazione del database server si rimanda alle relative guide. Se si decide di installare la versione di MS SQL EXPRESS 2008/2014 contenuta nel cd, è possibile installare anche l applicazione SQL SERVER MANAGEMENT STUDIO attraverso la quale si possono agevolmente creare i database necessari al funzionamento del sistema. Creare due nuovi database: un META database (dare un nome significativo es. metadb) e un DATA database (es. datadb). Questo passo è indispensabile. Senza la creazione dei database non sarà possibile iniziare la configurazione del sistema. I database possono essere creati su macchine differenti che utilizzano database server differenti. I due database hanno funzioni diverse: Il metadb serve per il login degli utenti; Il datadb serve per la gestione vera e propria dei files e delle query di ricerca. NOTA: il DB Server non deve essere necessariamente installato sulla macchina dove è installato il modulo base. Possiamo installare il DB Server su di un server dedicato che dovrà, ovviamente, essere connesso in rete e quindi possedere un indirizzo IP. ACCORTEZZE APPLICATIVE Riavvio Notturno Apache Tomcat Per poter utilizzare al meglio questa versione di Adiuto è necessario schedulare un operazione pianificata che effettui il riavvio notturno di Apache Tomcat. Gli eseguibili da schedulare si trovano nella cartella C:\Programmi\adiJed\workfolder\Utility. In questa cartella sono presenti due eseguibili: riavvio_tomcat5-5.bat riavvio_tomcat7.0.bat Intuitivamente andrà schedulato l eseguibile coerente con la versione di Apache Tomcat installata Jm Consulting srl.

14 GUIDA ALL'INSTALLAZIONE PAG. 13 Alter Database per Commit Frequenti Abbiamo notato che nelle installazioni medio-grandi risulta utile modificare una impostazione sui database di Adiuto. Questa modifica permetterà miglior esecuzione delle query di update da parte di Adiuto e Adifeed. Le istruzioni per modificare questa impostazioni sono le seguenti: Aprire il management studio di SQL Server e terminare tutte le connessioni presenti (se questa operazione è effettuata prima dell installazione di Adiuto non ci saranno connessioni attive). Andrà stoppato il servizio di Adifeed e chiuse tutte le applicazioni client di Adiuto (Adintegra, Adioffice, Adisdk, ecc ) Creare una nuova query vuota e copiare il seguente codice: --alter database per risoluzione blocco WF e commit rapidi ALTER DATABASE adiuto_meta SET READ_COMMITTED_SNAPSHOT ON; --Query controllo stato del database, il database è impostato correttamente se il valore ritornato dalla query è 1 SELECT is_read_committed_snapshot_on FROM sys.databases WHERE name= 'adiuto_meta' Sostituire, nel codice sopra, ad adiuto_meta il nome dei due o più database di Adiuto. L operazione va eseguita sia per il database meta che per i database data Jm Consulting srl.

15 GUIDA ALL'INSTALLAZIONE PAG INSTALLAZIONE FTP SERVER Per la gestione documentale ADIUTO utilizza un ftp server. Per ogni tipologia di documento è possibile parametrizzare un diverso file system (Server FTP) nel quale archiviare i documenti. Tale file system è accessibile dalla rete solo ed esclusivamente dall applicazione documentale. ADIUTO può utilizzare un qualsiasi FTP Server (anche il servizio FTP di Windows), all interno del CD di installazione troviamo nella cartella SOFTWARE UTILITY il server FTP FILEZILLA. NOTA: il server FTP non deve essere necessariamente installato sulla macchina dove è installato il modulo base. Possiamo installarlo un server dedicato che dovrà, ovviamente, essere connesso in rete e quindi possedere un indirizzo IP. NOTA: solitamente di default, il servizio FTP di Windows è impostato in sola lettura. Ricordarsi in caso di un suo utilizzo, di selezionare il diritto di scrittura sulla cartella utilizzata dal servizio Jm Consulting srl.

16 3. GUIDA RAPIDA DI INSTALLAZIONE