From: Kevin P. Fleming <kevin@km6g.us>
Date: Sun, 16 Apr 2023 11:36:06 +0000 (-0400)
Subject: auth doc: Document 2-step process for consumer zone updates.
X-Git-Tag: rec-5.2.0-alpha1~33^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=cbdb01d60861b3da945c1bcb7d2e33cf5eba2532;p=thirdparty%2Fpdns.git

auth doc: Document 2-step process for consumer zone updates.

Closes #12714.
---

diff --git a/docs/catalog.rst b/docs/catalog.rst
index e0ffbdabb7..654270a4f7 100644
--- a/docs/catalog.rst
+++ b/docs/catalog.rst
@@ -139,3 +139,19 @@ The only difference is the type, which is now set to CONSUMER.
 Creating consumer zones is supported in the :doc:`API <http-api/zone>`, using type ``CONSUMER``.
 
 New member zones on the consumer adopt their primaries from the consumer zone.
+
+Updating a secondary server when primary address/port changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If NOTIFY+AXFR are being used to replicate zone changes between the
+primary and secondary servers, and the address and/or port of the
+primary server changes, two steps are necessary on each secondary
+server in order to fully apply the changes.
+
+.. code-block:: shell
+
+  pdnsutil change-secondary-zone-primary catalog.example 192.0.2.45
+  pdns_control retrieve catalog.example
+
+This will update the primary server contact details in each zone
+included in the catalog zone.