FoIP Boot Strap VM Files

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