Questa è una vecchia versione del documento!
Installazione eXtraCDBridge
Appunti di Simone
La cartella di riferimento è “storage/releases/Bridge”. Qui sono presenti i pacchetti obsoleti e gli appunti lasciati da Simone Stagni.
Per l'ultima versione aggiornata, andare su nexus in “releases/ExtraCDBridge”
Qui il progetto su gitlab: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 configurato (si tratta dello authuser e non dell'utente della init)
Installazione
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' che si trova in smb:storage/releases/bridge/)
come db (logical) impostiamo extrawaybridge
Impostare come percorso “x:\3di.it\extraway\xw\db\extracdbridge\extracdbridge” (Windows) oppure “/opt/3di.it/extraway/xw/db/extrawaybridge/extracwaybridge” (Linux)
==EXTRAWAY:== 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: <code ini> … [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 .. </code> == Tomcat == 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 <code xml> … <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> … </code> 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 === Aggiornamento === 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.