Creazione del server

Il server su cui il software si appoggia è creato con il DBMS PostgreSQL. È necessario conoscere la porta di accesso al database creato, nonché lo username e la password per accedervi. Per facilitare la configurazione preliminare del database da parte degli utenti Windows, è consigliabile scaricare il client per PostgreSQL PGadmin, che offre un’interfaccia grafica che semplifica notevolmente la creazione del database.

Nota: I dati di accesso al database verranno richiesti sia in fase di inizializzazione del database, sia all’avvio di ServerES.

Nota: PostgreSQL dovrà essere in esecuzione e con il database avviato durante l’esecuzione del server di Emotional Songs.

Inizializzazione del database

Se è la prima volta che utilizzi Emotional Songs, devi prima inizializzare il database precedentemente creato con PostgreSQL. Questa operazione creerà le tabelle e le relazioni tra di esse, oltre a popolare il repository di canzoni.

Tool di supporto alla creazione delle relazioni della base di dati

Dopo aver scaricato PostgreSQL, creato ed avviato il proprio database, si potrà utilizzare uno specifico tool fornito di seguito che, una volta eseguito, popolerà la base di dati delle necessarie tabelle ed eventualmente anche delle canzoni (fornite nel file .txt presente assieme al tool).

Sarà sufficiente avviare con un doppio click il file .jar, inserire nome utente, password e porta del database e, qualora si vogliano inserire le canzoni, anche i dati del repository di canzoni (inserendo il percorso assoluto del file .txt).

Nota: il file usa come separatore delle tuple la stringa £SEP£.

Clicca qui per scaricare il file RepoData.txt, contenente il repository di canzoni da caricare nella base di dati di Emotional Songs.

Indipendentemente dal sistema operativo utilizzato, è necessario che i client e il server siano connessi alla stessa rete!

Windows

MacOS

Per inizializzare il database su sistema operativo MacOS è sufficiente scaricare l’archivio .zip contenente il tool di inizializzazione in formato .app, facendo clic sul pulsante qui sotto.

Linux e altre piattaforme

Il tool di inizializzazione del database per Linux è reso disponibile sotto forma di file .jar, il quale funziona anche su altre piattaforme che supportano questo tipo di eseguibili.

ServerES

Per permettere a Emotional Songs di interfacciarsi con i servizi offerti dal database, è necessario avviare sulla macchina che ospita il database il software ServerES.

ServerES è scaricabile di seguito:

Windows

MacOS

Linux e altre piattaforme

Una volta avviato, il tool richiederà i dati del database, quali nome e password del DB e numero di porta su cui è raggiungibile il database. Quest’ultima è la stessa porta scelta in fase di creazione del database con PostgreSQL.

Connessione al database

Non appena inseriti tutti i dati, a connessione avvenuta correttamente comparirà una finestra riportante il log della connessione al database.

Finestra di connessione del database

Da questa finestra sono visualizzabili l’indirizzo IP locale del server, nonché la porta a cui è possibile collegarsi tramite Emotional Songs per ottenere i servizi necessari al suo funzionamento.

Inoltre, è presente un pulsante che permette di esportare il log in formato .txt, in caso di necessità.