Installazione su piattaforma Windows

In questo documento si tratterà l'installazione di TITULUS su server Microsoft Windows.

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 TITULUS dipendono dalla velocità dei dispositivi di memorizzazione, dalla velocità della rete e, per la gestione di allegati non testuali, dalla memoria RAM.

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

Per un utilizzo medio:

• Processore Intel 2 Duo o Quad o compatibile
• 4 GB di RAM
• Almeno 3 dischi SATA in RAID 5 o un sistema alternativo di memorizzazione
• Almeno 300 GB dedicati allo storage
• Scheda di rete Gigabit o superiore
• Alimentazione tramite gruppo di continuità

• Windows Server 2003 SP2 o Windows Server 2008 SP2 (non domain controller¹⁾)
• Internet Information Server 6.0 o superiore
• Antivirus che possa essere configurato con eccezioni per quanto riguarda il controllo dei processi (ad esempio panda non funziona)
• Microsoft .NET 3.5 o superiore

• Windows XP SP2
• Windows Vista
• Windows 7
• Mac OS X > 10.5 ²⁾
• Linux Ubuntu > 8.10 ³⁾
• Linux Fedora > 10 ⁴⁾
• Linux Suse > 10 ⁵⁾

• Internet Explorer 6 sp 1 ⁶⁾
• Internet Explorer 7
• Internet Explorer 8
• Mozilla Firefox 2.0.17 ⁷⁾
• Mozilla Firefox 3.x ^{8) 9)}

Con Internet explorer è possibile usufruire dell'autenticazione automatica tramite le credenziali di Dominio¹⁰⁾.

Inoltre, per l'uso del workflow designer, è necessario installare il Java Runtime Environment (JRE) in versione 1.5 o superiore.

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 administrator o Power User sulla macchina client.
Il plug-in integra funzioni di:

• interfacciamento con lo scanner direttamente da browser
• stampa segnatura
• visualizzazione e stampa immagini acquisite con scanner
• integrazione con supporti di firma digitale
• registrazione contemporanea di più file (‘Sfoglia’ multipli)

Pertanto risulta di elevata utilità per le postazioni di registrazione di documenti (in arrivo o in partenza).
Attualmente il plug-in IW è compatibile solo con i browser della famiglia Internet Explorer. Per emulare Internet Explorer dall’interno di Mozilla Firefox e quindi poter far uso del plug-in anche dall’interno di Firefox, si suggerisce l’installazione del componente aggiuntivo IE Tab per Firefox.

Il cd di installazione contiene i moduli di TITULUS suddivisi in cartelle, di seguito la funzione di ogni componente:

• jre: Contiene il Java Runtime Environment (jre-1_6_0_16).
• msxml: contiene un un modulo microsoft per la trasformazione degli xml con fogli di stile (formato .msi).
• Openoffice: contiene l'eseguibile per l'installazione di Openoffice, utilizzato per la conversione degli allegati.
• Osworkflow: contiene le indicazioni su come avviare un flusso documentale di prova.
• tomcat: contiene l'applicativo Apache Tomcat che ospita l'applicazione java.
• Titulus\webapps\xway: contiene l'applicazione java e il suo file di contesto xway.xml da utilizzare con tomcat.
• Titulus\platform: contiene i due servizi che compongono il sistema di conversione/indicizzazione dei file, FCA e FCS.
• fcs_utils: contiene contiene le utility di terze parti per la conversione degli allegati.
• Titulus\platform\Mailstorage: contiene il modulo per l'archiviazione delle mail (MailStorage)
• Titulus\platform\rip: contiene il modulo per l'esportazione del registro di protocollo (RIP)
• titulus\: 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.
• Titulus\extraway\xw: cartella contenente il server per il database eXtraWay.
• Titulus\extraway\xw\db: Contiene l'archivio utilizzato dall'applicativo.
• xw3rdparts: contiene librerie di terze parti per la manipolazione degli xml e la compressione di files con le rispettive licenze d'uso.
• Titulus\webapps\www\isapi: 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.

