Indice

DocWay3 - Installazione su piattaforma Windows

In questo documento si tratterà l'installazione dell'applicativo per il protocollo DocWay 3 su sitemi Microsoft 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 DocWay 3 dipendono dalla velocità dei dispositivi di memorizzazione, dalla velocità della rete e, per la gestione di allegati non testuali, dalla memoria RAM.

Requisiti Minimi

Consigliati

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

Requisiti software

Server

Client

Macchina client con collegamento di rete diretto al server, si sconsiglia l'utilizzo di indirizzi mappati con tecnologia NAT.

Browser supportati

Con Internet Explorer e Google Chrome è possibile usufruire dell'autenticazione automatica tramite le credenziali di Dominio4).

In aggiunta potrebbe essere necessario installare un Java Runtime Environment per l'esecuzione di alcuni contenuti (applet di firma digitale, soprattutto).

Plugin IW

Per poter utilizzare appieno le funzionalità dell'applicativo, è possibile installare il plugin IW, che integra, tra le altre, funzionalità di stampa e scansione diretta di documenti in DocWay 3. Per installarlo è necessario scaricare il file di installazione dall'interfaccia di DocWay 3 5) oppure utilizzare l'installer MSI disponibile sul nostro FTP. In entrambi i casi, è necessario disporre di diritti amministrativi sulla macchina.

Installazione

Anatomia del cd di installazione

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

Java

Eseguire il setup di java dalla cartella jre del cd.
Non è necessario cambiare alcuna configurazione durante l'esecuzione del setup, bisogna però disabilitare l'installazione della Google Toolbar. Di base il Java Runtime Environment ha come destinazione C:\Programmi\Java\jre6\.

Tomcat

Eseguire il setup di Tomcat dalla cartella del cd. Durante l'installazione sarà necessario modificare il tipo di installazione selezionando come componenti aggiuntivi “Service”, che permette l'avvio automatico come servizio di Tomcat e “Native” che installa le librerie APR native per ottenere maggiori performance e scalabilità.


Sarà inoltre necessario modificare la cartella di destinazione: e:\programmi\Apache Software Foundation\Tomcat 6.0


Una volta terminata l'installazione si dovranno impostare altre opzioni tramite “Configure Tomcat” dal menù delle Applicazioni:


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


Nella pagina “Java”:



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

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

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

Qualora si abilitasse la cifratura bisognerà quindi scrivere la corrispondente password cifrata con l'algoritmo MD5 nel campo password di tomcat-users.xml

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>

Docway

Di base l'applicativo viene installato nel disco dedicato che per comodità indicheremo come 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:/3di.it/DocWay4/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>

Mail Archiver

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:\3di.it\DocWay4\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:/3di.it/DocWay4/MailStorage
set MY_JAVA_HOME=%INSTDIR%/lib

Registro di Protocollo

Il modulo per esportare il registro di protocollo (RIP) risiede solitamente nel percorso e:\3di.it\DocWay4\rip.
Nella cartella E:\3di.it\DocWay4\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:/3di.it/DocWay4/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:/3di.it/DocWay4/rip"</color>



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

Microsoft Visual C++ 2008 Redistributable

Prima dell'installazione del servizio extraxay sarà necessario installare dal CD Microsoft Visual C++ 2008 Redistributable, eseguendo vcredist_x86.exe dalla cartella msvc9

Extraway

Il server per il database solitamente risiede nella cartella e:/3di.it/extraway/.

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




Per poter installare il servizio extraway è necessario eseguire il setup dal percorso e:\3di.it\extraway\xw\bin:

Servizi di Conversione dei file (FCA, FCS, LibreOffice)

Installazione di LibreOffice

Il pacchetto LibreOffice 3.3.1 è disponibile per l'installazione dal sito ftp 3DI.

ATTENZIONE: per il funzonamento di fcs è necessario che LibreOffice sia installato in un percorso corto7)
Non sono necessarie altre modifiche alle impostazioni del setup di LibreOffice.

File Conversion Agent (FCA)

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

@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:\Progra~1\Java\jre6\bin\client\jvm.dll
call fca.bat

File Conversion Service (FCS)

Il modulo FCS risiede nella cartella e:\3di.it\platform\fcs, come nei casi precedenti, nel percorso e:\3di.it\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:\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=..........

...


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

Imagemagick e Tesseract

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 e:\programmi. 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 e:\3di.it\platform\fcs\classes\it.extrawaytech.fcs.properties.

* Installare Imagemagick in e:\programmi

Msxml

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.

Registrazione del servizio eXtraWay

Per poter utilizzare il modulo xw è necessario effettuare la registrazione:

Nel System tray apparirà un icona con il logo di eXtraWay:
Icona nella Tray Bar

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

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 server9).

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

Ordine di avvio dei servizi

L'ordine per effettuare l'avvio dei servizi tramite l'utility services.msc è il seguente:

1)
Nel caso si voglia usufruire dell'assistenza da remoto da parte di 3DI
2) , 3)
per un funzionamento ottimale potrebbe essere richiesto un aggiornamento alla versione attuale
4)
Per poter aggiungere questa funzionalità sia la macchina server sia quella client devono essere unite allo stesso dominio. Vedere sezione IIS
5)
Il link di scaricamento diventa visibile nella schermata di creazione/modifica di un documento o all'apertura di un documento contenente allegati
6)
La quantità di memoria massima che Tomcat può utilizzare in sistemi Windows a 32 bit non dovrebbe mai essere impostata a più di 1GB. Tuttavia è consigliabile non impostare un valore troppo basso, per evitare che durante lo scaricamento o l'inserimento di allegati, si esaurisca la memoria disponibile. Questo valore può essere aumentato tranquillamente su sistemi con java a 64 bit.
7)
Questo problema è causato dalle limitazioni della shell di windows
8)
Il pulsante nelle versioni precedenti era “Aggiorna licenza”
9)
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