Sources and Installation guide

Check the minimum requirements, configure your system by following the guide below, download the software from our repository and install your system by running the setup application.

Sources 1.0

Installation ( Ubuntu 8.04 raccomanded)

  1. Login as root
  2. Install the software reported in the minimum software requirements
  3. Start MySQL server (/etc/init.d/mysql start)
  4. Create voiceone database (mysqladmin create voiceone)
  5. Assign a password to database root user (mysqladmin password voiceone) or create a user with proper rights on voiceone database
  6. Add following row in /etc/sudoers: www-data ALL=NOPASSWD: /var/www/html/voiceone_webservices/config/script/vo-tools.sh

    Note: if you don't find /etc/sudoers, you have to install 'sudo'. On Debian you can do it with 'apt-get install sudo'. 'www-data' indicated user is apache user, if apache is run as different user you have to change the /etc/sudoers row with the right user. You have to even change the document root path where VoiceOne will be installed, default path is '/var/www' (Ubuntu e Debian) or '/var/www/html' (Red Hat). Some distributions set "defaults requiretty" in sudoers file, apache will run without tty so it can't do sudo. Consequently, for the VoiceOne installation you will need to comment it.

  7. Add following row in /etc/asterisk/modules.conf below modules section: preload => res_config_mysql.so
  8. Edit the settings section of /etc/asterisk/extconfig.conf file as follow:
    agents.conf => mysql,voiceone,ast_config
    extensions.conf => mysql,voiceone,ast_config
    features.conf => mysql,voiceone,ast_config
    iax.conf => mysql,voiceone,ast_config
    meetme.conf => mysql,voiceone,ast_config
    misdn.conf => mysql,voiceone,ast_config
    musiconhold.conf => mysql,voiceone,ast_config
    queues.conf => mysql,voiceone,ast_config
    sip.conf => mysql,voiceone,ast_config
    zapata.conf => mysql,voiceone,ast_config
    iaxusers => mysql,voiceone,iax_buddies
    iaxpeers => mysql,voiceone,iax_buddies
    sipusers => mysql,voiceone,sip_buddies
    sippeers => mysql,voiceone,sip_buddies
    voicemail => mysql,voiceone,voicemail_users
    extensions => mysql,voiceone,extensions_table
  9. Crete /etc/asterisk/res_mysql.conf file with the following content (set dbname e dbpass according with steps 3 and 4):
    [general]
    dbhost = localhost
    dbname = voiceone
    dbuser = root
    dbpass = voiceone
    dbport = 3306
    dbsock = /var/lib/mysql/mysql.sock

    Note: change socket name and path according with the linux distribution used

  10. Create /etc/asterisk/cdr_mysql.conf file with the following content (set dbname e dbpass according with steps 3 and 4):
    [global]
    hostname=localhost
    dbname=voiceone
    table=cdr
    user=root
    password=voiceone
    port=3306
    sock=/var/lib/mysql/mysql.sock
    userfield=1

    Note: change socket name and path according with the linux distribution used

  11. Edit /etc/asterisk/manager.conf file with the following content:
    [general]
    enabled=yes

    [admin]
    secret=qwerty_123_mnbvc
    deny=0.0.0.0/0.0.0.0
    permit=127.0.0.1/255.255.255.0
    read=system,call,log,verbose,command,agent,user
    write=system,call,log,verbose,command,agent,user
  12. Download and unzip the downloaded file from the repository and copy voiceone and voiceone_webservice folders in the document root 
  13. Rename both config.inc.php.default files in DOCUMENT_ROOT/voiceone/admin/config and DOCUMENT_ROOT/voiceone_webservices/config directories in confing.inc.php
  14. Edit DOCUMENT_ROOT/voiceone/admin/config/config.inc.php file setting $soapHostname with your IP address instead of localhost. If you are going to use a virtual host you have to add the fully qualified name.
  15. Edit DOCUMENT_ROOT/voiceone_webservices/config/config.inc.php file adding database accesses credentials
  16. Edit DOCUMENT_ROOT/voiceone_webservices/config/script/vo-tools.sh files setting VOCFGDIR variable with the absolute path of the DOCUMENT_ROOT/voiceone_webservices/config/script/vo.cfg script
  17. Check if all paths in DOCUMENT_ROOT/voiceone_webservices/config/script/vo.cfg file are corrects
  18. Restart the web server (/etc/init.d/apache restart)
  19. Open a browser and go to the following address: http://<yourdomain>/voiceone/setup.php. Follow the instructions for the VoiceOne setup