Top
DNS Behavior with Mediatrix Gateways
If the configuration of the DNS used with a Mediatrix Gateway is not done properly, it may cause delays. Therefore, understanding how DNS servers are used by the system will help to properly configure your DNS..
Up to four DNS servers can be used to resolve network names. The DNS servers can be specified statically or obtained automatically (for example through DHCP or PPP). DNS query results are cached on the system to optimise name resolution time. When the SOA record is processed, the Primary DNS server is never blacklisted when the authority server times out or fails, so the device will continue with SRV/A/AAA requests using the primary DNS server. By default, the device starts first with an NAPTR request and continues with SRV and A-Record requests. This behavior can be configured for the resolution of SIP server addresses via the SipEp.SupportedDnsQueries parameter (SIP/Misc/ DNS/Supported DNS Queries in the DGW Web interface).
Top
DNS Server Blacklisting
In the eventuality of a DNS query timing out because of a server going down or an invalid server address provided by the user, the faulty server is marked as down. It will no longer be used to issue queries for a specified period of time. The amount of time increases depending on the number of valid DNS servers which is by default: 30 seconds times the total number of valid servers. Before sending a query, the downtime for each server is checked and the blacklisting flag is removed if the time interval has been reached, making it available to send the query.
When the device is restarted, several services start before the SIP service (e.g. NTP and CWMP) which may result in the blacklisting of one more DNS servers. A blacklisted DNS server might have records for the SIP service, which are not available (for any reason) on the other listed DNS servers. In this case, the blacklisted DNS server will not be requested for SIP URLs and therefore the SIP registration might not work, until the server is removed from the blacklist. Refer to DNS Server Configuration Best Practices.
Top
DNS Server Configuration Best Practices
To avoid delays when using DNS servers with a Mediatrix gateway, follow these simple best practices:
Best Practice | Reason |
---|---|
Make sure all SIP related URLs are available on the secondary DNS servers as well. | When the device is restarted, several services start before the SIP service (eg. NTP, CWMP). A blacklisted DNS server might have records for the SIP service, which are not available (for any reason) on the other listed DNS servers. In this case, the blacklisted DNS server will be requested for SIP URLs and therefore the SIP registration might not work, until the server is unlisted. |
If handling SIP in IPv4 only, configure the SipEp.DnsIpVersion parameter (not in the Web page). For more details, refer to the DGW Configuration Guide - Reference Guide published on the Media5 Documentation Portal. | Even if we set the DNS request to Address (A) only, delays can occur because the device also does, by default, an AAAA request (IPv6). |
If your DNS server does NOT use NAPTR or DNS SRV, you should consider using SipEP.SupportedDnsQueries=Address in your configuration. | Each NAPTR and SRV request can take up to a few seconds on busy networks. This delay can be doubled if using registration with authentication. |
If you maintain your own DNS infrastructure, avoid CNAME records. |
|
Top
Configuring DNS Servers - Manually
Top
Configuring DNS Servers - Automatically
- Go to Network/Host.
- In the DNS Configuration table, from the Configuration Source selection list, choose Automatic IPv4 or Automatic IPv6 .
- Click Apply.
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.
- 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.