Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di:extraway_os:installazione_windows [2012/06/04 12:38] – creata mballerini
+++ documentazione_3di:extraway_os:installazione_windows [2019/09/24 10:52] – Attualizzazione della documentazione mpascale
@@ Linea 22: / Linea 22: @@
 ===== Requisiti software =====
 ==== Server ====
-  * Windows server 2003 sp2 (non domain controller((Per poter utilizzare l'autenticazione integrata di Internet Explorer è necessario che la macchina server si trovi all'interno del dominio, abbiamo notato tuttavia che i domain controller hanno restrizioni sull'utilizzo delle estensioni di IIS e non permettono il corretto funzionamento dell'applicativo))) o Windows server 2008 r2 (si consiglia 64 bit)
+  * Windows server 2003 sp2
+  * Windows server 2008 r2 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)
-  * 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 =====
-==== 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:
 \\
-  * <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>**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\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.
@@ Linea 39: / Linea 40: @@
   * <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>**fcs_utils:**</color> contiene contiene le utility di terze parti per la conversione degli allegati.
 ==== 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 ====
-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.
@@ Linea 65: / Linea 65: @@
 {{: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.))
 \\
@@ Linea 72: / Linea 72: @@
   <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 ===
 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:
@@ Linea 98: / Linea 98: @@
 ==== Console ====
 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"/>
   	<!--
@@ Linea 117: / Linea 117: @@
   * <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>
@@ Linea 137: / Linea 137: @@
   * <color darkblue>Eseguire e:\3di.it\extraway\xw\bin\HISETUP.exe</color>
   * <color darkblue>Premere il tasto "Installa / Avvia" e chiudere il setup</color>
+=== Installazione Versione maggiore di 25.8.0 ===
+Scaricato il pacchetto eXtraway della versione desiderata, copiare il contenuto della cartella 3di.it nel disco locale della macchina e lanciare l'installazione delle librerie microsoft (2008 e 2010 x86 e x64) presenti nella cartella 'vcredist'.
+<WRAP center round info 800%>
+NB: Effettuare le installazione sempre come Amministratore!
+</WRAP>
+Successivamente installare le librerie presenti nella cartella 'xw3dparts' necessarie al server eXtraway lanciando l'eseguibile 'xw3rdp-setup-2012.exe'
+Dopo aver registrato 'applicazione procedere con l'installazione del servizio:
+Aprire un prompt dei comandi (cmd.exe) e digitare il percorso della cartella contenente l'eseguibile xw.exe (es. 'e:\3di.it\extraway\xw\bin\xw.exe') ,
+Lanciare il comando per l'installazione del servizio: 'xw.exe -service_install'
 ==== 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.
 \\
 \\
+<WRAP center round info 90%>
+Su Windows 10 è stato necessario aggiungere il file install_custom.cmd richiamato dall'install.bat settando le variabili JAVA_HOME e JVMDLL
+</WRAP>
 === 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>:
+Seguire le istruzioni di installazione per windows (32 e 64 bit)
-  @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) ===
-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 ===
-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>
 ==== Webservices ====
 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>Modificare il file 3diws.xml e inserire il percorso E:\3di.it\webservices\3diws</color>
 ===== Registrazione del servizio eXtraWay =====
-Per poter utilizzare il modulo xw è necessario registrare il componente:
+Per poter utilizzare il modulo xw è necessario effettuare la registrazione:
   * <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}}
+{{:documentazione_3di:extraway_os:taskbar.jpg|Icona nella Tray Bar}}
 \\
 \\
 Con il tasto sinistro del mouse sopra l'icona si aprirà la seguente schermata:
 \\
-{{:documentazione_3di:extraway:xw_reg_main.jpg}}
+{{:documentazione_3di:extraway_os:xw_reg_main.jpg}}
 \\
-  * <color darkblue>Premere il pulsante "Registration"</color>
+  * <color darkblue>Premere il pulsante "Registration"((Il pulsante nelle versioni precedenti era "Aggiorna licenza"))</color>
 Si aprirà un altra finestra col nome "eXtraWay Server Installation" che richiede "Insert the number of workstations to activate". Il numero di postazioni indica il numero di istanze massime che possono essere attive in contemporanea sul server((Per convenzione di solito questo numero è il numero massimo degli utenti contemporanei  che utilizzeranno il server diviso 15 e può dipendere anche dalle prestazioni della macchina)).
   * <color darkblue>Inserire il numero di postazioni massime</color>