Installation


Installing from tarball

If you install from tarball be sure to download the one corresponding to your platform. Just as a quick reminder: Trixbox, Elastix, PBX in a Flash and AsteriskNow are all based on Centos. To find out if your current install is 32 or 64 bits you can run the command:

#> uname -a

If the output contains the strings i386 or i686, your need the 32 bits version. If not, you need the 64 bit version.

Then proceed to download the package from our servers.

After downloading the proper package, you will have to extract it with the command (the filename might change depending on the version you downloaded):

#> tar zxvf fop2-2.20-centos5-i386.tgz

Change to the extracted FOP2 directory:

#> cd fop2

For the sake of simplicity, included in the tarball there is a Makefile that can install the files for you, just type:

#> make install

The installation will copy the server files under /usr/local/fop2 and the web pages under /var/www/html/fop2, /var/www/fop2 or /srv/www/htdocs/fop2 depending on your distribution. It will also copy an init script for you.

The install will not create the mysql database needed for the visual phonebook feature. You must know the mysql root password in order to create the database, as instructed here. If you do not know the mysql root password you won't be able to use the phonebook feature. If you do not know what your mysql root password is, you might want to try with default passwords like passw0rd, eLaStIx.2oo7 or just an empty password.

FreePBX integration

For a complete FreePBX integration experience, you will need to copy a configuration file manually. It is not installed automatically because you might be already using the configuration file for other purposes, so it is left to be done by hand. The file in question is extensions_override_freepbx.conf located in /usr/local/fop2, and must be copied into /etc/asterisk . If you already have some content in that file, do not overwrite it but append the contents. This file is needed if you want to integrate FOP2 presence with FreePBX DND feature code. You do not need to do this if you are not using FreePBX.


To append the contents to the end of your original file:

#> cd /usr/local/fop2
#> cat extensions_override_freepbx.conf >>/etc/asterisk/extensions_override_freepbx.conf

Visual Phonebook

Installation instructions for the visual phonebook are available here


Copy files by hand

You should only do this if you opt for not running the make command as instructed earlier.

You can also opt to install the files manually instead of running "make", and place them to suitable locations on your hard disk. For example, you can move the daemon files and configurations to /usr/local, and the web pages to a directory inside your webserver web root:

#> mv server /usr/local/fop2
#> mv html /var/www/html/fop2

Manager Credentials

Before starting the service, some basic configuration is required in fop2.cfg and probably in /etc/asterisk/manager.conf, because the FOP2 daemon connects via TCP to the Asterisk Manager Interface (AMI) using a username and secret. The basic daemon config is covered here.

Once that the files are in place and the manager credentials configured you will have to start the service. There are a number of ways to do that. The best way is to use a proper init script for your distribution, another way is to start it from /etc/rc.local.

You can always check if the manager credentials are correctly configured, and also verify if your license is ok, by running the command:

#> /usr/local/fop2/fop2_server --test

That's it!