In this tutorial we show you how to install the interface “local retrieve” on a fresh Ubuntu Linux (Server). These instructions should be valid for any distributions which are based on Debian Linux. For other types of Linux distributions, you need to search for the corresponding command of your distribution. You will find that in the documentation.
In this installation the web root is located at “/var/www/” and the recordings are saved in “/var/mixvoip/”.
If you want to check the contents of the archive before downloading it to your server, here it is.
Ubuntu Linux with a Apache2 running php>=5.3.0
Installation: apache2 and php
With the following commands we are going to update the packet cache, install apache2 and the necessary modules for our purpose, enable modules and restart apache2:
If you have already various virtual hosts on your server you should already know how to handle this files.
In the next step we will create the virtual host file in /etc/apache2/sites-available/, in this case we use nano and the filename localretrieve.conf.
Copy the following content into your file, adapt it to your needs, for testing you can leave it as it is and edit it later.
We press ctrl-x to close and confirm save with “y”.
Now we will download and extract the interface. We go to the web root, download the file, extract the archive and delete it after.
Quick explanation of the variables
The configuration file can be found in /var/www/localretrieve/app/Config/AppSettings.php
The RECPATH folder must be accessible by the web-server and should contain a sub-folder with your MIXvoip username. The access right will be given in the last step.
The configuration itself
Now, let’s open the file. The contents of your file might be different, the only thing we have to edit are the variables. In our file below we have already edited them to fit our needs. Our user in this case, we replaced “mixvoip_user” with “mixvoipcloud” (use your username) and replaced “some_password” with “12345678” (do not use for production).
Adapted contents of the file:
We press ctrl-x, and confirm the changed with “y”
RECPATH folder Structure
In order that the interface can find the recordings the RECPATH folder must have this structure. The RECPATH folder contains a subfolder with your MIXvoip username (in the image mixvoipcloud). In this folder are subfolder with the dates which conatins the .wav files.
The files must have the following filename:
time is when the call started
src source number / extension
dst destination number / extension
callID uid of the call
username MIXvoip username
File Access Rights
To complete the configuration we need to give apache2 the rights to access the folders and its files. First we give apache2 the rights for the interface and also for the audio files.
And we are done.