Bv9ARM.ch03.html revision 727f5b8846457a33d06f515a10a7e1aa849ddf18
7a42357217528037bdfedcb17eeebfe96ae4266aAutomatic Updater>Name Server Configuration</TITLE
0c39b3ed9409ecb277d5e32fa763a4e4d6598df8Automatic UpdaterNAME="GENERATOR"
46da3117812814a29432a8d9a9ccf8acdbfdadceAutomatic UpdaterCONTENT="Modular DocBook HTML Stylesheet Version 1.61
79b273c187a4aa1016a62181983dfdd0521681aeMark AndrewsTITLE="BIND 9 Administrator Reference Manual"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonREL="PREVIOUS"
b253dcf9668f95e141bce9556dc88e30d3305a1dTinderbox UserTITLE="BIND Resource Requirements"
bbde8dc56605130058a1540609264fa109da3b63Automatic UpdaterTITLE="Advanced DNS Features"
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic UpdaterCLASS="chapter"
3cc98b8ecedcbc8465f1cf2740b966b315662430Automatic UpdaterBGCOLOR="#FFFFFF"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsTEXT="#000000"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsLINK="#0000FF"
a01aa536188bb3535dfc1107a623e6355a8e6b7cMark AndrewsVLINK="#840084"
89623368b8f662d458d9964b923050f33c5f75b0Tinderbox UserALINK="#0000FF"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterCLASS="NAVHEADER"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterCELLPADDING="0"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterCELLSPACING="0"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserALIGN="center"
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Hunt>BIND 9 Administrator Reference Manual</TH
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterVALIGN="bottom"
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterVALIGN="bottom"
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterVALIGN="bottom"
930f6069e5aa157cf6987cdafd412f5757a5a558Automatic UpdaterCLASS="chapter"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews>Chapter 3. Name Server Configuration</A
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson>Table of Contents</B
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterHREF="Bv9ARM.ch03.html#sample_configuration"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson>Sample Configurations</A
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User>Load Balancing</A
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews>Name Server Operations</A
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews>In this section we provide some suggested configurations along
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox Userwith guidelines for their use. We also address the topic of reasonable
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox Useroption setting.</P
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="sect1"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsNAME="sample_configuration"
7500521cecdff3c00e594ec41d3a17292332ffbcTinderbox User>3.1. Sample Configurations</A
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="sect2"
b871c7156eb037d41f53828c6fcb9cc876128962Mark AndrewsNAME="AEN255"
b871c7156eb037d41f53828c6fcb9cc876128962Mark Andrews>3.1.1. A Caching-only Name Server</A
b871c7156eb037d41f53828c6fcb9cc876128962Mark Andrews>The following sample configuration is appropriate for a caching-only
b871c7156eb037d41f53828c6fcb9cc876128962Mark Andrewsname server for use by clients internal to a corporation. All queries
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updaterfrom outside clients are refused using the <B
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic UpdaterCLASS="command"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater>allow-query</B
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updateroption. Alternatively, the same effect could be achieved using suitable
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updaterfirewall rules.</P
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterCLASS="programlisting"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic Updater> // Two corporate subnets we wish to allow queries from.
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafssonacl corpnets { 192.168.4.0/24; 192.168.7.0/24; };
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson allow-query { corpnets; };
dd65eb1efb40b1c47d57963192bfc54873b219beAutomatic Updater// Provide a reverse mapping for the loopback address 127.0.0.1
f132a836c4e386b1af045dd8fe7106ae61b90bffAutomatic Updater>3.1.2. An Authoritative-only Name Server</A
8f2c45a35dd8c40bcc9caba8f7d40ce64fc27bcdAutomatic Updater>This sample configuration is for an authoritative-only server
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox Userthat is the master server for "<TT
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="filename"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterand a slave for the subdomain "<TT
8f2c45a35dd8c40bcc9caba8f7d40ce64fc27bcdAutomatic UpdaterCLASS="filename"
e85565067cf73f8cc21ee29b11761659f1d47ee9Automatic UpdaterCLASS="programlisting"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> options {
bc0a53583d92309bebcf93c408e2f3247ebd3d3cAutomatic Updater directory "/etc/namedb"; // Working directory
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater allow-query { any; }; // This is the default
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater recursion no; // Do not provide recursive service
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater// Provide a reverse mapping for the loopback address 127.0.0.1
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater// We are the master server for example.com
7f94d9a8162c9a96b56e66176702b66e79d8e1a2Automatic Updater // IP addresses of slave servers allowed to transfer example.com
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater allow-transfer {
71bd43eebd9d6e42dbcae62b730f5b6508d5acd8Automatic Updater// We are a slave server for eng.example.com
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater // IP address of eng.example.com master server
9cd5eb6fe0f26d65724b99216cb31dcdd12e4afdAutomatic Updater masters { 192.168.4.12; };
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsNAME="AEN266"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews>3.2. Load Balancing</A
cafd3a2b9974fe0a4ab95e0289746062bd958d68Automatic Updater>A primitive form of load balancing can be achieved in
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="acronym"
f132a836c4e386b1af045dd8fe7106ae61b90bffAutomatic Updater> by using multiple A records for one name.</P
1368e4b34cef64604c874fcc40201c78e548714cTinderbox User>For example, if you have three WWW servers with network addresses
f7a71eef29bcbf892270460269c79664f600cffdAutomatic Updaterof 10.0.0.1, 10.0.0.2 and 10.0.0.3, a set of records such as the
3e5340279d8875d136a4dd815cccad0044aa2644Automatic Updaterfollowing means that clients will connect to each machine one third
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Userof the time:</P
cf7e98f59148b559946a7f1ca728471374f1eef3Automatic UpdaterCLASS="informaltable"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas GustafssonCELLPADDING="3"
c3fd32ed29e9e419bb56583f4272a506773b1ea0Automatic UpdaterCLASS="CALSTABLE"
3857cb6fcabeb79d85de4b3e3e4ab99912b701f8Mark AndrewsVALIGN="MIDDLE"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserVALIGN="MIDDLE"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsVALIGN="MIDDLE"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsVALIGN="MIDDLE"
0b57424d28c9a67018107133f9fbc0a7dcf057e2Mark AndrewsVALIGN="MIDDLE"
e8fc8c884b44371784805e1e0d3100da403dd3f1Automatic Updater>Resource Record (RR) Data</P
e8fc8c884b44371784805e1e0d3100da403dd3f1Automatic UpdaterVALIGN="MIDDLE"
b253dcf9668f95e141bce9556dc88e30d3305a1dTinderbox UserCLASS="literal"
59528addd704f8d5757b54e540520f74e588a7c7Automatic UpdaterVALIGN="MIDDLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="literal"
7f79131f9a8e804b93c57f3c679065cce878b726Automatic UpdaterVALIGN="MIDDLE"
f2770f6b39a9b2a98afb7a11ed105f73f1570c1eAutomatic UpdaterCLASS="literal"
f7369b2881b5e63d69600adcedc8ba938303d30cTinderbox UserVALIGN="MIDDLE"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="literal"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserVALIGN="MIDDLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="literal"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonVALIGN="MIDDLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonVALIGN="MIDDLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="literal"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonVALIGN="MIDDLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="literal"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonVALIGN="MIDDLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="literal"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonVALIGN="MIDDLE"
56effd2e3f579fd77b1fb37d47871d1bf1286bc4Automatic UpdaterCLASS="literal"
ae7e54b14c946e0984c191554db9abb4893f9349Automatic UpdaterVALIGN="MIDDLE"
ec8755f605d7dcb2de1076040e77bc2d7ec33b4aTinderbox UserVALIGN="MIDDLE"
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian WellingtonCLASS="literal"
aa1d397c4736cd86540555193d71e55fa3b37b2aMark AndrewsVALIGN="MIDDLE"
6c6a121295b30772cbf3dd75a51fb9d883051a0eAutomatic UpdaterCLASS="literal"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterVALIGN="MIDDLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="literal"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterVALIGN="MIDDLE"
3de6db3208d51de1e138b63b9670430c03f99694Automatic UpdaterCLASS="literal"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>When a resolver queries for these records, <SPAN
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="acronym"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington them and respond to the query with the records in a different
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington order. In the example above, clients will randomly receive
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington records in the order 1, 2, 3; 2, 3, 1; and 3, 1, 2. Most clients
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington will use the first record returned and discard the rest.</P
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>For more detail on ordering responses, check the
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark AndrewsCLASS="command"
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark Andrews>rrset-order</B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> substatement in the
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> statement, see
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterHREF="Bv9ARM.ch06.html#rrset_ordering"
79cea03ba823e2d3a34895f0ba91d7fb5ad799e7Automatic Updater>RRset Ordering</I
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark Andrews This substatement is not supported in
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="acronym"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> 9, and only the ordering scheme described above is
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington available.</P
b7aab05edae933e169d5f83c653935b17c7f0a8bMark AndrewsCLASS="sect1"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>3.3. Name Server Operations</A
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark AndrewsCLASS="sect2"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>3.3.1. Tools for Use With the Name Server Daemon</A
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>There are several indispensable diagnostic, administrative
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonand monitoring tools available to the system administrator for controlling
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonand debugging the name server daemon. We describe several in this
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterNAME="diagnostic_tools"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>3.3.1.1. Diagnostic Tools</A
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
42bee07ebb8152a6ec2f87f4790d87368c24704cAutomatic UpdaterCLASS="command"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="command"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> programs are all command line tools
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark Andrewsfor manually querying name servers. They differ in style and
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonoutput format.
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark AndrewsCLASS="variablelist"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="command"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>The domain information groper (<B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="command"
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic Updateris the most versatile and complete of these lookup tools.
89623368b8f662d458d9964b923050f33c5f75b0Tinderbox UserIt has two modes: simple interactive
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonmode for a single query, and batch mode which executes a query for
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Usereach in a list of several query lines. All query options are accessible
79cea03ba823e2d3a34895f0ba91d7fb5ad799e7Automatic Updaterfrom the command line.</P
f7369b2881b5e63d69600adcedc8ba938303d30cTinderbox UserCLASS="command"
84a18c72b9f05a7d2aabbc50886de494251d1719Automatic UpdaterCLASS="replaceable"
1fdd58445074579ee3b65c871137a7a1740eb542Mark AndrewsCLASS="replaceable"
cc5a9ce75af9870f2cb9e2bf00548c2f7e6398d6Automatic UpdaterCLASS="replaceable"
ec8755f605d7dcb2de1076040e77bc2d7ec33b4aTinderbox User>query-type</I
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
532d27b39244fadfcf8d8b4593f4c65434c9c664Automatic Updater>query-class</I
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>query-option</I
665ba746c0585088d0c314dcfc4671aa2c7b2dc1Automatic UpdaterCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater>The usual simple use of dig will take the form</P
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="command"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater>dig @server domain query-type query-class</B
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater>For more information and a list of available commands and
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updateroptions, see the <B
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="command"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="command"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="command"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater> utility emphasizes simplicity
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updaterand ease of use. By default, it converts
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updaterbetween host names and Internet addresses, but its functionality
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updatercan be extended with the use of options.</P
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="command"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic Updater> [-aCdlrTwv] [-c <TT
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="replaceable"
44e3b272904bfd85556771d30cf1bc6fa539dd03Automatic UpdaterCLASS="replaceable"
fe84edc17e0d582cf7b4270f8df9d4742a107b1cAutomatic UpdaterCLASS="replaceable"
bf8c3776f1bf1a1270e5e0443ae5a8df022632a8Mark AndrewsCLASS="replaceable"
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic UpdaterCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
40072ce70bc4125329addb4aaa56d18a1230bc17Automatic UpdaterCLASS="replaceable"
ff8ec39ce4afc2d774ce99f2386474d2c8539cd4Automatic Updater>For more information and a list of available commands and
ff8ec39ce4afc2d774ce99f2386474d2c8539cd4Automatic Updateroptions, see the <B
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic UpdaterCLASS="command"
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic UpdaterCLASS="command"
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic UpdaterCLASS="command"
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updater> has two modes: interactive
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updaterand non-interactive. Interactive mode allows the user to query name servers
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updaterfor information about various hosts and domains or to print a list
a308b69ac66fadf66863484f301314d6e6a3f1d2Automatic Updaterof hosts in a domain. Non-interactive mode is used to print just
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic Updaterthe name and requested information for a host or domain.</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
7dd02af3c9350553e1d52d980a7812425b3f1295Automatic Updater> [-option...] [<TT
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
d4ef65050feac78554addf6e16a06c6e2e0bd331Brian Wellington>host-to-find</I
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> | - [server]]</P
3e5b24a74c03d5b52f32d138e64e427bd2cbc8f3Automatic Updater>Interactive mode is entered when no arguments are given (the
3e5b24a74c03d5b52f32d138e64e427bd2cbc8f3Automatic Updaterdefault name server will be used) or when the first argument is a
ec8755f605d7dcb2de1076040e77bc2d7ec33b4aTinderbox Userhyphen (`-') and the second argument is the host name or Internet address
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterof a name server.</P
789875a1bd6d50c00d3bd883cad17ead1d3c21cdMark Andrews>Non-interactive mode is used when the name or Internet address
789875a1bd6d50c00d3bd883cad17ead1d3c21cdMark Andrewsof the host to be looked up is given as the first argument. The
789875a1bd6d50c00d3bd883cad17ead1d3c21cdMark Andrewsoptional second argument specifies the host name or address of a name server.</P
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User>Due to its arcane user interface and frequently inconsistent
b253dcf9668f95e141bce9556dc88e30d3305a1dTinderbox Userbehavior, we do not recommend the use of <B
b253dcf9668f95e141bce9556dc88e30d3305a1dTinderbox UserCLASS="command"
b123be91958e0bc58a10c165be64d47661199e3bEvan HuntCLASS="command"
b123be91958e0bc58a10c165be64d47661199e3bEvan Hunt> instead.</P
b123be91958e0bc58a10c165be64d47661199e3bEvan HuntCLASS="sect3"
b123be91958e0bc58a10c165be64d47661199e3bEvan HuntCLASS="sect3"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterNAME="admin_tools"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>3.3.1.2. Administrative Tools</A
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>Administrative tools play an integral part in the management
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterof a server.</P
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="variablelist"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserNAME="named-checkconf"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
ff62ab3c2e6274f19190ded15548c723d38bbbe3Automatic Updater>named-checkconf</B
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
1368e4b34cef64604c874fcc40201c78e548714cTinderbox User>named-checkconf</B
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater checks the syntax of a <TT
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic UpdaterCLASS="filename"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>named-checkconf</B
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserNAME="named-checkzone"
48b36fa08b2b5bc0d552dc2a4425b3f7007b3d59Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>named-checkzone</B
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>named-checkzone</B
7f814b8b164ae04916a8487cdc5e88ee3ff51a58Automatic Updater> program checks a master file for
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater syntax and consistency.</P
7f814b8b164ae04916a8487cdc5e88ee3ff51a58Automatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>named-checkzone</B
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> [-dq] [-c <TT
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
8711e5c73ca872d59810760af0332194cbdd619bAutomatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>The remote name daemon control
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
e5bf83fe0bbca838a0749e9071bd76d9ee0fb59bFrancis Dupont>) program allows the system
e5bf83fe0bbca838a0749e9071bd76d9ee0fb59bFrancis Dupont administrator to control the operation of a name server.
e5bf83fe0bbca838a0749e9071bd76d9ee0fb59bFrancis DupontCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> without any options
ead8aa3182c5805fccb6c7c1636cede6a24a5fc1Automatic Updater it will display a usage message as follows:</P
ead8aa3182c5805fccb6c7c1636cede6a24a5fc1Automatic UpdaterCLASS="command"
7169f76a893666eb20fc7750782e7f411db742d6Tinderbox UserCLASS="replaceable"
ead8aa3182c5805fccb6c7c1636cede6a24a5fc1Automatic UpdaterCLASS="replaceable"
ead8aa3182c5805fccb6c7c1636cede6a24a5fc1Automatic UpdaterCLASS="replaceable"
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic UpdaterCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="replaceable"
af9cf290cea6ada6ce27b51c724ab77ad5d73fa0Tinderbox UserCLASS="command"
c53a6f37deaa396660adb6a4ca600c4a58adfd3fAutomatic Updater> is one of the following:</P
19ad308d84cbf446a144e5a91f2032389a9d65c1Tinderbox UserCLASS="variablelist"
7af91d15b2ce1ce32f7320f6d5cc3b83621c241aAutomatic UpdaterCLASS="userinput"
6671e343b8c7e44ac10a7900fde59555fbc71571Automatic Updater>Reload configuration file and zones.</P
7af91d15b2ce1ce32f7320f6d5cc3b83621c241aAutomatic UpdaterCLASS="userinput"
7af91d15b2ce1ce32f7320f6d5cc3b83621c241aAutomatic UpdaterCLASS="replaceable"
7af91d15b2ce1ce32f7320f6d5cc3b83621c241aAutomatic UpdaterCLASS="optional"
af9cf290cea6ada6ce27b51c724ab77ad5d73fa0Tinderbox UserCLASS="replaceable"
229ea4644b3a7d9c7fdaa43888e7f55ba01e2ee3Automatic UpdaterCLASS="optional"
19ad308d84cbf446a144e5a91f2032389a9d65c1Tinderbox UserCLASS="replaceable"
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox User>Reload the given zone.</P
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox UserCLASS="userinput"
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox UserCLASS="replaceable"
bea3208b417a0700bd524807082875b7d09585e4Automatic UpdaterCLASS="optional"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="replaceable"
48dfee71508886d86fe8fb12f91961b5daf3141dMark AndrewsCLASS="optional"
48dfee71508886d86fe8fb12f91961b5daf3141dMark AndrewsCLASS="replaceable"
8f2c45a35dd8c40bcc9caba8f7d40ce64fc27bcdAutomatic Updater>Schedule zone maintenance for the given zone.</P
48dfee71508886d86fe8fb12f91961b5daf3141dMark AndrewsCLASS="userinput"
1368e4b34cef64604c874fcc40201c78e548714cTinderbox User>retransfer <TT
8c9c79e5fea0cb698026a74821695907c8312a46Mark AndrewsCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="optional"
8f2c45a35dd8c40bcc9caba8f7d40ce64fc27bcdAutomatic UpdaterCLASS="replaceable"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="optional"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Retransfer the given zone from the master.</P
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="userinput"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>Reload the configuration file and load new zones,
7adcb4de92bf4383a4c5624c4ed256736d02bc6dMark Andrews but do not reload existing zone files even if they have changed.
b6561016dc8a813bfd91cef5b876b3dfc3f08ffaTinderbox User This is faster than a full <B
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox UserCLASS="command"
3349f0044fda807e1fd6681c833d3593a22dad86Tinderbox User is a large number of zones because it avoids the need to examine the
95cfad51a3f71246d263af79a7861a6821f7a0beAutomatic Updater modification times of the zones files.
f132a836c4e386b1af045dd8fe7106ae61b90bffAutomatic UpdaterCLASS="userinput"
08d53af7d51409036462fa80fb1bde7a8c2ac123Automatic Updater>Write server statistics to the statistics file.</P
5ecad47f69b3fd945472ab2900a9ff826a7ce2f6Automatic UpdaterCLASS="userinput"
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updater>Toggle query logging. Query logging can also be enabled
e2e3f655d133f08056c9035412d4c013aab234e7Automatic Updater by explictly directing the <B
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox UserCLASS="command"
2fd1e3918971180155c10d09454a277f015daecaAutomatic UpdaterCLASS="command"
2fd1e3918971180155c10d09454a277f015daecaAutomatic UpdaterCLASS="command"
e2e3f655d133f08056c9035412d4c013aab234e7Automatic UpdaterCLASS="command"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="filename"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="userinput"
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updater>Dump the server's caches to the dump file. </P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
d145b64cacc8d9cda51f9924ec70cd4661c3e2cfAutomatic Updater>Stop the server,
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater making sure any recent changes
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater made through dynamic update or IXFR are first saved to the master files
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater of the updated zones.</P
d04fe0d954df649d763640642cb5a456ae1c63a3Automatic UpdaterCLASS="userinput"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>Stop the server immediately. Recent changes
2cdbfcdad94eba75f3f8e77343a0eefabf553b8eAutomatic Updater made through dynamic update or IXFR are not saved to the master files,
2cdbfcdad94eba75f3f8e77343a0eefabf553b8eAutomatic Updater but will be rolled forward from the journal files when the server
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User is restarted.</P
52cfbde0bd391cfb37e3c1a1b460c16ba6bf1a73Automatic UpdaterCLASS="userinput"
31a540386a9abaf681d8952f1b2cdf5c75a0ba6cAutomatic Updater>Increment the servers debugging level by one. </P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="replaceable"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Sets the server's debugging level to an explicit
601c1908d06375f5dea00ab98671a6c934d8a840Automatic UpdaterCLASS="userinput"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Sets the server's debugging level to 0.</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
ff8ec39ce4afc2d774ce99f2386474d2c8539cd4Automatic Updater>Flushes the server's cache.</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Display status of the server.</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="acronym"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updatersupports all the commands of the BIND 8 <B
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic UpdaterCLASS="command"
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updaterutility except <B
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater>ndc restart</B
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater>, which were also
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Usernot supported in <B
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>'s channel mode.</P
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>A configuration file is required, since all
601c1908d06375f5dea00ab98671a6c934d8a840Automatic Updatercommunication with the server is authenticated with
601c1908d06375f5dea00ab98671a6c934d8a840Automatic Updaterdigital signatures that rely on a shared secret, and
601c1908d06375f5dea00ab98671a6c934d8a840Automatic Updaterthere is no way to provide that secret other than with a
601c1908d06375f5dea00ab98671a6c934d8a840Automatic Updaterconfiguration file. The default location for the
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> configuration file is
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="filename"
4d813066e967a36c407ee641155ada0c614d4dc6Automatic Updater>, but an alternate
6de27e27ad6056d7c049feb912df5a6b9a56d1b8Automatic Updaterlocation can be specified with the <TT
4d813066e967a36c407ee641155ada0c614d4dc6Automatic Updateroption. If the configuration file is not found,
2cdbfcdad94eba75f3f8e77343a0eefabf553b8eAutomatic UpdaterCLASS="command"
4d813066e967a36c407ee641155ada0c614d4dc6Automatic Updater> will also look in
f42fc714eda962112e45b904d1f846c61a080114Automatic UpdaterCLASS="filename"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="varname"
f42fc714eda962112e45b904d1f846c61a080114Automatic Updater>sysconfdir</TT
4d813066e967a36c407ee641155ada0c614d4dc6Automatic Updater> was defined when
4d813066e967a36c407ee641155ada0c614d4dc6Automatic UpdaterCLASS="acronym"
f42fc714eda962112e45b904d1f846c61a080114Automatic Updater> build was configured).
f42fc714eda962112e45b904d1f846c61a080114Automatic UpdaterCLASS="filename"
4d813066e967a36c407ee641155ada0c614d4dc6Automatic Updater> file is generated by
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
f9666f4b6e4410b5f1a5ccae730e233313b96d18Mark Andrews>rndc-confgen -a</B
6686505e3ae3289eea38002a3269828893532489Evan Hunt> as described in
1368e4b34cef64604c874fcc40201c78e548714cTinderbox UserHREF="Bv9ARM.ch06.html#controls_statement_definition_and_usage"
b6561016dc8a813bfd91cef5b876b3dfc3f08ffaTinderbox User>Section 6.2.4</A
3f616e6f846be57b1717c6beaba0f74de9d5a7c6Automatic Updater>The format of the configuration file is similar to
afaa290bb6acc504e93a0adbf20b6dd6c64e6d63Vernon SchryverCLASS="filename"
7349698120e3f6f51162a2fdb5613f9aecbc78c3Automatic Updater>, but limited to
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox Useronly four statements, the <B
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox UserCLASS="command"
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox UserCLASS="command"
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox UserCLASS="command"
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox UserCLASS="command"
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox Userstatements. These statements are what associate the
5645e0c82a55b05abb975bd91b9566823dc5efb0Evan Huntsecret keys to the servers with which they are meant to
5645e0c82a55b05abb975bd91b9566823dc5efb0Evan Huntbe shared. The order of statements is not
ed52536a1722606f22332ba4f92cbb74c3b256d9Tinderbox Usersignificant.</P
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="command"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrews> statement has three clauses:
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="command"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrews>default-server</B
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="command"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrews>default-key</B
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="command"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrews>default-port</B
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="command"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrews>default-server</B
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrewshost name or address argument and represents the server that will
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrewsbe contacted if no <TT
7e1a8f402e3881388db37152f71c698cb1f1c426Mark AndrewsCLASS="option"
7e1a8f402e3881388db37152f71c698cb1f1c426Mark Andrewsoption is provided on the command line.
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
7a2a1b8b14fc804ac80612d7b98064095e445be5Automatic Updater>default-key</B
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic Updaterthe name of a key as its argument, as defined by a <B
7a2a1b8b14fc804ac80612d7b98064095e445be5Automatic UpdaterCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark AndrewsCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews>default-port</B
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews> specifies the port to which
351eca011cf38fd3272b325029afce144a9a1ebaMark AndrewsCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews> should connect if no
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrewsport is given on the command line or in a
351eca011cf38fd3272b325029afce144a9a1ebaMark AndrewsCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews> statement.</P
351eca011cf38fd3272b325029afce144a9a1ebaMark AndrewsCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews> statement defines an key to be used
351eca011cf38fd3272b325029afce144a9a1ebaMark AndrewsCLASS="command"
351eca011cf38fd3272b325029afce144a9a1ebaMark Andrews> when authenticating with
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>. Its syntax is identical to the
ff8ec39ce4afc2d774ce99f2386474d2c8539cd4Automatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserThe keyword <TT
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterfollowed by a key name, which must be a valid
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Userdomain name, though it need not actually be hierarchical; thus,
a382ca49c874d38ad3ac8995b49f9f27128e4ca9Automatic Updatera string like "<TT
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="userinput"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updater>" is a valid name.
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterCLASS="command"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updater> statement has two clauses:
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterCLASS="command"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterCLASS="command"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterWhile the configuration parser will accept any string as the argument
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updaterto algorithm, currently only the string "<TT
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterCLASS="userinput"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updaterhas any meaning. The secret is a base-64 encoded string.</P
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic UpdaterCLASS="command"
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updater> statement associates a key
8aa53dcb1d26277e8e805464bfff7bb7136f60cbAutomatic Updaterdefined using the <B
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> statement with a server.
29b33908adf234dbe677e2c0e152e74e2b1be13dTinderbox UserThe keyword <TT
1368e4b34cef64604c874fcc40201c78e548714cTinderbox UserCLASS="userinput"
1368e4b34cef64604c874fcc40201c78e548714cTinderbox User> is followed by a
1368e4b34cef64604c874fcc40201c78e548714cTinderbox Userhost name or address. The <B
1368e4b34cef64604c874fcc40201c78e548714cTinderbox UserCLASS="command"
1368e4b34cef64604c874fcc40201c78e548714cTinderbox Userhas two clauses: <B
059cd1994d4ac5c1b967ce777d2c7409dc829a42Tinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> clause specifies the name of the key
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Userto be used when communicating with this server, and the
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> clause can be used to
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonspecify the port <B
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> should connect
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterto on the server.</P
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic Updater>A sample minimal configuration file is as follows:</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="programlisting"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> key rndc_key {
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User algorithm "hmac-md5";
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User secret "c3Ryb25nIGVub3VnaCBmb3IgYSBtYW4gYnV0IG1hZGUgZm9yIGEgd29tYW4K";
94d0b4bd411a66a2c5a7ebc8722579a59cf9640bAutomatic Updater default-server 127.0.0.1;
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User default-key rndc_key;
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>This file, if installed as <TT
601c1908d06375f5dea00ab98671a6c934d8a840Automatic UpdaterCLASS="filename"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox Userwould allow the command:</P
8f536463f9fdfa7da6a8310e4f4895373beb2961Mark AndrewsCLASS="userinput"
f7a71eef29bcbf892270460269c79664f600cffdAutomatic Updater>rndc reload</B
3f68e9c0e5a6ce475d15eef04bfed9b08a22afa9Tinderbox User>to connect to 127.0.0.1 port 953 and cause the name server
dcd42a39d311b44877161ffd1e27fa62700c0171Mark Andrewsto reload, if a name server on the local machine were running with
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updaterfollowing controls statements:</P
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="programlisting"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> controls {
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater inet 127.0.0.1 allow { localhost; } keys { rndc_key; };
3f68e9c0e5a6ce475d15eef04bfed9b08a22afa9Tinderbox User>and it had an identical key statement for
3f68e9c0e5a6ce475d15eef04bfed9b08a22afa9Tinderbox UserCLASS="literal"
3f68e9c0e5a6ce475d15eef04bfed9b08a22afa9Tinderbox User>Running the <B
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>rndc-confgen</B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> program will
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellingtonconveniently create a <TT
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="filename"
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic Updaterfile for you, and also display the
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic Updatercorresponding <B
63654fea53d6a58a65112234bc8d0c322e0c81b5Automatic UpdaterCLASS="command"
27aa770222192dda4ba4ff4b76defd4b8c846226Automatic Updater> statement that you need to
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="filename"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>. Alternatively,
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>rndc-confgen -a</B
fd7c65dce9c2b1a3d12ca4df9074cd38019fdb5fAutomatic UpdaterCLASS="filename"
b871c7156eb037d41f53828c6fcb9cc876128962Mark Andrews> file and not modify
b871c7156eb037d41f53828c6fcb9cc876128962Mark AndrewsCLASS="filename"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>3.3.2. Signals</A
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Certain UNIX signals cause the name server to take specific
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updateractions, as described in the following table. These signals can
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic Updaterbe sent using the <B
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic UpdaterCLASS="command"
fe84edc17e0d582cf7b4270f8df9d4742a107b1cAutomatic UpdaterCLASS="informaltable"
82447d835d3ff5c658749b4e9b4f66166407b3eaAutomatic UpdaterCELLPADDING="3"
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic UpdaterCLASS="CALSTABLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterVALIGN="MIDDLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="command"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterVALIGN="MIDDLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>Causes the server to read <TT
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="filename"
8f2c45a35dd8c40bcc9caba8f7d40ce64fc27bcdAutomatic Updaterreload the database. </P
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic UpdaterVALIGN="MIDDLE"
e130ab53e992670e2a2ecf043976ac09f21358d1Automatic UpdaterCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserVALIGN="MIDDLE"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User>Causes the server to clean up and exit.</P
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserVALIGN="MIDDLE"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="command"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserVALIGN="MIDDLE"
7c899ff8af55a6855100e7fb4f5dd9a0a04b48a0Automatic Updater>Causes the server to clean up and exit.</P
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="NAVFOOTER"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCELLPADDING="0"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCELLSPACING="0"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsALIGN="center"
979e02d122cddf1624cca8a4dab8d084c900fa48Automatic UpdaterCLASS="acronym"
7f79131f9a8e804b93c57f3c679065cce878b726Automatic Updater> Resource Requirements</TD
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>Advanced DNS Features</TD