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
Next revision Both sides next revision
tutorials:ims:installation-howto [2013/07/22 18:34]
carstenbock created
tutorials:ims:installation-howto [2019/05/25 09:31]
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.txt · Last modified: 2021/12/23 09:08 by henningw