User Tools

Site Tools


tutorials:ims:installation-howto

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
tutorials:ims:installation-howto [2013/07/22 18:34]
carstenbock created
tutorials:ims:installation-howto [2019/05/25 09:31] (current)
ali [Installation of the DNS-Server]
Line 1: Line 1:
 **Note: This document is work in progress and yet unfinished!** **Note: This document is work in progress and yet unfinished!**
  
-This is a short installation howto for Debian ​Squeeze ​(old-stable). It should work as well with current stable, but that has not yet been tested.+This is a short installation howto for Debian ​Wheezy ​(stable). ​
  
 This installation howto has been derived from here: http://​uctimsclient.berlios.de/​openimscore_on_ubuntu_howto.html This installation howto has been derived from here: http://​uctimsclient.berlios.de/​openimscore_on_ubuntu_howto.html
Line 21: Line 21:
 Copy the open-ims-DNS file to the bind folder and add these lines to /​etc/​bind/​named.conf.local:​ Copy the open-ims-DNS file to the bind folder and add these lines to /​etc/​bind/​named.conf.local:​
  
-  zone "open-ims.test" {+  zone "kamailio-ims.org" {
               type master;               type master;
-              file "/​etc/​bind/​open-ims.dnszone";​+              file "/​etc/​bind/​kamailio-ims.org.dnszone";​
   };   };
 +  ​
 +**You can find a very basic dnszone-file in "​examples/​ims_dnszone"​-folder of the Kamailio repository**  ​
   ​   ​
 //You will need to restart bind for these changes to take effect.// //You will need to restart bind for these changes to take effect.//
Line 32: Line 34:
 Check that this all works. Try a ping and see if you get a response: Check that this all works. Try a ping and see if you get a response:
  
