Upgrade Backend

1. Overview

This document contains pointer to instructions on how to upgrade the Zonemaster::Backend component. An upgrade usually consist of an upgrade script to upgrade the database, and instructions to install new dependencies.

When upgrading from a version < v6.2.0 to a version ≥ v8.0.0, it is recommended to install the desired version following the Installation instructions skipping the part about the database if you want to keep it. To upgrade the database, apply each upgrade instructions one after another (see table below).

2. Prerequisites

Upgrade Zonemaster::LDNS and Zonemaster::Engine first following instructions within the Zonemaster::Engine installation document.

3. Upgrading Zonemaster::Backend

To upgrade Zonemaster::Backend perform the following tasks:

1. stop the zm-rpcapi and zm-testagent daemons (zm_rpcapi and zm_testagent on FreeBSD)
2. remove old files with cpanm --uninstall Zonemaster::Backend
3. install any new dependencies (see corresponding upgrade document below)
4. install the latest version from CPAN with cpanm Zonemaster::Backend
5. apply any remaining instructions specific to this new release
6. start the zm-rpcapi and zm-testagent daemons (zm_rpcapi and zm_testagent on FreeBSD)

Specific upgrade instructions

Always make a backup of the database before upgrading it.

When upgrading Zonemaster::Backend, it might be needed to upgrade the database and/or install new dependencies. Such instructions are available in the upgrade document coming with the release. See table below to refer to the right document.

When upgrading from an older version than the previous release, apply each upgrade instructions one after another.

4. Find current version

The following command will report the version of Zonemaster-Backend currently installed. If an error is report Zonemaster-Backend is not installed or not available for the user. If so, consider tunning the command as root or with sudo.

perl -E 'use Zonemaster::Backend; say $Zonemaster::Backend::VERSION;'