/ 
Zonemaster-Engine-v2.0.1
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. Make sure the development environment is installed.

    sudo yum groupinstall "Development Tools"

  2. Install binary packages.

    sudo yum install perl-core perl-ExtUtils-MakeMaker perl-File-ShareDir perl-File-Slurp perl-IO-Socket-INET6 perl-JSON-PP perl-List-MoreUtils perl-Readonly perl-Time-HiRes perl-YAML libidn-devel perl-Devel-CheckLib openssl-devel perl-Test-Fatal

  3. Install packages from CPAN.

    If it's the first time you use the CPAN module, it will ask some questions. For the first and third, the default responses are fine. For the second, answer "sudo" (the default is "local::lib", which you do not want).

    sudo cpan -i Locale::TextDomain Hash::Merge Net::IP::XS Zonemaster::LDNS Moose

  4. Install Zonemaster::Engine

    sudo cpan -i Zonemaster::Engine

    If necessary, answer any questions from the cpan script by accepting the default value (just press enter).

Installation on Debian

  1. Install dependencies from binary packages:

    sudo apt-get install build-essential libidn11-dev libfile-sharedir-perl libfile-slurp-perl libhash-merge-perl libio-socket-inet6-perl liblist-moreutils-perl libmail-rfc822-address-perl libmodule-find-perl libmoose-perl libnet-ip-perl libreadonly-xs-perl libtext-csv-perl libssl-dev libdevel-checklib-perl

  2. Install dependencies from CPAN:

    sudo cpan -i Locale::TextDomain Zonemaster::LDNS

    Note: If necessary, answer any questions from the cpan program by accepting the default value (just press enter).

    Note: libidn must be installed prior to Zonemaster::LDNS, or otherwise Zonemaster::LDNS will be installed without IDN support.

  3. Install Zonemaster::Engine:

    sudo cpan -i Zonemaster::Engine

Installation on FreeBSD

  1. Become root:

    su -l

  2. Install dependencies from binary packages:

    pkg install libidn p5-File-ShareDir p5-File-Slurp p5-Hash-Merge p5-IO-Socket-INET6 p5-List-MoreUtils p5-Locale-libintl p5-Mail-RFC822-Address p5-Module-Find p5-Moose p5-Net-IP p5-Readonly-XS p5-Text-CSV

  3. Install dependencies from CPAN:

    cpan -i Zonemaster::LDNS

    Note: If necessary, answer any questions from the cpan program by accepting the default value (just press enter).

    Note: libidn must be installed prior to Zonemaster::LDNS, or otherwise Zonemaster::LDNS will be installed without IDN support.

  4. Install Zonemaster::Engine:

    cpan -i 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 'print map {"$_\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

Copyright (c) 2013 - 2017, IIS (The Internet Foundation in Sweden)
Copyright (c) 2013 - 2017, AFNIC
Creative Commons Attribution 4.0 International License

You should have received a copy of the license along with this work. If not, see https://creativecommons.org/licenses/by/4.0/.