DNSCheck from IIS and Zonecheck from AFNIC are two different software packages that do DNS validation of the quality of a DNS delegation. AFNIC and IIS decided to develop a new DNS validation tool from the scratch under the name "Zonemaster".
The Zonemaster implementation intends to be a major rewrite of the existing DNS validation tools developed by AFNIC (Zonecheck) and IIS (DNSCheck), and implement the best parts of both.
The components developed as part of the Zonemaster project will help different types of users to check domain servers for configuration errors and generate a report that will enable to fix the errors.
The ambition of the Zonemaster project is to develop and maintain an open source DNS validation tool, offering better performance than the existing tools and provide extensive documentation which could be re-used by similar projects in the future.
The repository you are looking at is the main project repository. In this repository, documentation regarding the design, requirements and specifications for the zonemaster implementation are available.
Also, in this repository, you can find a brief user guide.
Zonemaster comes with documentation for and has been tested on the operative systems and processor architecture listed below.
- x86_64 / amd64
- CentOS 7
- Debian 7
- (Debian 8)
- (Debian 9)
- FreeBSD 10.3
- FreeBSD 11.1
- Ubuntu 14.04
- Ubuntu 16.04
Currently, Debian 8 and Debian 9 are not supported due to a known bug in Zonemaster::LDNS, see Zonemaster-LDNS issue 10 and Zonemaster-LDNS issue 30. That has to be resolved before we can include support for Debian 8 and Debian, respectively.
| Operating System | MySQL | PostgreSQL |
|---|---|---|
| CentOS 7 | 5.6 | 9.3 |
| Debian 7 | 5.5 | 10.1 |
| FreeBSD 10.3 | 5.6 | 9.5 |
| FreeBSD 11.1 | 5.6 | 9.5 |
| Ubuntu 14.04 | 5.5 | 9.3 |
| Ubuntu 16.04 | 5.7 | 9.5 |
Zonemaster Backend has been tested with the combination of OS and database engine version listed in the table above. Other versions of the database engines might work. PostgreSQL version 9.2 or earlier will NOT work.
| Operating System | Perl |
|---|---|
| CentOS 7 | 5.16 |
| Debian 7 | 5.14 |
| FreeBSD 10.3 | 5.24 |
| FreeBSD 11.1 | 5.24 |
| Ubuntu 14.04 | 5.18 |
| Ubuntu 16.04 | 5.22 |
Zonemaster has been tested with the combination of OS and Perl version listed in the table above. Other versions of Perl might work. Perl versions earlier than 5.14.2 will NOT work.
Zonemaster comes with localization for these locales:
- en.UTF-8
- fr.UTF-8
- sv.UTF-8
- da.UTF-8 (*)
*) Some strings have not yet been translated to Danish.
The Zonemaster Product consists of the main part and five components. The main part consists of specifications and documentation for the Zonemaster product, and is stored in main Zonemaster Github repository (zonemaster).
All the software for the Zonemaster project belong to the five components, each component being stored in its own Github repository (listed below).
The software has not yet been packaged for any operating systems, and you have to install most of it from the source code. The recommended method is to install from CPAN, but it is possible to install directly from clones of the Github repositories.
The Zonemaster Product includes the following components:
- zonemaster-ldns - A fork of of ldns with a Perl frontend used by zonemaster-engine.
- zonemaster-engine - The Zonemaster test library.
- zonemaster-cli - A Command Line Interface (CLI) to the test library (zonemaster-engine).
- zonemaster-backend - A JSON/RPC interface with database to the test library (zonemaster-engine).
- zonemaster-gui - A web user interface to the test library via zonemaster-backend.
To install Zonemaster, start with installation of zonemaster-engine (which will draw in Zonemaster-LDNS) and then continue with the other parts. You will find installation instructions from the links above.
Go to the release list of this repository to find the latest version of Zonemaster and the versions of the specific components. Be sure to read the release note of each component before installing or upgrading.
The core development team are people from IIS and Afnic. However, you can submit code by forking this repository and creating pull requests. When you create a pull request, please select the "develop" branch in the relevant Zonemaster repository.
You can follow the project in these two mailinglists:
For bug reporting go to the relevant Zonemaster repository and create a Github issue there. Before creating the issue, please search for the problem in the issue tracker in the relevant repository, and if you find an open issue covering your issue, please add a comment with additional information, if any.
- Issues in Zonemaster::LDNS
- Issues in Zonemaster::Engine
- Issues in Zonemaster::CLI
- Issues in Zonemaster::Backend
- Issues in zonemaster::GUI
If you cannot determine which repository to create the issue in, please select the main zonemaster repository, i.e. general issues in Zonemaster.
- Selecting language in Zonemaster CLI tool
zonemaster-clisometimes does not work, see issues dotse/zonemaster-cli#46 and dotse/zonemaster-cli#64. - Selecting language in Zonemaster Backend RPC API under FreeBSD does not work, see issue dotse/zonemaster-backend#315.
- Zonemaster-GUI version v1.0.10 fixes a vulnerability in non-Javascript GUI. This is part of Zonemaster version v2017.4.1.
- Zonemaster-GUI version v1.0.11 fixes a vulnerability in GUI. This is part of Zonemaster version v2017.4.2.
For contacting the Zonemaster project, please send a mail to "contact@zonemaster.net".