Installazione su piattaforma Linux

In questo documento si tratterà l'installazione dell'applicativo per il protocollo nella versione Titulus su sitemi linux e unix in generale.

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

• Processore Intel Pentium 4 o compatibile
• 2 GB di RAM
• Disco rigido dedicato con almeno 100 GB (per un archivio medio con allegati)

Per un utilizzo medio: circa 30 utenti collegati contemporaneamente, un milione documenti.

• Processore Intel Xeon multicore o compatibile;
• 4 GB di RAM;
• Dispositivo di storage ad alta affidabilità (Raid) o moduli esterni (SaN, Sas);
• Almeno 300 GB dedicati allo storage;
• Scheda di rete Gigabit o superiore;
• Alimentazione tramite gruppo di continuità;

TITULUS è stato testato ed è utilizzato con diverse distribuzioni:

• Redhat Enterprise (dalla versione 5)
• Fedora
• Ubuntu Server Edition
• Debian
• Centos

Distribuzioni Linux consigliate:

• Redhat Enterprise 5, 6
• Ubuntu Server 8.04.x, 10.04.x LTS
• fedora 12
• debian 5, 6

È necessario che le seguenti librerie di sistema siano presenti in /lib o /usr/lib:

• libdl.so.2
• libz.so.1
• libstdc++.so.6
• libm.so.6
• libgcc_s.so.1
• libpthread.so.0
• libc.so.6
• libxml2.so.2
• libxslt.so.1
• libsqlite3
• libSM.so.6 ¹⁾
• libXext.so.6 ²⁾

ATTENZIONE: è importante che la distribuzione usata possieda queste librerie nella versione indicate (eventualmente su un aggiornamento della distribuzione). La mancanza di queste librerie comporta il mancato funzionamento di TITULUS.

Per l'indicizzazione degli allegati in formato pdf è necessario installare l'utilità pdftotext.

In molte distribuzioni non è compresa nell'installazione di base: in alcune distribuzioni è presente all'interno del pacchetto xpdf (centos 4, redhat enterprise) o nel pacchetto poppler-utils (gentoo, ubuntu, debian, centos 5).

Per l'indicizzazione e la conversione degli allegati in formato grafico è necessario installare l'utilità ImageMagick.

In alcune distribuzioni non è compresa nell'installazione di base: tuttavia il pacchetto omonimo è solitamente presente tra quelli installabili.

• 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 ^{9) 10)}

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.

• Apache Tomcat 6.0.24
• Sun Java Runtime Environment 1.6.0_16
• Openoffice 3.1.1
• Titulus

E' consigliato mantenere l'installazione dell'applicativo in un dispositivo di memorizzazione separato rispetto a quello che ospita il sistema operativo.
Il pacchetto di installazione fornito da Kion è già configurato per essere installato sotto il direttorio /opt
Montare il dispositivo di memorizzazione scelto sotto /opt e inserire un riga apposita in /etc/fstab

Creare un utente con nome “extraway”. Questo sarà l'utente con cui verranno eseguiti tutti i processi relativi ad Titulus

Copiare il pacchetto di installazione di Titulus nella cartella /opt. Scaricare il pacchetto openoffice per la propria installazione e inserirlo nella cartella /opt

Estrarre il pacchetto Titulus nella cartella /opt.
Es.

/opt# tar xvjf titulus_3.8.12*.tar.bz2

Per garantire il funzionamento dell'applicativo e poter effettuare operazioni di assistenza diretta da parte dei tecnici Kion senza necessità di utilizzare credenziali amministrative (root) è necessario assegnare la cartella /opt all'utente extraway.
Es.

/opt# chown -R extraway:extraway /opt

In alternativa è possibile assegnare ad extraway le singole cartelle in opt, tuttavia ciò potrebbe richiedere accesso amministrativo per effettuare aggiornamenti futuri.

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

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

