1. Installation
Prepare debian system, guide notes that it have to be lenny 64bit, first problem, installation did not work on lenny and latest sipwise provider require 6.x version of debian (squeeze), otherwise your installation will not be sucesfull. OS install without X win and other sw (use netinstall iso for example) with basic configuration.
The sip:provider CE is based on the Sipwise NGCP, so download and install the Sipwise NGCP installer package:
PKG=ngcp-installer-latest.deb wget http://deb.sipwise.com/spce/${PKG}
--2011-10-12 09:28:56-- http://deb.sipwise.com/spce/ngcp-installer-latest.deb Resolving deb.sipwise.com... 77.244.249.93 Connecting to deb.sipwise.com|77.244.249.93|:80... connected. HTTP request sent, awaiting response... 200 OK Length: 16598 (16K) [application/x-debian-package] Saving to: `ngcp-installer-latest.deb' 100%[======================================>] 16,598 --.-K/s in 0.009s 2011-10-12 09:28:56 (1.71 MB/s) - `ngcp-installer-latest.deb' saved [16598/16598]
type:
dpkg -i ${PKG}
Selecting previously deselected package ngcp-installer-ce. (Reading database ... 20901 files and directories currently installed.) Unpacking ngcp-installer-ce (from ngcp-installer-latest.deb) ... Setting up ngcp-installer-ce (0.4.3) ...
and then
ngcp-installer
you should see follwoing output with sucesfull message at the end:
Welcome to Sipwise sip:provider installer. This software comes WITH NO WARRANTY. If you need SLA please consider upgrading to Sipwise sip:provider Pro Edition. This installation script is not intended to run in a shared system, as it can add/delete/update existing configurations. Please run this script only in a base install of 64 bit Debian 6.x on a dedicated server. Do you want to continue with the installation process? (y/n)y Running as root... OK Internet access... OK Looks like a clean install... OK Check Debian version... OK Check 64 bit capable system... OK Updating package repository...Retrieving GPG key for Percona repository. OK Installing package list. This might take several minutes depending on your network connection...OK OK Creating cdrexport user... OK Preparing dynamic configuration settings for MySQL: Total memory detected: 503384 Innodb poolsize factor set to: 0.5 innodb_pool_size set to: 251M Generating random passwords for mysql access...OK Creating databases... OK Setting MySQL Sipwise grants... OK Initializing the configuration framework... OK Generating default configuration files... OK OK Saving factory default settings... OK Enabling apache site ngcp-ossbss ...OK Enabling apache site ngcp-www-admin ...OK Enabling apache site ngcp-www-csc ...OK Restarting services before configuration... Restarting mysql ... OK Restarting rsyslog ... OK Restarting asterisk ... OK Restarting mediator ... OK Restarting sems ... OK Restarting ngcp-mediaproxy-ng-daemon ... OK Restarting apache2 ... OK Restarting ngcp-rate-o-mat ... OK Restarting collectd ... OK Restarting kamailio-proxy ... OK Restarting kamailio-lb ... OK Saving factory default settings... OK Installation finished. Thanks for choosing NGCP sip:provider Community Edition.
then check your network settings:
ip a
and open provider ce config
vim /etc/ngcp-config/config.yml
and change
networking: eaddress: 127.0.0.1
to
eaddress: <your.ip.address>
and apply changes
ngcpcfg apply
a long output is displayed:
Generating /etc/asterisk/logger.conf: OK Generating /etc/asterisk/extconfig.conf: OK Generating /etc/asterisk/modules.conf: OK Generating /etc/asterisk/voicemail.conf: OK Generating /etc/asterisk/asterisk.conf: OK Generating /etc/asterisk/res_odbc.conf: OK Generating /etc/asterisk/extensions.conf: OK Generating /etc/asterisk/sip.conf: OK Generating /etc/asterisk/rtp.conf: OK Generating /etc/crontab: OK Generating /etc/ngcp-cdr-exporter/cdr-exporter.conf: OK Generating /etc/ngcp-cleanup-tools/acc-cleanup.conf: OK Generating /etc/ngcp-rsyslog-tools/rotation.conf: OK Generating /etc/sems/sems.conf: OK Generating /etc/sems/etc/conference.conf: OK Generating /etc/sems/etc/ngcp.sbcprofile.conf: OK Generating /etc/sems/etc/sw_vsc.conf: OK Generating /etc/sems/etc/click2dial.conf: OK Generating /etc/sems/etc/xmlrpc2di.conf: OK Generating /etc/sems/etc/reg_agent.conf: OK Generating /etc/sems/etc/di_dial.conf: OK Generating /etc/sems/etc/app_mapping.conf: OK Generating /etc/sems/etc/sbc.conf: OK Generating /etc/init.d/collectd: OK Executing postbuild for /etc/init.d/collectd Generating /etc/init.d/apache2: OK Executing postbuild for /etc/init.d/apache2 Generating /etc/init.d/cron: OK Executing postbuild for /etc/init.d/cron Generating /etc/apt/apt.conf.d/71_no_recommended: OK Generating /etc/ngcp-reminder/reminder.conf: OK Generating /etc/mysql/my.cnf: OK Generating /etc/ngcp-check-tools/collectd-ngcp.conf: OK Generating /etc/ngcp-check-tools/check-tools.conf: OK Generating /etc/ngcp-www-csc/csc.conf: OK Generating /etc/ngcp-vmnotify/vmnotify.conf: OK Generating /etc/ngcp-vmnotify/mwi.sip: OK Generating /etc/collectd/collectd.conf: OK Generating /etc/odbcinst.ini: OK Generating /etc/ngcp-ossbss/logging.conf: OK Executing postbuild for /etc/ngcp-ossbss/logging.conf Generating /etc/ngcp-ossbss/mysql_values.cfg: OK Generating /etc/ngcp-ossbss/provisioning.htpasswd: OK Generating /etc/ngcp-ossbss/provisioning.conf: OK Executing postbuild for /etc/ngcp-ossbss/provisioning.conf Generating /etc/kamailio/lb/kamailio.cfg: OK Generating /etc/kamailio/lb/xmlrpc.cfg: OK Generating /etc/kamailio/lb/db/version: OK Generating /etc/kamailio/lb/db/dispatcher: OK Generating /etc/kamailio/lb/kamctlrc: OK Generating /etc/kamailio/proxy/kamailio.cfg: OK Generating /etc/kamailio/proxy/proxy.cfg: OK Generating /etc/kamailio/proxy/xmlrpc.cfg: OK Generating /etc/kamailio/proxy/registrar.cfg: OK Generating /etc/kamailio/proxy/kamctlrc: OK Generating /etc/apache2/sites-available/ngcp-www-csc: OK Generating /etc/apache2/sites-available/ngcp-www-admin: OK Generating /etc/apache2/sites-available/ngcp-ossbss: OK Generating /etc/logrotate.d/ngcp: OK Generating /etc/cron.d/rotate_database_syslog: OK Generating /etc/odbc.ini: OK Generating /etc/ngcp-www-admin/admin.conf: OK Generating /etc/rsyslog.conf: OK Generating /etc/default/ngcp-mediaproxy-ng-daemon: OK Generating /etc/default/kamailio.lb: OK Generating /etc/default/ngcp-rate-o-mat: OK Generating /etc/default/kamailio.proxy: OK Generating /etc/default/mediator: OK Generating /etc/default/kamailio: OK Executing action for /etc/ngcp-config/templates/etc/default/ngcp-mediaproxy-ng-daemon.services Restarting RTP/media proxy: ngcp-mediaproxy-ng-daemonGoing to background... . Executing action for /etc/ngcp-config/templates/etc/kamailio/lb/ngcpcfg.services Restarting kamailio-lb: kamailioloading modules under /usr/lib/kamailio/modules_k:/usr/lib/kamailio/modules Listening on udp: 158.193.139.59 [158.193.139.59]:5060 udp: 127.0.0.1:5060 tcp: 158.193.139.59 [158.193.139.59]:5060 tcp: 127.0.0.1:5060 Aliases: . Executing action for /etc/ngcp-config/templates/etc/kamailio/proxy/ngcpcfg.services Restarting kamailio-proxy: kamailioloading modules under /usr/lib/kamailio/modules_k:/usr/lib/kamailio/modules Listening on udp: 127.0.0.1:5062 tcp: 127.0.0.1:5062 Aliases: . Executing action for /etc/ngcp-config/templates/etc/sems/etc/ngcpcfg.services Restarting sems: sems Configuration: log level: INFO (2) log to stderr: no configuration file: /etc/sems/sems.conf plug-in path: /usr/lib/sems/plug-in/ daemon mode: yes daemon UID: sems daemon GID: sems application: $(mapping) . Executing action for /etc/ngcp-config/templates/etc/sems/sems.conf.services Restarting sems: sems Configuration: log level: INFO (2) log to stderr: no configuration file: /etc/sems/sems.conf plug-in path: /usr/lib/sems/plug-in/ daemon mode: yes daemon UID: sems daemon GID: sems application: $(mapping) . OK Checking state of /etc files [master acab45e] ngcpcfg apply on Wed Oct 12 18:00:40 CEST 2011 Author: palo <palo@server.test3.sip.uniza.sk> 8 files changed, 18 insertions(+), 15 deletions(-)
Securing your Server
Then secure your server and changedefault passwords. For CDR change password for user cdrexport
passwd cdrexport Enter new UNIX password: xxxxxxx Retype new UNIX password: xxxxxxx passwd: password updated successfully
for mysql
mysqladmin password <your mysql root password>
for administrator of ngcp through web panel, default is username: administrator, pasword administrator
https://<your-server-ip>:1443/
in my case
https://server.test3.sip.uniza.sk:1443/
then navigate to
and change your pass
Mail server
as reuqired
Testing
To start system testing we will need a SIP domain and some subscribers in this domain. I have prepared zone test3.sip.uniza.sk with SRV records:
dig SRV _sip._udp.test3.sip.uniza.sk ; <<>> DiG 9.7.3 <<>> SRV _sip._udp.test3.sip.uniza.sk ;; global options: +cmd ;; Got answer: ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 39623 ;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 2, ADDITIONAL: 5 ;; QUESTION SECTION: ;_sip._udp.test3.sip.uniza.sk. IN SRV ;; ANSWER SECTION: _sip._udp.test3.sip.uniza.sk. 43200 IN SRV 0 1 5060 server.test3.sip.uniza.sk.
Creating Domains
Go to https://<your IP>:1443/ login as administrator and create domain
Account and subscriber
In Provider CE an account is a billing container which may contain several subscribers. To create account go to User Administration -> Accounts and click Create new account.
To create a subscriber:
descriptions of individual fields you may find in manual
Create second user and basic testing may start.
Then register your preferred SIP client and start. Till now is evrything working.