Strumenti Utente

Strumenti Sito


documentazione_3di_riservata:manuali_sviluppo:docker:container_xwee

Questa è una vecchia versione del documento!


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:

  1. Mapping della directory db con una cartella della macchina locale
  2. Mapping della memoria condivisa
  3. Forwarding della porta di eXtraWay
  4. 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)
$ xwee-pidalive.sh #(Controlla se sono presenti file .pid in /var/lib/3di.it/ e li stampa)
$ xwee-cleanpid.sh #(Rimuove i file .pid in /var/lib/3di.it/)DA USARE CON CAUTELA

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
/data/attic/documentazione_3di_riservata/manuali_sviluppo/docker/container_xwee.1504861113.txt.gz · Ultima modifica: da 127.0.0.1