|
|
@@ -112,6 +112,8 @@ GeoDNS can post runtime data to [StatHat](http://www.stathat.com/).
|
|
|
|
|
|
## Country and continent lookups
|
|
|
|
|
|
+See zone targeting options below.
|
|
|
+
|
|
|
## Weighted records
|
|
|
|
|
|
Most records can have a 'weight' assigned. If any records of a particular type
|
|
|
@@ -131,10 +133,19 @@ As an example, if you configure
|
|
|
|
|
|
with `max_hosts` 2 then .4 will be returned about 4 times more often than .1.
|
|
|
|
|
|
-## Configuration format
|
|
|
+## Configuration file
|
|
|
+
|
|
|
+The geodns.conf file allows you to specify a specific directory for the GeoIP
|
|
|
+data files and enable posting metrics to StatHat. See the `geodns.conf.sample`
|
|
|
+file for example configuration.
|
|
|
+
|
|
|
+Most of the configuration is "per zone" and done in the zone .json files.
|
|
|
|
|
|
-In the configuration file the whole zone is a big hash (associative array). At the
|
|
|
-top level you can (optionally) set some options with the keys serial, ttl and max_hosts.
|
|
|
+## Zone format
|
|
|
+
|
|
|
+In the zone configuration file the whole zone is a big hash (associative array).
|
|
|
+At the top level you can (optionally) set some options with the keys serial,
|
|
|
+ttl and max_hosts.
|
|
|
|
|
|
The actual zone data (dns records) is in a hash under the key "data". The keys
|
|
|
in the hash are hostnames and the value for each hostname is yet another hash
|
|
|
@@ -162,6 +173,37 @@ The configuration files are automatically reloaded when they're updated. If a fi
|
|
|
can't be read (invalid JSON, for example) the previous configuration for that zone
|
|
|
will be kept.
|
|
|
|
|
|
+## Zone options
|
|
|
+
|
|
|
+* serial
|
|
|
+
|
|
|
+GeoDNS doesn't support zone transfers (AXFR), so the serial number is only used
|
|
|
+for debugging and monitoring. The default is the 'last modified' timestamp of
|
|
|
+the zone file.
|
|
|
+
|
|
|
+* ttl
|
|
|
+
|
|
|
+Set the default TTL for the zone (default 120).
|
|
|
+
|
|
|
+* targeting
|
|
|
+
|
|
|
+* max_hosts
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+* contact
|
|
|
+
|
|
|
+Set the soa 'contact' field (default is "hostmaster.$domain").
|
|
|
+
|
|
|
+## Zone targeting options
|
|
|
+
|
|
|
+@
|
|
|
+
|
|
|
+country
|
|
|
+continent
|
|
|
+
|
|
|
+region and regiongroup
|
|
|
+
|
|
|
## Supported record types
|
|
|
|
|
|
Each label has a hash (object/associative array) of record data, the keys are the type.
|
Ask Bjørn Hansen