-  ping pcscf.open-ims.test+  ping pcscf.kamailio-ims.org 
 +   
 +If you can not ping by DNS address, try: 
 + 
 +  host pcscf.kamailio-ims.org 
 + 
 +If the DNS address resolved to IP address currectly. You may need to update your "/​etc/​nsswitch.conf"​ file according to  
 +[[https://​askubuntu.com/​questions/​81797/​nslookup-finds-ip-but-ping-doesnt|this question on SO.]]. After that modification you should be able to ping by DNS address. 
  
 ====== Installation of the Kamailio-IMS-Packages ====== ====== Installation of the Kamailio-IMS-Packages ======
Line 44: Line 54:
 Then add the repository to your "/​etc/​apt/​sources.list":​ Then add the repository to your "/​etc/​apt/​sources.list":​
  
-  echo "deb http://​repository.ng-voice.com ​squeeze ​ims rtpproxy"​ >> /​etc/​apt/​sources.list+  echo "deb http://​repository.ng-voice.com ​jessie ​ims rtpproxy"​ >> /​etc/​apt/​sources.list 
 + 
 +NOTE: 
 +  * The repository is 64 Bit only 
 +  * we do have packages for Debian 7, Debian 8 (jessie) and Ubuntu LTS (trusty) 
 +  * the packages are updated regularly from trunk
  
 And update the available packets: And update the available packets:
  
- apt-get update +  ​apt-get update 
- +===== Installation of Proxy-/​Interrogating-/​Serving-CSCF Binary packages ​=====
-===== Proxy-CSCF =====+
  
 Install the modules: Install the modules:
  
-  apt-get install kamailio kamailio-ims-modules kamailio-presence-modules kamailio-sqlite-modules kamailio-tls-modules kamailio-xml-modules kamailio-xmlrpc-modules+  apt-get install kamailio kamailio-ims-modules kamailio-presence-modules kamailio-tls-modules kamailio-xml-modules kamailio-xmlrpc-modules
  
-If you want to have an RTP-Proxy/​RTP-Relay, ​+If you want to have an RTP-Proxy/​RTP-Relay, you find the "​mediaproxy-ng"​ from [[http://​www.sipwise.com|Sipwise]] in that repository as well,
  
 +
 +  apt-get install ngcp-mediaproxy-ng
 +  ​
 For I-CSCF you will also need a database structure: For I-CSCF you will also need a database structure:
  
-mysql -uroot -p < icscf.sql+  ​mysql -uroot -p < icscf.sql
 (on the database server) (on the database server)
 +===== Configuration of the network entities =====
 +
 +You find the according configs in the examples folder of Kamailio (Trunk). For the Proxy-CSCF, use the configurations in examples/​pcscf,​ for the Interrogating-CSCF in examples/​icscf/,​ for the Serving-CSCF in examples/​scscf/​.
 +
 +The configuration for each server consists of minimum two files:
 +  * kamailio.cfg - the main configuration-file (general for each entity)
 +  * pcscf.cfg / icscf.cfg / scscf.cfg - inidividual configurations for the P-/​I-/​S-CSCF (everything,​ that's individual per server)
 +  * pcscf.xml / icscf.xml / scscf.xml - Diameter configurations
  
-Copy the required config to kamailio.cfg ​(e.g. pcscf.cfg), adapt the config ​to your needs (change "​ng-voice.com"​ and the IP to your domain/IP, please remember also the escaped versions of the domain and the IP, e.g. "​pcscf\.ng-voice\.com). For components with Diameter-Interface (e.g. I-/S-CSCF) you will need to modify the according XML-files, e.g. "​pcscf.xml"​).+Copy the required config ​files to your /etc/kamailio/-folder, adapt the config in the pcscf.cfg/pcscf.xml to your needs (change "​ng-voice.com"​ and the IP to your domain/IP, please remember also the escaped versions of the domain and the IP, e.g. "​pcscf\.ng-voice\.com). For components with Diameter-Interface (e.g. I-/S-CSCF) you will need to modify the according XML-files, e.g. "​pcscf.xml"​).
  
 Finally, you should edit the "/​etc/​default/​kamailio"​-File,​ in order to run the component. Finally, you should edit the "/​etc/​default/​kamailio"​-File,​ in order to run the component.
Line 69: Line 94:
 Now the Component should be able to start: Now the Component should be able to start:
  
-pcscf:/# /​etc/​init.d/​kamailio start +  ​pcscf:/# /​etc/​init.d/​kamailio start 
-Starting kamailio: kamailioloading modules under /​usr/​lib/​kamailio/​modules:/​usr/​lib/​kamailio/​modules_s:/​usr/​lib/​kamailio/​modules_k +  Starting kamailio: kamailioloading modules under /​usr/​lib/​kamailio/​modules:/​usr/​lib/​kamailio/​modules_s:/​usr/​lib/​kamailio/​modules_k 
-Listening on+  Listening on
            udp: 109.239.50.67:​5060            udp: 109.239.50.67:​5060
            tcp: 109.239.50.67:​5060            tcp: 109.239.50.67:​5060
-Aliases:+  ​Aliases:
            tcp: pcscf:5060            tcp: pcscf:5060
            udp: pcscf:5060            udp: pcscf:5060
            *: pcscf.ng-voice.com:​5060            *: pcscf.ng-voice.com:​5060
 +           *
 And voila: Your component is running! And voila: Your component is running!
 +====== Installation of the Fraunhofer HSS ======
  
-Installation of the FHoSS+The Fraunhofer HSS (FHoSS) requires the original Java from Oracle/Sun. Using OpenJDK won't work. 
 + 
 +===== Install Sun Java (on Lenny) =====
  
 Note: You will need to add the “non-free” packages to your repository: Note: You will need to add the “non-free” packages to your repository:
  
-deb http://​ftp.de.debian.org/​debian lenny main non-free +  ​deb http://​ftp.de.debian.org/​debian lenny main non-free 
-deb http://​security.debian.org/​ lenny/​updates main non-free+  deb http://​security.debian.org/​ lenny/​updates main non-free 
 + 
 +===== Install Oracle Java (on Squeeze) ===== 
 + 
 +Oracle Java is no longer available in the official repository. However, there are several ways to install Oracle Java, here is one possible way: 
 + 
 +* http://​www.webupd8.org/​2012/​06/​how-to-install-oracle-java-7-in-debian.html 
 + 
 +===== Install the FHoSS-Packages ===== 
 + 
 +Add our repository to your "/​etc/​apt/​sources.list":​ 
 + 
 +  echo "deb http://​repository.ng-voice.com wheezy fhoss" >> /​etc/​apt/​sources.list 
 Install the FHoSS from our repository: Install the FHoSS from our repository:
  
-apt-get install openimscore-fhoss+  ​apt-get install openimscore-fhoss 
 Create the data in the database: Create the data in the database:
  
-mysql -uroot -p < /​etc/​fhoss/​sql_files/​hssdb.sql+  ​mysql -uroot -p < /​etc/​fhoss/​sql_files/​hssdb.sql 
 Add some sample data, if you like: Add some sample data, if you like:
  
-mysql -uroot -p < /​etc/​fhoss/​sql_files/​userdata.sql+  ​mysql -uroot -p < /​etc/​fhoss/​sql_files/​userdata.sql 
 The Webinterface should be reachable on port “8080″. The Webinterface should be reachable on port “8080″.
  
 The following config files (/​etc/​fhoss) may be of interest: The following config files (/​etc/​fhoss) may be of interest:
  
-DiameterPeerHSS.xml:​ The Diameter Interconnects and listening IP definition +  * DiameterPeerHSS.xml:​ The Diameter Interconnects and listening IP definition 
-hss.properties:​ The listening IP definition for the Web-Interface +  ​* ​hss.properties:​ The listening IP definition for the Web-Interface 
-hibernate.properties:​ The database interconnection for the HSS +  ​* ​hibernate.properties:​ The database interconnection for the HSS 
-conf/​tomcat-users.xml:​ Usernames and Passwords for the Web-User (default Username is: “hssAdmin” and password “hss”) +  ​* ​conf/​tomcat-users.xml:​ Usernames and Passwords for the Web-User (default Username is: “hssAdmin” and password “hss”) 
-Note: You will need to restart the FHoSS (“/​etc/​init.d/​openimscore-fhoss restart”) in order to apply changes.+  ​* ​Note: You will need to restart the FHoSS (“/​etc/​init.d/​openimscore-fhoss restart”) in order to apply changes.
tutorials/ims/installation-howto.1374510880.txt.gz · Last modified: 2013/07/22 18:34 by carstenbock