Entrambe le parti precedenti la revisioneRevisione precedenteProssima revisione | Revisione precedenteUltima revisioneEntrambe le parti successive la revisione |
documentazione_3di:extraway_os:installazione_windows [2017/08/02 11:59] – [Extraway] llagonigro | documentazione_3di:extraway_os:installazione_windows [2019/09/24 10:52] – Attualizzazione della documentazione mpascale |
---|
* Windows server 2008 r2 64bit | * Windows server 2008 r2 64bit |
* Windows server 2012 64bit | * Windows server 2012 64bit |
| * Windows server 2016 64bit |
* Antivirus che possa essere configurato con eccezioni per quanto riguarda il controllo dei processi (ad esempio panda non funziona) | * 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)) | * Accesso tramite remote desktop o vnc ((Nel caso si voglia usufruire dell'assistenza da remoto da parte di 3DI)) |
===== Installazione ===== | ===== Installazione ===== |
==== Anatomia del cd di installazione ==== | ==== Anatomia del pacchetto di installazione ==== |
Il cd di installazione contiene i moduli di ExtraWay Platform suddivisi in cartelle, di seguito la funzione di ogni componente: | Il cd di installazione contiene i moduli di ExtraWay Platform suddivisi in cartelle, di seguito la funzione di ogni componente: |
\\ | \\ |
* <color #004000>**jre:**</color> Contiene il Java Runtime Environment (jre-1_6_0_20). | * <color #004000>**jdk:**</color> Contiene il Java Runtime Environment (jre-1_8.x). |
* <color #004000>**LibreOffice:**</color> contiene l'eseguibile per l'installazione di LibreOffice, utilizzato per la conversione degli allegati. | |
* <color #004000>**tomcat:**</color> contiene l'applicativo Apache Tomcat che ospita l'applicazione java. | * <color #004000>**tomcat:**</color> contiene l'applicativo Apache Tomcat che ospita l'applicazione java. |
* <color #004000>**3di.it\console\xway:**</color> contiene la console java e il suo file di contesto xway.xml da utilizzare con tomcat. | * <color #004000>**console.war:**</color> contiene la console java 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>**3di.it\platform:**</color> contiene i due servizi che compongono il sistema di conversione/indicizzazione dei file, FCA e FCS. |
* <color #004000>**3di.it\webservices:**</color> al suo interno sono presenti, il client e il servizio SOAP, che pubblicano I metodi di accesso diretto a Extraway, e danno la possibilità di interfacciare applicativi esterni sulla base documentale. | * <color #004000>**3di.it\webservices:**</color> al suo interno sono presenti, il client e il servizio SOAP, che pubblicano I metodi di accesso diretto a Extraway, e danno la possibilità di interfacciare applicativi esterni sulla base documentale. |
* <color #004000>**3di.it\extraway\xw\db:**</color> Contiene un archivio di esempio con alcuni record di esempio, utilizzabile con i webservices. | * <color #004000>**3di.it\extraway\xw\db:**</color> Contiene un archivio di esempio con alcuni record di esempio, utilizzabile con i webservices. |
* <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>**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>**fcs_utils:**</color> contiene contiene le utility di terze parti per la conversione degli allegati. | |
| |
==== Java ==== | ==== Java ==== |
Eseguire il setup di java dalla cartella Jre del cd. | Eseguire il setup di java dalla cartella Jre del pacchetto. |
\\ | \\ |
Non è necessario cambiare alcuna configurazione durante l'esecuzione del setup. Di base il Java Runtime Environment ha come destinazione <color #004000>C:\Programmi\Java\jre6\</color>. | Non è necessario cambiare alcuna configurazione durante l'esecuzione del setup. Di base il Java Runtime Environment ha come destinazione <color #004000>C:\Programmi\Java\jdk8\</color>. |
\\ | \\ |
| |
==== Tomcat ==== | ==== Tomcat ==== |
Eseguire il setup di tomcat dalla cartella del cd. Anche qui non è necessario modificare alcuna impostazione durante l'esecuzione del setup and eccezione della cartella di destinazione: <color #004000>e:\Programmi\Apache Software Foundation\Tomcat 6.0</color> | Eseguire il setup di tomcat dalla cartella del cd. Anche qui non è necessario modificare alcuna impostazione durante l'esecuzione del setup and eccezione della cartella di destinazione: <color #004000>e:\Programmi\Apache Software Foundation\Tomcat 7.0</color> |
* <color darkblue>Cambiare la directory di installazione di Tomcat in 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 7.0.</color> |
\\ | \\ |
Una volta terminata l'installazione apparirà un icona con il logo di Apache Tomcat nel System Tray. | Una volta terminata l'installazione apparirà un icona con il logo di Apache Tomcat nel System Tray. |
{{:documentazione_3di:installazione_titulus3_docway3:tomcat_conf_java.jpg|}} | {{:documentazione_3di:installazione_titulus3_docway3:tomcat_conf_java.jpg|}} |
\\ | \\ |
* <color darkblue>Indicare il percorso: C:\Programmi\Java\jre6\bin\client\jvm.dll in "Java Virtual Machine".</color> | * <color darkblue>Indicare il percorso: C:\Programmi\Java\jdk8\jre\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 non dovrebbe mai essere impostata a meno di 1GB, per evitare che, durante lo scaricamento o l'inserimento di file molto grandi, si esaurisca la memoria disponibile. Tuttavia questo valore può essere aumentato se c'è disponibilità sul sistema.)) | * <color darkblue>Indicare "1024" in "Maximum Memory Pool".</color>((La quantità di memoria massima che Tomcat può utilizzare non dovrebbe mai essere impostata a meno di 1GB, per evitare che, durante lo scaricamento o l'inserimento di file molto grandi, si esaurisca la memoria disponibile. Tuttavia questo valore può essere aumentato se c'è disponibilità sul sistema.)) |
\\ | \\ |
<user username="admin" password="xxxxxx" roles="admin,manager"/> | <user username="admin" password="xxxxxx" roles="admin,manager"/> |
| |
* <color darkblue>Inserire nel valore role dell'utente admin nel file e:\Programmi\Apache Software Foundation\Tomcat 6.0\conf\tomcat-users.xml il valore admin.</color> | * <color darkblue>Inserire nel valore role dell'utente admin nel file e:\Programmi\Apache Software Foundation\Tomcat 7.0\conf\tomcat-users.xml il valore admin.</color> |
=== Cifratura delle password nel tomcat-users.xml === | === 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: | 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: |
==== Console ==== | ==== Console ==== |
Di base l'applicativo viene installato nel disco dedicato che per comodità indicheremo come e: | 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> | * <color darkblue>Copiare la cartella 3di.it dal pacchetto 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: | Per fare in modo che tomcat visualizzi l'applicazione è necessario copiare il file <color #004000>console.war</color> all'interno della cartella webapps 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: | è possibile specificare un path diverso utilizzando un context file 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/console/xway" debug="0" privileged="true"> | <Context path="/console" docBase="e:/3di.it/console" debug="0" privileged="true"> |
<ResourceLink name="xway" global="UserDatabase" type="org.apache.catalina.UserDatabase"/> | <ResourceLink name="xway" global="UserDatabase" type="org.apache.catalina.UserDatabase"/> |
<!-- | <!-- |
* <color darkblue>Copiare dalla cartella e:\3di.it\console\xway il file xway.xml nella cartella e:\programmi\Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost\</color> | * <color darkblue>Copiare dalla cartella e:\3di.it\console\xway il file xway.xml nella cartella e:\programmi\Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost\</color> |
| |
==== Microsoft Visual C++ 2008 Redistributable ==== | ==== Microsoft Visual C++ 2008/2011 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> | Prima dell'installazione del servizio extraxay sarà necessario installare dal pacchetto Microsoft Visual C++ 2008/2011 Redistributable, eseguendo <color darkblue> vcredist_x86.exe dalla cartella msvc9</color> |
| |
| |
==== Servizi di Conversione dei file (FCA, FCS, LibreOffice) ==== | ==== Servizi di Conversione dei file (FCA, FCS, LibreOffice) ==== |
=== Installazione di 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>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. | Non sono necessarie altre modifiche alle impostazioni del setup di LibreOffice. |
| |
=== File Conversion Agent (FCA) === | === File Conversion Agent (FCA) === |
<WRAP center round info 70%> | Seguire le istruzioni di installazione per windows (32 e 64 bit) |
Per installare come servizi l'fca e fcs lanciare l'install.bat da console di amministrazione. | |
</WRAP> | |
| |
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:\Programmi\Java\jre6\bin\client\jvm.dll | |
call fca.bat | |
| |
* <color darkblue>Inserire per la variabile "_J" il valore "C:\Programmi\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) === | === 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): | Seguire le istruzioni di installazione per windows (32 e 64 bit) |
... | |
| |
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:\Programmi\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 === | === 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>. | 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. |
* <color darkblue>Installare Imagemagick in e:\programmi</color> | * <color darkblue>Installare Imagemagick in e:\programmi</color> |
| |
| |
==== Webservices ==== | ==== Webservices ==== |
Solitamente i webservice si trovano nel percorso <color #004000>E:\3di.it\webservices\</color>. | Solitamente i webservice si trovano nel percorso <color #004000>E:\3di.it\webservices\</color>. |
\\ | \\ |
Per installarli è necessario inserire nella cartella di configurazione di Tomcat i due file <color #004000>xJwsClient.xml</color> e <color #004000>3diws.xml</color>. Come il file xway.xml per docway, contengono nell'intestazione il percorso da modificare. | Per installarli è necessario inserire nella cartella di configurazione di Tomcat il file <color #004000>3diws.xml</color>. Come il file console.xml per la console eXtraWay, contengono nell'intestazione il percorso da modificare. |
| |
* <color darkblue>Copiare il file xJwsClient.xml dalla cartella E:\3di.it\webservices\</color> | |
* <color darkblue>Modificare il file xJwsClient.xml e inserire il percorso E:\3di.it\webservices\xJwsClient</color> | |
* <color darkblue>Copiare il file 3diws.xml dalla cartella E:\3di.it\webservices\</color> | * <color darkblue>Copiare il file 3diws.xml dalla cartella E:\3di.it\webservices\</color> |
* <color darkblue>Modificare il file 3diws.xml e inserire il percorso E:\3di.it\webservices\3diws</color> | * <color darkblue>Modificare il file 3diws.xml e inserire il percorso E:\3di.it\webservices\3diws</color> |