dove <PERCORSO> rappresenta il percorso completo del file del db (es. “opt/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 ”/opt/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"/>

Estrarre il pacchetto openoffice.
Es.

/opt# tar xzf OOo_3.1.1_LinuxIntel_install_wJRE_en-US.tar.gz

ATTENZIONE: Per la l'installazione e la registrazione di openoffice è necessaria la presenza di una ambiente grafico, Eventualmente si possono utilizzare modalità alternative, ad esempio: abilitare il forwarding di X su ssh o vnc. L'autenticazione di ssh con forwarding di X necessita la presenza di librerire grafiche (Xorg) come Xauth

Eseguire il comando di installazione di openoffice (install.sh) dalla cartella estratta e seguire le indicazioni. Solitamente non è necessario cambiare nessun parametro dall'installazione di default.
Dopo aver terminato l'installazione è necessario registrare openoffice:
Es.

/opt# su - extraway
~$ soffice
~$ exit

Seguire le istruzioni a video dell'interfaccia grafica

Assegnare ad extraway la cartella openoffice
Es.

/opt# chown -R extraway:extraway openoffice.org3

Per poter utilizzare Titulus è necessario ottenere le licenze dal nostro settore commerciale.
Una volta ottenute le licenze eseguire il seguente comando dalla cartella /opt:

/opt~$ ./demo.sh registration

Dopo aver inserito il numero di licenze attivate, apparirà un numero.
Es. (per 10 licenze)

Entrato
Inizializzato
Analisi Parametri
Impostare il numero di postazioni da Abilitare
(-1=annulla, Invio=100):10
Inserire la chiave di abilitazione per 10-76469290

Comunicare all'assistenza Kion il numero ottenuto e inserire la chiave di abilitazione e il numero seriale che verranno forniti in cambio.
Successivamente inserire anche il nome e la società relativo al contratto di licenza.

Per utima cosa bisogna procedere a configurare il sistema operativo per interagire con i componenti in modo automatico.

Gli script per caricare automaticamente l'applicativo all'avvio della macchina (e per riavviarlo l'applicativo in caso di necessità) si trovano sotto il percorso /opt/Titulus/extra/init-files e sono i seguenti:

• tomcat-titulus
• extraway (motore database)
• titulus-fca (File Conversion Agent)
• titulus-fcs (File Conversion Service)
• titulus-msa (Mail Storage Agent)

Tutti accettano i comandi start, stop e restart.

NOTA: gli script all'interno di questa sezione sono tutti configurabili nel caso ci sia necessità di cambiare i percorsi di installazione.

Sono disponibili già per alcune distribuzioni degli script per inserirli automaticamente all'interno del sistema rc.d:

• chkconfig_initd.tar.bz2 Redhat, Fedora e Centos, Debian (da copiare in /etc/init.d e attivare con chkconfig o update-rc.d)

ATTENZIONE: l'esecuzione di alcuni di questi script richiede diritti amministrativi

E' possibile anche installare questi file manualmente. E' necessario creare dei link ai file in /opt/Titulus/extra/init-files/ in /etc/init.d e creare successivamente creare da questi dei link nei diversi runlevel:
Es.

~# ln -s /opt/Titulus/extra/init-files/extraway /etc/init.d/
~# ln -s /etc/init.d/extraway /etc/rc0.d/K20extraway
~# ln -s /etc/init.d/extraway /etc/rc1.d/K20extraway
~# ln -s /etc/init.d/extraway /etc/rc6.d/K20extraway
~# ln -s /etc/init.d/extraway /etc/rc2.d/S79extraway
~# ln -s /etc/init.d/extraway /etc/rc3.d/K79extraway
~# ln -s /etc/init.d/extraway /etc/rc4.d/K79extraway

Si consiglia di spegnere tomcat leggermente prima, di seguito l'ordine di partenza e di spegnimento di tutti i servizi:

• tomcat-titulus: start 80 | stop 19
• extraway: start 79 | stop 20
• titulus-fca: start 79 | stop 20
• titulus-fcs: start 79 | stop 20
• titulus-msa: start 79 | stop 20

L'esportazione del RIP può essere attivata aggiungendo al crontab dell'utente extraway il comando /opt/Titulus/platform/rip/bin/rip
Es.

~$ crontab -e
35 22 * * * /opt/Titulus/platform/rip/bin/rip </dev/null

E' altamente consigliato mantenere un backup dell'intera cartella Titulus (anche incrementale volendo).
Per fare ciò è necessario fermare i servizi extraway e tomcat5 prima di eseguire lo script di backup vero e proprio.

Es. script backup da inserire nel crontab di root:

/etc/init.d/tomcat-titulus stop
/etc/init.d/titulus-msa stop
/etc/init.d/titulus-fcs stop
/etc/init.d/titulus-fca stop
/etc/init.d/extraway stop
<comando backup>
/etc/init.d/extraway start
/etc/init.d/titulus-fca start
/etc/init.d/titulus-fcs start
/etc/init.d/titulus-msa start
/etc/init.d/tomcat-titulus start