Академический Документы
Профессиональный Документы
Культура Документы
ICTFAX 2.0
Introduction and Installation
Agenda
1.
2.
3.
4.
5.
6.
7.
8.
Introduction
Demo
Download
Installation of Basic Requirements
Freeswitch Installation
Plivo Installation
ICT Fax Front End Installation
Email to Fax / Fax to Email Service setup
1. Introduction
ICTFAX 2.0 is an open source multi-user and web based
software solution for service providers based on open source
Freeswitch, Plivo Framework and Drupal 7. ICTFAX is an email
to fax gateway, supports G.711 faxing , PSTN faxing and T.38
origination and termination.
2. Demo
Visit ICTFAX Demo site and use following credential to login
Admin Account
Username: admin
Username: demoictfax
User Account
Username: user
Username: demoictfax
3. Download
http://sourceforge.net/projects/ictfax/files/ictfax-2.0.tar.gz/download
5. Freeswitch Installation
ICTFax is based on Plivo Framework.
So you need to setup and run freeswitch provided by Plivo.org.
Instructions on how to install Freeswitch are given
at http://www.plivo.org/get-started/ and repeated here for your convenience:
Download and run the FreeSWITCH installer on your system
Note: Currently, this installer is tested on CentOS > 5.5 and Debian-based distros.
# wget --no-check-certificate https://github.com/plivo/plivo/raw/mast ... install.sh
# chmod +x install.sh
# ./install.sh
* Run FreeSWITCH
Run in Foreground
# ./usr/local/freeswitch/bin/freeswitch
Run in Background
# ./usr/local/freeswitch/bin/freeswitch -nc
6. Plivo Installation
Locate the folder "plivo-devel" in the extracted ICTFax directory.
1. Stop plivo service (if any) and clear /usr/local/plivo
2. Copy and Paste plivo-devel folder in /usr/
3. Go to /usr/plivo-devel and Run plivo_install.sh using following command:
#./plivo_install.sh /usr/local/plivo
4. Go to /usr/local/plivo/bin directory and Run plivo service using the following
command:
#./plivo start
NOTE: There may be some errors while starting plivo cache server. But make sure that
plivo default server is running.
Plivo Configurations
1. Go to /usr/local/plivo/etc/plivo/default.conf
2. Enable EXTRA_FS_VARS by removing # before it.
3. Set variable in plivo config as EXTRA_FS_VARS = variable_duration
4. Set Incoming DEFAULT_ANSWER_URL, DEFAULT_HANGUP_URL
DEFAULT_ANSWER_URL = http://127.0.0.1/ictfax/index.php?q=ictfax/receive_fax
DEFAULT_HANGUP_URL = http://127.0.0.1/ictfax/index.php?q=ictfax/receive_fax_billing
Modify above urls according to your installation settings.
Don't forget to remove # sign before DEFAULT_HANGUP_URL and EXTRA_FS_VARS.
8. route all mails for none-existing addresses into freeswitch mailbox so we can
receive emails for addresses likexyz_number@FAX_DOMAIN.COM
echo '@FAX_DOMAIN.COM freeswitch' >> /etc/mail/virtusertable
makemap hash /etc/mail/virtusertable
9. grant proper permission to apache user on mail folder
chmod +t /var/spool/mail
10. restart sendmail service so changes can take affect
service sendmail restart
13. setup cronjob so incoming email can be processed after every 5 minutes
echo 'MAILTO=""' > /tmp/freeswitch_cron.txt
echo "*/5 * * * * wget -O /dev/null
'http://FAX_DOMAIN.COM/cron.php?cron_key=your_key' 2>/dev/null" >>
/tmp/freeswitch_cron.txt
crontab -l >> /tmp/freeswitch_cron.txt
crontab /tmp/freeswitch_cron.txt
14. You can find your cron url by logging in at your web interface as admin. Go to
Reports -> Status Reports.
Copy your Cron URL and paste at the above URL and then run above lines at the
command prompt.
NOTE: make sure that /etc/hosts.allow is properly configured for accepting mails, and
smtp port (25) is not blocked by firewall. if so Add following line to
/etc/sysconfig/iptables above the last reject/drop rule:
-A INPUT -m state --state NEW -m tcp -p tcp --dport 25 -j ACCEPT
Also DO NOT enable CLEAN URLS, because plivo has been configured to use default
URLS.
15. Create a content type "fax" with three additional fields "to" of type text, "from"
of type text" and "file" of type file.
Go to Admin => Structure => Feeds Importer => Mailhandler nodes. Click Override
and then in Processor field make sure Fax Processor is selected. Click Mapping in
fax processor. Make sure that your to, from and file fields are correctly mapped to
toaddress, fromaddress and attachments respectively.
16. Now you are ready to send faxes through your email. See Admin/User Guide for
further details.