VoToL - Guida all'installazione

SDSOFT


Contents

1 Introduzione a VoToL

VoToL è un sistema per la gestione elettronica di votazioni, sia semplici che complesse. VoToL può gestire più seggi e più votazioni contemporaneamente mantenendo la sicurezza delle stesse grazie ad un sistema di ''bloccaggio'' del seggio. Solo un determinato votante determinato dal Presidente di Seggio potrà votare in tale seggio, e potrà votare una e una sola volta per una determinata votazione. VoToL gestisce Liste e Candidati asssociati a una lista, tiene traccia delle schede nulle e delle schede bianche ed è personalizzabile per quanto riguarda il numero massimo di candidati votabili e per quanto riguarda il voto disgiunto e il voto di lista.

2 Architettura del sistema

VoToL è un sistema composto da:

  1. Un sistema centrale (o Server) che tiene traccia delle votazioni, dei seggi e dei votanti.
  2. Un numero indeterminato di elaboratori (o Client) con funzioni di ''Seggio di votazione'' ''Presidente di seggio'' (NB: gli elaboratori ''Seggio di Votazione'' e ''Presidente di seggio'' dovranno essere in egual numero; ogni ''Presidente di seggio'' controlla uno e uno solo ''Seggio di Votazione'').

3 Requisiti di sistema per i Client

Unici requisiti per i client sono una connessione di rete ed un browser con supporto per JavaScript.

4 Requisiti di sistema per il Server

Nel sistema Server deve essere presente il seguente software:

  1. Sistema operativo GNU/Linux con pacchetti di installazione in formato RPM1
  2. Motore RDBMS FirebirdSQL2
  3. Application Server Apache Tomcat 53
  4. VoToL
In questa guida verrà trattata solamente l'installazione di VoToL. Si presume quindi che nel server si abbia un'installazione di FirebirdSQL e Tomcat 5 funzionante.

5 Installazione di VoToL

Attenzione: tutti i seguenti comandi devono essere dati da utente ''root''

- Portarsi nella directory /opt

cd /opt

- Decomprimere l'archivio VoToL

tar -xjvf /dove/e'/votol-versione.tar.bz2

- Creare un collegamento per l'esecuzione di backup automatici

cd /etc/cron.daily/

ln -s /opt/votol/bin/autobck votol_backup

- Configurazione di Tomcat 5 per il contesto VoToL

cp /opt/votol/etc/votol.xml /dove/è/installato/tomcat5/conf/Catalina/localhost/votol.xml

- Riavvio dell'application server Tomcat 5

6 Configurazione di VoToL per l'accesso al database

Per configurare VoToL per l'accesso al database è necessario editare 2 files: /opt/votol/etc/votolbck.conf e /opt/votol/app/WEB-INF/web.xml

6.1 Modifica di /opt/votol/etc/votolbck.conf

E' necessario modificare il parametro ''SYSDBAPW'' inserendo la password del SYSDBA di FirebirdSQL.

6.2 Modifica di /opt/votol/app/WEB-INF/web.xml

E' necessario modificare il parametro ''votoldb_jdbc_pass'' inserendo la password del SYSDBA di FirebirdSQL.

7 Configurazione della password per l'accesso al pannello di controllo

Andare con un browser all'url http://nome.del.server:porta_tomcat/votol/

quindi cliccare sul collegamento ''Gestione Votazioni''.

Verranno ora richiesti ''Nome Utente'' e ''Password'': inserire in entrambi i campi

VoToL

Ora andare nella scheda ''Impostazioni'' e modificare Password e Nome Utente.

8 Backup del database

8.1 Backup automatico

Un backup automatico del database viene fatto ogni giorno.

E' possibile consultare i log dei backup automatici andando nella cartella /opt/votol/log

I backup del database vengono salvati nella cartella /opt/votol/backup

8.2 Backup manuale

E' possibile effettuare un backup manuale del database seguendo le istruzioni descritte sotto:

- Effettuare il login sul server come ''root''

- Portarsi nella directory /opt/votol/bin

cd /opt/votol/bin

- Lanciare il comando ''backup''

./backup

Il nuovo backup è stato salvato nella cartella /opt/votol/backup

9 Restore del database

E' possibile effettuare il restore del database seguendo le istruzioni seguenti:

- Effettuare il login sul server come ''root''

- Portarsi nella directory /opt/votol/backup

cd /opt/votol/backup

- Lanciare il comando di restore

/opt/votol/bin/restore backup-da-fare-restore.fbk

10 Assistenza tecnica

Per qualsiasi questione di assistenza è possibile mandare una E-Mail all'indirizzo

ste @ dscnet.org

o consultare il forum su

http://votol.sourceforge.net/


Footnotes

... RPM1
E' consigliata la distribuzione ''Fedora Core''
... FirebirdSQL2
http://www.firebirdsql.org/
... 53
http://jakarta.apache.org/tomcat/

2005-06-20