Dialogic Support Helpweb
Dialogic® Host Media Processing (HMP) Software
Using Dialogic® Diva® SIPcontrol™ with Dialogic® Host Media Processing (HMP) Software
Introduction:
Dialogic® Diva® SIPcontrol™ software allows an application to control Dialogic® Diva® BRI, Dialogic® Diva® PRI, and Dialogic® Diva® analog cards via an IP call connection. When coupled with Dialogic® HMP software, this allows a powerful "thin blade" functionality for interfacing the Dialogic® HMP IP Calls to the PSTN connections on Dialogic® Diva® Server Cards. This note will provide some helpful hints to establish this configuration.
Installation:
Both Dialogic HMP software and Diva SIPcontrol software have their own installations. The Diva SIPcontrol software will need to detect the Licenses that are enabled inside Dialogic HMP software in order to fully enable itself. This being the case, the following is the recommended install procedure:
- Install Dialogic HMP software
- Configure the Dialogic HMP software and enable the Licenses
- Install the Dialogic® Diva® SDK software
- Configure the Dialogic® Diva® Server Adapters for the PSTN interface
- Install Diva SIPcontrol Software
Port Usage:
The way that the Diva SIPcontrol software works is that it will open 2 ports to use for inbound and outbound traffic. To avoid conflict, and by default, the Diva SIPcontrol service will use 9801 (outbound) and 9803 (inbound). This port selection can be modified inside the .xlm file located inside the diva server install directory, but it is recommended that you only change them if there is a direct conflict.
The Dialogic HMP software will default to 5060 for the SIP signaling. This is configurable inside the GCStart structure, if it is determined there is a need to change.
License Requirements:
For this type of installation, all calls will come in via the PSTN and be forwarded to Dialogic HMP software, with all call flow handled on the HMP side. Therefore, you are required to have IP Call control Licenses and enough media devices to handle the inbound calls. For the Diva SIPcontrol software side, if there are HMP licenses enabled, it will match that license density, so there should be no need for additional SIPcontrol licensing.
How it works:
The way that the Diva SIPcontrol software works is that it will translate the PSTN call control to IP call control. The service in essence turns the Dialogic® Diva® Adapter and software into a PSTN to IP gateway that is collocated inside the box.
Inbound Call Flow:
- Inbound call is detected on the PSTN by the Diva Adapter
- CallerID information is processed if available and the routing rules are applied
- Outbound call is made to the HMP stack (CALLERID@127.0.0.1:5060) by default.
- HMP answers the call
- Diva Adapter answers the PSTN Call
Outbound Call:
- 1. Dialogic HMP software places an outbound call to the Diva SIPcontrol service with the "number to be called" on the PSTN (Numbertobecalled@127.0.0.1:9803)
- 2. Diva SIPcontrol software detects this call and extracts out the "number to be called"
- 3. Diva Adapter attempts to make a call to the "number to be called"
- PSTN call is conntected
- Diva SIPcontrol software Connects HMP call
Helpful Hints:
- If there are multiple NICs inside the system that you are using, you may need to use the IP address for the machine rather then the loopback address (ie the call may need to go to NUMBERTOBECALLED@<ip address> rather then NUMBERTOBECALLED@127.0.0.1
- By default, Diva SIPcontrol software only supports G.711 on the RTP leg, so make sure you have that selected as one of the coders on the HMP side or else the calls will fail.
- You can test inbound and outbound functionality by using one of the Dialogic HMP software demos. No changes should be needed by default on the inbound side; for the outbound side, set the outbound IP address to NUMBERTOBECALLED@127.0.0.1 (or IP address rather then Loopback).
- Because the IP call is taking place back-to-back in the same box, you will not be able to capture the call control and RTP via network monitoring tools such as Ethereal or Wireshark. If you are interested in the message contents, you will have to obtain this via tracing on either end.
- By default you should not have to modify any of the Diva SIPcontrol software files. If you change the default IP addressing or port usage, you may need to modify this .xml file to get calls to connect. There are 2 .xml files:sipcontrol-0.xml and sipcontrol-xml. . The -0 file is used to control the PSTN->SIP leg and the -1 is the SIP-PSTN side. . If you do make changes to this file , make sure you restart the SIPCONTROL service via control panel.
Dialogic® Diva® SIPcontrol™ software V1.5
Dialogic® Diva® Server 8.x
Dialogic® HMP software 2.0 and 3.x
Glossary of Acronyms / Terms
HMP - Dialogic Host Media Processing Software
PSTN- Public Switched Telephone Network
SIP- Session Initiation Protocol
Related Documentation
Please refer to the Dialogic® Diva® SIPcontrol™ Product documentation or installed online help.
