Asterisk IT - La telefonia Open Source

Versione adatta alla stampa

Abbiamo già visto come installare IAXmodem e Hylafax e come configurarli sul nostro Asterisk. Oggi vedremo come installare Avantfax, un’applicazione WEB che ci permette di gestire il server Hylafax da una pagina web. Come potete ben capire i vantaggi sono molteplici:

• possibilità di gestire i nostri FAX da qualsiasi luogo dove sia disponibile una connessione a Internet.
• Interfaccia grafica per la gestione e la programmazione dell’invio/ricezione FAX
• Configurazione di più utenti con diversi livelli di accesso
• Smistamento dei fax e delle notifiche, via posta elettronica.

Questa guida è stata testata su una distribuzione Centos. Con le opportune modifiche è valida anche per altri tipi di distribuzioni.

Prima di tutto dobbiamo installare una serie di pacchetti indispensabili per il corretto funzionamento di Avantfax. Prestate bene attenzione quando eseguite yum install che non appaiano messaggi di errore (nel caso di pacchetti già installati il sistema si limiterà a segnalarvelo):

yum install httpd php php-pearphp-mysql php-mbstring mysql-server

yum install netpbm-progs php-pecl-Fileinfo ImageMagick-devel libungif

yum install libpng sudo libtiff ghostscript ghostscript-fonts ImageMagick expect vixie-cron rsync

Terminiamo con questi pacchetti:

yum install php-pear-Mail-Mime php-pear-Mail php-pear-Net-SMTP php-pear-MDB2-Driver-mysql

Se è la prima volta che installate MySQL vi verrà richiesto di configurare una password per l’utente root di MySQL.

Adesso scarichiamo il pacchetto di avantfax:

wget http://switch.dl.sourceforge.net/sourceforge/avantfax/avantfax-3.1.6.tgz

lo scompattiamo:

tar –xf avantfax-3.1.6.tgz

entriamo nella cartella creata:

cd avantfax-3.1.6

A questo punto dobbiamo muovere l’intera cartella “avantfax” contenuta nella cartella avantfax-3.1.6 nel nostro server WEB. Normalmente questa cartella è /var/www/html:

mv avantfax /var/www/htnl/avantfax

entriamo nella cartella:

cd /var/www/html/avantfax

e cambiamo i permessi di due cartelle:

chmod –R 777 tmp

chmod –R 777 faxes

Adesso creiamo alcuni link simbolici di alcuni script presenti in Avantfax nella cartella bin di Hylafax (se installato in /var/spool/hylafax)

ln -s /var/www/html/avantfax/includes/faxrcvd.php /var/spool/hylafax/bin/faxrcvd.php

ln -s /var/www/html/avantfax/includes/dynconf.php /var/spool/hylafax/bin/dynconf.php

ln -s /var/www/html/avantfax/includes/notify.php /var/spool/hylafax/bin/notify.php

Adesso modifichiamo il file di configurazione di ogni singolo modem che vogliamo utilizzare con Avantfax (nel mio caso ttyIAX).

nano /var/spool/hylafax/etc/config.ttyIAX

e aggiungiamo alla fine del file queste linee:

#
## AvantFAX configuration
#
FaxrcvdCmd:     /var/spool/hylafax/bin/faxrcvd.php
DynamicConfig:  /var/spool/hylafax/bin/dynconf.php
UseJobTSI:      true

Salviamo le modifiche e aggiungiamo alcune linee al file di configurazione generale di Hylafax:

nano /var/spool/hylafax/etc/config

#
## AvantFAX configuration
#
NotifyCmd:      bin/notify.php

Salviamo di nuovo le modifiche e rinominiamo il programma per creare l’intestazione dei fax:

mv /usr/bin/faxcover /usr/bin/faxcover.old

Creiamo un link simbolico dello script di avantfax per creare l’intestazione dei fax:

ln -s /var/www/html/avantfax/includes/faxcover.php /usr/bin/faxcover

Un altro link simbolico:

ln -s /usr/share/file/magic* /usr/share/misc/

Avantfax usa un database per gestire tutti i dati (utenti, fax, ecc.). Abbiamo già installato MySQL, adesso creiamo un nuovo utente, il database e le tabelle:

cd /usr/src/avantfax-3.1.6:

mysql -uroot -p < create_user.sql

