WebRTC-SIP Gateway
<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <div style='border:none;border-bottom:solid #4F81BD 1.0pt;padding:0in 0in 4.0pt 0in'> <p class="MsoTitleCxSpFirst" align="center" style='text-align:center'><span style='position:relative;z-index:251658240;left:-5px;top:-4px;width:839px; height:1070px'><img width="839" height="1070" src="WebRTC_SIP_Gateway_Doc_files/image001.png"></span><span style='font-size: 36.0pt'> </span></p> <br clear="ALL"> <p class="MsoTitleCxSpMiddle" align="center" style='text-align:center'><span style='font-size:36.0pt'>MRTC Documentation</span></p> <p class="MsoTitleCxSpLast" align="center" style='text-align:center'><span style='font-size:18.0pt'>Mizutech WebRTC-SIP gateway User Guide</span></p> </div> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoTocHeading">Contents</p> <p class="MsoNormal"> </p> <p class="MsoToc1"><a href="start.htm#_Toc514216587">About<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>3</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216588">Features<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>3</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216589">Requirements<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>4</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216590">How It Works<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>4</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216591">Legal Agreement<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>4</span></a></p> <p class="MsoToc1"><a href="start.htm#_Toc514216592">Setup and configuration<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>5</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216593">Install<span style='color:windowtext; display:none;text-decoration:none'> </span><span style='color:windowtext;display:none;text-decoration:none'>6</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216594">Configuration Wizard<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>6</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216595">SIP Server Configuration<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>7</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216596">WebRTC Client Configuration<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>7</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216597">Troubleshooting<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>9</span></a></p> <p class="MsoToc1"><a href="start.htm#_Toc514216598">Management and Monitoring<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>9</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216599">MizuManage<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>10</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216600">User Management<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>11</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216601">Add SIP Server<span style='color: windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>12</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216602">Add User<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>13</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216603">Outbound Routing<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>14</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216604">Inbound Routing<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>15</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216605">CDR<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>15</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216606">Statistics and Monitoring<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>16</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216607">Start/Stop<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>16</span></a></p> <p class="MsoToc3"><a href="start.htm#_Toc514216608">Backup/Restore<span style='color: windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>17</span></a></p> <p class="MsoToc1"><a href="start.htm#_Toc514216609">Additional Settings<span style='color:windowtext;display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>17</span></a></p> <p class="MsoToc1"><a href="start.htm#_Toc514216639">FAQ<span style='color:windowtext; display:none;text-decoration:none'>.. </span><span style='color:windowtext;display:none;text-decoration:none'>42</span></a></p> <p class="MsoToc1"><a href="start.htm#_Toc514216654">Resources<span style='color:windowtext; display:none;text-decoration:none'>. </span><span style='color:windowtext;display:none;text-decoration:none'>54</span></a></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h1 style='margin-top:0in'><a name="_Toc514216587"><span style='font-size:16.0pt; line-height:115%;font-family:"Calibri",sans-serif'>About</span></a></h1> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The Mizu </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP.aspx"><span style='font-size:14.0pt;line-height:115%'>WebRTC Gateway</span></a><span style='font-size:14.0pt;line-height:115%'> (MRTC) is a software solution to convert the WebRTC protocol family to the SIP protocol family.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The MRTC software runs as an NT service on Windows operating system and includes all modules for efficient protocol conversion between WebRTC and SIP.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216588"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Features</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'> </p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The most important features are listed below:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Full stack conversion between WebRTC and SIP</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>GUI based management with real-time monitoring and detailed statistics</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Multiple SIP server support for both outbound and inbound</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Convert Websocket (WS/WSS) to plain clear text SIP signaling over UDP or TCP</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Convert WebRTC media (DTLS/SRTP) to plain RTP/RTCP over UDP</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Media path negotiation with ICE, TURN, STUN</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Optimal media and codec negotiation between WebRTC and SIP</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Codec transcoding when necessary (handled automatically by default and can be forced/disabled)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Supported <span style='color:black'>codecs</span>: G.711, G.729, G.723, GSM, iLBC, OPUS, Speex, G.722, VP8, VP9, H.264, H.265</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Flexible configuration and routing rules</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Auto TLS certificate</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Push notifications (for Web, Android and iOS)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Intelligent NAT/firewall bypass using both UDP and TCP candidates and shortest path detection</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Secure: border security, media security, rate-limiter, DOS attack protection, topology hiding</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Encryption: TLS/DTLS/SRTP</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Reliable: HA setup with auto-failover and/or load-balancing, heartbeat monitoring and health statistics, threshold triggered actions, auto reroute, auto reconnect, auto redial</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Support for a broad range of VoIP features including voice, video and unified communication </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>PBX/Class 5 features: DTMF, call transfer, call forward, mute, hold, re-invite, caller-id, call fork</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Extra features: call rerouting, voice recording, IM recording, file transfer, conference, voice-mail, presence, chat, SMS, IVR, P2P, callback, webcall, click-to-call and many others</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Compatible with all SIP server, softswitch or IP-PBX such as Asterisk, Cisco, Voipswitch, 3CX, FreePBX, Trixbox, Elastix, SER and others</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Compatible with all native WebRTC clients and WebRTC capable browsers, including Firefox, Chrome, Edge, Safari, Opera and WebViews</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216589"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Requirements</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You will need the following elements to be able to use the gateway:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>The hardware requirements depends on the usage. For example for up to 10000 users and 100 simultaneous calls: a low-end server with 2 CPU core, 4 GB RAM and 60 GB disk. The service can be hosted also on a virtual server or cloud server</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Network requirements are similar to a typical SIP server (around 10 mbits for 150 simultaneous calls. Basic registrations are using minimal bandwidth: 1 mbits for 10000 users).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>OS: Windows (The MRTC gateway can be hosted on any Windows version. Recommended: latest server Standard version, 64bit. Note that your MRTC will be </span><a href="start.htm#_Security"><span style='font-size:14.0pt'>secure</span></a><span style='font-size:14.0pt'>, regardless of the OS)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>SIP Server (Softswitch or IP-PBX) or SIP proxy. This is your existing SIP server(s) where you wish to add WebRTC support</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Any RFC 7118 compatible WebRTC client (such as the </span><a href="https://www.mizu-voip.com/Software/WebPhone.aspx"><span style='font-size: 14.0pt'>webphone</span></a><span style='font-size:14.0pt'>, </span><a href="https://sipjs.com/"><span style='font-size:14.0pt'>SIP.js</span></a><span style='font-size:14.0pt'>, </span><a href="http://jssip.net/"><span style='font-size:14.0pt'>JsSIP</span></a><span style='font-size:14.0pt'>, </span><a href="http://www.doubango.org/sipml5/"><span style='font-size:14.0pt'>sipML5</span></a><span style='font-size:14.0pt'> and others. Usually ran from a browser but you can also use native WebRTC clients)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>More details can be found </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP/Prerequisites_for_WebRTC_SIP_gateway.aspx"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoListParagraph" style='margin-top:0in;margin-right:0in;margin-bottom: 0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216590"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>How It Works</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The WebRTC-SIP gateway acts as a relay between the WebRTC clients (usually browsers) and your SIP server(s) (IP PBX, Softswitch, SIP proxy or other SIP capable equipment). MRTC includes all the necessary modules for optimal protocol conversion regardless of your WebRTC or SIP software and network circumstances. The gateway will transparently convert the traffic from the WebRTC clients to plain SIP/RTP. No need for any changes or re-configuration on your existing server.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'><img border="0" width="726" height="146" id="Picture 1" src="WebRTC_SIP_Gateway_Doc_files/image002.png"></span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>More details about how it works can be found on the </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP.aspx#dnn_ctr1708_dnnTITLE_titleLabel"><span style='font-size:14.0pt'>MRTC homepage</span></a><span style='font-size:14.0pt'>. General technical details about WebRTC-SIP gateways can be found </span><a href="https://www.mizu-voip.com/Support/Wiki/tabid/99/Default.aspx?topic=WebRTC-SIP+gateway+definition"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216591"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Legal Agreement</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Mizu®, MRTC, webphone, Mizu WebRTC-SIP gateway, Mizu WebRTC-SIP proxy the names associated with Mizutech products are trademarks and/or service marks of Mizutech SRL. All other trademarks are property of their respective owners. This product may contain open source software freely downloadable from Mizutech website.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>This SOFTWARE is licensed, not sold. All rights reserved for MizuTech SRL.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>By installing, copying, or otherwise using this product, you acknowledge that you have read, understood, and agreed to be bound by the terms and conditions of the End User License Agreement for this product.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The software is provided "as is" without any warranty of any kind.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Mizutech makes no warranties, liability or responsibility for the accuracy of this document and makes no representations about the suitability of the information contained in this document for any purpose. In no event shall Mizutech be liable for any direct, consequential, incidental, special, punitive or other damages caused by this document or the MRTC software.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can order and purchase a license for this software from </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP/WebRTC-SIP-Gateway-Pricing.aspx"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Contact us with any questions at </span><a href="mailto:info@mizu-voip.com?subject=WebRTC-SIP%20Gateway"><span style='font-size:14.0pt'>info@mizu-voip.com</span></a><span style='font-size: 14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h1 style='margin-top:0in'><a name="_Toc514216592"><span style='font-size:16.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Setup and configuration</span></a></h1> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'>This is the most important chapter in this Guide.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><b><span style='font-size:14.0pt;line-height:115%'>In short</span></b><span style='font-size:14.0pt;line-height:115%'>, you just have to do the followings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Portals/0/Files/MRTC_Setup.exe"><span style='font-size:14.0pt;line-height:115%'>Download</span></a><span style='font-size:14.0pt;line-height:115%'> and install MRTC</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Configure MRTC from the MRTC Admin </span><a href="start.htm#_Configuration_Wizard"><span style='font-size:14.0pt;line-height:115%'>Configuration Wizard</span></a><span style='font-size:14.0pt;line-height:115%'>:<br> Just follow the instructions (set Bind/Local IP, Domain name, </span><a href="start.htm#_SIP_Server_Configuration"><span style='font-size:14.0pt;line-height: 115%'>SIP server</span></a><span style='font-size:14.0pt;line-height:115%'>)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Start the service and make sure that the executables are </span><a href="start.htm#_Firewall"><span style='font-size:14.0pt; line-height:115%'>enabled on your firewall</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If your gateway is behind NAT then forward the required ports on your router: MRTC Admin -> Config menu -> Networking -> Active ports</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>5.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Set your </span><a href="start.htm#_SSL_certificate"><span style='font-size:14.0pt;line-height:115%'>TLS certificate</span></a><span style='font-size:14.0pt;line-height:115%'>. If you configured a domain name, then the gateway is capable to acquire a Let’s Encrypt Certificate.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>6.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>You can verify if your networking/domain/port-forward/TLS is working correctly by opening this link in your browser: </span><a href="https://domainname/tlsproxytestxxxxxx"><span style='font-size:14.0pt; line-height:115%'>https://DOMAINNAME/tlsproxytestxxxxxx</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>7.<span style='font:7.0pt "Times New Roman"'> </span></span><a href="start.htm#_WebRTC_Client_Configuration"><span style='font-size:14.0pt;line-height: 115%'>Configure</span></a><span style='font-size:14.0pt;line-height:115%'> your WebRTC clients (SIP server, Websocket URL, ICE/STUN/TURN) after the instructions at Help menu -> Client Configuration</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>8.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Launch your WebRTC client, register and make test calls. See the </span><a href="start.htm#_Troubleshooting"><span style='font-size:14.0pt;line-height:115%'>troubleshooting</span></a><span style='font-size:14.0pt;line-height:115%'> chapter if you run into some issue.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Details below:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></i></p> <h3 style='margin-top:0in'><a name="_Toc514216593"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Install</span></a></h3> <p class="MsoNormalCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:black'> </span></p> <p class="MsoNormalCxSpMiddle" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:black'>The MRTC gateway has a standard easy to use installer.</span></p> <p class="MsoNormalCxSpMiddle" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:black'>The gateway shall be installed on a Windows machine (server or PC) somewhere near your softswitch OR near your customers OR in the path between (to minimize media delays).</span></p> <p class="MsoNormalCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that your system meets the </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP/Prerequisites_for_WebRTC_SIP_gateway.aspx"><span style='font-size:14.0pt;line-height:115%'>minimum requirements</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Download the MRTC installer from </span><a href="https://www.mizu-voip.com/Portals/0/Files/MRTC_Setup.exe"><span style='font-size:14.0pt;line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Double-click to start the install process and follow the instructions (requires Administrator rights)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Once the install completes, it should automatically start the Admin client with its Configuration Wizard. This is discussed in the next chapter.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216594"></a><a name="_Toc285322898"></a><a name="_Configuration_Wizard"></a><span style='font-size:14.0pt;line-height: 115%;font-family:"Calibri",sans-serif'>Configuration</span><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'> Wizard</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For the basic server configuration you should walk through the detailed <b>configuration wizard</b> which is started automatically at first usage or accessible from the “Config” menu.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Don’t change any setting that you don’t fully understand, just click on the “Next” button in this case. Most of the settings are self-explanatory with a short description near them and/or a hint if you hold the mouse over a control.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Pay <b>special attention to the “Network” and “SIP server”</b> pages:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>on the Network page enter the correct IP and NAT configuration ("Offer services for" or “Allow LAN peers”)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>make sure that the ports used by the WebRTC-SIP proxy (SIP port, Access port, Secure port) are not used by some other application such as a local web server (in this case either change the MRTC ports or the third party app port or bind them to separate IP address)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>you need a domain for TLS certificate, otherwise it won’t work in modern browsers (both the domain and the TLS certificate can be auto generated or alternatively you should assign a sub(domain) for the gateway IP and you can also set your own certificate)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>on the SIP server page enter your PBX/Softswitch details (later you can add </span><a href="start.htm#_Add_SIP_Server"><span style='font-size:14.0pt'>more</span></a><span style='font-size:14.0pt'> SIP servers if needed)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Click “Apply” on the last page to save the configuration. Check the displayed messages and instructions.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you select the “(Re)Start the server” checkbox, then the gateway service should start automatically. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Otherwise start it from the “Control” menu or use the Windows Service manager and start the “mserver” service.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'><br> When you start the service for the first time, it is a good idea to open the “Analyze” form to check for any potential issues. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Once the service is started, you can connect with WebRTC clients and make calls.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Later you can add more servers or modify advanced configuration </span><a href="start.htm#_Additional_Settings"><span style='font-size:14.0pt'>options</span></a><span style='font-size:14.0pt'> after your needs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'>Note: for WebRTC to work in modern browsers, you need to host your webpage on HTTPS (secure HTTP with valid SSL certificate) and you must use WSS (secure Websocket) for the WebRTC proxy connection. This means that you must specify a (sub)domain name and enable auto-ssl or set your own certificate for the gateway.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></i></p> <h3 style='margin-top:0in'><a name="_Toc285322899"></a><a name="_Toc514216595"></a><a name="_SIP_Server_Configuration"></a><span style='font-size:14.0pt;line-height: 115%;font-family:"Calibri",sans-serif'>SIP Server Configuration</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>A default/first SIP server record is created for you by the Configuration Wizard from the details you provide on the “SIP Server” page.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Use the “Add Upper SIP server” form (available from “Config” menu -> Quick add -> Users) <b>in case if you have more SIP servers</b> where the traffic from the clients needs to be sent (WebRTC -> SIP) or accepted from (SIP -> WebRTC). Also don’t forget to manage the routing in this case.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The most important configuration for a SIP server is its network address (IP and/or domain name). Also you must specify the port number if your server is not using the default SIP port (UDP 5060). This can be done by just appending it after the IP after a colon (such as 11.22.33.44:5678) or as the “port” field in the user table.</span><i><span style='font-size:12.0pt;line-height:115%'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>Note: if you enter the :port after the IP then the port part will disappear, but the port field will be set accordingly.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You <b>don’t need to change any setting on your existing SIP server</b>/PBX/Softswitch as you will see all the traffic coming from the WebRTC clients as normal SIP traffic, usually with the SIP standard digest authentication. The only notable difference is that all traffic from WebRTC clients will come from the Gateway IP, so make sure to white-list this IP on your server or release any rate-limiter restrictions, but do not set IP based authentication for the Gateway IP! (The registrations and calls from WebRTC clients will do proper SIP digest authentication, so you will need to authenticate them as endusers/extensions and not as a SIP trunk with IP authentication, unless you do this intentionally, to unconditionally accept any traffic from WebRTC).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>More details about configuration can be found </span><a href="start.htm#_Add_SIP_Server"><span style='font-size:14.0pt; line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height: 115%'> and </span><a href="start.htm#_Outbound_Routing"><span style='font-size:14.0pt; line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height: 115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216596"></a><a name="_WebRTC_Client_Configuration"></a><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>WebRTC Client Configuration</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In short: just <b>use the “Client configuration” from the “Help” menu</b> for the exact details.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Details:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Once you finished with the configuration wizard and your gateway is running, you can connect with your favorite WebRTC client and make calls.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Parameters:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>“Gateway address” means your MRTC gateway IP or domain name (if you have assigned a domain)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>“Mainport” means the gateway websocket port (use the secure port if you enabled SSL)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>If you have SSL enabled, use WSS for websocket. Otherwise use WS.</span></i></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>SIP domain/proxy/realm: your SIP server domain name or IP (for example 11.22.33.44:5060)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>WebSocket Server URL: the gateway wss://address:mainport/mfstwebsock (for example: wss://domain.com:443/mfstwebsock)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>TURN server address: the gateway address and the main unsecure port (for example domain.com:80)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>STUN server address: the gateway address and the <span style='color:#984806'>mainaportudp</span> port (for example domain.com:8090)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To find out how to configure your WebRTC client go to the “Help” menu and select the “Client configuration” item. Use the details listed in the “#### WebRTC” section. This will list all you need to know to connect with various WebRTC clients.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'>Note: if you haven’t set a domain and SSL certificate for the gateway or your webpage is not on HTTPS (secure HTTP with valid SSL certificate) then WebRTC will not work from modern browsers.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For the first test call use two enduser accounts (extensions) valid on your SIP server and make calls between them. Use the first account in your WebRTC client (such as webphone, sipml5 or jssip) and the second account in a SIP client (such as MizuPhone or X-Lite). Register with both and call from WebRTC to SIP then from SIP to WebRTC. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Please note that you can also make calls between WebRTC and WebRTC and also between SIP to SIP endpoints (although this latter usually doesn’t make much sense, because there are no reasons why you might connect with SIP clients via the gateway, since your SIP server can handle these anyway).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>During a call, you can open the “Current calls” form in the MizuManage to see the details.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>After the call you can see the CDR (call detail report) by opening the “CDR” form in the MizuManage. If there are no CDRs (call detail records), it means that the call has not reached the server (wrong network settings on server or client side).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216597"></a><a name="_Troubleshooting"></a><span style='font-size:14.0pt;line-height:115%; font-family:"Calibri",sans-serif'>Troubleshooting</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you can’t connect/register or make calls, check the followings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Make sure that the service is actually started (check the “mserver” service status in Windows Service manager)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Make sure that the application is enabled on your </span><a href="start.htm#_Firewall"><span style='font-size:14.0pt'>firewall</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Have a look at the “Dashboard” form</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Open the “Analyze” form and click on the “Analyze” button to detect potential issues</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Check any important errors or warnings on the “Logs” form</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Make sure that you have basic connectivity to the important ports such as 80 and 443. Use telnet gatewayip port command from a PC from where you are trying to connect with WebRTC</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Check if TLS/certificate is installed and working correctly (MManage -> Config menu -> Utilities -> Tests -> TLS certificate test)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Install a SIP softphone (such as </span><a href="http://www.counterpath.com/x-lite-download/"><span style='font-size:14.0pt'>X-Lite</span></a><span style='font-size:14.0pt'> or </span><a href="https://www.mizu-voip.com/Portals/0/Files/MizuPhone_Install.exe"><span style='font-size:14.0pt'>MizuPhone</span></a><span style='font-size:14.0pt'>) on the same server where you are running your Gateway and make sure that you can make call to your SIP server from there.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If you are making call to a user/extension, make sure that the called user is registered when you call it</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If you don’t hear any voice you might change the RTP routing for the user(s) to “always route RTP” from MizuManage -> Users and devices -> Edit tab</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If the call setup time is too long, check </span><a href="start.htm#_Slow_call_setup"><span style='font-size:14.0pt'>here</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Are you running your WebRTC or SIP endpoint on the gateway PC? Don’t do this. Most WebRTC stacks has various bugs when they are run from the same IP where they connect to.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>In case of call failure you can check the disconnect reason from the “CDR” form</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Verify the log files. You can find the logs in the server app folder (near the mserver.exe) -> “logs” subfolder. You can also open the folder from MRTCAdmin -> Files Menu -> Folders -> Server logs.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Open the last log file (“log_xxx.dat”) with a fast text viewer (For example F3 from Total Commander). To find application errors, open the last log file in the server app directory and search for “ERROR” and “WARNING”. To find a call, search for “INVITE sip:callednumber”.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>You can modify the trace details with the “loglevel” configuration option: from 1 to 5.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Contact </span><a href="mailto:info@mizu-voip.com?subject=WebRTC-SIP%20Gateway%20support"><span style='font-size:14.0pt'>Mizutech support</span></a><span style='font-size: 14.0pt'> if the problem persists and you have or wish to buy a license</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <h1 style='margin-top:0in'><a name="_Toc514216598"><span style='font-size:16.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Management and </span></a><a name="_Toc285322907"><span style='font-size:16.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Monitoring</span></a></h1> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The most important settings can be configured from Config menu -> Configuration Wizard as already discussed in the previous chapter.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Once the WebRTC-SIP gateway is installed and configured correctly, there is nothing much to manage on the Gateway itself as it has full auto-management capability (such as auto deleting log files, auto fine-tune to your hardware, automatic user management and others).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>This means that this whole chapter is completely optional and you might not need to know about these details at all to run a fully working WebRTC-SIP proxy.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216599"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>MizuManage</span></a><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'> </span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>All administration and monitoring tasks can be done from the MRTCAdmin client (MizuManage / MManage / MizuManagement), which is included in the WebRTC gateway install package.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Using the Gateway, you will still need to use your Softswitch/PBX to manage your Users (authentication, authorization, and accounting), Routing, Billing and any other aspects of your network.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Regardless of this, the WebRTC-SIP proxy also provides you complete monitoring and GUI based configuration managements, so you can easily change settings or find connectivity issues if that is WebRTC-SIP conversion related.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>Always check the status bar (the bottom text display). MRTCAdmin rarely displays popups and the success/error state of various operations are displayed on the status bar instead.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><u><span style='font-size:14.0pt;line-height:115%'>Filters:</span></u></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Nearly all forms in MRTCAdmin can be filtered with the followings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Quick filter: found in the top-left side in MizuManage. For example type “44*” in the quick filter box then open the “CDR” form and click “Load”. You should be able to see all calls to 44….. numbers. Or enter “test” and open the “Users and devices” form. Click on the load button to see accounts containing the “test” word (in name, username, address, etc)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Direction filtering: accessible by double clicking on the space below the quick filter or from the Fields menu -> Filter -> Set direction filter. When you are doing operation which needs more precision (eg. billing), always use the Set Directions form and not the quick filter.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Date-Time filter: found in the top-left side in the MizuManage. Useful to restrict statistics, reports and CDR listing intervals.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><u><span style='font-size:14.0pt;line-height:115%'>Menu:</span></u></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>The most important item is the Configuration wizard (from Config menu). Use this to (re)configure your gateway most important settings.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>From the “Control” menu you can Stop/Start/Restart your server (you can do so also from windows Services management console)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>To export data from the application, use File menu -> “Save As” (when the desired data is displayed)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>From the “Fields” menu you can manipulate the selected dataset (grids, etc).</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216600"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>User Management</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The MRTC gateway works transparently so you will have to continue to manage the users on your SIP server as you did it before. On the gateway you might configure only SIP server and Traffic sender user types to point to your SIP servers (if you have more than one SIP server, otherwise a single SIP server can be also configured from the Configuration Wizard).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>All user records can be managed from the “Users and devices” form (below the “Access” node in the tree-view).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Users can represent real people, endpoints, extensions, devices, gateways, proxies or servers.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The most important user types are the followings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>SIP server for outbound routing. Your SIP server(s) should be added here.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Traffic senders for inbound routing. Your SIP server(s) should be added also here.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Endusers: these are managed by the Gateway automatically.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Admin users: you should add yourself (and/or the administrator) here as it is used for various purposes such as sending alerts and reports.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The users are stored in the database tb_users table and they have a lot’s of properties which can be managed from the “Users and devices” form or (for advanced users only) changing database record fields (select a user the go to Fields menu -> Show fields).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><b><span style='font-size:14.0pt;line-height:115%'>You don’t need to manage endusers/extensions on the Gateway!</span></b><span style='font-size:14.0pt; line-height:115%'> In the MRTCAdmin you might see your endusers (extensions) listed on the “Users and devices” form, however that is only for monitoring purpose and for the gateway internals, auto created and managed by the Gateway. Except your extension usernames, no authentication credentials (password) or any sensitive information (such as billing) are stored on the Gateway. Use your Softswitch/PBX for user management.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><b><u><span style='font-size:14.0pt;line-height:115%'>Listing users</span></u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Open the “<b>Users and Devices</b>” form (below the “Access” section) and (double) click on a user type to have a listing. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can apply various filtering using the user “Type” checkbox-list, the dropdown-list on the top of the form or the already discussed direction filter or quick filter.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Your SIP servers can be found as “SIP Server” and “Traffic sender” accounts.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>You can easily search for users using the “quick filter” box. For example to list all outbound routes whose username or name contains the “carrier” word, select the “SIP Server” and type “carrier” in the quick filter. The quick filter will also search in other fields such as IP, name, email and others.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>Other listing options are available also from right click on the “Users and devices” node in the main tree-view or right click on user type node from within the “Users and devices” form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><a name="_Toc285322900"><b><u><span style='font-size:14.0pt;line-height:115%'>Creating users</span></u></b></a></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The best way to create new users is to clone an existing working account with the same user type.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For this, launch the “<b>Users and Devices</b>” form, select a user type, and click on the “Load” button. Then select any user entry and click on the “New User” button. <span style='color:black'>Alternatively right click on the “New” button for other options to add user records</span><span style='color:#984806'>. </span></span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Endusers</span></b><span style='font-size:14.0pt'> are created automatically by the server at first time when an extension will try to register or call. These enduser records are only for internal management and statistics reasons. This are the same users as the extensions on your PBX, but the Gateway might have information only about their username and display number (the gateway does not have to know the password since the authentications are forwarded to your SIP server). You don’t need to manage these endusers on the gateway (Keep using your PBX to manage your users).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The username can be also used as a real phone number; will be used also as the caller-id if not specified otherwise. Endusers can make voice or video calls, presence and chat directly between them without the need to be forwarded to your SIP server. (Alternatively you can disable direct routing between endusers by setting the <span style='color:#984806'>alloweuserusercalls</span> and <span style='color:#984806'>fs_directroutrfstofs</span> global config values to 0).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Traffic sender</span></b><span style='font-size:14.0pt'> users are used for receiving traffic from your SIP servers (PBX, Softswitch, SIP proxy or other SIP device). The authorization type is usually set to “Auth ip must match” and you have to enter a correct “Auth Ip” (IP address based authentication). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>SIP servers</span></b><span style='font-size:14.0pt'>: For outbound traffic you need one (or more) SIP Server user. The most important parameter here is the “IP” where the VoIP calls will be sent. Then you will have to configure these also on the Routing form. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>To be able to send and receive traffic to/from another SIP server or carrier you will have to add it as both a “traffic sender” and “sip server” user.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216601"></a><a name="_Add_SIP_Server"></a><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Add SIP Server</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Your upper SIP server(s) can be added multiple ways:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>from the Configuration wizard you can add your default/first SIP server on the “SIP server” page</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>from the “Add Upper SIP Server” form (from Config menu -> Quick add -> Users)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>by SQL query or API call (see the </span><a href="start.htm#_Integration"><span style='font-size:14.0pt'>Integration</span></a><span style='font-size:14.0pt'> chapter)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>from the “Users and devices” form (This is discussed here below)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>A default/first SIP server can be added during the configuration wizard. (You can also modify it from right click on “Configurations” node in the tree-view and select the “Upper server” from the popup menu).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The WebRTC-SIP proxy can handle multiple upper servers in case you have more SIP servers where you wish to accept WebRTC traffic.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>To add a SIP server open the “Add Upper SIP server” from Config menu -> Quick add -> Users.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>(Alternatively right click on the “Users and devices” node in the tree-view and select “Add Upper SIP Server”).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Pay attention to the following fields: IP, domain, port (you can also set the proxy field if needed).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Once you added your server, make sure to </span><a href="start.htm#_Outbound_Routing"><span style='font-size:14.0pt'>modify the routing</span></a><span style='font-size:14.0pt'> after your needs (if you have more than one server, then the routing needs to be able to decide somehow which traffic to send to which server. You can create various rules for this on the “Routing” form)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>When you add a SIP server, this is what happens:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>a Traffic sender account is created which will handle inbound traffic coming from your SIP server (SIP -> WebRTC)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>a SIP server account is created which will handle outbound traffic to your SIP server (WebRTC -> SIP)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>a default routing entry is created for the above SIP server</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Actually, you can “add a SIP server” also by just adding the above accounts manually from “Users and devices”.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If the WebRTC clients have to register to different SIP servers, set the “<span style='color:#984806'>routingforregister</span>” global config option to 1 (from the “Configurations” form). Otherwise set to 0. If the “<span style='color:#984806'>routingforregister</span>” is set to 0, then it will forward all registrations to your default SIP server which you have created during the configuration wizard.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>More details about multiple SIP servers can be found </span><a href="start.htm#_Multiple_SIP_servers"><span style='font-size: 14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216602"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Add User</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>There is <b>no need</b> to add endusers, extensions or WebRTC clients manually. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Just continue to manage your users as before: on your SIP server.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You will be able to see the users on the “Users and devices” form -> Endusers, however these are managed automatically by the Gateway and there is no need to change any settings here except if you have some extra requirement such as setting call forwarding, call recording or some other per user setting. The first time a WebRTC client will register or make call, a user entry is automatically created by the Gateway. This is mostly for internal usage only, but it also allows you to make per user changes if necessary. No password of these users are stored on the WebRTC gateway (The users are created with “Username” based authentication only, however the gateway will also check other parameters such as same session / same address for further account restriction. If you wish, you can create additional users of your own for various other purposes.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For special purposes you might add users also manually. There are multiple ways to do this: </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>click on the “New” button from “Users and Devices” </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>or right click on the “New” button </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>or right click on the “Users and devices” tree-view node.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>or from “Config” menu -> “Users”</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:#984806'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216603"></a><a name="_Toc285322902"></a><a name="_Outbound_Routing"></a><span style='font-size:14.0pt;line-height:115%; font-family:"Calibri",sans-serif'>Outbound Routing</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Outbound routing rules are required for the gateway to properly route the calls to your SIP server(s) (for WebRTC -> SIP calls).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Calls between users are handled automatically as this will bypass the routing table and it is routed directly </span><a href="start.htm#_Calls_between_endusers/extensions"><span style='font-size:14.0pt'>unless if you disable it</span></a><span style='font-size:14.0pt'>. However for outbound routing you need to add a “SIP server” user first and then add it to your routing rules.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Once you add your upper server as a “SIP server”, open the “<b>Routing</b>” <b>form</b>. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>In the left side you have to define your pattern which will restrict the condition when the actual route entries can be used. If all fields are empty and the time definition is set to “All times” then all patterns will match. You can make restrictions if you make specifications here (caller, called prefix, time restriction, etc). Make sure that you increase the priority for the pattern (to be higher than the “general” pattern where you have not made any restrictions).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>On the right side you will have to add one or more sip proxy users. If you set more than one route with equal priority, then you have load balancing, LCR or BRS (depending on the “<span style='color:#984806'>brs_lcr</span>” global config option); otherwise the traffic will be routed after the prioritizations (will flow to the lower priority servers only if you have reached the maximum port limitations or because automatic failover). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:#984806'>If you have only one server then just create one pattern (left side) enabled for all times and no any filter set, then assign your SIP server user entry to this pattern (right side).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:#984806'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For more details please read the </span><a href="https://www.mizu-voip.com/Portals/0/Files/Routing_guide.pdf"><span style='font-size:14.0pt'>routing guide</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><u><span style='font-size:14.0pt'>Client driven routing</span></u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The outbound routing can be influenced also from the client side. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>In this case the client will suggest the target upper SIP server with the INVITE target URI (so you will configure the gateway as a SIP proxy in your app and will set the SIP domain to the target upper SIP server) or by the X-Sy.Uppersrv (address), X-Sy.Uppersrvd (domain), X-Sy.Upperproxy (proxy) extra SIP headers. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>This is considered by the gateway only if <i>allowupperserverselection</i> global configuration is set to <i>1</i>. It can be set also from the Config Wizard -> “SIP Server” page -> “Allow client driven upper server selection” checkbox. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>In this case you should still create the SIP Server user entries and add them to the Routing (usually with equal priority, so the target server will be selected based on your app preferences)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><b><u><span style='font-size:14.0pt;line-height:115%'>Dial plans</span></u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can manipulate number format, SIP headers or the Caller-ID from the following settings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Users and devices form: caller-id, username, tel numbers (DID match), tech prefix</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Routing form: you can only specify routing direction here without number changes</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Rules form: this is a powerful module which you can use to change almost anything (including caller-id, called number format and many others)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Global configuration: a few global configuration options might also affect the dial plan. Right click on the “Configuration” node and select “Number rewrite” for the details.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Prefix rules and the dial plan form: use the “Rules” form instead when possible.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can find more details in the </span><a href="https://www.mizu-voip.com/Portals/0/Files/MAdminGuide.pdf"><span style='font-size:14.0pt'>VoIP Admin Guide</span></a><span style='font-size: 14.0pt'> below the Routing section.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216604"></a><a name="_Toc285322904"></a><a name="_Inbound_Routing"></a><span style='font-size:14.0pt;line-height:115%; font-family:"Calibri",sans-serif'>Inbound Routing</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you would like to accept traffic from your servers (SIP -> WebRTC calls), you need to have one or more “<b>Traffic sender</b>” user account created. Usually you can use IP based authentication. For this, add the peer IP to the “<b>Auth IP</b>” field.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For each incoming call, the server will first check if the called party is a local user. If not, then the call is routed according to the rules which are set by the “Routing” form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>One “Traffic sender” user entry can handle incoming traffic with IP authentication from multiple IP addresses. Use the “…” button near the “Auth IP List” to add more IP addresses.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>Usually there is no need to setup any routing rule for inbound calls (as these will be calls to local WebRTC users which are found automatically).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>Traffic between endusers/extensions is handled automatically.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216605"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>CDR</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>A CDR (call details report) is generated for each call on your gateway.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can access these records by using the <b>“CDR</b>” form under the “Monitoring” node in the tree-view. By default only the most important fields are listed (date-time, connect time, call duration, etc). You can see more details if you check the “All fields” checkbox. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>To quickly list the CDRs that belong to a user, open the “Users and devices” form. Find the user record, then right-click on it and select “Set Direction”. Than go back to the CDR form and click on the “Load/Reload” button.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>You can easily filter calls with a specific prefix by typing the prefix in the quick search box following with an asterisk and hit enter. For example searching for 44* will list all CDR where the called number begins with 44.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'>You can also see various statistics based on these CDR by using the “Statistics” or the “Disc. Reasons” forms.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:black'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216606"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Statistics and Monitoring</span></a></h3> <p class="MsoNoSpacing"><span style='font-size:14.0pt'> </span></p> <p class="MsoNoSpacing"><span style='font-size:14.0pt'>The Mizu WebRTC-SIP proxy provides endless possibilities for monitoring both real-time and statistics history. Some of the most important tools are the followings:</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Dashboard</span></b><span style='font-size:14.0pt'>: a summary of the most important parameters and a start point for management (Note: You can access various statistics by just clicking on the Dashboard items. For example click to “CCalls” will show the current calls)</span></p> <p class="MsoNoSpacing"><span style='font-size:14.0pt'>By using the “<b>Analyze</b>” form you can have a quick overview about the system and warnings for malfunctions or configuration suggestions</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Registrations</span></b><span style='font-size:14.0pt'>: Monitoring -> “Registrar” form and “Users and devices” form</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>List the active sessions: </span></b><span style='font-size:14.0pt'>Monitoring -> “Current Calls” form</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Disconnect reasons</span></b><span style='font-size:14.0pt'>: Monitoring -> Disc. Reasons will show statistics about call disconnect codes.</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Devices registrations</span></b><span style='font-size:14.0pt'>: Monitoring -> Registrar will show details about registrations</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Statistics by SIP server: </span></b><span style='font-size:14.0pt'>Monitoring -> Statistics -> Group By: called servers (useful if you have multiple server, softswitch or PBX)</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Statistics by users: </span></b><span style='font-size:14.0pt'>Monitoring -> Statistics -> Group By: caller</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Statistics by day: </span></b><span style='font-size:14.0pt'>Monitoring -> Statistics -> Group By: day</span></p> <p class="MsoNoSpacing"><b><span style='font-size:14.0pt'>Logs</span></b><span style='font-size:14.0pt'>: the most important logs can be listed from the “Logs” form. Detailed logs can be found in log files accessible from Files menu -> Folders -> Server Logs directory</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Other more <b>advanced statistics</b> can be generated by using the Statistics form and using different fields/options/grouping/directions.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>All statistics can be filtered by the “set direction” form or the “quick filer” edit-box and by a time interval selection.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Automatic reports: </span></b><span style='font-size:14.0pt'>The MRTC Gateway can send daily reports for administrators or email/sms alerts on malfunctions. For this you have to setup an “Admin” user with a valid email address (From the “Config Wizard” or from “Users and Devices”). Then set the following user fields to 1 (after your needs): “<span style='color:#984806'>sendemailalert</span>”, “<span style='color:#984806'>senddailyemal</span>”, “<span style='color:#984806'>sendmonthlyemail</span>”, “<span style='color:#984806'>sendsmsreport</span>”, “<span style='color:#984806'>sendsmsalert</span>”.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216607"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Start/Stop</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can start/stop the WebRTC-SIP gateway service from:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>the “Control” menu in MRTCAdmin</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>or by the Windows Service manager locate the “mserver” entry, right click and select “Start” or ”Stop” </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%'>Note: the first start might take a bit longer (around one minute), otherwise the start-up time should be below 10 seconds.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%'> </span></i></p> <h3 style='margin-top:0in'><a name="_Toc514216608"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Backup/Restore</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>A backup for MRTC can be done with simple file copy (xcopy) and just copy back the files for restore.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can back-up all your data and settings by just copying the mserver.sdf file from the app folder</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Alternatively, you might choose to copy the entire app directory, excluding logs (however these files can be easily recreated by a reinstall, so you really need only the mserver.sdf).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>By default the Gateway will automatically create nightly backups and auto-delete old backups (Search for “backup” in the global configuration if you wish to change this). <br> More details </span><a href="start.htm#_Backup/restore"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h1 style='margin-top:0in'><a name="_Toc514216609"></a><a name="_Additional_Settings"></a><span style='font-size:16.0pt;line-height:115%; font-family:"Calibri",sans-serif'>Additional Settings</span><span style='font-size:16.0pt;line-height:115%;font-family:"Calibri",sans-serif'> </span></h1> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The below discussed settings have to be changed only if you have some special requirements, otherwise the default settings are optimal values for a successful WebRTC-SIP protocol conversion.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Through this guide we often refer to various configuration keys also called as “global configuration” or “global config”. All these can be managed from the “Configuration” form (below the “Other” node in the tree-view).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216610"></a><a name="_Toc478373685"></a><a name="_Toc478281594"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Settings</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The gateway has a long list of configurable settings which you might adjust to turn on/off features or to adjust the WebRTC-SIP proxy behavior after your needs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The settings can be categorized in the following way:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>global configuration (editable from the “Configuration Wizard” and from the “Configuration” form)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>per user configuration (editable from “Users and devices”)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>other configurations (editable form various forms such as “Routing”, “Rules” and others)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216611"></a><a name="_Toc478373686"></a><a name="_Toc478281595"></a><a name="_Global_Configuration"></a><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Global Configuration</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can quickly change any global configuration from the “Configuration” form (below the “Other” node from the main tree-view). Just search for your keyword to find the related setting(s).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Most of the changes can be applied instantly (click on the “Apply Now” button), however some changes (such as local/bind ip/port reconfiguration) require a restart.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Some settings groups can be accessed by right clicking on the “Configuration” form. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>SBC related options can be listed by right click on the “Configuration” node and select the “Gateway” from the popup. Important gateway related settings are the following:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>autocreatereguser:</span><span style='font-size:14.0pt;line-height:115%'> 0=no,1=when fwd authenticated ok register, 2=always (when we receive the register)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>fwdregistrations:</span><span style='font-size:14.0pt;line-height:115%'> 0=no,1=only from alternate port, 2=always</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>fwdregistrations_address</span><span style='font-size:14.0pt;line-height:115%'>/<span style='color:#984806'>fwdregistrations_domain</span>/<span style='color:#984806'>fwdregistrations_ip</span>/<span style='color:#984806'>fwdregistrations_port</span>: the address of your SIP server (the upper server)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>forwardauthentifications:</span><span style='font-size:14.0pt;line-height:115%'> 0=no (default),1=yes,2=yes with username as callername, 3=yes with phonenumber as callername, 4=yes with username as authname too, 5=yes with phonenumber as authname too, 6=replace authorization with username but leave the A number intact, 7=replace authorization with sipphonenumber</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>forwardauthpassword</span><span style='font-size:14.0pt;line-height:115%'>: 0=fwd from ep, 1=means 2 if from webrtc for recent users, 2=answer from local always,3=answer from local also for register, 4=answer from remapped upperusername/upperpassword</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>fs_restrictsiptolocal</span><span style='font-size:14.0pt;line-height:115%'>: calls from SIP will be allowed only to webrtc. 0=no,1=yes if mizu gateway (def),2=yes if gw, 3=yes always (2 and 3 should not be used)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>fs_checkdomainmismatch</span><span style='font-size:14.0pt;line-height:115%'>: useful if you have multiple servers with different users and wish to avoid mismatch routing. 0=no,1=yes (def if fs_ismzgateway > 1),2=always</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>More WebRTC related options are listed </span><a href="start.htm#_Advanced_settings"><span style='font-size:14.0pt; line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height: 115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216612"></a><a name="_Toc478373687"></a><a name="_Toc478281596"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Clean Install</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>By default when you reinstall the MRTC service, it will keep your old settings and data, thus you can easily upgrade to new versions.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you wish to begin with a clean state, delete (backup first!) the old <span style='color:#984806'>mserver.sdf</span> file before launching the installer, thus you will have a clean state with all your previous settings and data erased.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216613"></a><a name="_Toc478373688"></a><a name="_Toc478281597"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Domain name</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Certain browsers require HTTPS for WebRTC to work (both for your website and for Websocket/DTLS) and to be able to setup a valid SSL certificate for your WebRTC-SIP proxy, first you need to assign a domain name to its IP address.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The domain name is also useful if later you wish to change your Gateway IP address or location (in this case you will just need to redirect the domain to the new IP and everything will continue to work as previously).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you don’t already have a domain, you can purchase it easily from any domain registrar company such as </span><a href="https://godaddy.com/"><span style='font-size:14.0pt;line-height:115%'>GoDaddy</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you already have a domain (for example created for your website), then you can easily add a sub-domain as most domain registrars provides an online user interface where you can add sub-domains for free.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>A sub-domain is perfectly fine for the WebRTC-SIP gateway, for example rtc.yourdomain.com. The sub-domain must have an A record set to your Gateway IP (ipv4 address).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Also the WebRTC gateway can provide you a free domain name with a single mouse click: on the Configuration Wizard click on the “get” link near the domain name to obtain it (provided by Mizutech auto-dns service). Please note that it might take some time until the domain will be assigned for your server (sometimes instantly, but sometimes it might take 2 or more hours). However, in production it is a good idea to assign your own domain name (which is owned and controlled by you). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can use the <span style='color:#984806'>nslookup</span> or the <span style='color:#984806'>ping</span> tools from your command line to see if the domain assignment is correct.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%;color:#984806'>For example:</span></p> <p class="MsoNormal" style='margin-top:0in;margin-right:0in;margin-bottom:0in; margin-left:.5in;margin-bottom:.0001pt'><span style='font-size:12.0pt; line-height:115%;color:#984806'>nslookup rtc.yourdomain.com</span></p> <p class="MsoNormal" style='margin-top:0in;margin-right:0in;margin-bottom:0in; margin-left:.5in;margin-bottom:.0001pt'><span style='font-size:12.0pt; line-height:115%;color:#984806'>ping rtc.yourdomain.com</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>See if the response lists your MRTC Gateway IP. If you have recently assigned the domain, then you might have to wait a few hours for the dns cache propagation. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Your OS might also cache (incorrect/old) dns record. Use the <span style='color:#984806'>ipconfig /flushdns</span> to clear the cache and recheck again with one of the above commands (<span style='color:#984806'>ping</span> or <span style='color:#984806'>nslookup</span>).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216614"></a><a name="_Toc478373689"></a><a name="_Toc478281598"></a><a name="_SSL_certificate"></a><span style='font-size: 14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>SSL certificate</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you are using a web based WebRTC client (not a native library) then most probably you will need an SSL certificate. This is because modern browsers will allow WebRTC only if you are using secure websocket (WSS). Self-signed SSL certificates will silently fail, so you will need a valid certificate. Also your webpage from where you launch your WebRTC client need to be hosted on HTTPS (or test from local file).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>“SSL certificate” is a commonly used term but in fact it really means signed RSA keypairs used for TLS encryption.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The Mizu WebRTC gateway can acquire and maintain a <b>free Let’s Encrypt certificate automatically</b> which is just perfect for WebRTC.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To enable this, make sure to select the “Auto get SSL/TLS certificate” checkbox on the “Network” page of the Configuration Wizard (or set the “<span style='color:#984806'>autotlscert</span>” global config to 1).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The following are the prerequisites for the auto-ssl to work:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>the gateway must have internet access </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>you must have a valid domain name assigned to your gateway IP (discussed in the previous point)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>ports 80 and 443 must be available for the Gateway (not used by other apps such as a Web server)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>if the gateway is behind NAT, make sure to forward ports 80 and 443 correctly</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'>Note: starting from MRTC v.2.4 (2018 Apr.) there is no need to forward ports 80 and 443 anymore if you acquired a webvoipphone.com subdomain since the new version is capable to utilize already prepared wildcard certificate for this domain.</span></i></p> <p class="MsoListParagraph" style='margin-top:0in;margin-right:0in;margin-bottom: 0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt; line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you prefer, you can also use <b>your own SSL certificate </b>if you already have one and it is assigned for the (sub)domain which you have set for the Gateway. For this you just have to copy the following files in the gateway directory (by default at C:\Program Files (x86)\MRTC\ or accessible from MRTCAdmin -> File menu -> Folders -> Server App directory):</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>key.pem</span><span style='font-size:14.0pt;line-height:115%'>: the key file (your private key which you have got when generated the CSR - keyfile.key)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>cert.pem</span><span style='font-size:14.0pt;line-height:115%'>: the certificate file (your certificate as received from the CA –yourdomaincertificate.crt)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>root.pem:</span><span style='font-size:14.0pt;line-height:115%'> the chain: CA intermediary + root certificate. intermediate.crt + root.crt. The root.pem is not so important and eventually might not be used at all in some circumstances or it can be loaded from the OS trust chain.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if your certificate has a password, you can configure it with the <span style='color:#984806'>sslcertpwd</span> global config (this usually applies for PKCS certificates: pfx or p12 files). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if your certificate is another format (such as p12), you can easily convert to pem with </span><a href="https://www.sslshopper.com/ssl-converter.html"><span style='font-size: 14.0pt;line-height:115%'>this tool</span></a><span style='font-size:14.0pt; line-height:115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>New versions (since July 2020) are capable to automatically use cert.crt, ca_bundle.crt or certificate.crt or convert from cert.p12, cert.pfx, certificate.p12, certificate.pfx.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if you are not familiar with obtaining TLS certificates and can’t use the built-in Let’s Encrypt, them the </span><a href="https://www.sslforfree.com/"><span style='font-size:14.0pt;line-height: 115%'>sslforfee</span></a><span style='font-size:14.0pt;line-height:115%'> website offers a free and easy way to create certificates.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can use the Gateway also <b>without an SSL</b> certificate. In this case use unsecure websocket (ws:\\IP:port) from any native WebRTC client or some browsers which doesn’t require secure websocket (It will not work from modern browsers).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><u><span style='font-size:14.0pt;line-height:115%'>SSL certificate on local LAN:</span></u></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Since it is impossible to acquire a valid certificate for a local domain assigned to a private IP address, you can do the following workaround in case if you wish to run MRTC on a private network:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>1. Create a (sub)domain and assign it to any existing web server IP and request a certificate for it (since you can easily request TLS certificates only for public webservers)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>2. Copy the certificate files to the MRTC app directory (.pem files as described above)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>3. Redirect the above (sub)domain to your gateway private IP address (just rewrite it’s A record settings)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can verify if your networking/domain/port-forward/TLS is working correctly by opening this link in your browser: </span><a href="https://domainname/tlsproxytestxxxxxx"><span style='font-size:14.0pt; line-height:115%'>https://DOMAINNAME/tlsproxytestxxxxxx</span></a></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:#984806'>Note: starting from MRTC v.2.4 (2018 Apr.) you can just get a webvoipphone.com subdomain for your private IP since the new version is capable to utilize already prepared wildcard certificate for this domain.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216615"></a><a name="_Toc478373690"></a><a name="_Toc478281599"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Change IP</span></a><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'> address</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you migrate the WebRTC-SIP Gateway to another box or your IP changed, then you will need to set the new IP.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>There are 2 ways to easily change the Gateway IP:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>going through the Configuration Wizard and make changes on the “Network” page</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>or right click on the “Configuration” node in the main tree-view (below the “Other” node), select “Network -Basic”, search for the old IP and rewrite to the new one (localip, bindip, domain, etc)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Restart your gateway once you changed the IP because this can’t be applied at runtime.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Note: the gateway is also capable to auto-detect it’s IP address configuration if you don’t explicitly set it’s bindip and localip.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216616"></a><a name="_Toc478373691"></a><a name="_Toc478281600"></a><a name="_Ports"></a><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Ports</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Since VoIP servers are using a wide range of ports, it is recommended to host it on a public server (with a public IP), unless you plan to use it only from an internal network. In addition, it is recommended to turn off any external or third party port based firewall (you can still use the Windows built-in firewall where it is easy to set exceptions for applications and not for ports).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>This section is important if you are hosting the WebRTC-SIP proxy behind a NAT or </span><a href="start.htm#_Firewall"><span style='font-size:14.0pt;line-height:115%'>firewall</span></a><span style='font-size:14.0pt;line-height:115%'> for some reason and the gateway is used from the external network (such as the public internet).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The MRTC listen on several ports to offer its services: SIP signaling, Websocket, RTP/SRTP ports range, RTCP/SRTPC port range, TURN, STUN and others.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>It is recommended to keep the default ports since the defaults are optimized for maximum connectivity and/or are conform to standards.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For example it is highly recommended to keep the default TCP port 80 for Websocket, TURN and API and use TCP 443 for the secure version of these. A lot of corporate networks allows traffic only on port 80 and 443 and if your gateway is using other ports the clients from behind more restrictive NAT’s and firewalls will not be able to connect with their WebRTC client. If you are behind NAT, it is recommended to set one-to-one port mapping (internal listening ports mapped to the same external ports on your NAT device).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If these ports are already used by some software running on the same host, then we recommend to assign a secondary IP for your server and bind the gateway to this new IP (set the bindip), then reconfigure the other software’s to use only the old IP (bind to the old IP). For example IIS can be bound to an IP with the following command: </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>netsh http add iplisten ipaddress=IPADDRESS</span><span style='font-size:14.0pt;line-height:115%'> (replace IPADDRESS with the IP to bind)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you are hosting the WebRTC-SIP Gateway on the same box where your softswitch is running, then assign a separate IP (bindip) to the Gateway if possible. If this is not possible, then make sure to change the ports on the gateway to avoid conflicts (if your SIP server is listening on 5060 on the same host, then set a different “<span style='color:#984806'>localport</span>” for the Gateway).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The exact port numbers used by the SBC service can be listed from MManage -> Config menu -> Network - > Active Ports.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Here is the default <b>list of ports</b> used by the gateway and their global config options which you can change from the “Configuration” form if needed.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Mandatory ports:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>localport UDP and TCP (main SIP signaling port. Default is 5060)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>mainaport UDP and TCP (main server port for various purposes websocket, TURN, API and others. Default is 80.)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>mainaportudp UDP (used for STUN, UDP RTP relay and others. default to 8090)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>sslportmain and cfg_sslport TCP (443 by default for SSL, HTTPS, WSS)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>MinRTP-MaxRTP range UDP (for RTP and RTCP; you might enable also TCP for TCP ICE candidates)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>fs_minrtp- fs_maxrtp range UDP (SRTP and SRTCP for WebRTC and RTP for extra PBX)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>tcpcandidatesrvport (TCP relay port, 10080 by default)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Optional ports (good to allow also these):</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>remote desktop TCP 3389 or 3386 (for easy server administration)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>TCP 1433 and/or 2223 (for remote management)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>adminport TCP (for remote CLI access from MManage server console. Default is 9885)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>monitorport TCP (to easy access logs from remote MManage. Default is 9889)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>forwarderport (TCP forwarder for various internal services, 11080 by default)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>localport+1 TCP (for secure SIP sips. Default is 5061 -if you enable TLS for SIP which is known as SIPS)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>ftpserverport TCP (for remote file access. Default is 9710)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>UDP: 44444 (“voice-here” functionality in MManage)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>TCP: 9886, 9889 (optional ports for admin console and logs)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Make sure to enable these ports if you are using a port based firewall.<br> Make sure that the ports used by the gateway are not used also by some other application such as a local web server (in this case either change the MRTC ports or the third party app port or bind them to separate IP address).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>In short, you should enable/forward the following ports on your firewall/NAT:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>UDP: 80, 5060, 8080, 8090, rtp port range defined by MinRTP-MaxRTP and fs_minrtp- fs_maxrtp</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>TCP: 80, 443, 2223, 3386, 5060, 5061, 9710, 9885-9890, 10080, 11080, 44444</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><i><span style='font-size:12.0pt'>The above mentioned RTP port range should be 4x the number of simultaneous calls. For example UDP ports 30000 – 40000 will enable 2500 simultaneous calls.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The port forwarding can be quickly tested from MManage -> Config menu -> Utilities -> Tests -> Check port access.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Firewall"></a><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Firewall</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you are using a firewall, the MRTC application and/or ports must be configured to be enabled.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><i><span style='font-size:12.0pt'>Usually most firewalls allows outbound traffic by default, thus you will have to configure only to enable also inbound connections.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><i><span style='font-size:12.0pt'>Since VoIP servers usually requires a bunch of open ports (usually 4 ports per call: inbound/outbound (S)RTP + (S)RTCP) an application level firewall is more suitable then a port based firewall. </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><i><span style='font-size:12.0pt'>Otherwise MRTC itself doesn’t require any firewall. Firewall is useful only to filter other unnecessary services to make your OS more secure as MRTC has its own </span></i><a href="start.htm#_Security"><i><span style='font-size:12.0pt'>built-in strong security</span></i></a><i><span style='font-size:12.0pt'> filters, including built-in dynamic firewall to filter out unwanted traffic such as DoS attacks.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Firewall configuration:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If you are using a <b>port based firewall</b>, make sure that all the required ports are enabled.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'>You will need to enable the following ports:</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>UDP: 80, 5060, 8080, 8090, rtp port range defined by MinRTP-MaxRTP and fs_minrtp- fs_maxrtp (values from the MRTC Admin -> Configurations form)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>TCP: 80, 443, 2223, 3386, 5060, 5061, 9710, 9885-9890, 10080, 11080,</span> <span style='font-size:14.0pt'>18080,</span> <span style='font-size:14.0pt'>12080, 44444</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'><br> For more details, see the </span><a href="start.htm#_Ports"><span style='font-size:14.0pt'>ports</span></a><span style='font-size:14.0pt'> chapter above.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>In case if you SIP server is inside your network and you need to allow only the WebRTC clients on your firewall or NAT, then it is enough to allow and forward the following ports (these are the default ports if you haven't reconfigured them):</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>TCP: 80, 443, 10080, 11080</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>UDP: 80, 8080, 8090</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>UDP: rtp port range defined by MinRTP-MaxRTP and fs_minrtp- fs_maxrtp (values from the MRTC Admin -> Configurations form. You can reconfigure them to be in the same range and the port ranges should cover 4x the maximum number of simultaneous calls for in/out RTP+RTCP)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>The exact port numbers used by your MRTC service can be listed from MManage -> Config menu -> Network - > Active Ports.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If you are using an <b>application level firewall</b> (for example Windows Defender), make sure that the following executables are enabled (from the MRTC application folder):</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>mserver.exe (the main service executable running the SIP, WebRTC and media stack)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>MizuManage.exe (admin client)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>lego.exe (used to acquire Let’s Encrypt TLS certificate)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>MServiceHost.exe (supervisor)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>\tsmodules\fs\FS_mserver.exe (PBX features and WebRTC processing in some circumstances)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>mserverftp.exe (used to access recorded files)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>MRTC can try to auto enable the above executables on the Windows firewall during install and first start, however if you are using some other firewall or if MRTC doesn’t have enough permission to change your firewall settings, then you might need to add the above executables manually to your firewall exception list.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%'>We recommend to turn off any external or third party port based firewall (you can still use the Windows built-in firewall where it is easy to set exceptions for applications and not for ports).</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216617"></a><a name="_Toc478373692"></a><a name="_Toc478281601"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Gateway behind NAT</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The WebRTC-SIP gateway can be used also behind NAT (located behind NAT or router, even without internet access).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>Note: this section is not about WebRTC clients connecting from behind NAT. That is a normal use case and the gateway will handle those very well by default, without any special attention needed. This chapter is when you install the Gateway on a local LAN with SIP and WebRTC clients on the same NAT or connecting from the internet.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If your gateway is behind a NAT or Router, make sure to forward the </span><a href="start.htm#_Ports"><span style='font-size:14.0pt;line-height:115%'>ports</span></a><span style='font-size:14.0pt;line-height:115%'> above correctly if you need connectivity also from external network <i>(WebRTC clients or SIP server on the internet. If both of these are behind NAT, then there is no need to enable these ports except ports 80 and 443 if you need auto-generated SSL certificate).</i> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In this case make sure to set the “<b>Offer services for</b>” option correctly on the “Network” page of the Configuration Wizard. </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Both LAN and internet: select this if WebRTC clients might connect also from the public internet (make sure to set proper port forward on your router in this case)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>LAN: means all WebRTC clients will connect from local LAN, but the SIP traffic might be sent to the public internet (your SIP server is outside)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Force LAN Only: means that all peers (including your SIP server and all clients) are located on the local LAN</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If your gateway is behind NAT and no access to the internet or you don’t forward ports 80 and 443 to it, then you will not be able to use its auto-ssl capability and no valid SSL certificate will be assigned. In this case you will not be able to use WebRTC from modern browsers, however old browsers or native WebRTC client apps might work just over unencrypted websocket. (use ws:\\gatewayIP). This is except if you use a webvoiphone.com subdomain since for this domain there is already prepared wildcard certificate for your convenience.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In other words, here are the <b>possible uses-cases</b>:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><u><span style='font-size:14.0pt;line-height:115%'>Gateway on the public internet:</span></u></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can just skip this chapter as you don’t need to take care about NAT in this case. (WebRTC clients connecting from behind NAT are handled automatically)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Set the “Offer services” option to “Internet only” if your SIP server is also located on the public internet or “Both LAN and Internet” of your SIP server or other SIP device is located on the same box or network.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Your “Public IP” and “Bind IP” can be the same public address in this case.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><u><span style='font-size:14.0pt;line-height:115%'>Gateway, SIP server and WebRTC clients all on local LAN: </span></u></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In this case you don’t need to set any port forwarding in this case as all peers will be reachable directly. The only thing to pay attention to is the SSL certificate, since an SSL certificate can be only installed if you have a valid domain assigned to your gateway IP. To be able to use the auto-ssl functionality, you also need to forward 80 and 443 TCP ports except if you use a webvoiphone.com subdomain since for this domain there is already prepared wildcard certificate for your convenience. </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The Gateway can be used also without any certificate via unsecure websocket from browsers which doesn’t require wss or from native WebRTC clients.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Set the “Offer services” option to “Force LAN only” in this case.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Your “Public IP” and “Bind IP” can be the same private address in this case.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><u><span style='font-size:14.0pt;line-height:115%'>Gateway and WebRTC clients behind NAT, SIP server on the internet:</span></u></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If the SIP server or SIP service has good NAT handling capability, then everything should work just fine by default. Otherwise setup proper port forwarding on your NAT/router for the above mentioned ports.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Set the “Offer services” option to “LAN” in this case.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><u><span style='font-size:14.0pt;line-height:115%'>Gateway behind NAT, WebRTC clients on the public internet:</span></u></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Set the “Offer services” option to “Both LAN and Internet” in this case and setup proper port forwarding on your NAT/router for the above mentioned ports.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Also set the “Public IP” to your network </span><a href="http://whatismyipaddress.com/"><span style='font-size: 14.0pt;line-height:115%'>external IP</span></a><span style='font-size:14.0pt; line-height:115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%'>If the gateway is behind NAT then the auto Let’s Encrypt certificate will work only if ports 80 and 443 are forwarded on your NAT/router. This is due to Let’s Encrypt policy, other ports can’t be used for this purpose. </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>Don’t run your WebRTC or SIP client from the same PC where MRTC is running. Most software has various bugs if uses the same local IP as the gateway IP!</span></i></p> <p class="MsoListParagraph" style='margin-top:0in;margin-right:0in;margin-bottom: 0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt; line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216618"></a><a name="_Multiple_SIP_servers"></a><span style='font-size:14.0pt;line-height: 115%;font-family:"Calibri",sans-serif'>Multiple SIP servers</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can use one MRTC gateway for multiple SIP servers (if you have more servers) for both outbound and inbound traffic.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Registrar routing:</span></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>By default all registrations will be routed to the default upper SIP server (what you have set during the configuration wizard or from global configuration search for “<span style='color:#984806'>fwdregistrations_</span><span style='color:black'>”</span>).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you have multiple upper SIP servers and the WebRTC clients need to register to different servers, make sure to set the <span style='color:#984806'>routingforregister</span> global config option to <span style='color:#984806'>1</span> (from the “Configuration” form).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Then the registrations will be routed after the routing rules which can be defined on the “Routing” form. The only exception is the called number since there is no called party in a registration (this is applicable only for calls).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>However, if your SIP servers are for completely different domains/businesses, then you should consider to set-up a separate WebRTC-SIP gateway for each of them.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'>Note: The “routingforregister“ is only for registrations. Call and chat routing are always performed after your “Routing” settings</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%;color:#984806'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Call routing:</span></b></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Outbound calls are always routed based on </span><a href="start.htm#_Outbound_Routing"><span style='font-size:14.0pt'>routing rules</span></a><span style='font-size:14.0pt'> which you define on the “Routing” form.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'>Routing rules can be set for SIP servers (so you must create “SIP server” user(s) before to be able to work with routing.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>To be able to accept </span><a href="start.htm#_Inbound_Routing"><span style='font-size:14.0pt'>inbound calls</span></a><span style='font-size:14.0pt'> (from your SIP server to WebRTC) you will need to create “Traffic Sender” user (usually with IP authentication with the Auth IP set to your SIP server address). </span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Calls between users (such as WebRTC to WebRTC) are handled automatically.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'>You might also set the following global config options:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;color:#984806'>routingforregister: 1</span><span style='font-size:14.0pt'> (to use Routing also for register requests)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;color:#984806'>upperserverlookup: 2</span><span style='font-size:14.0pt'> (lookup upper server from tb_users sipservers. -1: guess (not for mizuonly servers), 0: no, 1: if no upper server was set in global config, 2: always)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>More details about SIP servers can be found </span><a href="start.htm#_Add_SIP_Server"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216619"></a><a name="_Toc478373694"></a><a name="_Toc478281603"></a><a name="_Calls_between_endusers/extensions"></a><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Calls between endusers/extensions</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Calls between endusers can be routed directly, without the need to route them via your upper SIP server(s), thus saving your server resources (CPU/memory).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>These are usually calls between WebRTC clients (WebRTC to WebRTC), but they can be also WebRTC to SIP or SIP to WebRTC or SIP to SIP calls (if you register also SIP devices on the gateway).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>This direct routing is enabled by default and it can be easily changed by the following global config values (from the “Configurations” form):</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:#984806'>alloweuserusercalls</span><span style='font-size:14.0pt'>: 0=no (don't check if local target),1=yes,2=disable (drop) call to endusers</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt;color:#984806'>fs_directroutrfstofs</span><span style='font-size:14.0pt'>: -1=auto,0=no,1=via mizu server,2=within webrtc stack (route call between webrtc and webrtc within the webrtc stack), 3=quick websocket only,4=auto</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>To enable direct routing, set the <span style='color:#984806'>alloweuserusercalls</span> to 1 and <span style='color:#984806'>fs_directroutrfstofs</span> to 3.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>To disable direct routing, set the <span style='color:#984806'>alloweuserusercalls</span> to 0 and <span style='color:#984806'>fs_directroutrfstofs</span> to 0.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you disable direct routing, all calls will be routed via your SIP server(s). If the called endpoint is registered via the MRTC gateway, then the SIP server might route the call back to the gateway, so the call flow might look like this: Caller WebRTC endpoint -> MRTC gateway -> SIP server -> MRTC gateway -> Called WebRTC endpoint</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216620"></a><a name="_Toc478373695"><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Multiple registrations and call fork</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>One user can be registered from multiple locations at the same time and calls can be routed to all of its devices.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Use the following global configurations to modify this behavior:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>fs_multireg</span><span style='font-size:14.0pt;line-height:115%'>: -1: default, 0: no, 1: yes (enabled/disable multiple contact address)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>allowforkforsignaling</span><span style='font-size:14.0pt;line-height:115%'>: 0: no,1: partial,2: yes,3: yes and remember old addresses (send sip request to multiple recipients at once)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216621"></a><a name="_Toc478373696"></a><a name="_Toc478281604"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Connecting with SIP clients</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can also connect SIP clients via the WebRTC-SIP proxy, although these are usually connected directly to your SIP server since there is no need for protocol conversion</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Register with two softphones and call from the first account to the second account.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Softphone configuration:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>domain: your gateway IP or domain name (and the SIP port if your changed it from the standard 5060 UDP port)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>proxy: you can leave it empty</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>username / password: loaded from your SIP server (or from the Gateway if you created a special user with username/password authentication)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; line-height:normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Check “Client configuration” from the “Help” menu for the exact details.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>No other special settings are required (such as NAT, STUN, etc).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>The network setting should be automatically handled by the server. If you don’t hear any voice you might change the RTP routing for the user(s) to “always route RTP” from MizuManage -> Users and devices -> Edit tab.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216622"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>VoIP Push notifications</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><a href="https://www.mizu-voip.com/Solutions/PushNotifications.aspx"><span style='font-size:14.0pt'>VoIP Push notifications</span></a><span style='font-size:14.0pt'> are useful to notify sleeping or closed mobile and web SIP clients on incoming call (wake-up and handle the incoming call) and instant messages (message display).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Both the Apple PushKit and the Google FCM are supported.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Set the following global config options (MRTCAdmin -> Configurations form) to enable push notifications in your server or gateway:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>pushnotification: 2</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:normal'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>pushnotification_chat: 2</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>If you are using the Mizu webphone or softphones, push notifications are supported by default. If you are using a third party SIP client or develop your own, then you need to add client support for it in your app to make it working. The process is described </span><a href="https://www.mizu-voip.com/Portals/0/Files/VOIP_Push_notifications.pdf"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216623"></a><a name="_Toc478373697"><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Webserver configuration</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if you are using a web based WebRTC client, you will have to host it on your Web server such as IIS or Apache.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>However the WebRTC functionality has nothing to do with your Web server. Your Web server will be used only to serve your web content (including the html/css/JS needed for your WebRTC client), however once launched in a browser, WebRTC clients will connect directly to the WebRTC gateway (first with websocket, then also via ICE/DTLS/SRTP while in call).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Thus the WebRTC and <b>the WebRTC gateway have nothing to do with your Web server</b>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216624"></a><a name="_Toc478373698"></a><a name="_Toc478281605"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>STUN</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The WebRTC-SIP proxy has a built-in stun server <b>enabled by default</b>, usually listing on port 8080.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The stun server is listening on a port calculated at startup in the following way:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>-mainaportudp if that is set</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>-mainaport if that is set and if not 80</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>-otherwise on port 8090</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can easily get the STUN configuration required for your WebRTC clients from Help menu -> “Client configuration”.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The built-in stun service can be disabled by setting the<span style='color:#984806'> quickstun</span> to 0 and the <span style='color:#984806'>stunserver_ru</span>n to 0, however this is not recommended.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can also configure your WebRTC clients to use another STUN service, however this doesn’t make much sense as the built-in STUN in the MRTC Gateway is just perfect for WebRTC.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216625"></a><a name="_Toc478373699"></a><a name="_Toc478281606"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>TURN</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The Mizu WebRTC gateway has a built-in TURN service <b>enabled by default</b>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The TURN service is listening on the same port which you have set for websocket and API.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can configure this port from the Configuration Wizard -> Network page -> Access port</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>or by just changing the “<span style='color:#984806'>mainaport</span>” value in the global configuration (“Configuration” form).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To change any turn related configuration, search for “<span style='color:#984806'>turn</span>” on the “Configuration” form. However, these should be rarely required because the default settings are just fine for all networks.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The Gateway also handles the TURN authentication automatically, allowing only the WebRTC clients which are successfully connected via your Gateway.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can easily get the TURN related configuration required for your WebRTC clients from Help menu -> “Client configuration”.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can also configure your WebRTC clients to use another TURN service, however this doesn’t make much sense as the built-in TURN in the MRTC Gateway is just perfect for WebRTC.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216626"></a><a name="_Toc478373700"></a><a name="_Toc478281608"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Codec</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The gateway has support for all the commonly used audio and video codecs:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>G.711, OPUS, G.729, G.723, GSM, iLBC, Speex, G.722, VP8, H.264</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The codec is negotiated automatically for each call depending on WebRTC client and your SIP server capabilities and other circumstances such as the available bandwidth.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The codec used for calls can be also influenced by the “<span style='color:#984806'>choosecodecs</span>” user configuration (which can be also set on the “Users and devices” form -> Functions page -> Allowed codec setting).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The codec to be available for the WebRTC endpoints can be set with the “fs_codec” option whose default value is PCMU,PCMA,OPUS,GSM,G722,VP8,H264. Usually there is no need to change this since a browser WebRTC client has support only for PCMU, PCMA and OPUS audio and VP8 or H264 video.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216627"></a><a name="_Toc478373701"></a><a name="_Toc478281609"></a><a name="_Transcoding"></a><span style='font-size: 14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Transcoding</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>By default, the gateway will try to avoid transcoding when possible by negotiating a common codec between caller and called parties. If necessary, it will convert automatically from typical WebRTC codecs (OPUS and G.711) to typical telecom codecs (G.729, GSM and others). Change the following only if really needed.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If one of your peers has limited codec capabilities or the accepted codec(s) doesn’t match with the sender codecs, then set its “<span style='color:#984806'>needcodecconversion</span>” to 1 (for the target user which is usually a SIP Server user or Enduser). This can be also controlled on the "Functions" page of the "Users and devices" form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Change the “<span style='color:#984806'>convertcodecs</span>” global config value to the target codec payload list. The default value is 0,8,18 which means PCMU,PCMA and G.729.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To force always codec transcoding you can set the “fs_transcode” option to 2 (And set to 0 to avoid transcoding whenever possible).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The server is able to transcode between the following codecs: G.711 A-law , G.711 A-law ,G.729, G.723.1, GSM, OPUS, Speex 2,3,4,5,6 (narrowband, wideband and ultrawideband), G.726 and G.722. You might also have to set the “<span style='color:#984806'>choosecodecs</span>” field for the target user (same as the “convertcodecs” global config value) and the “convertcodecsforced” global config option to true.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Be aware that codec transcoding requires a high amount of CPU usage. For example one CPU (core) can handle around maximum 30-70 simultaneous transcodings between PCMU and G729 on full load.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216628"></a><a name="_Toc478373702"></a><a name="_Toc478281610"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>How to avoid transcoding?</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Codec transcoding should be avoided whenever possible because it will increase the CPU usage and also will degrade the quality a bit. By default the MRTC gateway will try to negotiate a common codec between the endpoints and transcode only when strictly necessary.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The good news is that all common WebRTC clients (including browser WebRTC stacks) and SIP servers have G.711 (PCMU and PCMA) capabilities. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To avoid codec transcoding, make sure to enable PCMU and/or PCMA on your SIP server.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If your SIP server has support for OPUS, then enable this also as its wideband variant has much better quality then G.711.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216629"></a><a name="_Toc478373703"></a><a name="_Toc478281611"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Optimal codec settings</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The MRTC WebRTC-SIP gateway is fine-tuned by default for best call quality.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>This means that when possible, it will use a wideband codec (usually OPUS as this is commonly supported by WebRTC and it has a very good quality, much better than PSTN). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>However, OPUS doesn’t make sense if the call has to be routed to PSTN, because PSTN usually supports only narrowband codecs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Usually WebRTC to WebRTC calls are done with OPUS.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If your SIP server has support for OPUS, then calls to SIP will also use this codec.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If a common wideband codec can’t be found, then it will use a narrowband codec (usually G.711 since this is supported by both SIP and WebRTC without the need for any transcoding).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If no common codec is found then it will transcode.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To achieve the best possible call quality, do the following:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Enable OPUS on your SIP server if it has support for this codec, especially if there are calls between users/extensions such as WebRTC to SIP or SIP to WebRTC calls. If all calls will go to landline or mobile (PSTN or a VoIP carrier, then OPUS is unnecessary, but it doesn’t hurt if it is enabled for occasional calls between users within your network)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>It is highly recommended to always enable G.711 (PCMU and/or PCMA). Actually this is enabled by default in every software, so just make sure to don’t disable it. Make sure that your carrier (if any) also has support for G.711, so the calls can pass end to end without the need for transcoding (most carriers allows G.711)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If, for some reason you must send out a call (or receive calls) with other codecs (such as G.729) the MRTC Gateway will do the transcoding automatically, but this will have a cost in the performance and might degrade the call quality a bit. You can also force/disable or change the </span><a href="start.htm#_Transcoding"><span style='font-size:14.0pt;line-height:115%'>transcoding settings</span></a><span style='font-size:14.0pt;line-height:115%'> after your needs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216630"></a><a name="_Slow_call_setup"></a><span style='font-size:14.0pt;line-height:115%; font-family:"Calibri",sans-serif'>Slow call setup</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>With some WebRTC clients you might experience a considerable delay at call connect (call connecting/setup/in progress). This delay is usually caused by poorly written or configured WebRTC clients and it has nothing to do with the MRTC gateway. To solve the problem, check your WebRTC client configuration and set a timeout for ICE/TURN/TURN (or lover the existing timeout value). Contact the developers if it doesn’t have such configuration.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Around 4 second timeout should be enough in all circumstances (media candidates not collected within 4 seconds are likely to be invalid anyway).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216631"></a><a name="_Toc478373704"></a><a name="_Toc478281613"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Call recording</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:12.0pt;line-height:115%'>The MRTC gateway has full call recording support which can be enabled/disabled per user or system wide (both can be done by just toggling a checkbox on the admin user interface). Then you can easily manipulate the recorded files (search, convert to mp3, export, access in the file system, access via API, etc).</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can set the system-wide call recording from Config menu -> Configurations -> Recording -> Call.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The voice recording option can be set for individual users by checking the “Voice Record” checkbox on the user configuration form in the MRTCAdmin (Users and Devices -> Functions tab). The followings fields will be affected in the tb_users table:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%;color:#984806'>record</span><span style='font-size:14.0pt;line-height:115%'>: 0 means no, 1 means yes</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%;color:#984806'>voicerecupload</span><span style='font-size:14.0pt;line-height:115%'>: optionally you can specify a HTTP or FTP URL where the recorded files will be uploaded </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Conversations will be saved in the directory specified by the “<span style='color:#984806'>serverftpvoice</span>” global config option.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The exact location will be: serverftpvoice\databasename\currentday\voice.xxx</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>A separate backup can be created in the directory specified by the “<span style='color:#984806'>voicebackupdir</span>” global config option.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Old files can be deleted by setting the “<span style='color:#984806'>keeprecorded</span>” option accordingly (days to keep).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Recorded files are compressed and encrypted by default. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>From the MRTC Admin you can work with the recorded calls from the “CDR” form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Recorded conversations can be played on the "CDR" form (Select the "Recorded Conversations" radio item, select the desired record and click on the Play button) or from the “Voice Record” form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can also export the files as wav or mp3.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Users can replay the last record by the following DTMF digits: *4*</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can also use the </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_API.pdf"><span style='font-size:14.0pt;line-height:115%'>voicerecdownload API</span></a><span style='font-size:14.0pt;line-height:115%'> to download any recorded file(s).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The request should look like this:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%;color:#984806'>https://yourdomain.com/mvapireq/?apientry=voicerecdownload&callid=XYZ&maxrecords=1&authkey=SERVERKEY&authid=ADMINUSERNAME&authpwd=ADMINPASSWORD</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if your are using the Mizu webphone, then the HTTP or FTP upload URI can be also configured in the webphone itself using the webphone voicerecupload parameter or voicerecord API.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Call recording will use extra disk space, can make the routing and media path longer by disabling peer to peer routing and also will increase your server I/O and CPU usage.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'>Technical details below:<br> System-wide call recording can be set from Config menu -> Configurations -> Recording -> Call or you can use the following SQL updates:</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'>To disable recording for all users, execute the following SQL’s in the “Direct Query” form:</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>update [tb_users] set record = 0, voicerecupload=’’, RouteRTPCaller = 1, RouteRTPCalled = 1 where type in (0,5,9)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>update tb_settings set valstr = '1' where keystr = 'defroutertp'</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:gray'>ALTER TABLE [tb_users] DROP CONSTRAINT [DF_tb_users_record]</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:gray'>ALTER TABLE [tb_users] ADD CONSTRAINT [DF_tb_users_record] DEFAULT 0 FOR [record]</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'>If you wish to enable call recording for all users, execute the following SQL’s in the “Direct Query” form:</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>update [tb_users] set record = 1, RouteRTPCaller = 7, RouteRTPCalled = 7 where type in (0,5,9)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>update tb_settings set valstr = '7</span></i><i><span style='font-size:9.0pt;line-height:115%'> </span></i><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>' where keystr = 'defroutertp'</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:gray'>ALTER TABLE [tb_users] DROP CONSTRAINT [DF_tb_users_record]</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:gray'>ALTER TABLE [tb_users] ADD CONSTRAINT [DF_tb_users_record] DEFAULT 1 FOR [record]</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='line-height:115%'>To force recording for all calls (even those where the media would be routed peer-to-peer otherwise), set the following global config options (This is usually not needed because even without these settings, calls between the WebRTC clients and your SIP servers will be recorded so these settings affects only WebRTC to WebRTC calls):</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>defroutertp=7 (force RTP routing by default)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>alloweuserusercalls=0 (optional setting to disable direct calls and route all calls via the upper SIP server –usually not needed)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>fs_directroutrfstofs= 1 (disable fast path routing)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>fs_forceoffrouteforvoicrec=4 (turn off webrtc direct routing. 0=no,1=yes on low load,2=yes-auto,3=yes, 4=force for all calls)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>hasturn=0 (this will disable to TURN server as this doesn’t support call recording. TCP candidate will be still available if needed)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>disablep2prtprouting=1 (disable peer to peer media path detection)</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:9.0pt;line-height:115%;color:#984806'>Delete the following routing rules if exists: check_user, check_user_notregistered, check_user_registered.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:10.0pt;line-height:115%'>Note: MRTC versions released after 2017 November automatically detects when recording is needed between two WebRTC endpoints and disable fast direct routing automatically.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216632"></a><a name="_Toc478373705"></a><a name="_Toc478281612"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Chat recording</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The users IM history can be recorded and stored in server database, tb_messages table.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For this set the “<span style='color:#984806'>logmessenger</span>” global config option: 0=no,1=on low load,2=always</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You might also disable fast message forwarding by setting the “<span style='color:#984806'>fastmessagequeue</span>” configuration option to 0. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The recorded messages can be seen on the “Chat Logs” form MRTCAdmin.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Note: In MRTC versions released after 2018 Marc, you can easily control the chat recording from Config menu -> Configurations -> Recording -> Chat.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216633"></a><a name="_Toc478373706"></a><a name="_Toc478281607"></a><a name="_First_test_calls"></a><a name="_DTMF"></a><span style='font-size:14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>DTMF</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The WebRTC-SIP Gateway will automatically handle DTMF sent from your client and server and it is capable to also transcode them if needed.</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>By default will accept the DTMF digits as RFC 2833 or as SIP INFO methods from both your WebRTC clients and SIP servers.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>By default it will send the DTMF digits as SIP INFO methods or as received but it might be capable to failover to RFC2833 or InBand if the remote endpoint doesn’t support or understand SIP INFO</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You just need to change the fs_dtmf_type_extern global config option to change the dtmf mode.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For this, open the MRTCAdmin -> Open the “Configurations” form (below the “Other” node in the tree view) -> enter “fs_dtmf_type_extern” in the search box -> Change the value after your needs -> Restart the gateway.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can restart the gateway from MRTCAdmin Control menu or from windows services restart the mserver service.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><u><span style='font-size:14.0pt;line-height:115%'>Your SIP server -> MRTC Gateway -> WebRTC client:</span></u></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Both RFC2833 and SIP INFO are accepted from your gateway, so there is no reason to change this.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><u><span style='font-size:14.0pt;line-height:115%'>WebRTC client -> MRTC Gateway -> Your SIP server:</span></u></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To set the DTMF method to use from our gateway to your SIP server, use the following settings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For SIP INFO: set the fs_dtmf_type_extern to 1 (default)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For RFC2833: set the fs_dtmf_type_extern to 2</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In-Band dtmf is not recommended.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Other important dtmf related global config options:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>handledtmfevent: enable dtmf based features such as transfer or call. 0: no, 1: auto (default), 2: always, 3: even while ringing (set to 2 if to always force handle dtmf events)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>forwarddtmf: 0: no, 1: auto (default), 2: yes</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>convertdtmf: -2=never convert, -1: auto (default), 0=no, convert,1=inband,2=info,</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>3=rfc2833,4=inband+orig,5=info+orig,6=rfc+orig,9=suppress</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>This can be set also by user (tb_users.confertdtmf field)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>You can find all the DTMF related settings if you search for "dtmf" on the "Configurations" form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216634"></a><a name="_Toc478373709"></a><a name="_Toc478281616"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Logs</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can find the Gateway logs from Files menu -> Folders -> Server log directory. Use a fast text reader to work with the files such as F3 from Total Commander.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The logs files are managed automatically by the gateway (auto deleting old log files or if you are low on disk-space).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can change the server log level from Control menu -> Log level.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Integration"></a><span style='font-size: 14.0pt;line-height:115%;font-family:"Calibri",sans-serif'>Integration</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can integrate the service with your backend or web service using direct database access or API. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The below documentations are for the softswitch, but most can be also applied for MRTC (except the billing related sections).</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP%20Integration.pdf"><span style='font-size:14.0pt;line-height:115%'>Integration guide</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Database_Interface.pdf"><span style='font-size:14.0pt;line-height:115%'>Database access</span></a></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_API.pdf"><span style='font-size:14.0pt;line-height:115%'>API</span></a><span style='font-size: 14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For example you can use the <span style='color:#984806'>addserver</span> API to add an upper SIP server: </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>Possible parameters:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_type: 0: both, 5: only as traffic sender, 9: only as SIP server (use 0 to add upper servers)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_name: name (either the name or the username must be provided)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_username: username (either the name or the username must be provided)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_password: will be auto generated if empty</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_domain: domain name (either the domain or the ip must be provided)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_ip: IP address. it can be also IP:port (either the domain or the ip must be provided)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_port: port number if not set as part of the domain or IP (default is 5060 if not provided)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_proxy: outbound proxy (optional)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_transport: udp, tcp or tls (default is udp if not set)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_auth: the needauth db field (default is 1 which means IP based auth; check the documentation for other possibilities)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_email: optional</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_country: optional</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_currency: optional</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_credit: optional</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_routing: routing entry id or name (set to "null" if no routing entry is required; set to empty to auto-guess).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• u_routingpriority: routing priority</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>• fieldnameX / fieldvalX: optional extra fields to be set in tb_users (X can go from 0 to 99)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>Here is a very simple example: </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><a href="http://10.2.0.71/mvapireq/?apientry=addserver&authkey=11979586&authid=voip_admin&authmd5=ccb612764b35204ed0d212bb80ef931a&authsalt=7394106&u_name=SERVERNAME&u_domain=DOMAIN&now=711"><span style='font-size:12.0pt;line-height:115%'>http://10.2.0.71/mvapireq/?apientry=addserver&authkey=11979586&authid=voip_admin&authmd5=ccb612764b35204ed0d212bb80ef931a&authsalt=7394106&u_name=SERVERNAME&u_domain=DOMAIN&now=711</span></a></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The same can be done also with <span style='color:#984806'>SQL queries</span>. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In this case you just need to insert two records to tb_users (traffic sender and SIP server) and add the SIP sever to tb_routinglist.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>Add traffic sender: </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>insert into tb_users (username, name, password, needauth, type, candial, belongstocompany, domainname, authip,port,protocol,RouteRtpCaller,RouteRtpCalled,MaxLines,maxlinesoffpeak,comment) \</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> values ("'NAME', 'NAME', 'RANDOMPASSWORD',1, 5, 1, 'DOMAIN', 'IP', 5060,0,1,1,1000,1000,'ANYCOMMENT')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:12.0pt;line-height:115%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:12.0pt;line-height:115%'>the type field must be set to 5 for traffic senders</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:12.0pt;line-height:115%; font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:12.0pt;line-height:115%'>needauth must be 1 for source address based authentication</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:12.0pt;line-height:115%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:12.0pt;line-height:115%'>protocol is 0 for UDP, 1 for TCP, 2 for TLS</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>Add SIP server: </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'>insert into tb_users (username, name, password, needauth, type, domainname, ip, proxyaddress, port,protocol,RouteRtpCaller,RouteRtpCalled,MaxLines,maxlinesoffpeak,comment) \</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> values ('NAME','NAME','RANDOMPASSWORD',1, 9, 'DOMAIN','IP', 'PROXY',5060,0, 1,1,1000,1000,'COMMENT')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:12.0pt;line-height:115%'> </span></p> <p class="MsoListParagraph" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:12.0pt;line-height:115%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:12.0pt;line-height:115%'>the type field must be set to 9 for SIP servers</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216635"></a><a name="_Toc478373708"></a><a name="_Toc478281615"></a><a name="_Security"></a><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Security</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>When using the SIP stack in “gateway mode” then it will not store your VoIP user credentials (SIP passwords). All other sensitive tasks such as billing and user management is also done entirely by your server (no such data is stored on the gateway) thus MRTC is not a critical component from the security point of view. However the list of the users (the SIP usernames) are always stored also on the gateway thus you can’t leave the gateway entirely unprotected.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Windows OS is as </span><a href="https://www.mizu-voip.com/Support/Blog/tabid/100/EntryID/8/Default.aspx"><span style='font-size:14.0pt;line-height:115%'>secure</span></a><span style='font-size:14.0pt;line-height:115%'> as any other (Linux/MAC/BSD) if you are using a clean install only to host the WebRTC gateway service with the built-in firewall turned on (allowing only the Gateway process). This is because all Windows services are turned off on such a server and kernel vulnerabilities exploitable via basic TCP/IP are extremely rare (not more than in Linux or even BSD).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>From security perspective it is important to run the MRTC gateway on a clean OS with no any unsafe third-party software installed.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The WebRTC gateway is based on our Softswitch core which implements a long list of security features applicable also for the Gateway. This includes transport and session based limits, rule based filtering, rate limiter, auto-ban, auto-blacklist, call limits, fraud detection, DDoS protection and more. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For the details please read </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_Security.pdf"><span style='font-size:14.0pt;line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <h3><a name="_Toc514216636"><span style='font-size:14.0pt;line-height:115%'>High availability</span></a></h3> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>HA, failover and redundancy is supported for both downstream and upstream.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>You can use a second backup gateway, multiple gateways for the same SIP server, handle multiple SIP servers by the same gateway or for the highest availability: use multiple gateways with multiple (same or different) SIP servers.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal"><b><u>Client side failover:</u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>There are multiple possibilities to implement HA toward the WebRTC clients:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><b><span style='font-size:14.0pt;line-height:120%'>API</span></b></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>The best option is to implement a simple availability verification into the client software and failover to other instances if no answer or bad answer have been received. This can be done by using the <span style='color:#984806'>wsload</span> </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_API.pdf"><span style='font-size:14.0pt;line-height:120%'>API</span></a><span style='font-size: 14.0pt;line-height:120%'> which will return one of the following answers: </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%;color:#984806'>ERROR, errortext</span><span style='font-size:14.0pt;line-height:120%'> indicates gateway malfunctioning</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>If there is no any answer then you can treat it as ERROR (gateway down)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%;color:#984806'>OK: WS Load: X type …</span><span style='font-size:14.0pt;line-height:120%'> indicates that the gateway is available. The X is a number from 0 to 4 indicating the gateway load (0-low, 1-normal, 2-high, 3-very high, 4-extreme). You can treat 4 as gateway malfunction, otherwise you should prioritize the gateway returning the lowest number. The "load" is calculated based on multiple factors such as your hardware capabilities, CPU usage, current users/calls, system state, previous malfunctions and others.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>If your gateways are geographically distributed, then you can check the response time to find out the nearest one (or more correctly, a combination of the gateway load and response time should be used).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>Example answer: <span style='color:#984806'>OK: WS Load: 1 type: 1 pmsec: 115 from: 91 wait: 0 ping: -1</span></span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>The pmsec is the time what was required for the gateway to answer the request (which depends on many factors, such as caching) minus the ping time between the gateway and the SIP server. You can deduct this from the total answer time. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><b><span style='font-size:14.0pt;line-height:120%'>UAC failover</span></b></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>Some WebRTC-SIP client might already have a failover mechanism implemented on the transport layer.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>A simple way to handle gateway availability is on the SIP protocol level. Failover if there are no or bad response of the REGISTER (or OPTIONS/INVITE requests)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><b><span style='font-size:14.0pt;line-height:120%'>Network </span></b></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:120%'><span style='font-size:14.0pt;line-height:120%'>Another way to implement failover is to simply redirect your WebRTC-SIP clients to other gateways on failure. This is not so sophisticated like the above mentioned methods, but offers administrators a simple way to circumvent major outages. Failover can be forced by the following methods</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>domain name redirect (easy usage but propagation will take some time. You need to set also the A record as SRV records usually can’t be used from browser clients)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>BGP (requires some expertize and access to BGP, thus mostly available only for ISP’s)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>dynamic IP (most server hosting providers nowadays can provide dynamic IP service which can be used instead of domain redirection as an instant redirect for all peers)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><i><span style='font-size:14.0pt;line-height:120%'>Note: the mizu webphone implements both API based and transport layer failover if you configure it with at least two gateways</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><i><span style='font-size:14.0pt;line-height:120%'> </span></i></p> <p class="MsoNormal"><b><u>Webphone failover:</u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>If you are using the </span><a href="https://www.mizu-voip.com/Software/WebPhone.aspx"><span style='font-size: 14.0pt;line-height:120%'>webphone</span></a><span style='font-size:14.0pt; line-height:120%'> as a WebRTC client with multiple MRTC gateways then HA (load balancing and/or failover) can be easily configured in the webphone using the following settings:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>ismrtcgateway: this parameter must be set to 1 if you are using MRTC with the webphone</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_address: domain name without the ws/wss protocol and the /mfstwebsock path (LocalDomain). For example: rtc.mizu-voip.com</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_apikey: server or gateway API key (serverapikey/apiv2key/httpapikey)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_salt: server or gateway API salt value if any (apiv2md5salt)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_sipport: server sip signaling listener port (LocalPort). Usually/default: 5060 (actually this will be rarely used, only in some special conditions might be required)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_stunport: server sip signaling STUN port (mainaportudp). Usually/default: 8090</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_turnport: server sip signaling TURN port (mainaport). Usually/default: 80</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_rtmpport: flash service port if any (hasflash). Usually/default: 1939 (actually this will be rarely used, only for the deprecated flash engine)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_delay: add delay like inverse pmsec (setting to a higher value such as 600 will result in failover instead of load-balancing)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>pgwX_try: if false, then it will be used only for failover. Usually/default: true</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Where X an index from 1 to 100, so you can use up to 100 gateways (although usually two is enough for HA).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Based on these settings the webphone will always connect to the “best” available gateway (prioritizing a bit the last worked gateway).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><i><span style='font-size:14.0pt;line-height:120%'> </span></i></p> <p class="MsoNormal"><b><u>Server side failover:</u></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>This is about auto-prioritization among upper servers (your SIP servers).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>You can configure multiple upper servers for a gateway and define various routing rules such as simple load balancing, quality based routing named (BRS) or any specific routing rules (depending on caller, called, time and other criteria). Check the </span><a href="https://www.mizu-voip.com/Portals/0/Files/Routing_guide.pdf"><span style='font-size:14.0pt;line-height:120%'>routing guide</span></a><span style='font-size:14.0pt;line-height:120%'> for a quick description.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Beside the routing rules, the MRTC gateway is capable to auto-detect malfunctioning servers and automatically deprioritize them. This is part of the BRS algorithm, but you have a basic failover even if you are not using BRS (basic failover meant to detect bad routes and deprioritize them if there are better working SIP servers). </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>MRTC implements failover on all levels:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Basic failover (“hard” failover, mentioned above, based on previous upper server behavior)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Routing automatic (“soft” prioritization, discussed above, based on detailed statistics)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Routing rules (upper server prioritizations/failover after pattern and/or destination priority)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Re-Register (redirect the registration to a working server on bad or no response)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Re-Dial (in-call failover when a bad or no response is received from the upper SIP server)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Or simply you might use a separate MRTC gateway for each of your SIP servers</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>More details can be found </span><a href="https://www.mizu-voip.com/Solutions/LargescaleVoIP.aspx"><span style='font-size:14.0pt;line-height:120%'>here</span></a><span style='font-size:14.0pt;line-height:120%'>, </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_HA_VoIP.pdf"><span style='font-size:14.0pt;line-height:120%'>here</span></a><span style='font-size:14.0pt;line-height:120%'>, </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_HA_Database.pdf"><span style='font-size:14.0pt;line-height:120%'>here</span></a><span style='font-size:14.0pt;line-height:120%'> and </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_DB_Failover.pdf"><span style='font-size:14.0pt;line-height:120%'>here</span></a><span style='font-size:14.0pt;line-height:120%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216637"><span style='font-size:14.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Feature support</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Certain features (such as voice recording) doesn’t depend on any external support, however some features require support also by the WebRTC client and/or your SIP server (and/or SIP peers):</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For IM/chat to work, your WebRTC client and SIP server need to support the SIP MESSAGE standard which is the basic instant messaging protocol as described in </span><a href="https://www.ietf.org/rfc/rfc3428.txt"><span style='font-size:14.0pt; line-height:115%'>RFC 3428</span></a><span style='font-size:14.0pt;line-height: 115%'>. Note that messaging can work between the clients on the same gateway even if your server doesn’t support RFC 3428.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For DTMF to work your SIP server and WebRTC client must have support for </span><a href="https://www.ietf.org/rfc/rfc2833.txt"><span style='font-size:14.0pt; line-height:115%'>RFC 2833</span></a><span style='font-size:14.0pt;line-height: 115%'> or </span><a href="https://tools.ietf.org/html/rfc2976"><span style='font-size:14.0pt;line-height:115%'>SIP INFO</span></a><span style='font-size:14.0pt;line-height:115%'>. The gateway can also perform the conversion between these if needed. In-band DTMF is routed as-is, so this method will also work if both your SIP server and WebRTC client use this method. The best is to make sure that your server can send/receive the DTMF in the same format that is emitted/accepted by your WebRTC clients.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For presence to work your software needs support for PUBLISH (required/used only by WebRTC) and for SUBSCRIBE/NOTIFY as specified in </span><a href="https://tools.ietf.org/html/rfc3856"><span style='font-size:14.0pt; line-height:115%'>RFC 3856</span></a><span style='font-size:14.0pt;line-height: 115%'>.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For video to work your SIP server and/or SIP peers need to support video codecs such as H.264, H.265, VP8, VP9.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For call transfer you will need support for SIP REFER as described in </span><a href="https://tools.ietf.org/html/rfc3515"><span style='font-size:14.0pt; line-height:115%'>RFC 3515</span></a><span style='font-size:14.0pt;line-height: 115%'>.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>For call forward you will need support for SIP response code 301 (Moved Permanently) and/or 302 (Moved Temporarily).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In general, WebRTC clients tends to has less features then SIP clients, but the most important call features should be compatible regardless of the transport layer.</span></p> <p class="MsoListParagraph" style='margin-top:0in;margin-right:0in;margin-bottom: 0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt; line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If some feature is supported by your WebRTC client but not by your SIP server, then it will work only for WebRTC->WebRTC calls (and not for WebRTC->SIP or SIP->WebRTC).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The MRTC gateway also does its best to compensate on missing support. For example, the chat might work even without SIP MESSAGE support by carrying the message by SIP OPTIONS or SIP NOTIFY requests if your SIP server allows. Also the basic presence might work without SUBSCRIBE/NOTIFY support by using the peer registrar state.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216638"></a><a name="_Toc478373707"></a><a name="_Toc478281614"><span style='font-size:14.0pt;line-height:115%;font-family: "Calibri",sans-serif'>Extra features</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Most of the extra SIP features will be just forwarded transparently by the gateway and actually negotiated between the WebRTC clients and your SIP server. Most SIP features will work out of the box by default. You might read below only if some extra or call control feature doesn’t work for you either because of no direct mapping between SIP and WebRTC or lack of implementation in your WebRTC client or in your Softswitch.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Class 5 features should be handled on your IP-PBX or Softswitch, however the Gateway also has some built-in features which might be useful for you (for example voicemail or call forward) assisted or handled entirely by the WebRTC gateway. Also for some functionalities there are no direct mapping between the WebRTC and SIP protocol so they can be solved only by extra features provided from the MRTC Gateway, by the Softswitch or by the WebRTC client (for example conference rooms). Other features don’t depend on the protocol used (no direct support in SIP or WebRTC) but can be implemented on the server side using some separate protocol (usually via a HTTP API exposed to clients).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Some extra PBX features can be enabled by setting the “<span style='color:#984806'>fs_pbx</span>” global configuration option to “1” (or disabled by setting the same to “0”).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Here are a few of the extra features:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>RTMP</span></b><span style='font-size:14.0pt'>: as a bonus, MRTC includes also a flash gateway module so it is compatible also with flash based voip clients. The RTMP is listening on port indicated by the “hasflash” setting defaulting to 1939. Disable by setting to 0.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Call forward</span></b><span style='font-size:14.0pt'>: can be enabled from users and devices form -> functions tab</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Call transfer</span></b><span style='font-size:14.0pt'>: available as specified SIP standards (via all devices with transfer support) or via *9*number# dtmf</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Voicemail</span></b><span style='font-size:14.0pt'>: Enable/disable from the “<span style='color:#984806'>voicemail</span>“global config. Then enable/disable per user from “Users and devices” form -> “Functions” tab. Default access number is 5000 (with pin) and 5001 (with auto authentication). Auto-email forward is enabled by default.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Conference</span></b><span style='font-size:14.0pt'>: via SIP standard, via dtmf *1*number# or via conference rooms using extensions between 5100-5199 for narrowband and 5200-5299 for wideband. You can use the “getconfroom” API to auto allocate a conference room and its access number for the user.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Special numbers</span></b><span style='font-size:14.0pt'> and IVR’s such as music, record/playback, vide record/playback and others</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Missed call notifications</span></b><span style='font-size:14.0pt'> by email</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Barge in: </span></b><span style='font-size:14.0pt'>via the “Voice here” form, or right click on current call or 5009 access number</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>Softphones</span></b><span style='font-size:14.0pt'>: Mizutech can also offer customized/branded softphones which works with the Gateway or directly with your SIP server: </span><a href="https://www.mizu-voip.com/Software/WebPhone.aspx"><span style='font-size: 14.0pt'>Browser webphone</span></a><span style='font-size:14.0pt'>, </span><a href="https://www.mizu-voip.com/Software/Softphones/Windowssoftphone.aspx"><span style='font-size:14.0pt'>Windows softphone</span></a><span style='font-size: 14.0pt'>, </span><a href="https://www.mizu-voip.com/Software/Softphones/AndroidSoftphone.aspx"><span style='font-size:14.0pt'>Android softphone</span></a><span style='font-size: 14.0pt'>, </span><a href="https://www.mizu-voip.com/Software/Softphones/iPhoneSoftphone.aspx"><span style='font-size:14.0pt'>iOS softphone</span></a><span style='font-size:14.0pt'>, </span><a href="https://www.mizu-voip.com/Software/Softphones/SymbianSoftphone.aspx"><span style='font-size:14.0pt'>Symbian dialer</span></a><span style='font-size:14.0pt'>, </span><a href="https://www.mizu-voip.com/Software/Softphones.aspx"><span style='font-size:14.0pt'>Other softphones</span></a></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>IVR</span></b><span style='font-size: 14.0pt'>: The IVR module can be used for various tasks like access numbers, callback, customer support etc.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>You can assign different IVR’s to different access numbers by using the “<b>Campaigns</b>” form. To create a new campaign, just click on the + sign and enter a “name” for the new record. The most important configuration for an IVR campaign is the script. Switch to the “details” tab to select a “Script”.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Scripts can be created by using the “IVR” form. The gateway is shipped with several preconfigured script examples, but you should easily add new scripts or modify the existing ones by following the </span><a href="https://www.mizu-voip.com/LinkClick.aspx?fileticket=iP2DA5gwh-s%3d&tabid=176&mid=675"><span style='font-size:14.0pt'>admin guide</span></a><span style='font-size:14.0pt'> or the </span><a href="https://www.mizu-voip.com/Portals/0/Files/IVR.pdf"><span style='font-size:14.0pt'>IVR documentation</span></a><span style='font-size: 14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>SMS: </span></b><span style='font-size:14.0pt'>by default the gateway is capable to route SMS message as SIP MESSAGE (RFC 3428). However, it is also possible to use an external service which can be accessed by a HTTP API. Just set the “<span style='color:#984806'>smsurl</span>” smsurl global config option or create SMS GW endpoints if you wish to use more than one provider. A guide can be found </span><a href="http://www.mizu-voip.com/Portals/0/Files/sms_softswitch.pdf"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><b><span style='font-size:14.0pt'>API</span></b><span style='font-size: 14.0pt'>: the Gateway also has a HTTP API which can be used for various tasks. See the </span><a href="https://www.mizu-voip.com/Portals/0/Files/VoIP_Server_API.pdf"><span style='font-size:14.0pt'>API documentation</span></a><span style='font-size: 14.0pt'> for the details.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><b><span style='font-size:14.0pt;line-height:115%'>Many other</span></b><span style='font-size:14.0pt;line-height:115%'> features are enabled for you by default and some of them can be changed/fine-tuned from configurations, such as caller-id, ring groups, call hold, call waiting/park/pickup and others. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The WebRTC-SIP proxy is based on the VoIP Server core thus you can also access almost all of the Softswitch features. See the </span><a href="https://www.mizu-voip.com/Portals/0/Files/MAdminGuide.pdf"><span style='font-size:14.0pt;line-height:115%'>Softswitch documentation</span></a><span style='font-size:14.0pt;line-height:115%'> for the details. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you are not sure where to find a specific configuration option, search for your keyword in:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>“Configurations” form within MRTCAdmin</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>This guide</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Portals/0/Files/MAdminGuide.pdf"><span style='font-size:14.0pt;line-height:115%'>VoIP server guide</span></a><span style='font-size:14.0pt;line-height:115%'> (most of the settings can be applied also for the MRTC gateway)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check the </span><a href="https://www.mizu-voip.com/Support/Documentations.aspx"><span style='font-size:14.0pt;line-height:115%'>other documentations</span></a><span style='font-size:14.0pt;line-height:115%'> (some of them are relevant also for MRTC)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>5.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Or ask </span><a href="mailto:info@mizu-voip.com?subject=WebRTC-SIP%20Gateway%20support%20request"><span style='font-size:14.0pt;line-height:115%'>Mizutech support</span></a></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h1 style='margin-top:0in'><a name="_Toc514216639"><span style='font-size:16.0pt; line-height:115%;font-family:"Calibri",sans-serif'>FAQ</span></a></h1> <p class="MsoNormal"> </p> <h3 style='margin-top:0in'><a name="_Toc514216640"><span style='font-size:14.0pt; line-height:115%'>How to get my WebRTC-SIP gateway</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Follow these steps:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Have a look at the </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP.aspx"><span style='font-size:14.0pt;line-height:115%'>home page</span></a><span style='font-size:14.0pt;line-height:115%'> and eventually download and try the free </span><a href="https://www.mizu-voip.com/G/download/MRTC_Setup.exe"><span style='font-size:14.0pt;line-height:115%'>WebRTC-SIP gateway</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If seems to be ok for your needs, purchase from </span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP/WebRTC-SIP-Gateway-Pricing.aspx"><span style='font-size:14.0pt;line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>On your payment Mizutech will send the download link by email (you can just reinstall to upgrade any existing versions without data/settings lost)</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Contact </span><a href="mailto:info@mizu-voip.com?subject=WebRTC-SIP%20gateway%20support%20request"><span style='font-size:14.0pt;line-height:115%'>mizutech support</span></a><span style='font-size:14.0pt;line-height:115%'> for any help or if you run into any issue using the MRTC gateway.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'> </span></p> <h3><a name="_Toc514216641"><span style='font-size:14.0pt;line-height:115%'>Can’t connect/register</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that the service is started (NT Services “mserver”)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that the required ports/executables are not </span><a href="start.htm#_Firewall"><span style='font-size:14.0pt;line-height:115%'>firewalled</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If the server is running on a private IP (local LAN) and you wish to connect from external network, make sure that the required </span><a href="start.htm#_Ports"><span style='font-size:14.0pt;line-height:115%'>ports</span></a><span style='font-size:14.0pt;line-height:115%'> are forwarded on your router</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check the Dashboard, Analyze and Logs forms for any errors</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>5.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that your IP/domain configuration is correct (bindip should be present on the local interface, localip should be your box public IP, the configured domain DNS A record should be set to the localip)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>6.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that TLS is configured correctly. If you enabled auto TLS from the configuration wizard, then you can see related issues in the logs if any. </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Test TLS connectivity from MRTCAdmin -> Config menu -> Utilities -> Tests -> TLS Certificate test -> TLS Proxy Test</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>7.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Don’t use special UTF characters in username/password (some SIP servers don’t like non-ASCII characters).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>8.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that you are using a correct SIP username/password valid on your SIP server.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>9.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Some server require to set a different username/auth username (Username is usually the Extension ID). If you are using the Mizu WebPhone, then set the Extension ID as the webphone “Caller ID” (“username” parameter) and set the Auth user name as the webphone “Username” (“sipusername” parameter).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>10.</span><span style='font-size: 14.0pt;line-height:115%'>Check if otherwise you can connect with a simple SIP client (first directly to your server, second to the gateway). If this works, then the problem is WebRTC or WebSocket related.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>11.</span><span style='font-size: 14.0pt;line-height:115%'>Test if the gateway WebRTC service is listening from MRTCAdmin -> Config menu -> Utilities -> Tests -> TLS Certificate test -> WSS SIP Test</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>12.</span><span style='font-size: 14.0pt;line-height:115%'>Check the browser console logs and the gateway logs (MRTCAdmin -> Files menu -> Folders -> Server logs).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216642"><span style='font-size:14.0pt;line-height:115%'>Can’t make calls</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check the Dashboard, Analyze and Logs form for any issues</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make a test call first from a simple SIP client such as mizu softphone or x-lite (first directly to your server, second to the gateway). If this works, then the problem is WebRTC or WebSocket related.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>If you are making call to a local user, make sure that the called user is registered when you call it</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>4.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check the CDR disconnect reason (if the call reached the gateway) from MRTCAdmin -> CDR form.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>5.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure to allow Media Permissions for WebRTC in your browser.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>6.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check the browser console output.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>7.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check if the call reaches the gateway and inspect the gateway logs (MRTCAdmin -> Files menu -> Folders -> Server logs).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>a)<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Open the last logfile (“log_xxx.dat”) with a fast text viewer (For example F3 from TotalCommander). To find application errors, open the last log file in the server app directory and search for “ERROR” and “WARNING”. To find a call, search for “INVITE sip:callednumber”.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt'>b)<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>In case if the logs doesn’t contain the SIP signaling details, enable the detailed logs first (Control menu -> Logs -> Set -> On), reproduce the problem and check the log files again</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>8.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check if the call reaches your SIP server and inspect your server logs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216643"><span style='font-size:14.0pt;line-height:115%'>Incoming calls not received</span></a></h3> <p class="MsoNormal"> </p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check if the call reaches your SIP server. If not, then the problem has nothing to do with WebRTC.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check if the call reaches the WebRTC gateway. In not, then make sure that the WebRTC client is registered to your server at the time when the inbound call is routed to it.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Check if the call reaches the WebRTC client (check the browser console output with detailed trace/log level, search for “INVITE sip”).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216644"><span style='font-size:14.0pt;line-height:115%'>Calls are disconnecting</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Call disconnection immediately upon setup can have many reasons such as codec incompatibility issues, NAT issues, DTLS/SRTP setup problems or audio problems.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Call disconnection after 20 seconds might be caused by MEDIATIMEOUT and MEDIATIMEOUTSTART global config option if there is no audio (RTP stream) or one way audio only.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216645"><span style='font-size:14.0pt;line-height:115%'>No voice or one side audio</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Change the RTP media routing for one or all users.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For one user this can be changed from the “Users and Devices” form -> Functions page -> Media relay.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For all users it can be changed in the following ways:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To disable media routing, execute the following SQL’s in the “Direct Query” form:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>update [tb_users] set RouteRTPCaller = 1, RouteRTPCalled = 1 where type in (0,5,9)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>Update tb_settings set valstr = '1' where keystr = 'defroutertp</span> <span style='line-height:115%;color:#984806'>'</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:gray'>ALTER TABLE [tb_users] DROP CONSTRAINT [DF_tb_users_record]</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:gray'>ALTER TABLE [tb_users] ADD CONSTRAINT [DF_tb_users_record] DEFAULT 0 FOR [record]</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To enable media routing, execute the following SQL’s in the “Direct Query” form:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>update [tb_users] set RouteRTPCaller = 7, RouteRTPCalled = 7 where type in (0,5,9)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>update tb_settings set valstr = '7</span> <span style='line-height:115%;color:#984806'>' where keystr = 'defroutertp'</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:gray'>ALTER TABLE [tb_users] DROP CONSTRAINT [DF_tb_users_record]</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:gray'>ALTER TABLE [tb_users] ADD CONSTRAINT [DF_tb_users_record] DEFAULT 1 FOR [record]</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To force the media routing even for WebRTC-WebRTC calls, also set the following global config options:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>defroutertp=7 (force RTP routing by default)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>alloweuserusercalls=0 (optional setting to disable direct calls and route all calls via the SIP server –usually not needed)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>fs_directroutrfstofs=1 (disable fast path routing)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='line-height:115%;color:#984806'>fs_forceoffrouteforvoicrec=4 (turn off webrtc direct routing. 0=no,1=yes on low load,2=yes-auto,3=yes,4=force for all calls)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3 style='margin-top:0in'><a name="_Toc514216646"><span style='font-size:14.0pt; line-height:115%'>Long call setup time</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>If you experience long setup or ring time, that is almost always due to poor client side WebRTC implementation. Make sure to use a WebRTC client with proper ICE timeout limitations such as the mizu webphone. It is normal for ICE queries to take 20 or more seconds, however it is not normal to wait for these to complete on the client side as such delayed responses are always useless and mostly caused by unused network interfaces.</span></p> <h3><a name="_Toc514216647"><span style='font-size:14.0pt;line-height:115%'>Chat doesn’t work</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Make sure that your SIP server and WebRTC client has support for SIP MESSAGE as described in </span><a href="https://www.ietf.org/rfc/rfc3428.txt"><span style='font-size:14.0pt; line-height:115%'>RFC3428</span></a><span style='font-size:14.0pt;line-height: 115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Most old Asterisk installations might not have support for this </span><a href="http://www.voip-info.org/wiki/view/Asterisk+SIP+Messaging"><span style='font-size:14.0pt'>by default</span></a><span style='font-size:14.0pt'>. You might use </span><a href="http://www.kamailio.org/"><span style='font-size: 14.0pt'>Kamailio</span></a><span style='font-size:14.0pt'> for this purpose or any other </span><a href="https://www.mizu-voip.com/Products/VoIPServer.aspx"><span style='font-size:14.0pt'>softswitch</span></a><span style='font-size:14.0pt'> (most of them has support for RFC 3428).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For new versions of Asterisk based SIP servers you need to properly </span><a href="http://stackoverflow.com/a/23110898/3376017"><span style='font-size:14.0pt'>configure SIP MESSAGE routing</span></a><span style='font-size:14.0pt'> in order for IM to work.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>See also </span><a href="http://www.voip-info.org/wiki/view/Asterisk+SIP+Messaging"><span style='font-size:14.0pt'>Asterisk patch</span></a><span style='font-size:14.0pt'> or </span><a href="http://issues.freepbx.org/browse/FREEPBX-7058"><span style='font-size:14.0pt'>FreePBX settings</span></a><span style='font-size: 14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216648"><span style='font-size:14.0pt;line-height:115%'>Presence doesn’t work</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>Presence is implemented as standard SIP PUBLISH/SUBSCRIBE/NOTIFY so your SIP server must support </span><a href="https://www.ietf.org/rfc/rfc3265.txt"><span style='font-size:14.0pt'>RFC 3265</span></a><span style='font-size:14.0pt'> and </span><a href="https://www.ietf.org/rfc/rfc3856.txt"><span style='font-size:14.0pt'>RFC 3856</span></a><span style='font-size:14.0pt'> in order for this to work.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal'><span style='font-size:14.0pt'>For Asterisk based servers you can find configuration details </span><a href="https://www.voip-info.org/wiki/view/Asterisk+presence"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'> and </span><a href="https://wiki.asterisk.org/wiki/display/AST/Configuring+chan_sip+for+Presence+Subscriptions"><span style='font-size:14.0pt'>here</span></a><span style='font-size:14.0pt'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216649"><span style='font-size:14.0pt;line-height:115%'>Video doesn’t work</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Make sure that your server has full support for H.264 and VP8 or it bypass the media routing and forwards the SDP attributes correctly.</span></p> <h3><a name="_Toc514216650"><span style='font-size:14.0pt;line-height:115%'>DTMF doesn’t work</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>WebRTC clients are usually sending the DTMF with SIP INFO so make sure that your SIP server can handle this DTMF method.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Adjust the gateway global configuration after your needs:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>fs_dtmf_type_intern: //dtmf-type to clients : 0=default, 1=info, 2=rfc2833</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>fs_dtmf_type_extern: dtmf-type to servers: 0=default, 1=info, 2=rfc2833</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>fs_dtmf_duration: dtmf-duration. def: 600</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>for other DTMF related settings, search for “dtmf” in the global configuration</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For more details, read </span><a href="start.htm#_DTMF"><span style='font-size:14.0pt;line-height:115%'>here</span></a><span style='font-size:14.0pt;line-height:115%'>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="node0" id="node0"></a><span style='font-size:14.0pt;line-height:115%'>DTMF triggered actions</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The gateway has built-in functions to be triggered by DTMF digits, useful for endpoints with no conference or transfer support.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For these to work the PBX module have to be enabled and the <span style='color:#984806'>handledtmfevent</span> global config option must be set to <span style='color:#984806'>2</span>.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Here are the defined keys:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>create conference or add new user to conference: *1*number# </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>unattended transfer: *9*number# </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>transfer with consultation : *8*number# </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>talk with new client while in transfer: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>talk with old client while in transfer: 3</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>disconnecting last conference party: *5* </span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>disconnecting conference party: *6*number#</span></p> <h3><a name="node1" id="node1"></a><span style='font-size:14.0pt;line-height:115%'>How to explicitly set the IP address used in signaling</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The RTC gateway might auto-detect another (best match) address to be used in the SIP signaling even if you have set a bindip and/or localip. This might be the case on servers with multiple network interface or a different/changing external IP.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can use the following global config options to prevent this:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>autouselocalip: set to 0</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>autodetectlocalip: set to 0</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Additional related parameters:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>localip (you might set this explicitely)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>bindip (you might set this explicitely)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>localinternalip (you might set this explicitely)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>nathandling</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>nataddrtype</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family: Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>usephisicalfromaddr</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can also explicitly set the ip address to use per peer by setting the interface field in tb_users and the secondarybindip values in the global configuration.</span></p> <h3><a name="_Toc514216651"><span style='font-size:14.0pt;line-height:115%'>I don’t see some calls on my SIP server</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'><br> </span><span style='font-size:14.0pt;line-height:115%'>The WebRTC gateway by default will route the calls between the endusers bypassing your SIP server with the advantage of freeing up resource utilizations on your SIP server.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>You can disable this behavior by setting the <span style='color:#984806'>alloweuserusercalls</span> and <span style='color:#984806'>fs_directroutrfstofs</span></span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>global config options to <span style='color:#C0504D'>0</span> thus forcing all calls to be routed via your server.</span></p> <h3><a name="node2" id="node2"></a><span style='font-size:14.0pt;line-height:115%'>How to forward custom SIP headers</span></h3> <p class="MsoNormal"><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>The gateway might drop or rewrite SIP headers in the SIP signaling, however you can add any custom SIP headers with the “X-“ prefix to be forwarded as-is.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Example:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>X-MyHeader: 1234</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="node3" id="node3"></a><span style='font-size:14.0pt;line-height:115%'>How to restrict users max concurrent calls</span></h3> <p class="MsoNormal"><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>This can be configured globally from the Configuration Wizard “Users” page or per user from “Users and Devices” -> “Functions” page Max Lines settings.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if you need to set later for all users, you can use the following query (copy-paste to Direct Query form, replace X after your needs and execute): </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>For individual users:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>update tb_settings set valstr = 'true' where keystr = 'checkmaxlines'</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>update tb_settings set valstr = 'X' where keystr in ('endusersdefmaxline', 'maxlineforautotunnelusers')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>update tb_users set MaxLines = X, MaxLinesOffpeak = X where type = 0</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:black'>For trunks (all traffic from/to your SIP server):</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>update tb_settings set valstr = 'X' where keystr = 'maxlinefornewunknownparents'</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'>update tb_users set MaxLines = X, MaxLinesOffpeak = X where type > 0</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%;color:#984806'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%;color:black'>Note: the total number of maximum simultaneous calls might be also restricted by your MRTC license.</span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="_Toc514216652"><span style='font-size:14.0pt;line-height:115%'>Call quality problems</span></a></h3> <p class="MsoNormal"><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal"><span style='font-size:14.0pt;line-height:115%'>Call quality is influenced primarily by the followings:</span></p> <p class="MsoListParagraphCxSpFirst" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Network conditions (QoS)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Codec used to carry the media (wideband has better quality)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>AEC, AGC and denoise (enable/disable these in your client after your needs)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Hardware: enough CPU power and quality headset/microphone/speaker (try a headset, try on another device)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>OS/Browser (drivers problems)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Settings (codec, jitter size, AEC, etc)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Software problem or bug</span></p> <p class="MsoListParagraphCxSpLast" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>VoIP route (carrier/call termination/voip service provider call quality)</span></p> <p class="MsoNormal"><span style='font-size:14.0pt;line-height:115%'>If you have call quality issues then the followings should be verified:</span></p> <p class="MsoListParagraphCxSpFirst" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Check your network quality: speed, packet loss, delay and jitter </span><a href="https://sourceforge.net/speedtest/"><span style='font-size:14.0pt; line-height:120%'>here</span></a><span style='font-size:14.0pt;line-height: 120%'>. (Other tools: </span><a href="http://speedtestatl.cbeyond.net/index.html"><span style='font-size:14.0pt; line-height:120%'>a</span></a><span style='font-size:14.0pt;line-height:120%'> , </span><a href="http://myspeed.visualware.com/"><span style='font-size:14.0pt; line-height:120%'>b</span></a><span style='font-size:14.0pt;line-height:120%'>, </span><a href="http://www.speedtest.net/"><span style='font-size:14.0pt; line-height:120%'>c</span></a><span style='font-size:14.0pt;line-height:120%'>, </span><a href="http://www.pingtest.net/"><span style='font-size:14.0pt; line-height:120%'>d</span></a><span style='font-size:14.0pt;line-height:120%'>)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Check whether you have good call quality using a third party softphone from the same location (try X-Lite for example). If not, than the problem is not related to the gateway (continue to look for server, termination gateway or bandwidth issues)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Make sure that the CPU load is not near 100% when you are doing the tests </span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Make sure that you have enough </span><a href="https://www.bandcalc.com/"><span style='font-size:14.0pt;line-height:120%'>bandwidth</span></a><span style='font-size:14.0pt;line-height:120%'>/QoS for the </span><a href="start.htm#_Toc514216626"><span style='font-size:14.0pt;line-height:120%'>codec</span></a><span style='font-size:14.0pt;line-height:120%'> that you are using (G.729 requires around 24 kbits. G.711 requires around 80 kbits. Opus requires around 20-50 kbits. However the overall bandwidth is rarely the problem and you should check if you have these minimums constantly, with less packet loss then 2% and no big variations in roundtrip delays)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Change the codec </span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Try to set only one single codec (such as PCMU) to make sure that the problem is not caused by poor server side handling of the automatically selected codec</span></p> <p class="MsoListParagraphCxSpLast" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Perform a network trace (With </span><a href="https://www.wireshark.org/download.html"><span style='font-size:14.0pt;line-height:120%'>Wireshark</span></a><span style='font-size:14.0pt;line-height:120%'> for example; Filter for SIP and RTP. Check missing or duplicated packets)</span></p> <p class="MsoNormal" style='line-height:120%'><span style='font-size:14.0pt; line-height:120%'>Optimize for best call quality:</span></p> <p class="MsoListParagraphCxSpFirst" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>If possible, avoid RTP routing on the server side altogether. This will allow peer to peer direct media. If your SIP trunk provider requires the RTP packets to be sent from your IP, then configure your server with RTP routing only for outbound/inbound calls (and not for user to user calls)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Use (enable) OPUS (and speex) wideband if possible. Wideband codec has much better quality then narrowband and even if your service providers(s) accepts only codec like G.729 or G.711, this can be auto-negotiated and you should not force only these codec’s on your server (allowing wideband for user to user calls)</span></p> <p class="MsoListParagraphCxSpMiddle" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>If possible, avoid codec conversion (transcoding). End to end G.711 has better quality then half-way OPUS and then conversion to G.711</span></p> <p class="MsoListParagraphCxSpLast" style='text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Follow best practices for VoIP (make sure that you have enough and good quality bandwidth with minimal jitter and no packet loss, make sure that your server resources are not over utilized and the CPU is cable to handle RTP routing with minimal delay, etc)</span></p> <h3><a name="_Backup/restore"></a><span style='font-size:14.0pt;line-height: 115%'>Backup and restore</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Just copy the mserver.sdf file for a full backup.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Details:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Automatic backup can be configured from the configuration wizard.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>In case if you wish to perform the backup with other tool or manually, then all you need to copy is the mserver.sdf file. Stop the service and close the MRTCAdmin client first to release the database. <br> This is the internal database, which contains all the settings and data such as routes and CDR records. All the other files can be recreated by simply reinstalling the gateway with it’s standard installer. (Once reinstalled, just replace the .sdf file in the app folder with your backup).</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>You might also backup the other files if you wish, in this case you might exclude the logs.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>You might also backup the call recording files separately, which are stored in the “recorded” subfolder by default.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <h3><a name="node4" id="node4"></a><span style='font-size:14.0pt;line-height:115%'>Change upper SIP server address</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>This is about changing your SIP server IP address or domain name (the upper SIP server where the calls are routed and received from) if you are using a single SIP server. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>For example if you migrated your SIP server to a new location or if you have to change the upper SIP server details for any reason.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>In case if you are using a licensed MRTC gateway, make sure that your license allows the usage also with the new SIP server address.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'><br> <b>GUI configuration (this will not rewrite the upper server for existing users):</b></span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>You might go trough the Configuration Wizard again and configure your new SIP server.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Alternatively just search for “fwdregistrations_” on the “Configurations” form and rewrite it to your new server address.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Add the new SIP server user record at the "Users and Devices" form.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Use the Routing form and specify your custom rules for the server selection.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><b><span style='font-size:14.0pt;line-height:120%'>From SQL:</span></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Replace OLDIP to your old SIP server IP and the NEWIP to the new SIP server IP address and then run the following SQL commands to change the upper SIP server address (copy-paste to the “Direct Query” form and hit the “Go” button):</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%;color:#984806'>update tb_users set hwid = REPLACE(hwid,'OLDIP','NEWIP'), ContractComment = REPLACE(ContractComment,'OLDIP','NEWIP'), ip = REPLACE(ip,'OLDIP','NEWIP'), authip = REPLACE(authip,'OLDIP','NEWIP'), domainname = REPLACE(domainname,'OLDIP','NEWIP'), proxyaddress = REPLACE(proxyaddress,'OLDIP','NEWIP'), transip = REPLACE(transip,'OLDIP','NEWIP'), name = REPLACE(name,'OLDIP','NEWIP'), username = REPLACE(username,'OLDIP','NEWIP')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%;color:#984806'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%;color:#984806'>update tb_users_authip set authip = REPLACE(authip,'OLDIP','NEWIP')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%;color:#984806'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%;color:#984806'>update tb_settings set valstr = REPLACE(valstr,'OLDIP','NEWIP')</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>If you (also) use a domain name, then replace OLDIP to your old SIP server domain and the NEWIP to the new SIP server domain name and then run the SQL statements again.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><b><span style='font-size:14.0pt;line-height:120%'>Using MRTC with multiple SIP server at the same time:</span></b></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'>The WebRTC-SIP gateway can be also used with multiple SIP servers. To be able to route the users to their respective servers (register, call, chat and other sessions) you have the following possibilities:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt'>1.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Specify the upper server from your WebRTC client instead (as the SIP server domain for your app config). <br> To allow client driven upper server selection, set the <span style='color:#632423'>allowupperserverselection </span>global config option is set to <span style='color:#632423'>true</span>.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt'>2.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Specify the upper server from the gateway/server routing rules:</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal; text-autospace:none'><span style='font-size:14.0pt'> Add the new SIP server to the “Users and Devices”</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'> Use the Routing form and specify your custom rules for the server selection.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'> For the routing rules to be applied also for register requests, you need to set the <span style='color:#632423'>routingforregister </span>global config option is set to <span style='color:#632423'>1</span>.</span></p> <p class="MsoListParagraph" style='margin-top:0in;margin-right:0in;margin-bottom: 0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'>3.<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Both:</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'> You can use both routing rules and upper server suggestions from your SIP clients.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'> If the allowupperserverselection settings is true, then the client suggestion will overwrite your routing rules.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: normal;text-autospace:none'><span style='font-size:14.0pt'>For all cases, make sure to create the necessary records from the “Users and devices” form for all your SIP servers:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Add them as “SIP Server” (for outbound) and as “Traffic Senders” (for inbound, usually with IP authentication).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal;text-autospace:none'><span style='font-size:14.0pt; font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt'>Then configure them in the “Routing” after your needs to specify what kind of users/calls have to be routed to which SIP server. </span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal; text-autospace:none'><span style='font-size:14.0pt'>For example you can just list them under the “default” pattern with equal priority for load balancing or configure any rules after your requirements.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <h3><a name="_Advanced_settings"></a><span style='font-size:14.0pt;line-height: 115%'>Advanced settings</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>WebRTC and gateway related settings are listed below for informational purposes only. </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Normally these values should be left with their </span><a href="start.htm#_Global_Configuration"><span style='font-size:14.0pt; line-height:115%'>default values</span></a><span style='font-size:14.0pt; line-height:115%'> and you just need to follow the </span><a href="start.htm#_Configuration_Wizard"><span style='font-size:14.0pt;line-height:115%'>configuration wizard</span></a><span style='font-size:14.0pt;line-height:115%'> for a proper setup.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>WebRTC module:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height: 120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>haswebrtc: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fs_use: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>haswebsocket: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>hasturn: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>localdomain: set to a valid domain name with its A record set to the server IP address</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>autotlscert: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>usetlsforall: true</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Optional settings:</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>hasflash: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fs_pbx: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>enableconferencerooms: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>v2mode: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>usemainaport: true</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>usetlsforweb: true</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>sslportmain: 443</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fs_restrictsiptolocal: 1</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fs_checkdomainmismatch: 1</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'>Gateway mode:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height: 120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>forwardauthentifications: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>autocreatereguser: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-bottom:0in;margin-bottom: .0001pt;text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt; line-height:120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fwdregistrations: 2</span></p> <p class="MsoListParagraphCxSpLast" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height: 120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>forwardauthpassword: 1</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <p class="MsoListParagraphCxSpFirst" style='margin-bottom:0in;margin-bottom:.0001pt; text-indent:-.25in;line-height:120%'><span style='font-size:14.0pt;line-height: 120%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>Optional:</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>hasbilling: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>blocknotbilledcalls: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fwdunknownheaders: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fwdregistrations_xxx</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>allowupperserverselection: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>runwebportal: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>fastauth: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>enforcestrongauth: false</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>MINUSERNAMELEN: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>minpwdlength: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>strongdigestauth: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>allowanonymouscaller: true</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>blocksatellitecalls: false</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>blockpremiumnumbers: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>builddynamicblacklist: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>anumberhandling: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>enablejsonp: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>maxreroute: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>normalizenumbers: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>normalizedef: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>validateinput: 2</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>normalize_clean: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>allowdiscmessage: false</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>publicservices: 1</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>dbmaint_backuplevel: 0</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>dbmaint_backuptables: 0</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:1.0in;margin-bottom:.0001pt;text-indent:-.25in; line-height:120%'><span style='font-size:14.0pt;line-height:120%;font-family: "Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:120%'>playadvfor: 0</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt;line-height: 120%'><span style='font-size:14.0pt;line-height:120%'> </span></p> <h3><a name="_Toc514216653"><span style='font-size:14.0pt;line-height:115%'>How to upgrade?</span></a></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>To upgrade or update to the latest version, all you have to do is to run the installer. This will overwrite your old binaries while keeping all your existing data intact, so you will not lose any settings. On first startup it will automatically upgrade also the data structures, so there is no need for any manual action.</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h3><a name="node5" id="node5"></a><span style='font-size:14.0pt;line-height:115%'>How to get support?</span></h3> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if you run into any issue, please send us the followings and we can help:</span></p> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Accurate problem description (including What you did? What should happen? What happened?)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Mention also the (caller/called) username and/or SIP Call-ID or CDR ID of the problematic session(s).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>(The CDR ID can be found in the first column on the “CDR” form after call disconnect)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Detailed client log (the content of your browser console) about a failed connect/register or call session (enable max log/trace level in your WebRTC client software first if it has such setting)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If the problem is with inbound call, send the SIP Call-ID of the failed incoming call or a detailed log from your SIP server which contains also the SIP signaling (enable max log/trace level in your SIP server first if possible)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>If there are multiple issues, then send the above' s separately for each issue</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Make sure that the logs were turned on when the problem happened (or reproduce the problem with the logs enabled): Control menu -> Logs -> Set -> On</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Remote desktop (RDP) </span><a href="https://www.mizu-voip.com/Support/Wiki/tabid/99/Default.aspx?topic=Remote+desktop+login"><span style='font-size:14.0pt;line-height:115%'>access</span></a><span style='font-size:14.0pt;line-height:115%'> to the machine hosting the MRTC gateway (you might need to forward the TCP and UDP 3389 if the machine if behind NAT and/or enable this port on your firewall).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>In case if you can't provide RDP access, then please send us the MRTC logs and sdf files:</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Stop the gateway first (Control menu -> Stop server ort stop the “mserver” NT service) to release the currently opened log and sdf files.</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>The SDF files can be found in app folder: mserver.sdf (usually at C:\Program Files (x86)\MRTC\ or it can be accessed from the MRTCAdmin -> File menu -> Folders -> Work directory)</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>The log files can be found in the app Logs subfolder (can be accessed also from File menu -> Folders -> Logs directory).</span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>We usually need the latest file(s) or the file which contains the failed register or call sessions.</span></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.75in;margin-bottom:.0001pt;text-indent:-.25in'><span style='font-size:14.0pt;line-height:115%;font-family:"Courier New"'>o<span style='font:7.0pt "Times New Roman"'> </span></span><span style='font-size:14.0pt;line-height:115%'>Compress the files and send as email attachment or if too large then make it available to download (using any file-sharing service)</span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><i><span style='font-size:14.0pt;line-height:115%'> </span></i></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'> </span></p> <h1 style='margin-top:0in'><a name="_Toc514216654"><span style='font-size:16.0pt; line-height:115%;font-family:"Calibri",sans-serif'>Resources</span></a></h1> <p class="MsoListParagraphCxSpFirst" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP.aspx"><span style='font-size:14.0pt'>WebRTC-SIP Gateway home page</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="https://www.mizu-voip.com/Software/WebRTCtoSIP/WebRTC-SIP-Gateway-Pricing.aspx"><span style='font-size:14.0pt'>Licensing</span></a></p> <p class="MsoListParagraphCxSpMiddle" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;text-indent:-.25in; line-height:normal'><span style='font-size:14.0pt;font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'> </span></span><a href="mailto:info@mizu-voip.com?subject=WebRTC-SIP%20Gateway"><span style='font-size:14.0pt'>Contact</span></a></p> <p class="MsoListParagraphCxSpLast" style='margin-top:0in;margin-right:0in; margin-bottom:0in;margin-left:.25in;margin-bottom:.0001pt;line-height:normal'><span style='font-size:14.0pt'> </span></p> <p class="MsoNormal" style='margin-bottom:0in;margin-bottom:.0001pt'><span style='font-size:14.0pt;line-height:115%'>Copyright © </span><span style='font-size:14.0pt;line-height:115%'>Mizutech SRL</span></p> </div>
Contents
Topics
Search
About
Features
Requirements
How It Works
Legal Agreement
Setup and configuration
Install
Configuration Wizard
SIP Server Configuration
WebRTC Client Configuration
Troubleshooting
Management and Monitoring
MizuManage
User Management
Add SIP Server
Add User
Outbound Routing
Inbound Routing
CDR
Statistics and Monitoring
Start/Stop
Backup/Restore
Additional Settings
Settings
Global Configuration
Clean Install
Domain name
SSL certificate
Change IP address
Ports
Firewall
Gateway behind NAT
Multiple SIP servers
Calls between endusers/extensions
Multiple registrations and call fork
Connecting with SIP clients
VoIP Push notifications
Webserver configuration
STUN
TURN
Codec
Transcoding
How to avoid transcoding?
Optimal codec settings
Slow call setup
Call recording
Chat recording
DTMF
Logs
Integration
Security
High availability
Feature support
Extra features
FAQ
How to get my WebRTC-SIP gateway
Can’t connect/register
Can’t make calls
Incoming calls not received
Calls are disconnecting
No voice or one side audio
Long call setup time
Chat doesn’t work
Presence doesn’t work
Video doesn’t work
DTMF doesn’t work
DTMF triggered actions
How to explicitly set the IP address used in signaling
I don’t see some calls on my SIP server
How to forward custom SIP headers
How to restrict users max concurrent calls
Call quality problems
Backup and restore
Change upper SIP server address
Advanced settings
How to upgrade?
How to get support?
Resources
About
Add SIP Server
Add User
Additional Settings
Advanced settings
Backup and restore
Backup/Restore
Call quality problems
Call recording
Calls are disconnecting
Calls between endusers/extensions
Can’t connect/register
Can’t make calls
CDR
Change IP address
Change upper SIP server address
Chat doesn’t work
Chat recording
Clean Install
Codec
Configuration Wizard
Connecting with SIP clients
Domain name
DTMF
DTMF doesn’t work
DTMF triggered actions
Extra features
FAQ
Feature support
Features
Firewall
Gateway behind NAT
Global Configuration
High availability
How to upgrade?
How It Works
How to avoid transcoding?
How to explicitly set the IP address used in signaling
How to forward custom SIP headers
How to get my WebRTC-SIP gateway
How to get support?
How to restrict users max concurrent calls
I don’t see some calls on my SIP server
Inbound Routing
Incoming calls not received
Install
Integration
Legal Agreement
Logs
Long call setup time
Management and Monitoring
MizuManage
Multiple registrations and call fork
Multiple SIP servers
No voice or one side audio
Optimal codec settings
Outbound Routing
Ports
Presence doesn’t work
Requirements
Resources
Security
Settings
Setup and configuration
SIP Server Configuration
Slow call setup
SSL certificate
Start/Stop
Statistics and Monitoring
STUN
Transcoding
Troubleshooting
TURN
User Management
Video doesn’t work
VoIP Push notifications
WebRTC Client Configuration
Webserver configuration
WebRTC SIP Gateway
