The generic DNS agent is compatible with other native DNS servers, providing increased flexibility and allowing communication with new types of DNS servers.
To install and configure the Generic DNS Agent:
- Install:
- Windows: Run the agent installer. There is no separate installer for the generic agent, so use the standard agent installer.
- Linux: Run the agent installer with the parameter
--generic-dns-controller.
- Install a script interpreter. We recommend using Python (version 3.8 or later) script interpreter. Micetro provides example connector scripts for Python.
- Add the
GenericDNSScriptXML tag to thepreferences.cfgfile. If the file doesn't exist, create it.Note: On Windows, thepreferences.cfgfile is located in the hidden directory C:\ProgramData\Men and Mice\DNS Server Controller. - Use the following example configuration for the Python interpreter and a
connector script located on the C drive in the scripts
sub-directory:
<GenericDNSScript value="python c:\scripts\genericDNS.py" />The genericDNS.py script implements the generic API and interfaces with the DNS server.
- Log into Micetro and add a new generic DNS server. The name and optional IP address must point to the machine running the generic DNS Agent.
Limitations
- The API does not yet support reading, modifying zone/server options, reading logs, clearing cache, or controlling the server itself.
- Depending on the connector script, only primary zones are currently supported. Secondary zones are supported for PowerDNS.
Note: The connector script can interface with a secondary zone
and return an error when Central attempts to update the zone. However, the zone
will appear as a "Primary" in Micetro.
Available connector script
A connector script is available for PowerDNS Authoritative DNS Server. For more information, refer to Integrating PowerDNS Authoritative Server with Micetro.