Quick Install Guide

From VoiceOne Wiki Documentation

1. Log into the system as root

2. Start MySQL server

3. Create a database, e.g. voiceone (hint: type 'mysqladmin create voiceone' at Linux prompt)

4. Assign a password to the root user, e.g. voiceone (hint: type 'mysqladmin password voiceone' at Linux prompt)

5. Add the following lines to /etc/sudoers:

     www-data ALL=NOPASSWD: /var/www/html/voiceone_webservices/config/script/vo-tools.sh     

(Hint: If you can't find /etc/sudoers, you will have to install 'sudo' first. On Debian you can do this with 'apt-get install sudo')

Please note that 'www-data' is the apache user, so if your apache is running as a different user, you will need to change this. Change the path of the document root according where you are going to install voiceone and voiceone_webservices, which may be '/var/www' (Debian) or '/var/www/html' (Red Hat)

Note: Some distributions set "defaults requiretty" in sudoers, apache will run without tty so it could not do sudo. Hence it is necessary to comment this out on a voiceone installation.

6. Add the following line to /etc/asterisk/modules.conf under the modules section:

     preload => res_config_mysql.so

7. Edit the settings section of /etc/asterisk/extconfig.conf as follows:

     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

8. Create /etc/asterisk/res_mysql.conf (set dbname & dbpass according to steps 3 and 4 respectively):

     [general]
     dbhost = localhost
     dbname = voiceone
     dbuser = root
     dbpass = voiceone
     dbport = 3306
     dbsock = /var/lib/mysql/mysql.sock

Change the path and/or the filename of the socket according to your distro

9. Create /etc/asterisk/cdr_mysql.conf (set dbname & password according to steps 3 and 4 respectively):

     [global]
     hostname=localhost
     dbname=voiceone
     table=cdr
     user=root
     password=voiceone
     port=3306
     sock=/var/lib/mysql/mysql.sock
     userfield=1

Change the path and/or the filename of the socket according to your distro

10. Edit /etc/asterisk/manager.conf:

     [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

11. Download and unzip the file you've downloaded, and copy it into the document root (there are two folders, voiceone/ and voiceone_webservice/ )

12. Rename both config.inc.php.default in DOCUMENT_ROOT/voiceone/admin/config and DOCUMENT_ROOT/voiceone_webservices/config in config.inc.php (i.e. config.inc.php.default -> config.inc.php)

13. Edit DOCUMENT_ROOT/voiceone/admin/config/config.inc.php (We suggest to set in $soapHostname your IP address in place of localhost. If you use virtual hosts you have to use the fully qualified name!)

14. Edit DOCUMENT_ROOT/voiceone_webservices/config/config.inc.php

15. Edit DOCUMENT_ROOT/voiceone_webservices/config/script/vo-tools.sh and insert the script absolute path in the VOCFGDIR variable

16. Check the paths inside the bash script in DOCUMENT_ROOT/voiceone_webservices/config/script/vo.cfg

17. Restart the Apache server

18. Browse http://yourdomain/voiceone/setup.php and follow the instructions