Top

Basic Concepts

Registration Agent

The Registration Agent is a feature that performs REGISTERs on behalf of other users.

In some use cases, using the Registration Agent may be necessary to have a separate entity perform the REGISTERs on behalf of users. For example:
  • When users cannot register themselves.
  • To separate internal and external networks in Demarcation Point scenarios
The Registration Agent is only involved with the registrations it initiates. If the Registration Agent is used, its REGISTERs are routed to the Mediatrix unit via the registration_ca Call Agent.
Top

registration_ca Call Agent

The registration_ca Call Agent is used to route the registrations issued by the Registration Agent.

The registration_ca Call Agent should not be used for other purposes. The registrations issued by the Registration Agent must be routed from the registration_ca to the Call Agent facing the destination Sip registrar (typically wan_ip_trunk_ca_ca or secondary_ip_trunk_ca).

The registration is routed using the User Name, Password and Domain to build the AOR and the R-URI . The Contact is the contact header of the registration, it should contain the IP-address or FQDN of the Mediatrix unit.



Top

Configuration Tasks

Configuring the Registration Call Agent

Associate the registration_ca Call Agent to the Registration Agent to route the registrations issued by the Registration Agent.

Steps
  1. Go to SBC/Configuration.
  2. In the Call Agent Configuration, click located on the same line as registration_ca.
  3. In the Configure Call Agent table, make sure the Enable checkbox is selected.
  4. From the Signaling Interface selection list, choose loop_s.
  5. From the Media Interface selection list, choose loop_m.
  6. In the Peer Host field, enter 127.0.0.1:5060.
  7. Click Save.
  8. Click Apply.
Result


Top

Configuring a Registration Agent

Configure the registration agent used to issue the registrations.

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 sip:myUSERNAME@%capubip(wan_ip_trunk_ca)%.
    Note: myUSERNAME must be replaced by the SIP account
    Note: %capubip(wan_ip_trunk_ca)% is a macro, which will be automatically replaced by the IP address and port and prefixed by sip:.
  5. From the Registration Type selection, make sure Normal is selected.
  6. If necessary, repeat step 2 to step 4 if you are using more than one service provider.
  7. Click Apply.
Result
Top

Configuring the wan_ip_trunk_ca Call Agent

Associate the Call Agent used to route VoIP Calls to the ITSP.

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. In the Call Agent Rulesets table, click .
  6. From the Name selection list, choose uac_authentication_out.
    Note: If the ruleset is not in the selection list, it is because it was removed and you will need to import the latest Ruleset package.
  7. In the Parameters field enter USERNAME=your_username PASSWORD=your_password corresponding to the username and password used for authentication.
    Note: The parameters are case sensitive and are separated by a space.
  8. Click Save.
  9. Click Apply to apply all changes to the configuration.
Result
Once the settings are applied, the Configuration Modified field will change to No 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. The uac_authentication_out Call Agent Ruleset will handle the digest authentication, with the “USERNAME” and “PASSWORD” parameters.

Top

Associating the registration_to_wan_ip_trunk Routing Ruleset to your Configuration

Configure the route to send SIP registrations to the ITSP.

Steps
  1. Go to SBC/Configuration.
  2. Click .
  3. In the Routing Rulesets table, from the Name selection list, select registration_to_wan_ip_trunk.
    Note: If the ruleset is not in the selection list, it is because it was removed and you will need to import the latest Ruleset package.
  4. Click Save.
  5. Click Apply to apply all changes to the configuration.
Result


Top

Online Help

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 bedisplayed.

Top

DGW Documentation

Mediatrix devices are supplied with an exhaustive set of documentation.

Mediatrix user documentation is available on the Media5 Documentation Portal.

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

Copyright Notice

Copyright © 2023 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.