Eseguire il setup di java dalla cartella jre del cd.
Non è necessario cambiare alcuna configurazione durante l'esecuzione del setup. Di base il Java Runtime Environment ha come destinazione C:\Programmi\Java\jre6\.

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: e:\programmi\Apache Software Foundation\Tomacat 5.5

• Cambiare la directory di installazione di Tomcat in e:\programmi\Apache Software Foundation\Tomacat 5.5.

Una volta terminata l'installazione apparirà un icona con il logo di Apache Tomcat nel System Tray.

• Col tasto destro del mouse accedere al menu “Configure…”.

Nella prima pagina “General” si può notare che l'avvio di Tomcat è impostato su manuale:

• Cambiare l'impostazione “Startup Type” in “Automatic”.

Nella pagina “Java”:

• Indicare il percorso: C:\Progra~1\Java\jre6\bin\client\jvm.dll in “Java Virtual Machine”.
• Indicare “1024” in “Maximum Memory Pool”.¹¹⁾

Per poter utilizzare alcune funzionalità di Tomcat è necessario modificare una sezione del file di configurazione web.xml come segue:

...
<servlet>
  <servlet-name>jsp</servlet-name>
  <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
  <init-param>
    <param-name>fork</param-name>
    <param-value>false</param-value>
  </init-param>
  <init-param>
    <param-name>xpoweredBy</param-name>
    <param-value>false</param-value>
  </init-param>
  <init-param>
    <param-name>compilerSourceVM</param-name>
    <param-value>1.4</param-value>
  </init-param>
  <init-param>
    <param-name>compilerTargetVM</param-name>
    <param-value>1.5</param-value>
  </init-param>
  <load-on-startup>3</load-on-startup>
</servlet>
...

• Inserire le sezioni “compilerSourceVM” e “compilerTargetVM” all'interno del file e:\Programmi\Apache Software Foundation\Tomcat 5.5\conf\web.xml (intorno alla riga 239).

Per poter utilizzare l'utente base di Tomcat (solitamente admin) come utente amministratore di TITULUS è necessario inserire i valori “jspuser” e “admjspuser” al file tomcat-users.xml:

<user username="admin" password="xxxxxx" roles="admin,manager,jspuser,admjspuser"/>

• Inserire nel valore role dell'utente admin nel file e:\Programmi\Apache Software Foundation\Tomcat 5.5\conf\tomcat-users.xml i valori jspuser e admjspuser.

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"/>

• Inserire il parametro “digest=MD5” all'interno dell'attributo “Realm” (UserDatabase)” nel file e:\Programmi\Apache Software Foundation\Tomcat 5.5\conf\server.xml

Di base l'applicativo viene installato nel disco dedicato che per comodità indicheremo come e:

• Copiare la cartella Titulus dal cd in e:\

Per fare in modo che tomcat visualizzi l'applicazione è necessario copiare il file di configurazione xway.xml 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:/Titulus/webapps/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>

• Copiare dalla cartella e:\Titulus\webapps\xway il file xway.xml nella cartella e:\programmi\Apache Software Foundation\Tomcat 5.5\conf\Catalina\localhost\

La configurazione di Titulus risiede in un database relazionale SQLite che si trova nel direttorio “Titulus\conf”.
E' possibile indicare un percorso differente per questo db, introducendo il seguente parametro nel file di context dell'applicazione (cioè “xway.xml”):

<Parameter name="jdbc.uri" value="jdbc:sqlite://<PERCORSO>" override="true"/>

dove <PERCORSO> rappresenta il percorso completo del file del db (es. “e:/Titulus_conf/titulusconf.db3”).

Note:

• Il nome del db (“titulusconf.db3”) non può essere modificato.
• Qualora si utilizzino i web service di Titulus, il parametro “jdbc.uri” deve essere inserito anche nel loro file di context (cioè “titulus_ws.xml” ed eventualmente anche “3diws.xml”).
• Qualora si utilizzi il modulo MSA (per l'archiviazione delle email o per l'interoperabilità tramite PEC), il nuovo percorso del db di configurazione deve essere indicato nel file “e:\Titulus\platform\MailStorage\classes\msa.properties” mediante la seguente notazione:

     jdbc.uri=jdbc:sqlite://<PERCORSO>

