MANUALE ADIUTO INSTALLAZIONE DEL SISTEMA MANUALE ADIUTO. Guida all Installazione. Febbraio 2018 Ver

Transcript

1 MANUALE ADIUTO INSTALLAZIONE DEL SISTEMA MANUALE ADIUTO Guida all Installazione Febbraio 2018 Ver

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

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.

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. Dopo l installazione aprire il pannello di controllo Java e disabilitare il controllo automatico della presenza di aggiornamenti. Il pannello di controllo Java è raggiungibile dai programmi del menù Start di Windows aprendo la lista programmi Java e cliccando su Configura Java. NOTA: è obbligatorio installare JAVA RUNTIME prima di procedere ai passi successivi.

5 GUIDA ALL'INSTALLAZIONE PAG 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: Premere per proseguire con l installazione.

6 GUIDA ALL'INSTALLAZIONE PAG. 5 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 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 impostazioni di default).

7 GUIDA ALL'INSTALLAZIONE PAG. 6 Premere per continuare. Apparirà la schermata seguente: 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:

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):

9 GUIDA ALL'INSTALLAZIONE PAG. 8 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) Aggiungere le seguenti opzioni Java: -XX:PermSize=128m -XX:MaxPermSize=128m

10 GUIDA ALL'INSTALLAZIONE PAG. 9 Modificare il file Server.xml che si trova nella cartella C:\Programmi\Apache Software Foundation\Tomcat 8.5\conf commentando due elementi che potrebbero creare problemi e aggiungendo un nuovo TAG: DA COMMENTARE (le righe sono indicative): DA COMMENTARE (le righe sono indicative):

11 GUIDA ALL'INSTALLAZIONE PAG INSTALLAZIONE DEL MODULO BASE La procedura guidata di installazione del modulo base si avvia lanciando il file Adijed_v6.5.0.exe che si trova nella cartella \ADIUTO V6.5.0\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: Premendo il bottone d uso. verrà visualizzata la schermata contenente i termini del contratto di licenza

12 GUIDA ALL'INSTALLAZIONE PAG. 11 Selezionare Accetto i termini del contratto di licenza e premere successiva. per passare alla schermata 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.

13 GUIDA ALL'INSTALLAZIONE PAG. 12 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

14 GUIDA ALL'INSTALLAZIONE PAG. 13 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. 2.4 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 pacchetto di installazione (cartella SOFTWARE UTILITY ), troviamo due dei database server che possono essere utilizzati con ADIUTO: MICROSOFT SQL EXPRESS 2014 E MICROSOFT SQL EXPRESS È possibile provvedere all installazione di 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 2014/2016 contenuta nel pacchetto, è 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.

15 GUIDA ALL'INSTALLAZIONE PAG. 14 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. L eseguibile da schedulare si trovano nella cartella C:\Programmi\adiJed\workfolder\Utility. In questa cartella è presente un eseguibile: RiavviaTomcat.bat 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.

16 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.

17 3. GUIDA RAPIDA DI INSTALLAZIONE