Boot Strap your Fax over VoIP (ICTFAX) evalution.
Version: 0.01 Alpha
This is a VirtualBox VM containing the following (compiled or installed,
but _not_ configured _nor_ tested):
1. CentOS 6.4 (Basic Server), updated as of June 9, 2013.
2. yudit-2.9.2
3. FreeSWITCH 1.2.10
4. plivo 0.1.0
5. ICTFAX (with Drupal) 2.1.1
This project was started in order to help a fellow dslreports.com member
in the VoIP Tech Chat forum get past the installation phase of ICTFAX
and into the actual configuration phase.
The virtual machine was split into smaller parts with HJSplit.
HJSplit is multi-platform, freeware, program available at:
http://www.hjsplit.org.
Please download the 32-bit or 64-bit files to needed to reassemble the
desired virtual machine, and check the downloaded files (md5sums,
sha256sums, and par2 files are available) prior to joining with HJSplit.
A par2 program ( https://en.wikipedia.org/wiki/Parchive ), along with
the appropriate amount of *.par2 files, can repair a damaged, downloaded
file.
In other words, if there is a damaged file, instead of re-downloading a
100 MB file, you can download the much smaller par2 files until you have
enough "repair blocks" to heal a damaged file. :)
Prior to running the VM for the first time, I recommend that you disable
the networking between the VM host and this VM, and scan it with your
favorite utility. :)
Once you are satisfied that it's clean, you can re-enable the networking.
Everything is in its _default_ installation state, except for the items
listed below:
1. CentOS : Currently set for the Pacific Time zone.
2. network : Set to autoboot with dhcp (otherwise, you would have to
manually bring up network with 'ifup eth0')
3. plivo : used installation script from
https://github.com/plivo/plivoframework/raw/master/scripts/plivo_install.sh
instead of version that came with ICTFAX.
Configured
/usr/local/plivo/etc/plivo/default.conf
just enough to get plivo started.
4. mysql : table ictfax created
Please note that the following require configuration before an
online test can be performed:
1. iptables
2. Apache
3. MySQL
4. FreeSWITCH
5. plivo
6. ICTFAX
How to confirm programs are running prior to configuration:
1. Start the virtual machine after importation.
2. Log in as root.
The password is: password
Please scan this VM before going online, and don't forget
to change the password after configuration!
3. uname -a
This will confirm which version, 32-bit or 64-bit, is running.
4. ifconfig
This will show your IP address.
Please note the IP address, because you'll need it at step 11.
5. service httpd restart
6. service mysqld restart
7. This will confirm that FreeSWITCH will run:
/usr/local/freeswitch/bin/freeswitch
To stop FreeSWITCH from the command line, type:
fsctl shutdown
Next, we're going to restart it in the background:
/usr/local/freeswitch/bin/freeswitch -nc
Press the enter/return key twice.
8. service plivo restart
9. service plivocache restart
10. service iptables stop
You'll need to do this until you configure iptables.
11. Start your browser, and go to the following address:
http://IPaddressFromStep4/ictfax
12. You're on your own from here!
This project was started in order to help a fellow
dslreports.com member (VoIP Tech Chat forum) get past
the installation phase of ICTFAX and into the actual
configuration phase. :)
References:
----------
VirtualBox: http://en.wikipedia.org/wiki/Virtualbox
http://www.virtualbox.org
FreeSWITCH: http://wiki.freeswitch.org/wiki/Getting_Started_Guide
Mozilla Public License Version 1.1
plivo: http://plivo.com/open-source
Mozilla Public License Version 1.1
ICTFAX: http://ictfax.org/content/ictfax-installation-guide
GNU General Public License v3
Download Latest Version
plivo.tar.gz (1.7 MB)
