Thread: 10.04 - Hylafax w/ Avantfax install guide

disclosure: not official guide means. use build hyalfax/avantfax boxes company work for. put co-worker , myself, , edit needed. how works us, hope works

what hylafax/avantfax? - hylafax application can used sorts of things faxing on linux. avantfax application sits "on top" of hylafax , adds website administering faxes.

use following: 1) receiving faxes contain orders our company , emailing faxes specific inbox or having users log avantfax page server , manage faxes needed there. 2) installing hylafax client send faxes user's desktops using modems on hylafax server. i'm sure other people can use other means, use for.

why 10.04 instead of 12.04? - because haven't verified on 12.04 yet, it's coming

introduction: (straight website)
hylafax:
hylafax enterprise-class system sending , receiving facsimiles sending alpha-numeric pages. software designed around client-server architecture. fax modems may reside on single machine on network , clients can submit outbound job other machine on network. client software designed lightweight , easy port. hylafax designed robust , reliable. fax server designed guard against unexpected failures in software, in configuration, in hardware , in general use. hylafax can support multiple modems , heavy traffic load. not mention, it's open source, if you're going install modem or create new hylafax server, you'll need prepared linux command line use.

administering hylafax avantfax:
avantfax piece of software open source , run on same server hylafax server. helps creating web site showcases faxing that's done through server , can if breaks or if reports need generated.

setting new server
assumptions: tested ubuntu 10.04 , ubuntu build of hylafax package. ubuntu server setup ssh, updated, , ready go.

make sure static ip set something:

code:

#pico /etc/network/inferfaces  auto eth0 iface eth0 inet static address 192.168.1.100 netmask 255.255.255.0 gateway 192.168.1.1 network 192.168.1.0 broadcast 192.168.1.255  dns-nameservers <ips of local dns servers> dns-search <domain name> dns-domain <domain name>

1) install hylafax:

code:

# sudo apt-get install hylafax-server hylafax-client

a) during installs happen @ stage, there couple of pop-ups asking information. please use following in order answers:
which type of setup: internet smarthost
system mail name: <fqdn of server>
smtp relay host: <your relay server>

a) configure software:

code:

# sudo faxsetup

a) choose defaults until asks if want setup modem. once point setup asking if want run faxaddmodem configure modem, choose no. add modems later , possibly once you're on site.

2) install avantfax:

either download software avantfax's website (http://www.avantfax.com/) or wherever store after download. have stored on network share, it's ssh'd /home/user directory.

a) move software you'd reside , untar it

code:

# sudo mv /home/user/avantfax-3.3.3.tgz /opt # sudo cd /opt # sudo tar -xvzf avantfax-3.3.3.tgz

b) move avantfax folder /var/www

code:

# sudo mv avantfax-<version number>/ /var/www

c) run install script (only ever run script 1 time!!)

code:

# sudo cd /var/www # sudo ./debian-install.sh

1) set mysql password whatever want, remember next step

d) create avantfax db

**notice** - i'm setting database default avantfax user's password. please change if don't want people know database password.

code:

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

e) change avantfax log location

code:

# sudo cd /etc/apache2/sites-available # pico default  <virtualhost *:80>  documentroot /var/www/avantfax # servername avantfax  errorlog /var/log/apache2/avantfax-error_log  customlog /var/log/apache2/avantfax-access_log common </virtualhost>

f) restart apache

code:

# sudo apache2ctl restart

g) open browser http://<ip of hylafax server>/avantfax/admin verify avantfax works

1) username: admin password: password
2) change password whatever desire

3) change following file have 127.0.0.1 in faxstat works correctly , modem status shows correctly in avantfax:

code:

# sudo pico /etc/hylafax/hosts.hfaxd  127.0.0.1

4) ensure avantfax can show faxes in inbox , send emails:

code:

# sudo mv /var/spool/hylafax/bin/faxrcvd faxrcvd_hylafax # sudo mv /var/spool/hylafax/bin/faxrcvd.php faxrcvd

5) restart hylafax

code:

# sudo /etc/init.d/hylafax restart

if you're going use system multiple modems attached it, know following: if they're external usb modems, every system reboot have possibility change location (ttyacm0 become ttyacm1), in order around this, setup udev (http://linux.die.net/man/8/udev) rules make them
stay static. couldn't use serial numbers (even though i've found modems unique serial numbers, udevadm can't see them). therefore, create new "rules" file , add rules following:

pico /etc/udev/rules/75-presistent-modems.rules

# line x - modem01 comment line.
subsystems=="usb", kernels=="3-4.3:1.0", symlink+="modem01"

sources/extra info:
project web pages:
hylafax: http://www.hylafax.org/content/main_page
avantfax: http://www.avantfax.com/

useful commands:

code:

# watch faxstat

refreshes "faxstat" every 2 seconds give snapshot of modems have been setup hylafax , current status is.

common errors:
issue - modem says "waiting modem come free" when run faxstat , faxes aren't coming in
fix - restart hylafax service running:

code:

# sudo /etc/init.d/hylafax restart

how reset modem if gets stuck:

code:

minicom -s atz atdt<number call>  ctrl-a,q

congratulations, should have working hylafax w/ avantfax box ready use! after this, setups administrating these boxes (we have ~10 hylafax servers). if there demand have me write of following, please let me know! also, if have critiques, questions, or concerns guide, please don't hesitate pm me!

1) scripted failed faxes report - co-worker created way use mercurial send out , update script that's run daily through crontab email faxes failed, reasons why, , how many failed per modem.
2) install snmp use dell omsa , nagios monitor server hardware

so i'm apparently forum noob , can't edit post, jahape4 showing me issue in guide! below have in there:

code:

# sudo mv /var/spool/hylafax/bin/faxrcvd faxrcvd_hylafax  # sudo mv /var/spool/hylafax/bin/faxrcvd.php faxrcvd

to specific, should following:

code:

# sudo mv /var/spool/hylafax/bin/faxrcvd /var/spool/hylafax/bin/faxrcvd_hylafax  # sudo mv /var/spool/hylafax/bin/faxrcvd.php /var/spool/hylafax/bin/faxrcvd

we're renaming files in place. previous commands renamed them , moved files whatever directory user in. bad

Forum The Ubuntu Forum Community Ubuntu Specialised Support Ubuntu Servers, Cloud and Juju Server Platforms [SOLVED] 10.04 - Hylafax w/ Avantfax install guide

Ubuntu