• E' possibile utilizzare lo stesso db di configurazione di Titulus per altre webapplication di Titulus secondarie (quando ad esempio si utilizzano sistemi di autenticazione eterogenei), indicandole come slave tramite il parametro:

<Parameter name="slave" value="true" override="true"/>

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 e:\Titulus\platform\MailStorage\bin\ si trova lo script install.bat 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:\Titulus\platform\MailStorage
set MY_JAVA_HOME=%INSTDIR%/lib

• Inserire per la variabile “JVMDLL” il valore “C:\Progra~1\Java\jre6\bin\client\jvm.dll”
• Inserire per la variabile “INSTDIR” il valore “e:\Titulus\platform\MailStorage”
• Eseguire lo script per installare il modulo

Il modulo per esportare il registro di protocollo (RIP) risiede solitamente nel percorso e:\Titulus\platform\rip.
Nella cartella E:\Titulus\platform\rip\bin\ si trova il file rip.bat. 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:\Titulus\platform\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:/Titulus/platform\rip"</color>

Per poter usufruire di questo servizio, è necessario inserirlo nelle operazioni pianificate di windows:

• Inserire il file e:\Titulus\platform\rip\bin\rip nelle operazioni pianificate di Windows, in modo che sia eseguito ciclicamente (si consiglia un esportazione giornaliera)

Il server per il database solitamente risiede nella cartella e:/Titulus/extraway/.

L'Extraway server richiede alcune librerie di sistema per funzionare. Per installarle è sufficiente lanciare l'eseguibile xw.exe e seguire le instruzioni.

• Eseguire e:\Titulus\extraway\xw\bin\xw.exe

Per poter installare il servizio extraway è necessario eseguire il setup dal percorso e:\Titulus\extraway\xw\bin:

• Eseguire e:\Titulus\extraway\xw\bin\HISETUP.exe
• Premere il tasto “Installa / Avvia” e chiudere il setup

All'interno della cartella xw3rdparts sul cd sono presenti delle librerie di terze parti per alcune funzioni di eXtraway.

• Copiare i files con estensione “dll” dalla cartella xw3rdparts del CD, nella cartella c:\windows\system32

• Eseguire il setup di openoffice
• Scegliere l'installazione personalizzata e inserire come percorso e:\OOo

ATTENZIONE: per il funzonamento di fcs è necessario che openoffice sia installato in un percorso corto¹²⁾
Non sono necessarie altre modifiche alle impostazioni del setup di openoffice.

Una volta completata l'installazione è necessario procedere alla registrazione¹³⁾:

• Aprire Openoffice.org Base dal menu Start
• Effettuare la registrazione (non è necessario compilare i campi) e chiudere openoffice

Si consiglia di disattivare la ricerca automatica degli aggiornamenti.

Le informazioni di registrazione si trovano nella directory %userprofile%\Dati Applicazioni\Openoffice.org2, è necessario compiarle nella cartella dei servizi (profilo di sistema) di Windows. Purtroppo questa cartella cambia a seconda della versione del sistema operativo.

• Windows XP: C:\Documents and Settings\Local Service\Dati applicazioni
• Windows Server 2000 e 2003: C:\Documents and Settings\Default User\Dati applicazioni
• Windows Vista e Server 2008 (32 bit): C:\windows\system32\config\systemprofile\appdata\Roaming
• Windows Vista e Server 2008 (64 bit): C:\windows\sysWoW64\config\systemprofile\appdata\Roaming

ATTENZIONE: Le versioni inglesi di Windows utilizzano la cartella “Application Data” anziché “Dati applicazioni”¹⁴⁾.

• Copiare la cartella di registrazione openoffice.org2 sul profilo di sistema della propria macchina (vedi tabella soprastante)

Il modulo FCA risiede nella cartella e:\Titulus\platform\fca, come nel caso dell'MSA, nel percorso e:\Titulus\platform\fca\bin è presente il file install.bat:

@echo off

