view release on metacpan or  search on metacpan

docs/installation.md  view on Meta::CPAN

# Zonemaster Engine installation guide

This is the installation instructions for the Zonemaster Engine perl
module. For an overview of the Zonemaster components, please see the
[Zonemaster repository](https://github.com/dotse/zonemaster).

>
> The Engine Perl module name is 'Zonemaster'.
>


This section covers the following operating systems:

 * [2] <a href="#Debian">Ubuntu 14.04 (LTS))</a>
 * [3] <a href="#Debian">Debian Jessie (version 8) - 64 bits</a>
 * [4] <a href="#FreeBSD">FreeBSD 10.1</a>
 * [5] <a href="#CentOS">CentOS 7 - 64 bits</a>

>
> Note: We assume the installation instructions will work for earlier OS
> versions too. If you have any issue in installing the Zonemaster engine with
> earlier versions, please send a mail with details to contact@zonemaster.net
>

To install the engine, one installs the dependecies for the chosen OS and then
finally install the engine itself. 

## <a name="Debian"></a> Debian & Ubuntu

1) Make sure the package database is up to date.

```sh
sudo apt-get update
```

2) Install all necessary packages.

```sh
sudo apt-get install build-essential libfile-slurp-perl libjson-perl liblist-moreutils-perl libio-socket-inet6-perl libmodule-find-perl libmoose-perl libfile-sharedir-perl libhash-merge-perl libreadonly-perl libmail-rfc822-address-perl libintl-xs-per...
```

3) Install the Zonemaster engine

```sh
sudo cpan -i Zonemaster
```

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

## <a name="FreeBSD"></a> FreeBSD 

1) Become root.

```sh
su
```

2) Install all necessary packages

```sh
pkg install libidn p5-Devel-CheckLib p5-MIME-Base64 p5-Test-Fatal p5-JSON-PP p5-IO-Socket-INET6 p5-Moose p5-Module-Find p5-JSON p5-File-ShareDir p5-File-Slurp p5-Mail-RFC822-Address p5-Hash-Merge p5-Time-HiRes p5-Locale-libintl p5-Readonly-XS p5-Tie-...
```

3) Install the CPAN modules

```sh
cpan -i Net::IP Net::LDNS
```

4) Install the Zonemaster engine

```sh
cpan -i Zonemaster
```

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

### <a name="CentOS"></a> CentOS 

1) Make sure the development environment is installed.

```sh
sudo yum groupinstall "Development Tools"
```

2) Install packages.

```sh
sudo yum install perl-core perl-ExtUtils-MakeMaker perl-File-ShareDir perl-File-Slurp perl-IO-Socket-INET6 perl-JSON perl-List-MoreUtils perl-Readonly perl-Time-HiRes perl-YAML libidn-devel perl-libintl perl-Devel-CheckLib openssl-devel perl-Test-Fat...
```

3) Install CPAN modules.

If it's the first time you use the CPAN module, it will ask three 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).