Skip to content

Latest commit

 

History

History
108 lines (72 loc) · 2.26 KB

upgrade_zonemaster_backend_ver_8.0.0.md

File metadata and controls

108 lines (72 loc) · 2.26 KB

Upgrade to 8.0.0

On FreeBSD run the following command first to become root:

su -l

New dependencies

Zonemaster::Backend requires new dependencies. Depending on the used OS, run the corresponding command.

Centos

sudo cpanm Plack::Middleware::ReverseProxy

Debian / Ubuntu

sudo apt-get install libplack-middleware-reverseproxy-perl

FreeBSD

pkg install p5-Plack-Middleware-ReverseProxy

Changes in the ini file

New sections and properties have been added to the backend_config.ini file. By default the add_api_user method is disabled. To enable it, add the following to your backend_config.ini file:

[RPCAPI]
enable_add_api_user = yes

See the Configuration document for more information.

Upgrading init scripts

The zm-rpcapi (zm_rpcapi on FreeBSD) init script has been updated. It needs to be reinstalled.

CentOS

cd `perl -MFile::ShareDir=dist_dir -E 'say dist_dir("Zonemaster-Backend")'`
sudo install -v -m 755 ./zm-rpcapi.lsb /etc/init.d/zm-rpcapi

Debian / Ubuntu

cd `perl -MFile::ShareDir=dist_dir -E 'say dist_dir("Zonemaster-Backend")'`
sudo install -v -m 755 ./zm-rpcapi.lsb /etc/init.d/zm-rpcapi

FreeBSD

cd `perl -MFile::ShareDir=dist_dir -E 'say dist_dir("Zonemaster-Backend")'`
install -v -m 755 ./zm_rpcapi-bsd /usr/local/etc/rc.d/zm_rpcapi

Upgrading the database

If your Zonemaster database was created by a Zonemaster-Backend version smaller than v8.0.0, and not upgraded, use the following instructions.

Depending on the database size this upgrade can take some time (around 30 minutes for a database with 1 million entries)

You may need to run the command with sudo.

SQLite

Run

cd $(perl -MFile::ShareDir -le 'print File::ShareDir::dist_dir("Zonemaster-Backend")')
perl patch_sqlite_db_zonemaster_backend_ver_8.0.0.pl

MySQL (or MariaDB)

Run

cd $(perl -MFile::ShareDir -le 'print File::ShareDir::dist_dir("Zonemaster-Backend")')
perl patch/patch_mysql_db_zonemaster_backend_ver_8.0.0.pl

PostgreSQL

Run

cd $(perl -MFile::ShareDir -le 'print File::ShareDir::dist_dir("Zonemaster-Backend")')
perl patch/patch_postgresql_db_zonemaster_backend_ver_8.0.0.pl