Installation

Overview

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

Prerequisites

Before installing Zonemaster::CLI, you should install Zonemaster::Engine.

Note: Zonemaster::Engine and Zonemaster::LDNS are dependencies of Zonemaster::CLI. Zonemaster::LDNS has a special installation requirement, and Zonemaster::Engine has a list of dependencies that you may prefer to install from your operating system distribution (rather than CPAN). We recommend following the Zonemaster::Engine installation instruction.

Prerequisite for FreeBSD is that the package system is updated and activated (see the FreeBSD section of Zonemaster::Engine installation).

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

Installation

This instruction covers the following operating systems:

• Installation on CentOS
• Installation on Debian
• Installation on FreeBSD
• Installation on Ubuntu

Installation on CentOS

1. Install binary dependencies:

   sudo yum install perl-JSON-XS
   

2. Install dependencies from CPAN:

   sudo cpanm Locale::Msgfmt Locale::TextDomain MooseX::Getopt Text::Reflow
   

3. Install Zonemaster::CLI

   sudo cpanm Zonemaster::CLI
   

Installation on Debian

1. Update configuration of "locale"

   sudo perl -pi -e 's/^# (da_DK\.UTF-8.*|en_US\.UTF-8.*|fr_FR\.UTF-8.*|nb_NO\.UTF-8.*|sv_SE\.UTF-8.*)/$1/' /etc/locale.gen
   sudo locale-gen
   

   After the update, locale -a should at least list the following locales:

   da_DK.utf8
   en_US.utf8
   fr_FR.utf8
   nb_NO.utf8
   sv_SE.utf8
   

2. Install dependencies:

   sudo apt-get install libmoosex-getopt-perl libtext-reflow-perl libmodule-install-perl
   

3. Install Zonemaster::CLI:

   sudo cpanm Zonemaster::CLI
   

Installation on FreeBSD

1. Become root:

   su -l
   

2. Install dependencies available from binary packages:

   pkg install devel/gmake p5-JSON-XS p5-Locale-libintl p5-MooseX-Getopt p5-Text-Reflow
   

3. Install Zonemaster::CLI:

   cpanm Zonemaster::CLI
   

Installation on Ubuntu

Use the procedure for installation on Debian.

Post-installation sanity check

Run the zonemaster-cli command:

zonemaster-cli --test 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?

• For a web GUI, follow the Zonemaster::Backend and Zonemaster::GUI installation instructions.
• For a JSON-RPC frontend, follow the Zonemaster::Backend installation instruction.