set _W=e:\Titulus\platform\fca
set xwbin=e:\Titulus\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

• Inserire per la variabile “_J” il valore “C:\Progra~1\Java\jre6\bin\client\jvm.dll”
• Inserire per la variabile “_W” il valore “e:\Titulus\platform\fca”
• Inserire per la variabile “xwbin” il valore “e:\Titulus\extraway\xw\bin”
• Eseguire lo script per installare il modulo

Il modulo FCS risiede nella cartella e:\Titulus\platform\fcs, come nei casi precedenti, nel percorso e:\Titulus\platform\fcs\bin è presente il solito file install.bat (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:\Titulus\platform\fcs
set _O=E:\OOo

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

...

• Inserire per la variabile “_J” il valore “C:\Progra~1\Java\jre6\bin\client\jvm.dll”
• Inserire per la variabile “_W” il valore “E:\Titulus\platform\fcs”
• Inserire per la variabile “_O” il valore “E:\OOo” (come da installazione OpenOffice)
• A partire dalla versione 3.6.1.0 di FCS è necessario decommentare, a seconda della versione di OpenOffice installata (2.* o 3.*), una delle due versioni della variabile “_L” (classpath di FCS)
• Eseguire lo script per installare il modulo

Per poter utilizzare l'FCS inoltre è necessario installare alcune librerie nel sistema:

• Copiare il contenuto della cartella e:\Titulus\platform\fcs\bin\system32 dal CD nella cartella di sistema di windows c:\windows\system32

Per poter utilizzare alcune delle funzionalità di conversione degli allegati sono necessari questi componenti che si trovano all'interno della cartella fcs_utils del cd. Si consiglia di installare queste utility in c:\programmi. Nel caso si vogliano modificare i percorsi di installazione sarà necessario modificare di conseguenza il file e:\Titulus\platform\fcs\classes\it.extrawaytech.fcs.properties. Mentre Imagemagick ha un setup.exe, Tesseract va copiato direttamente nella cartella Programmi.

* Installare Imagemagick e Tesseract in c:\programmi

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.

• Installare Msxml utilizzando il setup nella cartella msxml del CD

Solitamente i webservice si trovano nel percorso E:\Titulus\webapps\.
Per installarli è necessario inserire nella cartella di configurazione di Tomcat i file xJwsClient.xml, titulus_ws.xml e 3diws.xml. Come il file xway.xml per TITULUS, contengono nell'intestazione il percorso da modificare.

• Copiare il file xJwsClient.xml dalla cartella E:\Titulus\webapps\
• Modificare il file xJwsClient.xml ed inserire il percorso E:\Titulus\webapps\xJwsClient
• Copiare il file titulus_ws.xml dalla cartella E:\Titulus\webapps\
• Modificare il file titulus_ws.xml e inserire il percorso E:\Titulus\webapps\titulus_ws
• Copiare il file 3diws.xml dalla cartella E:\Titulus\webapps\
• Modificare il file 3diws.xml e inserire il percorso E:\Titulus\webapps\3diws

Per poter utilizzare il modulo xw con più di 3000 documenti è necessario attivare le licenze:

• Eseguire e:\titulus\extraway\xw\bin\xw.exe

Nel System tray apparirà un icona con il logo di eXtraWay:


Con il tasto sinistro del mouse sopra l'icona si aprirà la seguente schermata:

• Premere il pulsante “Aggiorna licenza”

Si aprirà un altra finestra col nome “Installazione eXtraWay Server” che richiede “Impostare il numero di postazioni abilitate”.

• Inserire il numero di licenze abilitate da contratto

Apparirà la seguente schermata “Inserire la chiave di abilitazione per”:

Per poter ottenere la chiave di attivazione è necessario comunicare il codice di licenza che compare in alto al servizio di assistenza Kion.

• Inserire il codice di attivazione fornito da Kion
• Inserire il numero di serie che compare nel contratto
• Inserire il nome del responsabile e l'organizzazione

Una volta completata l'attivazione compare una finestra “abilitazione completata” al di sotto della prima finestra, premere ok per chiudere la procedura.