Release notes for IRRd 4.2.2

IRRd 4.2.2 was released on December 2nd, 2021, and fixes four issues that occurred in 4.2.1:

Steps required to upgrade

IRRD 4.2.2 contains new changes to the PostgreSQL database. This means you must run the irrd_database_upgrade command as part of the update process.

Follow these steps to upgrade:

  • Disable all cron and e-mail triggered tasks. There should be no calls to any IRRd scripts during the upgrade process.

  • Upgrade your installed version of IRRD to 4.2.2.

  • Run irrd_database_upgrade. This may take several minutes.

  • Start IRRd and re-enable the cron / e-mail triggered tasks.

Between the time that the upgrade finishes and IRRD is restarted, mirroring processes may fail. This will automatically recover after the restart.

The underlying reason is that if your database version is inconsistent with the version of running IRRD code, inserting or updating RPSL objects will fail. Therefore, user updates received over e-mail should be paused during this time.

As with all other database upgrades, you can also choose to entirely shut down IRRD during the database upgrade.

Downgrading from 4.2.2 to 4.2.1

If you are running IRRd 4.2.2, and would like to downgrade back to 4.2.1, the database schema needs to be reverted. You can either restore an older copy of your database, start with a fresh database, or use the database migrations.

If you want to use the database migrations, run this command before downgrading your local package installation to 4.2.1:

irrd_database_downgrade --version 893d0d5363b3

If you would like to re-upgrade to 4.2.2 later on, you will need to run the database migrations again, as listed in the upgrade steps.