Installing

Login

Update

Configuring

How To

User Features

Security Issues

Documentation bullet Installing

In using FreeSentral there are three components involved:

  • The Yate telephony server program.
  • The Web server that provides the interface.
  • The database server that stores all information.

Requirements:

  • php5, php5-ming, php5-pgsql, php-cli
  • PostgreSQL
  • apache
  • yate. Use a version between 3.0 and 4.3
  • lame
  • madplay
  • sox
  • openssl
  • mod_ssl (for apache). If you dont access the interface from localhost you will automatically be redirected to use https


In a small configuration all these components are installed on the same machine. It is however possible to use different computers to improve performance. In this case you should perform the installation described below both on the Yate server and on the Web server. The database can be initialized remotely during either of these installs.


  1. Log on to your system or start a terminal console
  2. Download and install the last copy of Yate from the Subversion (SVN). 

     See documentation here 
     (perform this step only on yate server)

        You will need Yate 3.0, or later

  3. Download the last copy of FreeSentral from Subversion (SVN) Download
  4. Go to FreeSentral new created directory: cd freesentral
  5. Run install.sh: ./install.sh
  6. Answer the questions of the interactive installer.


Before showing a console example of the installation process, it's necessary to explain the content of the main directories used by FreeSentral.The directories used for installing configuration files, scripts or IVR prompts are as follows:

  • /usr/local/etc/yate : the config files are installed in this directory; the config files give Yate the appropriate value of parameters for FreeSentral to properly work.
  • /usr/local/share/yate/scripts : here you will find the external routing module, the script for the Auto Attendant, the click-to-call script, the voicemail script; the directory has all the custom scripts that will make Yate work as an IP PBX.
  • /var/spool/voicemail : the au and mp3 files will be found at var/spool/voicemail after installation; also other required folders will be created in the voicemail/ directory.
  • /var/www/html/freesentral : the files for the web interface are found in this directory.



These are the questions that the installer is going to ask. They all have default answers and you will need to insert different if you wish to change the default settings.

    [root@localhost freesentral]# ./install.sh 
    -------------------------------------------------------- 
    Note!!! FreeSentral requires at least PostgreSQL 8.2.0 
    -------------------------------------------------------- 
    Installer for FreeSentral v1.
    At the following prompts you can enter the word 'no' to disable defaults
    Install Yate config file in: [/usr/local/etc/yate]
    Install Yate scripts in: [/usr/local/share/yate/scripts]
    Install IVR prompts in: [/var/spool/voicemail]
    Install Web pages in: [/var/www/html/freesentral]
    Ip address for yate server: [127.0.0.1]
    Web user : [apache]
    Database host: [localhost]
    Database name: [freesentral]
    Database user: [postgres]
    Database password: []
    PostgreSQL command: [/usr/bin/psql]
    Install options
        Config file in '/usr/local/etc/yate'
        Scripts dir in '/usr/local/share/yate/scripts'
        IVR prompts in '/var/spool/voicemail'
        Web pages in   '/var/www/html/freesentral'
	    Web user       'apache'
        Database:
            Host     'localhost'
            Name     'freesentral'
            User     'postgres'
            Password ''
        PosgreSQL tool '/usr/bin/psql'
    Proceed with installation?: [yes]
    Installing Yate configuration files
    Creating extmodule configuration file
    Creating moh configuration file
    Creating pgsqldb configuration file
    Creating queues configuration file
    Creating pbxassist configuration file
    Creating openssl configuration file
    Creating rmanager configuration file
    Trying to generate SSL certificate
    Generating SSL key
    Generating SSL csr
    Installing Yate scripts
    Installing IVR prompts
    Installing Web application
    Creating configuration file
    Initializing the database 
    CREATE DATABASE

Documentation