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).
Upgrade Zonemaster::LDNS and Zonemaster::Engine first following instructions within the Zonemaster::Engine installation document.
To upgrade Zonemaster::Backend perform the following tasks:
- stop the
zm-rpcapiandzm-testagentdaemons (zm_rpcapiandzm_testagenton FreeBSD) - install any new dependencies (see corresponding upgrade document)
- install the latest version from CPAN with
cpanm Zonemaster::Backend - apply any remaining instructions specific to this new release
- start the
zm-rpcapiandzm-testagentdaemons (zm_rpcapiandzm_testagenton FreeBSD)
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.
| Current Zonemaster::Backend version | Link to instructions | Comments |
|---|---|---|
| version < 1.0.3 | Upgrade to 1.0.3 | |
| 1.0.3 ≤ version < 1.1.0 | Upgrade to 1.1.0 | |
| 1.1.0 ≤ version < 5.0.0 | Upgrade to 5.0.0 | |
| 5.0.0 ≤ version < 5.0.2 | Upgrade to 5.0.2 | For MySQL/MariaDB only |
| 5.0.2 ≤ version < 8.0.0 | Upgrade to 8.0.0 |