Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Once you have installed the NetBorder Call Analyzer and started the service, you should place an outbound call to verify that a call is successfully put through, and that call progress analysis is functioning and returning the expected results. 

This chapter assumes that the NetBorder Call Analyzer software has been successfully installed on your system.   For installation procedures, please proceed to the Installation section

NCA User Guide

Prerequisites to making a test SIP call

To make a test SIP call, you will need the following:

  • PC-based softphone, which provides the same functionality as a typical handset and integrates with other multi-service applications such as web browsing and instant messaging; examples include the Kapanga Softphone and the CounterPath X-Lite. 

    Note: 

    If you do not have a softphone, both of the products listed above are available for download at the URIs provided. For the purposes of this test, you will be making a SIP to SIP call; therefore, you will need two softphones, one on your system, and another installed on a different system (the callee). 

  • Full-duplex sound card.    

  • Speakers and microphone, or a headset.    

  • Connection to an IP network.    

You will also need to configure the softphone to use NetBorder Call Analyzer as an outbound proxy.  Refer to the Configuration Section

Configuring as an Outbound Proxy

By default, the NetBorder Call Analyzer is configured to serve as an outbound proxy. Before making your test call, you will need to configure your softphone to route calls through NetBorder. 

The following steps feature X-Lite. Configuration of other softphones will follow the same general procedures.

The step to use the NetBorder Call Analyzer is to make sure you can use it in your own environment. To do so, the setup illustrated below should be used. Note that the caller softphone, on your left, is located on its own computer with a different IP address than the NCA, in the center and the called softphone, on your right. It would also be possible to use the same computer for the caller softphone and the NCA, but the callee should be on its own computer. 

To set up proxy configuration parameters:

  1. Access the soft phone’s SIP Account settings menu

  2. Depending on the soft phone you are using (for example, X-Lite), add a new profile.

  3. Enter the required SIP Proxy settings:

  • Domain: Used to form all destination URIs when a telephone number is entered without specifying the domain explicitly.

  • Proxy usage mode: “Outbound Proxy” or “Strict Outbound Proxy”, depending on the softphone used.

  • Outbound proxy Address: The full SIP URI of the outbound proxy. This URI should consist of the “sip:” prefix, followed by the IP address of the proxy, and the port number (“5062” for NetBorder Call Analyzer).

     

For example: sip:192.168.11.173:5062. 

NOTE

When using “5062” as the listening port for NetBorder, it is important not to run any other application that may cause conflict on that port (such as a SIP phone). In general, SIP phones use “5060” as the

default listening port. 

By configuring the softphone to use an outbound proxy, the softphone will initiate all its SIP communication through the outbound proxy; that is, the callee’s SIP URI will be processed by NetBorder. In other words, all SIP requests and responses will be sent through NetBorder. 

Making a Call Without NCA

To further verify the NetBorder Call Analyzer installation, you should place an outbound call to ensure that it is put through and you receive valid results.

Based on the SIP INVITE arguments that are received by NetBorder, the call progress analysis can be activated or deactivated. If no arguments are present, the call is placed without call progress analysis.

Once an outbound call has been placed, NetBorder receives the request and re- originates the outbound call towards the VoIP provider network. Thus, NetBorder is acting as a User Agent Server (UAS). To answer the incoming SIP request, NetBorder will act as a User Agent Client (UAC),regenerate the SIP request, and send it over the network.

Again, the following steps feature X-Lite. Other softphones will follow the same general procedures. 

To initiate an outbound call:

  1. start your soft phone application

  2. Place a call using the soft phone. Enter the phone number in the “CallTo”  field using dotted notation, as follows:

    sip:[phone number or extension]@[IP address]:[port] 
    For example: sip:1024@192.168.11.103:5061.    

    In the example above, X-Lite is being used to call the telephone extension “1024”, reachable via the PSTN gateway at 192.168.11.103:5061.

     

     

  3. Place the call. If you are using X-Lite, press Enter or click the green telephone icon in the left side of the application

  4. Verify that you hear a ringing tone and ultimately, once the call is connected, audio on the other end 

  5. Interact with the application to verify that audio is coming through on both ends of the call

    Note: If you fail to hear audio, your firewall may be preventing calls from being put through. Also, if the call is established successfully and no audio is heard, the firewall may be blocking the media (RTP) packets. Try disabling your firewall.

  6. When finished, hang up.  If you are using X-Lite, click the red telephone icon on the right side of the application 

  7.  

If you wish, you can view SIP messages related to the call to verify that you have received the expected results. The call-log files are located in the following directory: 
●[NETBORDER_INSTALLDIR]\logs\call-logs where [NETBORDER_INSTALLDIR] is the root folder of the installation (for example, C:\Program Files\Sangoma NetBorder Platform 2.0\logs\call-logs).  By default, call-log files are saved in subdirectories based on date and time. 
 

Making a Call With NCA

Now place an outbound call with CPA on to verify that call progress analysis is functioning properly and returning useful results. The CPA scenario is triggered by placing “ ;cpd=on ” in the SIP Invite. Therefore, this process is very similar to the previous procedure, except that you add “ ;cpd=on ” to the phone number you are dialing. 

To initiate an outbound call with CPA:    

  1. Start your soft phone application.

  2. Place a call using the soft phone.  Enter the phone number in the “Call To” field using dotted notation, as follows:

     sip:[phone number or extension]@[IP address]:[port] 

    For example: sip:1024@192.168.11.103:5061.

  3. Append the following to the phone number you entered: “;cpd=on”.

    For example: sip:1024@192.168.11.103:5061; cpd=on.

  4. Place the call. 

  1. Verify that you hear a ringing tone and ultimately, once the call is connected, audio on the other end.

  2. Interact with the application to verify that audio is coming through on both ends of the call.

  3. When finished,hangup.

    If you are using X-Lite, click the red telephone icon on the right side of the application.

    If you receive an error message, such as a “Decline” message from the softphone application, see What to do if a call is not connected on page 43.

  4. Now take a look at the call-log files to verify the results of the call and particularly of the call progress analysis. 

Do the following:
a) Open the call-log files located in the following directory:

● [NETBORDER_INSTALLDIR]\logs\call-logs

      where [NETBORDER_INSTALLDIR] is the root folder of the installation
      (for example, C:\Program Files\Sangoma NetBorder Platform 2.0\logs\call-logs).

By default, call-log files are saved in subdirectories based on date and time.

b) Take a look at both the SIP request and SIP response messages. Conduct a search for the following:

    ●   “CPD-Result” in the .log file: For the result of the call progress analysis 
          (for example, “CPD-Result: Voice” in a SIP response header).

   ●  “CPA” in the .analyzer-engine.log file: To locate information such as the degree of certainty 
        (expressed in decimal percentages) of the NCA result. For example:

 CPA_HUMAN=0.710736
 CPA_MACHINE=0.150314 
 CPA_FAX=0.13895 

  • No labels