Questo software permette di avere un’interfaccia web per gestire il proprio server HylaFAX. E’ interamente sviluppato in PHP ed utilizza il database MySQL, semplicissima la sua installazione.

Sito web del software: www.avantfax.com

Per poter installare AvantFAX, il sistema deve avere già:

• HylaFAX
• PHP 5
• PHP PEAR 5 including DB, Mail and Mail_Mime
• PECL FileInfo
• PHP mbstring - for better UTF-8 sorting support (opzionale)
• PHP MySQL 5
• MySQL server 4.1.12 or better
• Apache
• ImageMagick
• ghostscript
• libtiff
• netpbm-progs
• libungif
• sudo
• sendmail/postfix/exim/qmail or other SMTP settings
• a2ps and psutils
• expect

Diamo quindi il comando per l’installazione di questi pacchetti:

# sudo apt-get install php-pear php-db php-mail-mime

	netpbm imagemagick gs-gpl a2ps

	psutils libungif4g libtiff4

Siamo ora pronti a procedere con l’installazione.
Scarichiamo il pacchetto da www.avantfax.com

Rinominiamo il file avantfax/includes/local_config-example.php in avantfax/includes/local_config.php

Apriamo il file avantfax/includes/local_config.php per modificarlo:
- settiamo la lingua italiana specificicata nella variabile $dft_config_lang = “it”;
- date un’occhiata anche al resto dei settaggi, ma per me andavano bene quelli di default

Possiamo mettere ora tutta la directory /avantfax nella sua destinazione finale (ad es. /var/www/avantfax) e diamo alle sottocartelle tmp e faxes i permessi 777:

# chmod -R 777 /var/www/avantfax/tmp /var/www/avantfax/faxes

Creiamo i Symlink alla HylaFAX spool bin directory:

# ln -s /var/www/avantfax/includes/faxrcvd.php

	/var/spool/hylafax/bin/faxrcvd.php

# ln -s /var/www/avantfax/includes/notify.php

	/var/spool/hylafax/bin/notify.php

Modifichiamo ora la configurazione del modem (/etc/hylafax/config.ttyXX) che vogliamo utilizzare con AvantFAX, aggiungiamo quindi al file la seguente riga:

## AvantFAX configuration
#
FaxrcvdCmd:     bin/faxrcvd.php

Modifichiamo anche il file config (es. /etc/hylafax/config) aggiungendo queste righe:

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

Rinominiamo ora la pagina cover di HylaFAX in qualcos’altro:

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

Creiamo al suo posto un Symlink alla cover di HylaFAX:

# ln -s /var/www/avantfax/includes/faxcover.php

	/usr/bin/faxcover

Creiamo il DB MySQL per AvantFAX:

# mysql -uroot -p < create_user.sql
# mysql -uavantfax -pd58fe49 avantfax < create_tables.sql

con la seconda istruzione però il server MySQL mi restituiva un errore, così nel file create_tables.sql ho dovuto eliminare le prime righe che cancellavano e ricreavano il database creato già da create_user.sql (appunto operazione di cui non vedo l’utilità)

Per il supporto alla gestione della coda fax abbiamo bisogno di aver installato il pacchetto “expect” (l’abbiamo già fatto all’inizio, se l’operazione è andata a buon fine)

Aggiungiamo quindi al file /etc/hylafx/hosts.faxd l’utente di Apache (es. apache, wwwrun, www-data). L’utente di Apache deve essere sulla prima riga del file, mentre 127.0.0.1 sulla seconda:

# /usr/sbin/faxadduser -a pwd www-data
# /usr/sbin/faxdeluser localhost
# /usr/sbin/faxdeluser 127.0.0.1
# echo 127.0.0.1 >> /var/spool/hylafax/etc/hosts.hfaxd

Aggiungiamo due script al crontab:

# ogni ora aggiorna la rubrica
0 * * * * /var/www/avantfax/includes/phb.php
# ogni giorno cancella i vecchi file
0 0 * * * /var/www/avantfax/includes/remold.php

A presto punto riavviamo sia Hylafax che Apache.
Possiamo procedere quindi al primo login:

http://10.0.0.1/admin/

i primi dati per autenticarsi sono:

username: afadmin
password: password