From 490c2321356710eb6e14bb1183d550316fc29346 Mon Sep 17 00:00:00 2001 From: Kees Monshouwer Date: Mon, 13 Nov 2023 21:08:21 +0100 Subject: [PATCH] auth: remove legacy doc updates --- docs/backends/bind.rst | 12 +++-- docs/backends/generic-sql.rst | 88 ++++++++++++++++------------------- docs/upgrading.rst | 39 ++++++++++++++++ 3 files changed, 89 insertions(+), 50 deletions(-) diff --git a/docs/backends/bind.rst b/docs/backends/bind.rst index dc787c76cd..2027392006 100644 --- a/docs/backends/bind.rst +++ b/docs/backends/bind.rst @@ -116,7 +116,9 @@ Autoprimary support (experimental) ``bind-autoprimaries`` ~~~~~~~~~~~~~~~~~~~~~~ -Changed in version 4.9.0: This was called ``bind-supermasters`` before 4.9.0. +.. versionchanged:: 4.9.0 + + This was called ``bind-supermasters`` before 4.9.0. Specifies file where to read list of autoprimaries. BIND backend only checks IP address of primary server. @@ -130,7 +132,9 @@ BIND backend can only read this file, not write it. ``bind-autoprimary-config`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Changed in version 4.9.0: This was called ``bind-supermaster-config`` before 4.9.0. +.. versionchanged:: 4.9.0 + + This was called ``bind-supermaster-config`` before 4.9.0. When a new zone is configured via the autosecondary mechanism, bindbackend *writes* a zone entry to this file. @@ -141,7 +145,9 @@ Your ``bind-config`` file should have an ``include`` statement to make sure this ``bind-autoprimary-destdir`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Changed in version 4.9.0: This was called ``bind-supermaster-destdir`` before 4.9.0. +.. versionchanged:: 4.9.0 + + This was called ``bind-supermaster-destdir`` before 4.9.0. Each new zone configured via the autosecondary mechanism gets a zone file in this directory. This directory must be writable. diff --git a/docs/backends/generic-sql.rst b/docs/backends/generic-sql.rst index 3a18a4b5df..09f049c221 100644 --- a/docs/backends/generic-sql.rst +++ b/docs/backends/generic-sql.rst @@ -29,23 +29,23 @@ To add a domain, issue the following:: Records can now be added using ``pdnsutil add-record`` or ``pdnsutil edit-zone``. -Slave operation -^^^^^^^^^^^^^^^ +Secondary operation +^^^^^^^^^^^^^^^^^^^ -These backends are fully slave capable. To become a slave of the -'example.com' domain, using 198.51.100.6 as the master execute this:: +These backends are fully secondary capable. To become a secondary of the +'example.com' domain, using 198.51.100.6 as the primary execute this:: - pdnsutil create-slave-zone example.com 198.51.100.6 + pdnsutil create-secondary-zone example.com 198.51.100.6 And wait a while for PowerDNS to pick up the addition - which happens within one minute (this is determined by the -:ref:`setting-slave-cycle-interval` +:ref:`setting-xfr-cycle-interval` setting). There is no need to inform PowerDNS that a new domain was added. Typical output is:: - Apr 09 13:34:29 All slave domains are fresh - Apr 09 13:35:29 1 slave domain needs checking - Apr 09 13:35:29 Domain example.com is stale, master serial 1, our serial 0 + Apr 09 13:34:29 All secondary domains are fresh + Apr 09 13:35:29 1 secondary domain needs checking + Apr 09 13:35:29 Domain example.com is stale, primary serial 1, our serial 0 Apr 09 13:35:30 [gPgSQLBackend] Connected to database Apr 09 13:35:30 AXFR started for 'example.com' Apr 09 13:35:30 AXFR done for 'example.com' @@ -56,37 +56,37 @@ will respond accordingly for queries within that zone. Periodically, PowerDNS schedules checks to see if domains are still fresh. The default -:ref:`setting-slave-cycle-interval` is 60 +:ref:`setting-xfr-cycle-interval` is 60 seconds, large installations may need to raise this value. Once a domain has been checked, it will not be checked before its SOA refresh timer has expired. Domains whose status is unknown get checked every 60 seconds by default. -PowerDNS has support for multiple masters per zone, and also port numbers for these masters:: +PowerDNS has support for multiple primaries per zone, and also port numbers for these primaries:: - pdnsutil create-slave-zone example.com 198.51.100.6 2001:0DB8:15:4AF::4 - pdnsutil create-slave-zone example.net 198.51.100.20:5301 '[2001:0DB8:11:6E::4]:54' + pdnsutil create-secondary-zone example.com 198.51.100.6 2001:0DB8:15:4AF::4 + pdnsutil create-secondary-zone example.net 198.51.100.20:5301 '[2001:0DB8:11:6E::4]:54' -Superslave operation -^^^^^^^^^^^^^^^^^^^^ +Autoprimary operation +^^^^^^^^^^^^^^^^^^^^^ -To configure a :ref:`supermaster ` with IP address 203.0.113.53 which lists this -installation as 'autoslave.example.com', issue the following:: +To configure a :ref:`autoprimary ` with IP address 203.0.113.53 which lists this +installation as 'autosecondary.example.com', issue the following:: - pdnsutil add-supermaster 203.0.113.53 autoslave.example.com internal + pdnsutil add-autoprimary 203.0.113.53 autosecondary.example.com internal From now on, valid notifies from 203.0.113.53 for which the zone lists an NS record -containing 'autoslave.example.com' will lead to the provisioning of a -slave domain under the account 'internal'. See :ref:`supermaster-operation` +containing 'autosecondary.example.com' will lead to the provisioning of a +secondary domain under the account 'internal'. See :ref:`autoprimary-operation` for details. -Master operation -^^^^^^^^^^^^^^^^ +Primary operation +^^^^^^^^^^^^^^^^^ -The generic SQL backend is fully master capable with automatic discovery +The generic SQL backend is fully primary capable with automatic discovery of serial changes. Raising the serial number of a domain suffices to trigger PowerDNS to send out notifications. To configure a domain for -master operation instead of the default native replication, issue:: +primary operation instead of the default native replication, issue:: pdnsutil create-zone example.com pdnsutil set-kind example.com MASTER @@ -105,8 +105,8 @@ This value cannot be set with ``pdnsutil``. Effects: the record (or domain, respectively) will not be visible to DNS clients. The REST API will still see the record (or domain). Even if a -domain is disabled, slaving still works. Slaving considers a disabled -domain to have a serial of 0; this implies that a slaved domain will not +domain is disabled, xfr still works. A secondary considers a disabled +domain to have a serial of 0; this implies that a secondary domain will not stay disabled. .. _generic-sql-handling-dnssec-signed-zones: @@ -300,37 +300,31 @@ Domain and zone manipulation a zone. - ``remove-domain-key-query``: Called to remove a crypto key. -Master/slave queries -^^^^^^^^^^^^^^^^^^^^ +Primary/secondary queries +^^^^^^^^^^^^^^^^^^^^^^^^^ -These queries are used to manipulate the master/slave information in the +These queries are used to manipulate the primary/secondary information in the database. Most installations will have zero need to change the following queries. -On masters -~~~~~~~~~~ +On primaries +~~~~~~~~~~~~ -- ``info-all-master-query``: Called to get data on all domains for - which the server is master. -- ``update-serial-query`` Called to update the last notified serial of - a master domain. +- ``info-all-primary-query``: Called to get data on all domains for which the server is primary. +- ``update-serial-query`` Called to update the last notified serial of a primary domain. -On slaves -~~~~~~~~~ +On secondaries +~~~~~~~~~~~~~~ -- ``info-all-slaves-query``: Called to retrieve all slave domains. -- ``update-lastcheck-query``: Called to update the last time a slave - domain was successfully checked for freshness. -- ``update-master-query``: Called to update the master address of a - domain. +- ``info-all-secondaries-query``: Called to retrieve all secondary domains. +- ``update-lastcheck-query``: Called to update the last time a secondary domain was successfully checked for freshness. +- ``update-primary-query``: Called to update the primary address of a domain. -On superslaves +On autoprimary ~~~~~~~~~~~~~~ -- ``supermaster-query``: Called to determine if a certain host is a - supermaster for a certain domain name. -- ``supermaster-name-to-ips``: Called to the IP and account for a - supermaster. +- ``autoprimary-query``: Called to determine if a certain host is a autoprimary for a certain domain name. +- ``autoprimary-name-to-ips``: Called to the IP and account for a autoprimary. TSIG ^^^^ diff --git a/docs/upgrading.rst b/docs/upgrading.rst index fc65427a01..f1fed5ace3 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -8,6 +8,45 @@ 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.8.0 to 4.9.0 +-------------- + +Removed options +^^^^^^^^^^^^^^^ + +Various settings, deprecated since 4.5.0, have been removed. + +* :ref:`setting-allow-unsigned-supermaster` is now :ref:`setting-allow-unsigned-autoprimary` +* :ref:`setting-master` is now :ref:`setting-primary` +* :ref:`setting-slave-cycle-interval` is now :ref:`setting-xfr-cycle-interval` +* :ref:`setting-slave-renotify` is now :ref:`setting-secondary-do-renotify` +* :ref:`setting-slave` is now :ref:`setting-secondary` +* :ref:`setting-superslave` is now :ref:`setting-autosecondary` + +Renamed options +^^^^^^^^^^^^^^^ + +Bind backend +~~~~~~~~~~~~ + +Various experimental autoprimary settings have been renamed. + +* ``supermaster-config`` is now ``autoprimary-config`` +* ``supermasters`` is now ``autoprimaries`` +* ``supermaster-destdir`` is now ``autoprimary-destdir`` + +Gsql backends +~~~~~~~~~~~~~ + +Various custom queries have been renamed. + +* ``info-all-slaves-query`` is now ``info-all-secondaries-query`` +* ``supermaster-query`` is now ``autoprimary-query`` +* ``supermaster-name-to-ips`` is now ``autoprimary-name-to-ips`` +* ``supermaster-add`` is now ``autoprimary-add`` +* ``update-master-query`` is now ``update-primary-query`` +* ``info-all-master-query`` is now ``info-all-primary-query`` + any version to 4.8.x -------------------- -- 2.47.2