| |
| documentazione_3di:installazione_titulus3_docway3:installazione_windows [2013/03/22 12:30] – mballerini | documentazione_3di:installazione_titulus3_docway3:installazione_windows [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1 |
|---|
| ====== Installazione su piattaforma Windows di Docway3 ====== | |
| In questo documento si tratterà l'installazione dell'applicativo per il protocollo Docway3 su sitemi Microsoft Windows. | |
| ===== Requisiti Hardware ===== | |
| Le specifiche della macchina server dipendono principalmente dal numero di utenti che utilizzerà l'applicativo e dal tipo di utilizzo. In linea di massima le prestazioni di Docway3 dipendono dalla velocità dei dispositivi di memorizzazione, dalla velocità della rete e, per la gestione di allegati non testuali, dalla memoria RAM. | |
| ==== Requisiti Minimi ==== | |
| |
| * Processore Intel Xeon 2.00 Ghz o compatibile | |
| * 2 GB di RAM | |
| * Disco rigido dedicato con almeno 100 GB (per un archivio medio con allegati) | |
| |
| ==== Consigliati ==== | |
| |
| Per un utilizzo medio: circa 30 utenti collegati contemporaneamente, un milione documenti. | |
| |
| * Processore Intel Xeon Quad Core o compatibile | |
| * 4 GB di RAM | |
| * Almeno 3 dischi SATA in RAID 5 o un sistema alternativo di memorizzazione | |
| * Almeno 300 GB sul sitema di memorizzazione scelto | |
| * Scheda di rete Gigabit o superiore | |
| * Alimentazione tramite gruppo di continuità | |
| |
| ===== Requisiti software ===== | |
| ==== Server ==== | |
| |
| * Windows server 2003 sp2 con Internet Information Server 6.0 | |
| * Windows server 2008 r2 64bit con Internet Information Server 7.5 | |
| * Windows server 2012 64bit con Internet Information Server 8 | |
| * Antivirus che possa essere configurato con eccezioni per quanto riguarda il controllo dei processi (ad esempio panda non funziona) | |
| * Accesso tramite remote desktop o vnc((Nel caso si voglia usufruire dell'assistenza da remoto da parte di 3DI)) | |
| |
| ==== Client ==== | |
| |
| Macchina client con collegamento di rete diretto al server, si sconsiglia l'utilizzo di indirizzi mappati con tecnologia NAT. | |
| \\ | |
| === Browser supportati === | |
| * Internet Explorer 6 sp 1 ((Sono stati segnalati alcuni errori con il javascript per quanto riguarda il completamento automatico)) | |
| * Internet Explorer 7 | |
| * Internet Explorer 8 ((in modalità compatibile)) | |
| * Internet Explorer 9 ((in modalità compatibile)) | |
| * Mozilla Firefox ((per un funzionamento ottimale potrebbe essere richiesto un aggiornamento alla versione attuale)) | |
| * Chrome ((per un funzionamento ottimale potrebbe essere richiesto un aggiornamento alla versione attuale)) | |
| |
| Con Internet explorer è possibile usufruire dell'autenticazione automatica tramite le credenziali di Dominio((Per poter aggiungere questa funzionalità sia la macchina server sia quella client devono essere unite allo stesso dominio. Vedere sezione IIS)). | |
| \\ | |
| \\ | |
| In aggiunta è necessario avere installata una [[http://java.com| java virtual machine]] della stessa versione del server o superiore. | |
| |
| === Plugin IW === | |
| |
| Per poter utilizzare a pieno le funzionalità dell'applicativo, la prima volta che si accede utilizzando Internet Explorer viene richiesta l'installazione del plugin Highway Imaging Control (IW). Lo scaricamento impiega dai 30 secondi ai 2 minuti e per completare l'installazione sono richiesti i diritti di amministrazione sulla macchina client. | |
| |
| In alternativa è possibile forzare l'installazione del plugin IW da remoto con [[ftp://ftp.3di.it/extra/iw/aggiornaIW.zip|questo script Visual Basic]]. | |
| |
| ===== Installazione ===== | |
| ==== Anatomia del cd di installazione ==== | |
| Il cd di installazione contiene i moduli di Docway3 suddivisi in cartelle, di seguito la funzione di ogni componente: | |
| \\ | |
| * <color #004000>**jre:**</color> Contiene il Java Runtime Environment (jre-1_6_0_18). | |
| * <color #004000>**msxml:**</color> contiene un un modulo microsoft per la trasformazione degli xml con fogli di stile (formato .msi). | |
| * <color #004000>**LibreOffice:**</color> contiene l'eseguibile per l'installazione di LibreOffice, utilizzato per la conversione degli allegati. | |
| * <color #004000>**Osworkflow:**</color> contiene le indicazioni su come avviare un flusso documentale di prova. | |
| * <color #004000>**tomcat:**</color> contiene l'applicativo Apache Tomcat che ospita l'applicazione java. | |
| * <color #004000>**msvc9:**</color> contiene il pacchetto Microsoft Visual C++ 2008 Redistributable, che deve essere installato per il corretto funzionamento dei componenti. | |
| * <color #004000>**3di.it\docway3\xway:**</color> contiene l'applicazione java e il suo file di contesto xway.xml da utilizzare con tomcat. | |
| * <color #004000>**3di.it\platform:**</color> contiene i due servizi che compongono il sistema di conversione/indicizzazione dei file, FCA e FCS. | |
| * <color #004000>**fcs_utils:**</color> contiene contiene le utility di terze parti per la conversione degli allegati. | |
| * <color #004000>**3di.it\docway3\Mailstorage:**</color> contiene il modulo per l'archiviazione delle mail (MailStorage) | |
| * <color #004000>**3di.it\docway3\rip:**</color> contiene il modulo per l'esportazione del registro di protocollo (RIP) | |
| * <color #004000>**3di.it\webservices:**</color> cartella dove è possibile installare il modulo aggiuntivo dei webservice | |
| * <color #004000>**3di.it\extraway\xw:**</color> cartella contenente il server per il database eXtraWay. | |
| * <color #004000>**3di.it\extraway\xw\db:**</color> Contiene l'archivio utilizzato dall'applicativo. | |
| * <color #004000>**xw3rdparts:**</color> contiene librerie di terze parti per la manipolazione degli xml e la compressione di files con le rispettive licenze d'uso. | |
| * <color #004000>**3di.it\docway3\www\isapi:**</color> Contiene i componenti aggiuntivi utilizzati da IIS per comunicare direttamente con tomcat. Al suo interno è presente una directory [bin] dove sono contenute le estensioni per IIS. | |
| |
| |
| ==== Java ==== | |
| Eseguire il setup di java dalla cartella jre del cd. | |
| \\ | |
| Non è necessario cambiare alcuna configurazione durante l'esecuzione del setup, bisogna però disabilitare l'installazione della Google Toolbar. | |
| Di base il Java Runtime Environment ha come destinazione <color #004000>C:\Programmi\Java\jre6\</color>. | |
| \\ | |
| |
| ==== Tomcat ==== | |
| Eseguire il setup di Tomcat dalla cartella del cd. Durante l'installazione sarà necessario modificare il tipo di installazione selezionando come componenti aggiuntivi "Service", che permette l'avvio automatico come servizio di Tomcat e "Native" che installa le librerie APR native per ottenere maggiori performance e scalabilità. | |
| \\ | |
| * <color darkblue>Selezionare Service e Native nelle componenti di installazione.</color> | |
| \\ | |
| Sarà inoltre necessario modificare la cartella di destinazione: <color #004000>e:\programmi\Apache Software Foundation\Tomcat 6.0</color> | |
| * <color darkblue>Cambiare la directory di installazione di Tomcat in e:\programmi\Apache Software Foundation\Tomcat 6.0.</color> | |
| \\ | |
| Una volta terminata l'installazione si dovranno impostare altre opzioni tramite "Configure Tomcat" dal menù delle Applicazioni: | |
| \\ | |
| * <color darkblue>Accedere al menu Programmi -> Apache Tomcat -> Configure Tomcat.</color> | |
| \\ | |
| Nella prima pagina "General" si può notare che l'avvio di Tomcat è impostato su automatico: | |
| \\ | |
| {{:documentazione_3di:installazione_titulus3_docway3:tomcat_conf_gen.jpg|}} | |
| \\ | |
| * <color darkblue>Verificare l'impostazione "Startup Type" in "Automatic".</color> | |
| \\ | |
| Nella pagina "Java": | |
| \\ | |
| {{:documentazione_3di:installazione_titulus3_docway3:tomcat_conf_java.jpg|}} | |
| \\ | |
| * <color darkblue>Indicare il percorso: C:\Progra~1\Java\jre6\bin\client\jvm.dll in "Java Virtual Machine".</color> | |
| * <color darkblue>Indicare "1024" in "Maximum Memory Pool".</color>((La quantità di memoria massima che Tomcat può utilizzare in sistemi Windows a 32 bit non dovrebbe mai essere impostata a più di 1GB. Tuttavia è consigliabile non impostare un valore troppo basso, per evitare che durante lo scaricamento o l'inserimento di allegati, si esaurisca la memoria disponibile. Questo valore può essere aumentato tranquillamente su sistemi con java a 64 bit.)) | |
| \\ | |
| \\ | |
| Per poter utilizzare l'utente base di Tomcat (solitamente admin) come utente amministratore di docway3 è necessario inserire i valori "jspuser" e "admjspuser" al file <color #004000>tomcat-users.xml</color>: | |
| <user username="admin" password="xxxxxx" roles="admin,manager,jspuser,admjspuser"/> | |
| |
| * <color darkblue>Inserire nel valore role dell'utente admin nel file e:\Programmi\Apache Software Foundation\Tomcat 6.0\conf\tomcat-users.xml i valori jspuser e admjspuser.</color> | |
| === Cifratura delle password nel tomcat-users.xml === | |
| Di base le password all'interno del file tomcat-users.xml sono in chiaro, per abilitare la cifratura è necessario inserire il parametro "digest=MD5" nel server.xml di Tomcat: | |
| <!-- This Realm uses the UserDatabase configured in the global JNDI resources under the key "UserDatabase". | |
| Any edits that are performed against this UserDatabase are immediately available for use by the Realm. --> | |
| <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase" digest="MD5"/> | |
| |
| * <color darkblue>Inserire il parametro "digest=MD5" all'interno dell'attributo "Realm" (UserDatabase)" nel file e:\Programmi\Apache Software Foundation\Tomcat 6.0\conf\server.xml</color> | |
| Qualora si abilitasse la cifratura bisognerà quindi scrivere la corrispondente password cifrata con l'algoritmo MD5 nel campo password di <color #004000>tomcat-users.xml</color> | |
| === Abilitare permessi di scrittura sul tomcat-users.xml === | |
| Di base il file tomcat-users.xml è aperto in sola lettura, per abilitare il permesso di scrittura è necessario inserire il parametro "readonly=false" nel server.xml di Tomcat: | |
| <GlobalNamingResources> | |
| <!-- Editable user database that can also be used by | |
| UserDatabaseRealm to authenticate users | |
| --> | |
| <Resource name="UserDatabase" auth="Container" | |
| type="org.apache.catalina.UserDatabase" | |
| description="User database that can be updated and saved" | |
| factory="org.apache.catalina.users.MemoryUserDatabaseFactory" | |
| pathname="conf/tomcat-users.xml" readonly="false" /> | |
| </GlobalNamingResources> | |
| |
| * <color darkblue>Inserire il parametro "readonly=false" all'interno dell'attributo "Realm" (UserDatabase)" nel file e:\Programmi\Apache Software Foundation\Tomcat 6.0\conf\server.xml</color> | |
| ==== Docway ==== | |
| Di base l'applicativo viene installato nel disco dedicato che per comodità indicheremo come e: | |
| * <color darkblue>Copiare la cartella 3di.it dal cd in e:\</color> | |
| \\ | |
| Per fare in modo che tomcat visualizzi l'applicazione è necessario copiare il file di configurazione <color #004000>xway.xml</color> all'interno della cartella di configurazione di tomcat: | |
| |
| questo file è utilizzato per localizzare l'applicativo sul disco, al suo interno sono presenti dei percorsi che vanno valorizzati in relazione alla posizione della applicazione. Ad esempio: | |
| |
| <Context path="/xway" docBase="e:/3di.it/docway3/xway" debug="0" privileged="true"> | |
| <ResourceLink name="xway" global="UserDatabase" type="org.apache.catalina.UserDatabase"/> | |
| <!-- | |
| Uncomment this Valve to limit access to this app to localhost for security reasons. | |
| Allow may be a comma-separated list on hosts (or even regular expressions). | |
| --> | |
| <!-- | |
| <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127.0.0.1,localhost"/> | |
| --> | |
| </Context> | |
| |
| * <color darkblue>Copiare dalla cartella e:\3di.it\docway3\xway il file xway.xml nella cartella e:\programmi\Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost\ (da creare)</color> | |
| |
| ==== Mail Archiver ==== | |
| Il modulo Mail Storage Agent (MSA) consente di inserire delle mail all'interno del protocollo, semplicemente spedendole ad un indirizzo creato ad hoc. | |
| \\ | |
| \\ | |
| All'interno della cartella <color #004000>e:\3di.it\docway3\MailStorage\bin\</color> si trova lo script <color #004000>install.bat</color> per l'installazione automatica del modulo MSA: | |
| @echo off | |
| | |
| @rem TODO: | |
| @rem impostare INSTDIR | |
| @rem verificare la variabile d'ambiente JAVA_HOME, se assente inserirlo nel presente file | |
| @rem verificare percorso del file di log in classes/log4j.properties | |
| set JVMDLL=C:\Progra~1\Java\jre6\bin\client\jvm.dll | |
| set INSTDIR=e:/3di.it/docway3/MailStorage | |
| set MY_JAVA_HOME=%INSTDIR%/lib | |
| |
| * <color darkblue>Inserire per la variabile "JVMDLL" il valore "C:\Progra~1\Java\jre6\bin\client\jvm.dll"</color> | |
| * <color darkblue>Inserire per la variabile "INSTDIR" il valore "e:/3di.it/docway3/MailStorage"</color> | |
| * <color darkblue>Eseguire lo script per installare il modulo</color> | |
| |
| ==== Registro di Protocollo ==== | |
| Il modulo per esportare il registro di protocollo (RIP) risiede solitamente nel percorso <color #004000>e:\3di.it\docway3\rip</color>. | |
| \\ | |
| Nella cartella <color #004000>E:\3di.it\docway3\rip\bin\</color> si trova il file <color #004000>rip.bat</color>. Come nel caso dell'MSA è necessario impostare i percorsi in modo corretto: | |
| @echo off | |
| | |
| @rem TODO: | |
| @rem impostare INSTDIR | |
| @rem verificare la variabile d'ambiente JAVA_HOME, se assente inserirlo nel presente file | |
| @rem verificare percorso del file di log in classes/log4j.properties | |
| @rem impostare eventuali parametri nella variabile PARAMETERS | |
| set JAVA_HOME=C:\Programmi\Java\jre6 | |
| set INSTDIR=E:/3di.it/docway3/rip | |
| set MY_JAVA_HOME=%INSTDIR%/lib | |
| * <color darkblue>Impostare alla variabile "JAVA_HOME" il valore "C:\Programmi\Java\jre6"</color> | |
| * <color darkblue>Impostare alla variabile "INSTDIR" il valore "E:/3di.it/docway3/rip"</color> | |
| \\ | |
| \\ | |
| __Per poter usufruire di questo servizio, è necessario inserirlo nelle operazioni pianificate di windows__: | |
| * <color darkblue>Inserire il file e:\3di.it\docway3\rip\bin\rip nelle operazioni pianificate di Windows, in modo che sia eseguito ciclicamente (si consiglia un esportazione giornaliera)</color> | |
| |
| ==== Microsoft Visual C++ 2008 Redistributable ==== | |
| Prima dell'installazione del servizio extraxay sarà necessario installare dal CD Microsoft Visual C++ 2008 Redistributable, eseguendo <color darkblue> vcredist_x86.exe dalla cartella msvc9</color> | |
| |
| ==== Extraway ==== | |
| Il server per il database solitamente risiede nella cartella <color #004000>e:/3di.it/extraway/</color>. | |
| \\ | |
| \\ | |
| L'Extraway server richiede alcune librerie di sistema per funzionare. Per installarle è sufficiente lanciare l'eseguibile xw3dp-setup.exe e seguire le instruzioni. | |
| \\ | |
| * <color darkblue>Eseguire e:\3di.it\extraway\xw\bin\xw.exe</color> | |
| \\ | |
| \\ | |
| \\ | |
| Per poter installare il servizio extraway è necessario eseguire il setup dal percorso <color #004000>e:\3di.it\extraway\xw\bin</color>: | |
| \\ | |
| {{:documentazione_3di:installazione_titulus3_docway3:hisetup_conf.jpg|}} | |
| \\ | |
| * <color darkblue>Eseguire e:\3di.it\extraway\xw\bin\HISETUP.exe</color> | |
| * <color darkblue>Premere il tasto "Installa / Avvia" e chiudere il setup</color> | |
| |
| ==== Servizi di Conversione dei file (FCA, FCS, LibreOffice) ==== | |
| === Installazione di LibreOffice === | |
| Il [[ftp://ftp.3di.it/extra/libreoffice/LibO_3.3.1_Win_x86_install_multi.exe | pacchetto LibreOffice 3.3.1]] è disponibile per l'installazione dal [[ftp://ftp.3di.it/ | sito ftp 3DI]]. | |
| * <color darkblue>Eseguire il setup di LibreOffice</color> | |
| * <color darkblue>Scegliere l'installazione personalizzata e inserire come percorso e:\LibreO~1.org</color> | |
| <color #505050>//ATTENZIONE: per il funzonamento di fcs è necessario che LibreOffice sia installato in un percorso corto((Questo problema è causato dalle limitazioni della shell di windows))//</color> | |
| \\ | |
| Non sono necessarie altre modifiche alle impostazioni del setup di LibreOffice. | |
| \\ | |
| === File Conversion Agent (FCA) === | |
| Il modulo FCA risiede nella cartella <color #004000>e:\3di.it\platform\fca</color>, come nel caso dell'MSA, nel percorso <color #004000>e:\3di.it\platform\fca\bin</color> è presente il file <color #004000>install.bat</color>: | |
| @echo off | |
| | |
| set _W=e:\3di.it\platform\fca | |
| set xwbin=e:\3di.it\extraway\xw\bin | |
| | |
| @rem set JAVA_HOME = | |
| @rem impostarla come variabile di sistema, altrimenti scrivere il percorso esplicito nella variabile sottostante | |
| set _J=C:\Progra~1\Java\jre6\bin\client\jvm.dll | |
| call fca.bat | |
| |
| * <color darkblue>Inserire per la variabile "_J" il valore "C:\Progra~1\Java\jre6\bin\client\jvm.dll"</color> | |
| * <color darkblue>Inserire per la variabile "_W" il valore "e:\3di.it\platform\fca"</color> | |
| * <color darkblue>Inserire per la variabile "xwbin" il valore "e:\3di.it\extraway\xw\bin"</color> | |
| * <color darkblue>Eseguire lo script per installare il modulo</color> | |
| === File Conversion Service (FCS) === | |
| Il modulo FCS risiede nella cartella <color #004000>e:\3di.it\platform\fcs</color>, come nei casi precedenti, nel percorso <color #004000>e:\3di.it\platform\fcs\bin</color> è presente il solito file <color #004000>install.bat</color> (si riporta solo la dichiarazione delle variabili da configurare della versione distribuita a partire dalla release //3.6.1.0// di FCS): | |
| ... | |
| | |
| set _W=E:\3di.it\platform\fcs | |
| set _O=E:\LibreO~1.org | |
| | |
| rem set JAVA_HOME = | |
| rem impostarla come variabile di sistema, altrimenti scrivere il percorso esplicito nella variabile sottostante | |
| set _J=%JAVA_HOME%\jre\bin\server\jvm.dll | |
| | |
| rem CLASSPATH per OO 2 | |
| rem set _L=.......... | |
| | |
| rem CLASSPATH per OO 3 | |
| rem set _L=.......... | |
| | |
| ... | |
| |
| * <color darkblue>Inserire per la variabile "_J" il valore "C:\Progra~1\Java\jre6\bin\client\jvm.dll"</color> | |
| * <color darkblue>Inserire per la variabile "_W" il valore "E:\3di.it\platform\fcs"</color> | |
| * <color darkblue>Inserire per la variabile "_O" il valore "E:\LibreO~1.org" (come da installazione LibreOffice)</color> | |
| * <color darkblue>Eseguire lo script per installare il modulo</color> | |
| \\ | |
| Per poter utilizzare l'FCS inoltre è necessario installare alcune librerie nel sistema: | |
| * <color darkblue>Copiare il contenuto della cartella e:\3di.it\platform\fcs\bin\system32 dal CD nella cartella di sistema di windows c:\windows\system32</color> | |
| |
| === Imagemagick e Tesseract === | |
| Per poter utilizzare alcune delle funzionalità di conversione degli allegati sono necessari questi componenti che si trovano all'interno della cartella <color #004000>fcs_utils</color> del cd. Si consiglia di installare queste utility in <color #004000>e:\programmi</color>. Tesseract dalle ultime versioni è integrato all'interno della cartella platform mentre per imagemagick esiste un setup.exe. Nel caso si vogliano modificare i percorsi di installazione sarà necessario modificare di conseguenza il file <color #004000>e:\3di.it\platform\fcs\classes\it.extrawaytech.fcs.properties</color>. | |
| |
| * <color darkblue>Installare Imagemagick in e:\programmi</color> | |
| |
| ==== Msxml ==== | |
| La libreria msxml è necessaria per la trasformazione dell'xml a livello server. Eseguire il setup dalla cartella omonima del cd, non è necessario modificare nulla nelle impostazioni del setup. | |
| * <color darkblue>Installare Msxml utilizzando il setup nella cartella msxml del CD</color> | |
| |
| ===== Registrazione del servizio eXtraWay ===== | |
| Per poter utilizzare il modulo xw con più di 3000 documenti è necessario attivare le licenze: | |
| * <color darkblue>Eseguire e:\3di.it\extraway\xw\bin\xw.exe</color> | |
| Nel System tray apparirà un icona con il logo di eXtraWay: | |
| \\ | |
| {{:documentazione_3di:extraway:taskbar.jpg|Icona nella Tray Bar}} | |
| \\ | |
| \\ | |
| Con il tasto sinistro del mouse sopra l'icona si aprirà la seguente schermata: | |
| \\ | |
| {{:documentazione_3di:installazione_titulus3_docway3:xw_lic_man.jpg|}} | |
| \\ | |
| * <color darkblue>Premere il pulsante "Aggiorna licenza"</color> | |
| Si aprirà un altra finestra col nome "Installazione eXtraWay Server" che richiede "Impostare il numero di postazioni abilitate". | |
| * <color darkblue>Inserire il numero di licenze abilitate da contratto</color> | |
| Apparirà la seguente schermata "Inserire la chiave di abilitazione per": | |
| \\ | |
| {{:documentazione_3di:installazione_titulus3_docway3:xw_lic_code.jpg|}} | |
| \\ | |
| Per poter ottenere la chiave di attivazione è necessario comunicare il codice di licenza che compare in alto al servizio di assistenza 3DI. | |
| * <color darkblue>Inserire il codice di attivazione fornito da 3DI</color> | |
| * <color darkblue>Inserire il numero di serie che compare nel contratto</color> | |
| * <color darkblue>Inserire il nome del responsabile e l'organizzazione</color> | |
| Una volta completata l'attivazione compare una finestra "abilitazione completata" al di sotto della prima finestra, premere ok per chiudere la procedura. | |
| |
| ===== Ordine di avvio dei servizi ===== | |
| |
| L'ordine per effettuare l'avvio dei servizi tramite l'utility <color darkblue>services.msc</color> è il seguente: | |
| * eXtraWay server | |
| * eXtraWay FCS | |
| * eXtraWay FCA | |
| * eXtraWay Mail Archiver | |
| * Tomcat | |
