/ 
Zonemaster-Engine-v3.0.3
River stage one • 2 direct dependents • 2 total dependents
⭐ Starred 34 GitHub stars
/ docs/Installation.md

Installation

This document describes prerequisites, installation, post-install sanity checking for Zonemaster::Engine, and rounds up with a few pointer to interfaces for Zonemaster::Engine. For an overview of the Zonemaster product, please see the main Zonemaster Repository.

Prerequisites

For details on supported operating system versions and Perl verisons for Zonemaster::Engine, see the declaration of prerequisites.

Installation

This instruction covers the following operating systems:

Installation on CentOS

  1. Install the EPEL 7 repository:

    sudo yum --enablerepo=extras install epel-release

  2. Make sure the development environment is installed:

    sudo yum groupinstall "Development Tools"

  3. Install binary packages:

    sudo yum install cpanminus libidn-devel openssl-devel perl-Clone perl-core perl-Devel-CheckLib perl-File-ShareDir perl-File-Slurp perl-IO-Socket-INET6 perl-JSON-PP perl-List-MoreUtils perl-Module-Find perl-Moose perl-Net-IP perl-Pod-Coverage perl-Readonly-XS perl-Test-Differences perl-Test-Exception perl-Test-Fatal perl-Test-Pod perl-YAML

  4. Install packages from CPAN:

    sudo cpanm Locale::Msgfmt Locale::TextDomain Mail::RFC822::Address Module::Install Module::Install::XSUtil Test::More Text::CSV

  5. Install Zonemaster::LDNS and Zonemaster::Engine:

    sudo cpanm Zonemaster::LDNS Zonemaster::Engine

Installation on Debian

  1. Refresh the package information

    sudo apt update

  2. Install dependencies from binary packages:

    sudo apt install autoconf automake build-essential cpanminus libclone-perl libdevel-checklib-perl libfile-sharedir-perl libfile-slurp-perl libidn11-dev libintl-perl libio-socket-inet6-perl libjson-pp-perl liblist-moreutils-perl liblocale-msgfmt-perl libmail-rfc822-address-perl libmodule-find-perl libmodule-install-xsutil-perl libmoose-perl libnet-ip-perl libpod-coverage-perl libreadonly-xs-perl libssl-dev libtest-differences-perl libtest-exception-perl libtest-fatal-perl libtest-pod-perl libtext-csv-perl libtool m4

  3. Install dependencies from CPAN:

    sudo cpanm Module::Install Test::More

  4. Install Zonemaster::LDNS and Zonemaster::Engine:

    sudo cpanm Zonemaster::LDNS Zonemaster::Engine

Installation on FreeBSD

  1. Become root:

    su -l

  2. Update list of package repositories:

    Create the file /usr/local/etc/pkg/repos/FreeBSD.conf with the following content, unless it is already updated:

    FreeBSD: {
url: "pkg+http://pkg.FreeBSD.org/${ABI}/latest",
}

  3. Check or activate the package system:

    Run the following command, and accept the installation of the pkg package if suggested.

    pkg info -E pkg

  4. Update local package repository:

    pkg update -f

  5. Install dependencies from binary packages:

    pkg install libidn p5-App-cpanminus p5-Clone p5-Devel-CheckLib p5-File-ShareDir p5-File-Slurp p5-IO-Socket-INET6 p5-JSON-PP p5-List-MoreUtils p5-Locale-libintl p5-Locale-Msgfmt p5-Mail-RFC822-Address p5-Module-Find p5-Module-Install p5-Module-Install-XSUtil p5-Moose p5-Net-IP p5-Pod-Coverage p5-Readonly-XS p5-Test-Differences p5-Test-Exception p5-Test-Fatal p5-Test-Pod p5-Text-CSV

  6. Install Zonemaster::LDNS and Zonemaster::Engine:

    cpanm Zonemaster::LDNS Zonemaster::Engine

Installation on Ubuntu

Use the procedure for installation on Debian.

Post-installation sanity check

Make sure Zonemaster::Engine is properly installed.

time perl -MZonemaster::Engine -E 'say join "\n", Zonemaster::Engine->test_module("BASIC", "zonemaster.net")'

The command is expected to take a few seconds and print some results about the delegation of zonemaster.net.

What to do next