mysql -uavantfax -pd58fe49 avantfax < create_tables.sql

Se tutto va a buon fine vedremo questo messaggio:

Tables_in_avantfax
AddressBook
AddressBookEmail
AddressBookFAX
BarcodeRoute
DIDRoute
DistroList
DynConf
FaxArchive
FaxCategory
Modems
SysLog
UserAccount
UserPasswords

Creiamo l’utente apache (normalmente configurato nel file di configurazione del server WEB) e l’host 127.0.0.1 (localhost) in hosts.hfaxd. In questo file vengono configurati gli utenti e gli host che hanno accesso al server Hylafax (locali o remoti). Siccome la lista deve avere un ordine ben determinato prima di iniziare cancelliamo il file:

rm /var/spool/hylafax/etc/hosts.hfaxd

/usr/sbin/faxadduser -a password apache

Sostituiamo password con un valore a scelta.

Adesso l’host 127.0.0.1

echo 127.0.0.1 >> /var/spool/hylafax/etc/hosts.hfaxd

Aggiungiamo due script al cron tab che periodicamente aggiorneranno la nostra rubrica e gli utenti configurati in Avantfax:

nano /etc/crontab

aggiugiamo alla fine del file:

0 * * * * /var/www/html/avantfax/includes/phb.php

0 0 * * * /var/www/html/avantfax/includes/avantfaxcron.php -t 2

Salviamo le modifiche e passiamop al file sudoers dove sono configurati i SuperUsers, inserendo l’utente apache e dandogli alcuni privilegi e nello stesso tempo commentado una linea:

nano /etc/sudoers

cerchiamo questa linea:

Defaults    requiretty

e la commentiamo:

#Defaults    requiretty

nella linea seguente inseriamo:

apache ALL = NOPASSWD: /sbin/reboot, /sbin/halt, /usr/sbin/faxdeluser, /usr/sbin/faxadduser -u * -p * *

Salviamo le modifiche. Disattiviamo Selinux per il server web:

setsebool -P httpd_disable_trans 1
setsebool:  SELinux is disabled.

Facciamo ripartire il server WEB:

/etc/init.d/httpd restart

Adesso ci rimane solo da configurare il file di configurazione di Avantfax:

mv /var/www/html/avantfax/includes/local_config-example.php mv /var/www/html/avantfax/includes/local_config.php

nano /var/www/html/avantfax/includes/local_config.php

cerchiamo questa linea:

$FAXRMPWD                       = "password";

e al posto di password mettiamo quella che abbiamo scelto al momento di aggiungere l’utente apache al file hosts.hfaxd

Salviamo le modifiche o se vogliamo controlliamo il resto del file per eventuali configurazioni personalizzate.

A questo punto dovremmo essere in grado di entrare nella pagina di amministrazione di Avantfax.

Nel caso di un’installazione locale:

http://localhost/avantfax/admin

Nel caso di un’installazione remota:

http://mioIP/avantfax/admin

Se avete problemi ad accedere provate a cambiare il proprietario dei files contenuti nella cartella avantfax del server WEB in questo modo:

cd /var/www/html/avantfax

chown –R apache:apache *

Se tutto va bene vedrete questa pagina di login:

 

Entriamo con username admin e password password

Ci verrá subito richiesto di cambiare la password:

 

 

Apparirà la pagina di amministrazione:

 

 

Per prima cosa configuriamo i modem in Avantfax. Dal menu a tendina scegliamo l’opzione Modems:

 

Appena terminato torniamo alla Dashboard e modifichiamo i dati dell’utente Admin. Possiamo configurare tutta una serie di opzioni tra cui la lingua. Appena terminato ci scolleghiamo.

Se configuriamo altri utenti, questi dovranno accedere al server Avantfax dalla seguente pagina:

http://mioIP/avantfax

Concludiamo importando i fax ricevuti in Avantfax con il seguente comando:

cd /var/spool/hylafax; for i in `ls recvq/*`; do bin/faxrcvd.php $i ttyIAX2; done

Sostituite ttyIAX2 con il nome della vostra periferica e ripetete il comando per tutte le periferiche installate.

Per importare i fax inviati:

cd /var/spool/hylafax; for i in `ls doneq/q*`; do bin/notify.php $i done :30; done

Il risultato:

E adesso a divertirsi :)