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 upadated 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:

• CentOS
• Debian
• FreeBSD
• Ubuntu

1. CentOS

Install Zonemaster::CLI

sudo cpanm Zonemaster::CLI

2. Debian

Install dependencies:

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

Install Zonemaster::CLI:

sudo cpanm Zonemaster::CLI

3. FreeBSD

Become root:

su -l

Install dependencies available from binary packages:

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

Install Zonemaster::CLI:

cpanm Zonemaster::CLI

4. 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.

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 http://creativecommons.org/licenses/by/4.0/.