Žilinská univerzita > Fakulta riadenia a informatiky > Katedra informačných sietí

Sipwise Provider CE 2.2 - quick test install on debian squeeze 64 bit

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:

3

 

descriptions of individual fields you may find in manual

 

7

Create second user and basic testing may start.

Then register your preferred SIP client and start. Till now is evrything working.

jitsi

Web

http://www.sipwise.com/doc/2.2/spce/

AttachmentSize
File sipwiseprovider-ce.2.2.guide_.PDF269.78 KB
Groups: