Questa è una vecchia versione del documento!
Indice
Container eXtraWayEE
Installazione dell'immagine eXtraWayEE
L'immagine docker per eXtraWayEE si trova sul registry locale 3di.
$ docker pull dockerhub.3di.it:5000/xwee
Una volta scaricata si può ritaggare l'immagine per comodità
$ docker tag dockerhub.3di.it:5000/xwee xwee:latest
Avviare un container eXtraWayEE
Prima di tutto occorre eseguire il mount della shared memory in modo da poterla poi passare al container (altrimenti si avrebbe un limite della memoria che renderebbe inutilizzabile il motore, riscontrato errore in create/map su due archivi uno di seguito all'altro):
$ sudo mount none -t tmpfs /mnt/shmxwee/
Una volta effettuato il mount è possibile lanciare il container. Tramite il comando occorre:
- Mapping della directory db con una cartella della macchina locale
- Mapping della memoria condivisa
- Forwarding della porta di eXtraWay
- Dare un nome al container (opzionale)
$ docker run --name xwee -v /mnt/shmxwee/:/dev/shm -v /opt/extraway-ee/db:/opt/3di.it/extraway/xwee/db -p 4859:4859 -d xwee
Una volta lanciato questo comando verrà eseguito lo stack (xwee - fca - fcs - tomcat7)
Per avere una shell nel container si utilizza il comando :
$ docker exec -ti <CONTAINER_NAME> /bin/bash
Dopo aver avviato il container verificate che il server sia registrato!
Per lanciare il container senza avviare lo stack si usa
$ docker run --name xwee -v /mnt/shmxwee/:/dev/shm -v /opt/extraway-ee/db:/opt/3di.it/extraway/xwee/db -p 4859:4859 -ti xwee /bin/bash
Per esporre il servizio FCS all'esterno occorre lanciare il container con il forwarding della porta di FCS (-p 4870:4870)
$ docker run --name xwee -v /mnt/shmxwee/:/dev/shm -v /opt/extraway-ee/db:/opt/3di.it/extraway/xwee/db -p 4859:4859 -p 4870:4870 -ti xwee /bin/bash
Nel caso in cui si stia montando dall’esterno una directory con gli archivi o si stia arrivando da una differente versione del container di docker (sempre con mount degli archivi) occorre assegnare la directory db di eXtraWay all’utente 'extraway'.
Avviare il container spento
$ docker start <CONTAINER_NAME> (es. goofy_elion)
Attach ad STDIN/STDOUT del container
$ docker attach <CONTAINER_NAME> (es. goofy_elion)
Troubleshooting / Consigli utili
Registrazione del server
Eseguire nel container
$ register.sh $ xweectl restart
Il container va su internet ma non riesce a risolvere i dns .bo.priv
Per qualche oscuro motivo il container ha acquisito 8.8.8.8 come server DNS (probabilmente il tuo resolv.conf è rotto)
Rimuovere il container e e rilanciarlo aggiungendo l'opzione :
--dns=10.17.61.33
Avvio, arresto e riavvio di tutto lo stack eXtraWay-ee/Tomcat/FCA/FCS
$ xwee-startup.sh #(avvia i servizi) $ xwee-shutdown.sh #(ferma i servizi) $ xwee-restart.sh #(Riavvia i servizi)
N.B.: Dopo l'avvio di eXtraWay controllare se il processo relativo al logger è attivo, in caso contrario non verranno scritti i log di eXtraWay. In questo caso seguire i passi descritti in 'How-To in caso di MANCATO AVVIO'.
How-To in caso di MANCATO AVVIO
Eliminare eventuali processi xw rimasti attivi sul server:
$ ps aux | grep xw $ kill <process>
Eliminare i file temporanei di xweelogger:
eXtraWay fino a ver. 1.0.2:
$ ls /tmp/ (presenza di xweelogger.pid) $ rm /tmp/xweelogger.pid
eXtraWay da ver. 1.0.4:
$ ls /var/lib/3di.it (presenza di xweelogger.pid) $ rm /var/lib/3di.it/xweelogger.pid
Eliminare eventuali residui in memoria condivisa
$ rm -rf /dev/shm/*
Gestire i singoli servizi
Start/Stop/Restart di Tomcat (eXtraWay Console)
$ cd /opt/3di.it/extra/init-files/ $ tomcat7 start/stop/restart
Start/Stop/Restart di FCA/FCS
$ /opt/3di.it/extra/init-files/extraway-fcs start/stop/restart $ /opt/3di.it/extra/init-files/extrawayee-fca start/stop/restart
Start/Stop/Restart di xwee
$ xweectl start $ xweectl stop $ xweectl restart