Truedoc

[[TracNav(TOC)]]

h2. Installare e configurare Round Cube

"Roundcube":http://roundcube.net/ è una delle piattaforme di posta web più interessanti fra quelle disponibili, supportando molte funzionalità avanzate ed una interfaccia utente molto gradevole. Non essendo disponibile come pacchetto Debian, descriveremo qui la procedura utilizzata per installarla su una Debian Lenny. 

<pre>

<pre>

tar -xvzf roundcubemail-*-dep.tar.gz

mv roundcubemail-*-dep /srv/roundcube

chown -R root.root /srv/roundcube

</pre>

<pre>

<pre>

cd /srv/roundcube

chown -R www-data.www-data temp logs

</pre>

Si dovrà poi prevedere configurare Apache per fornire accesso all'installazione ed eseguire il codice di ausilio per il controllo e la creazione automatica dei file di configurazione. Nel caso specifico si potrà definire un opportuno _virtual host_ oppure aggiungere le seguenti righe a quello di default:

<pre>

<Directory /srv/roundcube>

        [[AllowOverride]] All

</Directory>

Alias /roundcube /srv/roundcube

</pre>

<pre>

<pre>

a2enmod expires

a2enmod headers

a2enmod deflate

</pre>

<pre>

Una volta riavviato Apache si potrà contattare la pagina di installazione all'indirizzo:

<pre>

http://mio.server.address/roundcube/installer

</pre>

e seguire la procedura di installazione per passi ivi descritta. 

Il primo passo controlla la presenza delle dipendenze necessarie ed opzionali, segnalando cosa manca, nel nostro caso si sono installati i seguenti pacchetti ausiliari:

<pre>

apt-get install libapache2-mod-php5 php5-mcrypt php-pear php5-gd php5-mysql \

                php-net-smtp 

</pre>

(si abbia cura di riavviare apache dopo l'installazione), inoltre sarà necessario anche installare dal sito di backports i pacchetti:

<pre>

apt-get -t lenny-backports install php-mdb2 php-mdb2-driver-mysql php-mail-mime

</pre>

<pre>

Una volta completata l'installazione delle dipendenze, si può passare al passo successivo che richiede l'immissione di una lunga serie di parametri di configurazione. La maggior parte di questi possono essere lasciati al loro valore di default, in sostanza ci sarà da cambiare soltanto quelli relativi alla connessione al database (mettendovi username, password e nome del database) e impostare quelli relativi all'indirizzo del server IMAP e SMTP che si vuole usare (usualmente localhost, supponendo che la webmail giri sul server di posta elettronica).

Si tenga presente che il programma necessita di un database (con [[MySQL]], [[PostgresSQL]] o SQLite). Nel nostro caso si è fatto riferimento a [[MySQL]], sul quale andrà creato un database dedicato all'applicazione che deve essere oppurtunamente inizializzato. Per la creazione iniziale si può fare riferimento alle istruzioni generali riportate in [[MySQLInitConf]], nel nostro caso si sono utilizzati i seguenti comandi (collegandosi da root):

<pre>

CREATE DATABASE roundcubemail /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;

GRANT ALL PRIVILEGES ON roundcubemail.* TO 'roundcube'@'localhost' IDENTIFIED BY 'pwdsegreta'; 

</pre>

Una volta creato il database lo si dovrà inizializzare con lo schema fornito nei sorgenti del programma, nel nostro caso questo è stato fatto con il comando:

<pre>

mysql -u roundcube -p roundcubemail < SQL/mysql.initial.sql

</pre>

(questo passaggio pare non essere necessario nelle versioni più recenti del software che una volta generati ed installati i due file di configurazione come nel paragrafo precedente offre un pulsante di creazione dello schema direttamente dall'interfaccia web).

<pre>

<pre>

chmod 700 installer

</pre>

(oppure spostandola in altra posizione rispetto all'installazione)