mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-08-31 22:45:39 +00:00
document rndc freeze & unfreeze
This commit is contained in:
@@ -2,7 +2,7 @@
|
|||||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
|
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
|
||||||
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
|
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
|
||||||
|
|
||||||
<!-- File: $Id: Bv9ARM-book.xml,v 1.189 2002/01/30 00:09:54 bwelling Exp $ -->
|
<!-- File: $Id: Bv9ARM-book.xml,v 1.190 2002/01/30 01:47:35 bwelling Exp $ -->
|
||||||
|
|
||||||
<book>
|
<book>
|
||||||
<title>BIND 9 Administrator Reference Manual</title>
|
<title>BIND 9 Administrator Reference Manual</title>
|
||||||
@@ -726,6 +726,25 @@ of a server.</para>
|
|||||||
<listitem><para>Retransfer the given zone from the master.</para></listitem>
|
<listitem><para>Retransfer the given zone from the master.</para></listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry><term><userinput>freeze <replaceable>zone</replaceable>
|
||||||
|
<optional><replaceable>class</replaceable>
|
||||||
|
<optional><replaceable>view</replaceable></optional></optional></userinput></term>
|
||||||
|
<listitem><para>Suspend updates to a dynamic zone. This allows manual
|
||||||
|
edits to be made to a zone normally updated by dynamic update. It
|
||||||
|
also causes changes in the journal file to be synced into the master
|
||||||
|
and the journal file to be removed. All dynamic update attempts will
|
||||||
|
be refused while the zone is frozen.</para></listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
|
<varlistentry><term><userinput>unfreeze <replaceable>zone</replaceable>
|
||||||
|
<optional><replaceable>class</replaceable>
|
||||||
|
<optional><replaceable>view</replaceable></optional></optional></userinput></term>
|
||||||
|
<listitem><para>Enable updates to a frozen dynamic zone. This causes
|
||||||
|
the server to reload the zone from disk, and re-enables dynamic updates
|
||||||
|
after the load has completed. After a zone is unfrozen, dynamic updates
|
||||||
|
will no longer be refused.</para></listitem>
|
||||||
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry><term><userinput>reconfig</userinput></term>
|
<varlistentry><term><userinput>reconfig</userinput></term>
|
||||||
<listitem><para>Reload the configuration file and load new zones,
|
<listitem><para>Reload the configuration file and load new zones,
|
||||||
but do not reload existing zone files even if they have changed.
|
but do not reload existing zone files even if they have changed.
|
||||||
@@ -1001,16 +1020,13 @@ protocol is specified in RFC 1996.
|
|||||||
is up to date is to run <command>rndc stop</command>.</para>
|
is up to date is to run <command>rndc stop</command>.</para>
|
||||||
|
|
||||||
<para>If you have to make changes to a dynamic zone
|
<para>If you have to make changes to a dynamic zone
|
||||||
manually, the following procedure will work: Shut down
|
manually, the following procedure will work: Disable dynamic updates
|
||||||
the server using <command>rndc stop</command> (sending a signal
|
to the zone using
|
||||||
or using <command>rndc halt</command> is <emphasis>not</emphasis>
|
<command>rndc freeze <replaceable>zone</replaceable></command>.
|
||||||
sufficient). Wait for the server to exit,
|
This will also remove the zone's <filename>.jnl</filename> file
|
||||||
then <emphasis>remove</emphasis> the zone's
|
and update the master file. Edit the zone file. Run
|
||||||
<filename>.jnl</filename> file, edit the zone file,
|
<command>rndc unfreeze <replaceable>zone</replaceable></command>
|
||||||
and restart the server. Removing the <filename>.jnl</filename>
|
to reload the changed zone and re-enable dynamic updates.</para>
|
||||||
file is necessary because the manual edits will not be
|
|
||||||
present in the journal, rendering it inconsistent with the
|
|
||||||
contents of the zone file.</para>
|
|
||||||
|
|
||||||
</sect2>
|
</sect2>
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user