From 7f3563dda3119ca015cffe491a578111d2f57056 Mon Sep 17 00:00:00 2001 From: Peter van Dijk Date: Wed, 17 Feb 2021 13:25:20 +0100 Subject: [PATCH] document CSYNC+upgrade notes+fix in 4.4 notes --- .github/actions/spell-check/expect.txt | 1 + docs/appendices/types.rst | 9 +++++++++ docs/upgrading.rst | 17 ++++++++++++++++- 3 files changed, 26 insertions(+), 1 deletion(-) diff --git a/.github/actions/spell-check/expect.txt b/.github/actions/spell-check/expect.txt index dca38257e2..ec0c775deb 100644 --- a/.github/actions/spell-check/expect.txt +++ b/.github/actions/spell-check/expect.txt @@ -366,6 +366,7 @@ cryptopp cryptoshop css csv +CSYNC ctime ctor ctx diff --git a/docs/appendices/types.rst b/docs/appendices/types.rst index e1ad339b3b..64c6a62151 100644 --- a/docs/appendices/types.rst +++ b/docs/appendices/types.rst @@ -100,6 +100,15 @@ The CNAME record specifies the canonical name of a record. It is stored plainly. Like all other records, it is not terminated by a dot. A sample might be 'webserver-01.yourcompany.com'. +.. _types-csync: + +CSYNC +----- + +The CSYNC record is used for 'Child-to-Parent Synchronization in DNS', as described in :rfc:`7477`. +Right now it is only supported as zone content; no special processing is implemented. +Note that SOA-EDIT is not applied to serial numbers in CSYNC content. + .. _types-dnskey: DNSKEY diff --git a/docs/upgrading.rst b/docs/upgrading.rst index 915befc3bf..19c73e26ff 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -8,6 +8,21 @@ Please upgrade to the PowerDNS Authoritative Server 4.0.0 from 3.4.2+. See the `3.X `__ upgrade notes if your version is older than 3.4.2. +4.4.x to 4.5.0 or master +------------------------ + +Record type changes +^^^^^^^^^^^^^^^^^^^ + +The in-database format of ``CSYNC`` and ``IPSECKEY`` records has changed from 'generic' format to its specialized format. + +API users might notice that replacing records of these types leaves the old TYPExx records around, even if PowerDNS is not serving them. +To fix this, enable :ref:`setting-upgrade-unknown-types` and replace the records; this will then delete those TYPExx records. +Then, disable the setting again, because it has a serious performance impact on API operations. + +On secondaries, it is recommended to re-transfer, using ``pdns_control retrieve ZONE``, with :ref:`setting-upgrade-unknown-types` enabled, all zones that have records of those types, or ``TYPExx``, for numbers 45 and 62. +Leave the setting on until all zones have been re-transferred. + 4.3.x to 4.4.0 -------------- @@ -46,7 +61,7 @@ API users might notice that replacing records of these types leaves the old TYPE To fix this, enable :ref:`setting-upgrade-unknown-types` and replace the records; this will then delete those TYPExx records. Then, disable the setting again, because it has a serious performance impact on API operations. -On secondaries, it is recommended to re-transfer, using ``pdns_control retrieve ZONE``, with :ref:`setting-upgrade-unknown-types` enabled, all zones that have records of those types, or ``TYPExx``, for numbers 42, 45, 64, 65. +On secondaries, it is recommended to re-transfer, using ``pdns_control retrieve ZONE``, with :ref:`setting-upgrade-unknown-types` enabled, all zones that have records of those types, or ``TYPExx``, for numbers 42, 64, 65. Leave the setting on until all zones have been re-transferred. PostgreSQL configuration escaping -- 2.47.2