La seguente guida descrive la procedura necessaria per l'installazione e l'avvio dell'applicazione client di ePAS che si collega ai lettori badge locali sfruttando la piattaforma Docker e l'utilizzo di Docker Compose.
Sono stati sviluppati client di ePAS per interfacciarsi ad alcuni tipi di lettore badge, prima di effettuare l'installazione verificare con il supporto di ePAS se è già disponibile un client per il proprio lettore badge, eventualmente scrivendo a epas@iit.cnr.it.
Al momento sono disponibili alcuni client di ePAS, le due versioni che raccolgono le esigenze comuni sono stati rilasciati come software opensource sono disponibili agli indirizzi:
- https://github.com/consiglionazionaledellericerche/epas-client (client per lettore badge smartclock/fingerclock, per file da cartella locale o da server ftp/sftp)
- https://github.com/consiglionazionaledellericerche/epas-client-sql (client per prelevamento timbrature da database MySQL o MSSQL)
Per le informazioni di installazione e configurazione consultare le pagine github del client a cui si è interessati.
Prerequisiti
Per il corretto funzionamento dell'applicazione sono richieste le seguenti caratteristiche
- Macchina virtuale/fisica con processore a 1 o più core
- Ram 1Gb+
- Spazio disco 20Gb+
- Sistema operativo linux a 64bit con kernel 3.8+
La procedura descritta in questa pagina si riferisce all'installazione su una distribuzione 18.04LTS di Ubuntu
Per verificare i requisiti e per indicazioni specifiche della piattaforma docker su una diversa distribuzione rimandiamo alla guida ufficiale docker
Installazione docker
Installare il client seguendo la guida ufficiale docker
Aggiungere l'utente che utilizzeremo per la gestione dei containers docker al gruppo docker
$ sudo usermod -aG docker utente
E' necessario effettuare il logout e riloggare dopo quest'ultima modifica
Installazione Docker-compose
Per semplificare l'avvio e la gestione delle macchine docker è necessario installare anche il componente docker-compose
Per farlo rimandiamo alla guida ufficiale docker. Se l'installazione è andata a buon fine, il comando
$ docker-compose -v
Visualizzerà la versione appena installata