SIP Servlets Server User Guide
Total Page:16
File Type:pdf, Size:1020Kb
SIP Servlets Server User Guide The Guide to the SIP Servlets v1.1-Certified Server Douglas Silas <[email protected]> Jean Deruelle <jean.deruelle (at) gmail.com> Vladimir Ralev <vladimir.ralev (at) gmail.com> Ivelin Ivanov <ivelin.atanasoff.ivanov (at) gmail.com> Charles Roufay <charles.roufay (at) gmail.com> Jared Morgan <[email protected]> SIP Servlets Server User Guide: The Guide to the SIP Servlets v1.1-Certified Server by Douglas Silas, Jean Deruelle, Vladimir Ralev, Ivelin Ivanov, Charles Roufay, and Jared Morgan Abstract This user guide will help you get a better understanding of Mobicents SIP servlets and how the container can be used in an enterprise context. The guide will cover how to how to quickly get started with Mobicents SIP servlets either on top of JBoss or Apache Tomcat containers. There are sample applications included for those who want to grasp how to build SIP applications. You will also learn how to use advanced features like High Availability through Clustering and Failover. Finally, monitoring and security will be explained. Preface ............................................................................................................................. vi 1. Document Conventions ......................................................................................... vi 1.1. Typographic Conventions ............................................................................ vi 1.2. Pull-quote Conventions ............................................................................. viii 1.3. Notes and Warnings ................................................................................. viii 1. Introduction ................................................................................................................. 1 1.1. Overview of Mobicents SIP Servlets within the Telecommunications Industry .......... 1 1.2. Overview of SIP Servlets Server .......................................................................... 1 2. SIP Servlets Server-Installing, Configuring and Running ............................................ 3 2.1. Getting Started with MSS for JBoss AS7 .............................................................. 3 2.1.1. Downloading and Starting MSS for JBoss AS7 .......................................... 3 2.1.2. Testing Click2Call with MSS for JBOSS AS7 ............................................. 6 2.1.3. Command Line Interface for MSS JBoss AS7 ............................................ 9 2.1.4. Accessing Management Console ............................................................. 13 2.2. Getting Started with MSS for Tomcat 7 .............................................................. 18 2.2.1. Testing Click2CallAsync with MSS for Tomcat 7 ....................................... 19 2.2.2. Tomcat for Windows ............................................................................... 25 2.3. Sip Connectors ................................................................................................. 27 2.3.1. Configuring SIP Connectors and Bindings ................................................ 27 2.3.2. Application Routing and Service Configuration ......................................... 30 2.3.3. SIP Servlets Server Logging ................................................................... 34 3. Application Router ..................................................................................................... 38 3.1. Default Application Router ................................................................................. 38 3.1.1. Role of the Application Router ................................................................ 38 3.1.2. Mobicents Default Application Router ...................................................... 38 3.1.3. Limitations of the Default Application Router ............................................ 43 3.2. DFC Application Router ..................................................................................... 44 3.2.1. Description of DFC Application Router ..................................................... 44 3.2.2. Installing the DFC Application Router ...................................................... 44 4. SIP Servlet Example Applications ............................................................................. 46 4.1. Operating the Example Applications ................................................................... 48 4.1.1. The Location Service .............................................................................. 48 4.1.2. The Diameter Event-Changing Service .................................................... 51 4.1.3. The Call-Blocking Service ....................................................................... 57 4.1.4. The Call-Forwarding Service ................................................................... 59 4.1.5. The Call-Controller Service ..................................................................... 62 4.1.6. Media IPBX ........................................................................................... 65 4.1.7. Tomcat Servlet Click2call Windows Setup ................................................ 66 5. Clustering and High Availability ................................................................................ 79 5.1. Understanding Mobicents High Availabilty .......................................................... 79 5.2. Load Balancer .................................................................................................. 80 5.2.1. SIP Load Balancer: Installing, Configuring and Running ............................ 81 5.2.2. IP Load Balancing .................................................................................. 92 5.2.3. SIP Load Balancing Basics ..................................................................... 93 iii SIP Servlets Server User Guide 5.2.4. HTTP Load Balancing Basics .................................................................. 94 5.2.5. Pluggable balancer algorithms ................................................................ 94 5.2.6. Distributed load balancing ....................................................................... 95 5.2.7. Implementation of the Mobicents Load Balancer ....................................... 96 5.2.8. SIP Message Flow ................................................................................. 97 6. Enterprise Monitoring and Management .................................................................... 99 7. Security .................................................................................................................... 100 7.1. SIP Servlets Application Security ..................................................................... 100 7.2. TLS ................................................................................................................ 103 7.2.1. Quick Start ........................................................................................... 103 7.2.2. Production Setup .................................................................................. 108 8. Advanced Features of the SIP Servlets Server ........................................................ 110 8.1. Media Support ................................................................................................ 110 8.1.1. JSR 309: Media Server Control API ...................................................... 110 8.2. Concurrency and Congestion Control ............................................................... 110 8.3. STUN Support ................................................................................................ 116 8.4. Mobicents vendor-specific Extensions to JSR 289 ............................................. 117 8.5. CDI Telco Framework ..................................................................................... 118 8.6. Diameter Support ............................................................................................ 118 8.7. SIP and IMS Extensions .................................................................................. 119 8.8. SIP Servlets - JAIN SLEE Interoperability ......................................................... 122 8.9. Eclipse IDE Tools ........................................................................................... 124 8.9.1. Pre-Install requirements ........................................................................ 125 8.9.2. Installation ............................................................................................ 125 8.9.3. SIP Servlets Core Plug-in ..................................................................... 125 8.9.4. SIP Phone Plug-in ................................................................................ 125 9. Best Practices .......................................................................................................... 126 9.1. Mobicents SIP Servlets Performance Tips ........................................................ 126 9.1.1. Tuning JBoss ....................................................................................... 126 9.1.2. Tuning Mobicents SIP Servlets .............................................................. 126 9.1.3. Tuning The JAIN SIP Stack .................................................................. 126 9.1.4. Tuning The JVM .................................................................................. 128 9.1.5. Tuning The Operating System ............................................................... 129 9.2. NAT Traversal ...............................................................................................