Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- documentazione_3di_riservata:bridge:bridge_installazione [2021/07/19 10:36] – Aggiunta dell'utenza user richiesta per la login nei 3diws fabio.guidotti
+++ documentazione_3di_riservata:bridge:bridge_installazione [Data sconosciuta] (versione attuale) – eliminata - modifica esterna (Data sconosciuta) 127.0.0.1
@@ Linea 1: / Linea 1: @@
-==== Installazione eXtraCDBridge ====
-== Appunti di Simone ==
-LA cartella di riferimento è "storage/RELEASE/Bridge". Qui sono presenti i pacchetti e gli appunti lasciati da Simone Stagni.
-<code txt 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)
-</code>
-=== 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'__)
- <WRAP center round box 60%>
- 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)
-</WRAP>
-==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.