Differenze

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

--- utenti:extraway_platform_server:installazione_piattaforma_windows [2023/03/09 14:49] – [Tomcat] chiara.pavanati
+++ utenti:extraway_platform_server:installazione_piattaforma_windows [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-====== eXtraWay Platform Server - Installazione su piattaforma Windows ======
-In questo **documento** si tratterà l'**installazione** di **ExtraWay Platform** su piattaforme **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 eXtraWay 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** di **documenti**.
-  * **Processore Intel Xeon multicore** o compatibile;
-  * **4 GB** di **RAM**;
-  * Almeno **3 dischi SATA** in **RAID 5** o un sistema alternativo di memorizzazione;
-  * Almeno **300 GB** sul **sistema** di **memorizzazione** scelto;
-  * **Scheda** di **rete Gigabit** o superiore;
-  * **Alimentazione** tramite **gruppo** di **continuità**.
-===== Requisiti software =====
-==== Server ====
-  * **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)).
-===== 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>**jdk:**</color> Contiene il **Java Runtime Environment** (jre-1_8.x);
-  * <color #004000>**tomcat:**</color> Contiene l'applicativo **Apache Tomcat** che ospita l'applicazione **java**;
-  * <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**;
-  * <color #004000>**3di.it\extraway\xw:**</color> Cartella contenente il **server** per il **database** eXtraWay;
-  * <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.
-==== Java ====
-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\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 7.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**.
-\\
-  * <color darkblue>Col tasto destro del mouse accedere al menu "Configure...".</color>
-\\
-Nella **prima pagina** ''General'' si può notare che l'**avvio** di **Tomcat** è impostato su manuale:
-\\
-''{{:documentazione_3di:installazione_titulus3_docway3:tomcat_conf_gen.jpg|}}''
-\\
-  * <color darkblue>Cambiare 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:\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.))
-\\
-\\
-Per poter utilizzare l'**utente base** di **Tomcat** (solitamente admin) per accedere alla console è necessario inserire il **valore** ''admin'' al **file** <color #004000>tomcat-users.xml</color>:
-  <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 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:
-  <!-- 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>
-=== 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>
-==== Console ====
-Di base l'applicativo viene installato nel disco dedicato che per comodità indicheremo come e:
-  * <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 <color #004000>console.war</color> all'interno della cartella webapps di tomcat:
-è 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="/console" docBase="e:/3di.it/console" 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\console\xway il file xway.xml nella cartella e:\programmi\Apache Software Foundation\Tomcat 6.0\conf\Catalina\localhost\</color>
-==== Microsoft Visual C++ 2008/2011 Redistributable ====
-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>
-==== 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>
-=== 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 ===
-  * <color darkblue>Eseguire il setup di LibreOffice</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) ===
-Seguire le istruzioni di installazione per windows (32 e 64 bit)
-=== File Conversion Service (FCS) ===
-Seguire le istruzioni di installazione per windows (32 e 64 bit)
-=== 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.
-* <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 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 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 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_os:taskbar.jpg|Icona nella Tray Bar}}
-\\
-\\
-Con il tasto sinistro del mouse sopra l'icona si aprirà la seguente schermata:
-\\
-{{:documentazione_3di:extraway_os:xw_reg_main.jpg}}
-\\
-  * <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>
-  * <color darkblue>Inserire il numero di serie (se presente)</color>
-  * <color darkblue>Inserire il nome del responsabile e l'organizzazione</color>
-Una volta completata la registrazione compare una finestra "registrazione completata" al di sotto della prima finestra, premere ok per chiudere la procedura.