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

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
tutorials:ims:installation-howto [2013/08/23 17:14]
carstenbock [Configuration of the repository (All nodes)]
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
  
-(replace squeeze with wheezy for Debian7).+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 =====
  
-Copy the required config to kamailio.cfg (e.gpcscf.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").+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 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 71: 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