Commit 442b869f authored by Libor Peltan's avatar Libor Peltan

doc: described the freeze-edit-thaw procedure

parent fc2054c0
......@@ -246,6 +246,31 @@ A full example of setting up a completely new zone from scratch::
$ knotc zone-set www 3600 A
$ knotc zone-commit
.. _Editing zonefile:
Safe reading and editing zone file
It's always possible to read and edit the zone contents via zone file manipulation.
However, it may lead to confusion if zone contents are continuously changing or
in case of operator's mistake. This paragraph describes a safe way to modify zone
by editing zone file, taking advantage of zone freeze/thaw feature.::
$ knotc zone-freeze
$ while ! knotc zone-status +freeze | grep -q 'freeze: yes'; do sleep 1; done
$ knotc zone-flush
After calling freeze to the zone, there still may be running zone operations (e.g. signing),
causing freeze pending. So we watch the zone status until frozen. Then we can flush the
frozen zone contents.
Now we open a text editor and perform desired changes to the zone file. It's necessary
to increase SOA serial in this step to keep consistency. Finaly, we can load the
modified zone file and if successful, thaw the zone.::
$ knotc zone-reload
$ knotc zone-thaw
.. _Journal behaviour:
Journal behaviour
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment