Skip to end of metadata
Go to start of metadata

Download PDF Document



2019-08-29
For Sentinel units
45.0.1809
Top

1 PSTN Survivability

This use case describes the configuration of PSTN Survivability with the Mediatrix unit located in the LAN or on the Edge . When PSTN survivability is configured it implies that:

  • The Mediatrix unit is setup as a demarcation point.
  • When SIP trunk fails, calls go through the unit PSTN port.
  • The Mediatrix unit may or may not register to the SIP trunk.
  • The Mediatrix unit is located either:
    • on the EDGE of the Internet with one interface in the LAN and one on the Internet
    • in the LAN, behind a Near-End NAT

Important

If the Sentinel SBC is located on the EDGE, it is important to configure the local firewalls. Refer to the DGW Configuration Guide - Configuring the Network Firewall , published on the Media5 documentation portal https://documentation.media5corp.com/

The SBC service allows the IP PBX to use the Mediatrix LAN port as an outbound proxy, while the Mediatrix can use the Uplink port to reach the SIP server. For this scenario, the following call agents re used:

  • Registration_ca ---- The registration_ca Call Agent is used to route the registrations issued by the Registration Agent.
  • trunk_lines_ca ---- The trunk_lines_ca Call Agent is used to route calls to the Public Switch Telephony Network (PSTN) or a enterprise's existent PBX through the PRI, BRI, FXS or FXO ports of the unit.
  • lan_ip_pbx_ca ---- The lan_ip_pbx_ca Call Agent routes calls to and from an IP PBX located in the LAN.
  • wan_ip_trunk_ca ---- Call Agent is used to route VoIP calls. Calls are routed from or to the main SIP server or provider located in the WAN.

Top

1.1 Importing Rulesets

