La cartella di riferimento è “storage/RELEASE/Bridge”. Qui sono presenti i pacchetti obsoleti e gli appunti lasciati da Simone Stagni.

Per la versione aggiornata, andare su nexus in “releases/ExtraCDBridge” http://gitlab.bo.priv/progetti/extracdbridge

instruzioni.txt

EXTRAWAY BRIDGE
 
*** NUOVA INSTALLAZIONE ***
 
-decomprimere lo zip base e poi lo zip aggiornamento
-creare archivio extrawaybridge (il conf si trova dentro la cartella META-INF)
 
WEB-INF/web.xml
-impostare parametri per invio email di errore (smtpHost, smtpPort, smtpProtocol, smtpUser, smtpPwd, emailDest, emailSender)
-impostare eventualmente autostartAgent a true se si vuole attivare l'avvio automatico dell'agent
 
WEB-INF/classes/extraway-bridge-config.xml
-inserire utenti con ruolo amministratore (di base sono già inseriti gli utenti admin e extrawaybridge)
 
tomcat-users.xml
-inserire utente extrawaybridge con ruolo xwbridgeuser
 
*** AGGIORNAMENTO ***
-se aggiornamento rimuovere dalla installazione corrente la cartella lib (non obbligatorio ma consigliabile se si tratta di una versione particolarmente vecchia) e
 decomprimere lo zip aggiornamento
 
*** CONFIGURAZIONE SORGENTI/SERVIZI ***
se servizio LEGALDOC
-policy jar
 
se sorgente DOCWAY
-occorre collegarsi a web service 3diws protetti con autenticazione (user deve essere utente in ACL). Ricordarsi che i 3diws devono avere settate correttamente le property
 relative a DocWay
-si suggerisce di avere un alias per il db xdocwaydoc (es: dcw) e configurarlo nel wizard. Ricordarsi di impostare nel tomcat-users.xml i ruoli dcw (o nome dell'alias) e
 jwsadmin per l'utente ocnfigurato (si tratta dello authuser e non dell'utente della init)

La webapp va installata nella cartella “webservices” (su Windows x:\3di.it\webservices\; su Linux su /opt/3di.it/webservices/ ) .

• Scompattare l'archivio zip che contiene l'installazione base;
• Cancellare la cartella lib ( eXtraCDBridge/WEB-INF/lib );
• Sovrascrivere con il pacchetto della versione desiderata.

Collegarsi alla console di eXtraWay creiamo l'archivio del extrawaybridge. Il file di configurazione è presente in “eXtraCDBrigde/META-INF”. (NB: Prima creare la cartella 'extrawaybridge' nel percorso seguente: '\3di.it\extraway\xw\db' al cui interno và inserito il file di conf 'extrawaybridge.conf.xml')

Creare un alias per il database xdocwaydoc es:dcw.

Aggiungere riga x alias dcw nel file 'xw.ini' all'interno della cartella “\3di.it\extraway\xw\conf” nella sezione:

...
[Archivi]
; Indicare gli alias d'archivio ed il loro percorso completo
;<alias>=<percorso e nome del file>.stat.xml
 
xdocwaydocper=d:\3di.it\extraway\xw\db\xdocwaydoc-per\xdocwaydoc-per.stat
 
xdocwaydoc-perper=d:\3di.it\extraway\xw\db\xdocwaydoc-per\xdocwaydoc-per.stat
 
xdocwayprocper=d:\3di.it\extraway\xw\db\xdocwayproc-per\xdocwayproc-per.stat
 
xdocwayproc-per=d:\3di.it\extraway\xw\db\xdocwayproc-per\xdocwayproc-per.stat
 
dcw=d:\3di.it\extraway\xw\db\xdocwaydoc\xdocwaydoc.stat
 
.. 

Nel file tomcat-users.xml:

• inserire utente extrawaybridge con ruolo xwbridgeuser;
• inserire utente user con password “password” come scritto nel file web.xml
• aggiungere il ruolo (alias creato prima) per l'utente di servizio (es: xwservice);

Aggiungere nei security constaint nel web.xml dei 3diws il ruolo alias per le chiamate nel Bridge

...
        <auth-constraint>
                    <role-name>jwsuser</role-name>
                    <role-name>jwsadmin</role-name>
                    <role-name>jspuser</role-name>
                    <role-name>dcw</role-name>
                </auth-constraint>
        </security-constraint>
 
        <login-config>
                <auth-method>BASIC</auth-method>
                <realm-name>eXtraWay Java Web Services</realm-name>
        </login-config>
 
        <security-role>
                <role-name>jspuser</role-name>
    </security-role>
 
    <security-role>
                <role-name>jwsuser</role-name>
    </security-role>
 
    <security-role>
                <role-name>jwsadmin</role-name>
    </security-role>
 
        <security-role>
                <role-name>dcw</role-name>
    </security-role>
 
...

Modificare il file 'ExtraCDBridge.xml' con l'indirizzo corretto del docBase (path dove abbiamo installato ExtraCDBridge) \Program Files\Apache Software Foundation\Tomcat 7.0\conf\Catalina\localhost

docBase=“\3di.it\webservices\ExtraCDBridge”

Link di test http://localhost:8080/ExtraCDBridge/Login

In fase di aggiornamento rimuovere dall'installazione corrente la cartella lib (../ExtraCDBridge/WEB-INF/lib) e successivamente decomprimere l'archivio zip con l'aggiornamento sovrascrivendo.