Differences

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

--- tutorials:ims:installation-howto [2013/07/22 16:34] – created carstenbock
+++ tutorials:ims:installation-howto [2021/12/23 08:08] (current) – henningw
@@ Line 1: / Line 1: @@
+**Note: This document is now (2021) outdated, as the IMS packages have been integrated into the common Kamailio repository **
 **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
@@ Line 21: / Line 23: @@
 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;
-              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.//
@@ Line 32: / Line 36: @@
 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 ======
@@ Line 44: / Line 56: @@
 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
-And update the available packets:
+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
- apt-get update
+And update the available packets:
-===== Proxy-CSCF =====
+  apt-get update
+===== Installation of Proxy-/Interrogating-/Serving-CSCF Binary packages =====
 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:
-mysql -uroot -p < icscf.sql
+  mysql -uroot -p < icscf.sql
 (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.
@@ Line 69: / Line 96: @@
 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
            tcp: 109.239.50.67:5060
-Aliases:
+  Aliases:
            tcp: pcscf:5060
            udp: pcscf:5060
            *: pcscf.ng-voice.com:5060
+           *
 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:
-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:
-apt-get install openimscore-fhoss
+  apt-get install openimscore-fhoss
 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:
-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 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.