Before You Start
Rulesets must be imported. The latest Ruleset package can be found at https://media5.secure.force.com/supportportal (you will be required to supply a user name and password).
Context
Steps
  1. Go to Management /File .
  2. Click Activate unsecure file importation from the Web browser .

    Note

    Step 2 is only required when importing the first Ruleset and if you are not using a secure connection to access the Management Interface (http://).

  3. From the Path field, select sbc/rulesets/.
  4. Click Browse , and navigate to the Ruleset you wish to import, i.e.
    1. rate_limit_invite_per_source_in.crs
    2. automatic_media_relay.crs
    3. lan_pbx_to_wan_ip_trunk_failover_to_trunk_dm.rrs
    4. trunk_lines_to_local_pbx_dm .rrs
    5. wan_ip_trunk_to_lan_pbx.rrs
    6. registration_to_wan_ip_trunk.rrs

    Note

    Ruleset file extension must be *.crs for Call Agent Rulesets or *.rrs for Routing Rulesets.

  5. Click Import .
Result
The imported Ruleset will appear in the Internal files table, with the selected path in front of the name. The Ruleset will be available in the tables of the SBC /Rulesets page.

Next Step

1.2 Configuring the wan_ip_trunk_ca Call Agent
Top

1.2 Configuring the wan_ip_trunk_ca Call Agent

Before You Start
Importing Rulesets must be completed for Call Agent Rulesets to be available.
Context
If you are not familiar with the meaning of the fields and buttons, click Show Help , located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will be displayed.
Steps
  1. Go to SBC /Configuration .
  2. Select the Enable check box, located next to wan_ip_trunk_ca .
  3. In the Call Agent Configuration table, click next to wan_ip_trunk_ca .
  4. In the Configure Call Agent table, complete the following fields:
    1. From the Signaling Interface selection list, select uplink_s .
    2. From the Media Interface selection list, select uplink_m .
    3. Set the Peer Host to the IP address of the service provider server or FQDN.
  5. Set the Keep-Alive Interval field to 30.
  6. Set the Blacklisting Duration to 60.
  7. In the Call Agent Rulesets table, click .

    Note

    Steps 8 and 9 are mandatory only if the Sentinel registers to the SIP provider

  8. If the service provider is challenging for a password, from the Name selection list, choose uac_authentication_out .
  9. In the Parameters column of the uac_authentication_out row add the username and password (used by the Sentinel to register to the SIP provider).

    Note

    Format used must be USERNAME=your_username PASSWORD=your_password

  10. Click
  11. From the Name selection list, choose rate_limit_invite_per_source_in .
  12. Click
  13. From the Name selection list, choose automatic_media_relay .
  14. Click Save .
  15. Click Apply to apply all changes to the configuration.
  16. Click Apply to apply all changes to the configuration.
Result
No will be displayed in the Config. Modified field, indicating that the configuration that was modified is now applied to the system. When the Mediatrix SBC will use the selected Call Agent for a communication, the selected parameters will be applied.

Next Step

1.3 Configuring the lan_ip_pbx_ca Call Agent
Top

1.3 Configuring the lan_ip_pbx_ca Call Agent

Before You Start
Importing Rulesets must be completed for Call Agent Rulesets to be available.
Context
If you are not familiar with the meaning of the fields and buttons, click Show Help , located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will be displayed.
Steps
  1. Go to SBC /Configuration .
  2. Select the Enable check box located next to lan_ip_pbx_ca .
  3. In the Call Agent Configuration table, click next to lan_ip_pbx_ca .
  4. In the Configure Call Agent table, complete the fields as follows:
    1. From the Signaling Interface selection list, select lan1_s .
    2. From the Media Interface selection list, select lan1_m .
    3. Set the Peer Host to IP address of the IP PBX.
  5. Click Save .
  6. Click Apply to apply all changes to the configuration.
Result
No will be displayed in the Config. Modified field, indicating that the configuration that was modified is now applied to the system. When the Mediatrix SBC will use the selected Call Agent for a communication, the selected parameters will be applied.

Next Step

1.4 Configuring a Registration Agent
Top

1.4 Configuring a Registration Agent

Context

Note

This procedure is only necessary if your Mediatrix unit registers to the service provider.

Steps
  1. Go to SBC /Registration .
  2. In the Registration Agent Configuration table, click .

    Note

    A new line of fields is added.

  3. Complete the User Name , Friendly Name , and Domain parameters fields according to the service provider's requirements.
  4. In the Contact field, enter credentials to register against the service provider.

    Note

    Format must be sip:user@public_IP Address or sip:public_IP Address or sips:user@public_IP_Address:sip listening port;uri-parameters of the unit.

  5. If necessary, repeat step 2 to step 4 if you are using more than one service provider.
  6. Click Apply .
Result

Next Step

1.5 Associating Routing Rulesets to Your Configuration
Top

1.5 Associating Routing Rulesets to Your Configuration

Before You Start
Importing Rulesets must be completed for Routing Rulesets to be available.
Steps
  1. Go to SBC /Configuration
  2. In the Routing Rulesets table, from the Name selection list, select lan_pbx_to_wan_ip_trunk_failover_to_trunk_dm .
  3. Click .
  4. From the Name selection list, select trunk_lines_to_local_pbx_dm .
  5. Click .
  6. From the Name selection list, select wan_ip_trunk_to_lan_pbx .
  7. Click .
  8. If the Mediatrix SBC Registers to the Service Provider, from the Name selection list, select registration_to_wan_ip_trunk .
  9. Click Save .
  10. Click Apply to apply all changes to the configuration.
Result

Next Step

1.6 Configuring the IP PBX
Top

1.6 Configuring the IP PBX

Context
The IP PBX server is configured with the IP address and port of the Mediatrix SBC lan1_s Signaling Interface. The Mediatrix unit must be configured in the PBX as a SIP Trunk.

Next Step

1.7 Creating a Route - PSTN Telephones
Top

1.7 Creating a Route - PSTN Telephones

Steps
  1. Go to Call Router /Route Config .
  2. In the Routes table,
    • click located on the same row as an existing route to add a route above or,
    • click located at the bottom of the table to add a route at the end of the table.
  3. Set the Sources field to sip-trunk_lines_gw .
  4. Set the Destination field to PSTN .
  5. Leave the other fields empty.
  6. Click Save .
  7. Repeat steps 2 to 7 for the other routes.
Result

In a normal scenario, when the SIP server is available, the call comes from the lan_ip_pbx_ca Call Agent and goes to the wan_ip_trunk_ca Call Agent.

In a survivability scenario, when the call comes from the lan_ip_pbx_ca Call Agent, the wan_ip_trunk_ca Call Agent is blacklisted, meaning that the SIP server is unreachable, the call will be routed to trunk_lines_ca Call Agent that is assosiacted with the trunk_lines_gw gateway. The route then will be configured in the Destination field.

The blacklisted duration will depend on the Monitoring and Blacklisting Duration parameters configured under wan_ip_trunk_ca Call Agent.

Top

2 DGW Documentation

Mediatrix units are supplied with an exhaustive set of documentation.

Mediatrix user documentation is available on the Documentation Portal at http://documentation.media5corp.com

Several types of documents were created to clearly present the information you are looking for. Our documentation includes:

  • Release notes : Generated at each GA release, this document includes the known and solved issues of the software. It also outlines the changes and the new features the release includes.
  • Configuration notes : These documents are created to facilitate the configuration of a specific use case. They address a configuration aspect we consider that most users will need to perform. However, in some cases, a configuration note is created after receiving a question from a customer. They provide standard step-by-step procedures detailing the values of the parameters to use. They provide a means of validation and present some conceptual information. The configuration notes are specifically created to guide the user through an aspect of the configuration.
  • Technical bulletins : These documents are created to facilitate the configuration of a specific technical action, such as performing a firmware upgrade.
  • Hardware installation guide : They provide the detailed procedure on how to safely and adequately install the unit. It provides information on card installation, cable connections, and how to access for the first time the Management interface.
  • User guide : The user guide explains how to customise to your needs the configuration of the unit. Although this document is task oriented, it provides conceptual information to help the user understand the purpose and impact of each task. The User Guide will provide information such as where and how TR-069 can be configured in the Management Interface, how to set firewalls, or how to use the CLI to configure parameters that are not available in the Management Interface.
  • Reference guide : This exhaustive document has been created for advanced users. It includes a description of all the parameters used by all the services of the Mediatrix units. You will find, for example, scripts to configure a specific parameter, notification messages sent by a service, or an action description used to create Rulesets. This document includes reference information such as a dictionary, and it does not include any step-by-step procedures.

Top

3 Copyright Notice

Copyright © 2019 Media5 Corporation.

This document contains information that is proprietary to Media5 Corporation.

Media5 Corporation reserves all rights to this document as well as to the Intellectual Property of the document and the technology and know-how that it includes and represents.

This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.

Media5 Corporation reserves the right to revise this publication and make changes at any time and without the obligation to notify any person and/or entity of such revisions and/or changes.

Top