org
Panduan Setup
Fax server (Hylafax) lengkap dengan Avantfax
di Ubuntu 7.10
page 1 of 16
http://linux2.arinet.org
Pendahuluan
Panduan ini dibuat dengan latar belakang keingintahuan penulis mengenai cara
menyetel fungsi-fungsi server di Ubuntu. Penulis berlatar belakang dari distro keluarga
RedHat seperti Mandriva, Fedora, CentOs, dan Suse (walaupun sebenarnya Suse adalah
keturunan Slackware). Telah kira-kira 8 bulan ini penulis menggunakan distro Ubuntu
yang merupakan keluarga Debian.
Sebenarnya panduan mensetup Fax server menggunakan Hylafax dan Avantfax telah
banyak terdapat di internet, namun sebagian besar dibuat untuk distro keluarga
RedHat, sangat sedikit yang berbasiskan Debian, dalam hal ini Ubuntu. Kalaupun ada,
kebanyakan sudah cukup lama tidak diupdate. Oleh karena itulah juga penulis membuat
panduan ini menggunakan paket-paket yang terbaru.
Latar Belakang
Sebenarnya mengapa sih repot-repot membuat faxserver?
Selama ini kita mengenal mesin fax untuk mengirim dan menerima fax. Tergantung
merek dan tipenya, harga mesin fax dapat mencapai jutaan rupiah.
Oleh karenanya, kini banyak perusahan yang telah menerapkan solusi FaxServer,
karena memberikan keunggulan-keunggulan berikut ini:
1. Tidak perlu maintenance khusus, karena menggunakan sebuah PC sebagai
servernya.
2. Dokumen dapat langsung di fax ke tujuan tanpa harus di print dahulu. Hemat
kertas, tinta, dan fax terkirim dengan kualitas seperti pada di layar komputer.
3. Fax yang masuk disimpan dalam bentuk file PDF di komputer, sehingga terjamin.
4. Fax terkirim/diterima langsung tersimpan dalam folder-folder khusus dalam
bentuk file PDF.
5. Fax yang masuk dapat secara otomatis dikirim melalui email.
page 2 of 16
http://linux2.arinet.org
Baiklah kita mulai, install Ubuntu seperti biasa. Pasang modem ke PC, sambungkan ke
line telpon dan hidupkan.
Selanjutnya kita mulai install-install. Bisa menggunakan synaptic ataupun apt-get dari
console, terserah sesuai kebiasaan kita. Di dalam panduan ini dicantumkan
menggunakan apt-get.
A1. Kita install Postfix dulu. Mengapa? Sebab kalau tidak hylafax akan menginstall pula
Exim mailserver, kalau kita familiar sih tidak apa-apa.
(Tulisan-tulisan yang didahului oleh tanda '#' dan berhuruf tebal berarti adalah
command yang harus kita ketik di console).
Setup saja postfix seperti biasa/default. Secara default postfix sudah dapat mengirim
email.
page 3 of 16
http://linux2.arinet.org
modem. Modem kita biasanya akan terdeteksi sebagai /dev/ttyS0 (serial pertama),
kecuali di contoh panduan ini, karena saya menggunakan modem virtual, maka modem
saya adalah /dev/ttyx0 dan /dev/ttyx1:
# faxsetup
The file:
/etc/hylafax/getty-link
The file:
/etc/hylafax/vgetty-link
The file:
/etc/hylafax/egetty-link
page 4 of 16
http://linux2.arinet.org
Update /var/spool/hylafax/status/any.info.
/etc/init.d/hylafax start
Not starting HylaFAX daemons since they are already running.
You do not appear to have any modems configured for use. Modems are
configured for use with HylaFAX with the faxaddmodem(8) command.
Do you want to run faxaddmodem to configure a modem [yes]?
Serial port that modem is connected to [ttyS0]? ttyx0
Hmm, there does not appear to be an fuser command on your machine.
This means that I am unable to ensure that all processes using the
modem have been killed. I will keep going, but beware that you may
have competition for the modem.
Ok, time to setup a configuration file for the modem. The manual
page config(5) may be useful during this process. Also be aware
that at any time you can safely interrupt this procedure.
page 5 of 16
http://linux2.arinet.org
Your facsimile phone number (5551234) does not agree with your
country code (1) or area code (021). The number
should be a fully qualified international dialing number of the form:
Spaces, hyphens, and periods can be included for legibility. For example,
+1.021.555.1212
CountryCode: 1
AreaCode: 021
FAXNumber: 5551234
LongDistancePrefix: 1
InternationalPrefix: 011
DialStringRules: etc/dialrules
SessionTracing: 11
RingsBeforeAnswer: 1
SpeakerVolume: off
GettyArgs: "-h %l dx_%s"
LocalIdentifier: UbuntuFax
TagLineFont: etc/lutRS18.pcf
TagLineFormat: "From %%l|%c|Page %%P of %%T"
MaxRecvPages: 25
Now we are going to probe the tty port to figure out the type
of modem that is attached. This takes a few seconds, so be patient.
Note that if you do not have the modem cabled to the port, or the
modem is turned off, this may hang (just go and cable up the modem
or turn it on, or whatever).
The difference between fax classes has to do with how HylaFAX interacts
with the modem and the fax protocol features that are used when sending
or receiving faxes. One class isn't inherently better than another;
however, one probably will suit a user's needs better than others.
HylaFAX generally will have more features when using Class 1/1.0 than
when using most modems' Class 2 or Class 2.0 implementations. Generally
any problems encountered in Class 1/1.0 can be resolved by modifications
page 6 of 16
http://linux2.arinet.org
ModemFlowControl: rtscts
ModemRevQueryCmd: AT+FREV?
CountryCode: 1
AreaCode: 021
LongDistancePrefix: 1
InternationalPrefix: 011
DialStringRules: etc/dialrules
Don't forget to restart hylafax in order to run faxgetty on this new modem
line.
Updating /etc/hylafax/config from /var/spool/hylafax/etc/config.
Creating /etc/hylafax/config.sav from /var/spool/hylafax/etc/config.sav.
Creating /etc/hylafax/config.ttyx0 from /var/spool/hylafax/etc/config.ttyx0.
Updating /etc/hylafax/setup.cache from /var/spool/hylafax/etc/setup.cache.
Updating /etc/hylafax/setup.modem from /var/spool/hylafax/etc/setup.modem.
/var/spool/hylafax/config
# faxstat -a -s
HylaFAX scheduler on voyager2: Running
page 7 of 16
http://linux2.arinet.org
A5. Create Admin dan User. Hal ini diperlukan bila nanti kita akan menggunakan
program fax dari network yang memerlukan login.
Cukup banyak paket-paket yang dibutuhkan dan ada beberapa paket yang memerlukan
setup lebih lanjut.
B1.
# apt-get install apache2 apache2-mpm-prefork apache2-utils apache2.2-
common libapache2-mod-php5 libmagic-dev php5-gd php5-cli php5-mysql php5-
common php-pear php5 php5-dev php-soap mysql-server imagemagick libtiff4
libtiff4-dev netpbm libungif4g a2ps
B2.
# pear install MDB2 mail mail_mime
B3.
# pear install pear/MDB2#MySQL
B4.
# pecl install fileinfo
page 8 of 16
http://linux2.arinet.org
C3. Edit file setup.sh dan sesuaikan dengan kondisi Ubuntu kita:
- Ubah baris chown apache.apache menjadi chown www-data.www-data
Pastikan tidak ada error. Bila ada, betulkan dan jalankan kembali.
page 9 of 16
http://linux2.arinet.org
C6. Setup Avantfax lewat Web interface. Hidupkan web browser dan buka
http://localhost/avantfax/admin
Kita akan melihat layar login seperti ini (username standard: admin, passwordnya:
password):
Pada pertama kali login ini kita akan diminta untuk segera mengganti password admin:
page 10 of 16
http://linux2.arinet.org
Seperti dapat dilihat di gambar di atas, sepertinya ada bug di avantfax dimana user
admin pertama kita tidak memiliki info apapun, oleh karena itu segeralah kita membuat
user baru dengan mengklik menu New User. Berikan ia hak-hak administrasi. Tuliskan
pula email accountnya ke user linux.
page 11 of 16
http://linux2.arinet.org
Selanjutnya yang juga penting dan wajib adalah mensetup modem di Avantfax. Klik
menu Configure Modems.
Bila modem kita adalah /dev/ttyS0, maka cukup dituliskan ttyS0. Disini karena modem
saya /dev/ttyx0 dan /dev/ttyx1, maka saya menuliskannya ttyx0. Alias modem pilih
identifikasi terserah kita saja, misalnya: modem1. Contact dikosongkan saja dulu.
page 12 of 16
http://linux2.arinet.org
Bila sudah tersetel user dan modem, maka kita sudah bisa login dari layar depan
Avantfax, yaitu: http://localhost/avantfax
page 13 of 16
http://linux2.arinet.org
Selanjutnya silahkan dicoba kirim/terima fax. Bila sudah ada fax masuk, maka di Inbox
Avantfax kita akan terlihat seperti ini:
D. Troubleshooting
Kita dapat memonitor proses kirim/terima fax dari /var/log/syslog. Dengan demikian kita
bisa mengetahui apa kesalahan apa, misalnya busy tone, dll.
D1.
# tail -f /var/log/syslog
Jan 16 11:14:53 voyager2 FaxSend[4467]: MODEM VYACHESLAV FROLOV T38FAX/0.8.0
Jan 16 11:14:54 voyager2 FaxSend[4467]: SEND FAX: JOB 10 DEST 0123 COMMID 000000032 DEVICE '/dev/ttyx0'
FROM 'root <root@localhost>' USER admin
Jan 16 11:15:03 voyager2 FaxGetty[15482]: ANSWER: FAX CONNECTION DEVICE '/dev/ttyx1'
Jan 16 11:15:17 voyager2 FaxGetty[4532]: RECV FAX (000000033): from UbuntuFax, page 1 in 0:14, INF,
3.85 line/mm, 2-D MMR, 14400 bit/s
Jan 16 11:15:18 voyager2 FaxSend[4467]: SEND FAX: JOB 10 SENT in 0:12
Jan 16 11:15:32 voyager2 FaxGetty[4562]: RECV FAX (000000033): from UbuntuFax, page 2 in 0:13, INF,
page 14 of 16
http://linux2.arinet.org
Setiap hari Avantfax juga akan mengirimkan summary penggunaan fax server kita ke
email seperti ini:
D2. Kemana lagi bila masih mengalami kesulitan? Yang paling tepat adalah dengan
mengikuti mailing list hylafax di http://www.hylafax.org
page 15 of 16
http://linux2.arinet.org
Atau bisa juga menghubungi saya di fajarpri@arinet.org, semoga saya bisa membantu.
E. Penutup
Demikianlah panduan Faxserver dengan Hylafax dan Avantfax di Ubuntu. Masih banyak
kekurangan dan mungkin saja ada cara yang lebih baik. Oleh karena itu silahkan
kirimkan koreksi/kritik/saran kamu ke fajarpri@arinet.org. Dapat juga menghubungi
saya lewat yahoo messenger di fajarpri
Semua hasil karya penulis di website http://linux2.arinet.org ini dilisensikan di bawah terms Creative
Commons License.
Silahkan di klik link di atas untuk melihat secara detail, tapi secara singkat memiliki arti:
Kamu bebas untuk:
1. Mengcopy, mendistribusikan, dan mempraktekkannya
2. Melakukan perubahan atas aslinya.
Selamat belajar :)
page 16 of 16