From: Michael Meffie <mmeffie@sinenomine.net>
Date: Mon, 10 Dec 2012 18:36:06 +0000 (-0500)
Subject: getting started: fix dns text
X-Git-Url: http://git.openafs.org/?p=openafs-wiki.git;a=commitdiff_plain;h=3caf6d3aaaeca719f2fb46921a5048988387e6cb;hp=546eb091fa00267d688d6e3ff2109ddc8a233cdb

getting started: fix dns text

Fix text and add example.
---

diff --git a/GettingStarted.mdwn b/GettingStarted.mdwn
index 362bdeb..6db8bc7 100644
--- a/GettingStarted.mdwn
+++ b/GettingStarted.mdwn
@@ -59,23 +59,40 @@ compatibility with older versions of AFS.  You may see it mentioned in various
 older documentatin, how-to guides, and mail list archives, however `kaserver`
 should not be used in new installations of OpenAFS.
 
-### DNS ###
-
-You should to DNS A records and PTR for your file and database servers, to
-make adminstration easier.
-
-AFS clients do not lookup servers by name, but need to locate the AFS database
-servers. Modern clients can use DNS service records to locate the AFS database
-servers.  Older clients can use AFSDB DNS records, which predate the support
-of service requires.
-
-
 ### Time Synchronization ###
 
 Kerberos requires servers and clients to have good clock synchronization,
 using `ntp` or some other synchronization mechanism. Be sure ntp is installed
 and working on every machine to be used as an OpenAFS client or server.
 
+### DNS ###
+
+You should create a DNS A record and a PTR record for each file and database
+server.  It is recommended to have the PTR record match the A record, and not
+an alias.
+
+OpenAFS clients need to locate the AFS database servers. Modern clients can use
+DNS SRV (service) records to locate the AFS database servers.  You may also
+which to create DNS AFSDB records for older AFS clients, which do not have
+support for the newer AFS SRV records.  You will need to create SRV records
+for the `vlserver` and the `prserver` services.
+
+The following is an example DNS bind configuration.
+
+    afsdb1                IN A              80.80.0.10
+    afsdb2                IN A              80.80.0.20
+    afsdb3                IN A              80.80.0.30
+    @                     IN AFSDB   1      afsdb1
+                          IN AFSDB   1      afsdb2
+                          IN AFSDB   1      afsdb3
+    _afs3-vlserver._udp   IN SRV 10 10 7003 afsdb1
+    _afs3-vlserver._udp   IN SRV 10 10 7003 afsdb2
+    _afs3-vlserver._udp   IN SRV 10 10 7003 afsdb3
+    _afs3-prserver._udp   IN SRV 10 10 7002 afsdb1
+    _afs3-prserver._udp   IN SRV 10 10 7002 afsdb2
+    _afs3-prserver._udp   IN SRV 10 10 7002 afsdb3
+
+
 ### Naming considerations ###
 
 OpenAFS servers are administratively grouped into a collection called a 'cell'.