Verwalten der Zonendaten

Hostsharing Dokumentation – die Hauptbereiche

Einstieg | Hsadmin | Pakete | User | Domains | Cron | Logging | E-Mail | WWW
Datenbanken | Backup & Restore | Installationsanleitungen | FAQ | Bugtracker

 

Das Zonenfile für eine Domain enthält die Konfiguration des Domain Name Service (DNS), d.h. der Nameserver der Domain. Es wird hinterlegt, welche Hostnamen innerhalb der Domain existieren und auf welche IP-Adressen diese zeigen. Außerdem wird hierüber auch gesteuert, an welches System Mails für die Domain geliefert werden sollen.

Achtung

Aufgrund der zentralen Bedeutung sollten Änderungen nur mit Vorsicht vorgenommen werden, da eine fehlerhafte Einstellung dazu führen kann, dass die Webseite nicht mehr im Internet abgerufen werden kann oder Mails verloren gehen!

Achtung

Das Standardzonefile und die gültigen Platzhalter ändern sich in Kürze. Die Dokumentation wird derzeit aktualisiert.

aktives Zonefile

Die gerade aktive Konfiguration einer Domain example.com ist in /etc/bind/pri.example.com zu finden (Zonefile).

Es sieht standardmäßig in etwa wie folgt aus:

$TTL 6H
example.org. IN SOA dns1.hostsharing.net. hostmaster.hostsharing.net. (
		1242748945 ; serial secs since Jan 1 1970
		6H		; refresh (>=10000)
		1H		; retry (>=1800)
		1W		; expire
		1H		; minimum
		)

		IN	NS	dns1.hostsharing.net.
		IN	NS	dns2.hostsharing.net.
		IN	NS	dns3.hostsharing.net.

		IN	MX	10 mailin.hostsharing.net.

		IN	A	83.223.95.30
*               IN	A	83.223.95.30

Der erste Block SOA definiert die "Start Of Authority" Ressource. Der wichtigste Eintrag hier ist die Seriennummer. Diese wird von den DNS-Servern benutzt, um eine Änderung zu erkennen. Deshalb muss diese Nummer bei jeder Anpassung erhöht werden, sonst wird die Änderung nicht vollständig im Internet verbreitet. Der konkrete Wert ist nicht wichtig, so dass man durchaus auch einfach die dort stehende Zahl um eins erhöhen kann. In der Regel verwenden wir hier die Anzahl der Sekunden seit 1970, die für den Platzhalter {SIO} (s. unten) eingetragen wird.

Änderungen

Domainadmins können Änderungen beauftragen. Dafür ist ein vollständiges Zonefile im Konfigurationsverzeichnis etc der Domain abzulegen.

Am besten man beginnt mit der folgenden universellen Vorlage. Sie enthält Platzhalter, die bei der Übernahme der Konfiguration vom HS Robot automatisch durch die aktuellen Werte ersetzt werden:

$TTL {TTL}
{DOM_HOSTNAME}. IN SOA {HS_DNS1_HOSTNAME}. hostmaster.hostsharing.net. (
                {SIO} ; serial secs since Jan 1 1970 
                6H              ; refresh (>=10000)
                1H              ; retry (>=1800)
                1W              ; expire
                1H              ; minimum
                        )
; please read https://wiki.hostsharing.net/index.php?title=Domains:Verwalten_der_Zonendaten
                        IN      NS      {HS_DNS1_HOSTNAME}.
                        IN      NS      {HS_DNS2_HOSTNAME}.
                        IN      NS      {HS_DNS3_HOSTNAME}.
                        IN      MX  10  {MX_HOSTNAME}.
                        IN      A       {DOM_IPNUMBER}
www                     IN      A       {DOM_IPNUMBER}
*                       IN      A       {DOM_IPNUMBER}

Man speichert diese Vorlage unter /home/doms/example.com/etc/pri.example.com und kann sie dann bearbeiten und eigene Einträge ergänzen.

Beispiele:

; externe Server per "CNAME Record" eintragen
wackelserver           IN     CNAME     server0815.massenhoster-domain.tld
homeip                 IN     CNAME     mein-nick.dyn-ip-service.tld

; www Domaindelegation (Freigabe zur Aufschaltung in separatem Dynamic-Web Paket)
; (Bestehender "A Record" der www Domain muss zudem entfernt werden.)
www                       IN      NS      {HS_DNS1_HOSTNAME}.
www                       IN      NS      {HS_DNS2_HOSTNAME}.
www                       IN      NS      {HS_DNS3_HOSTNAME}.

soll statt www eine subdomain deligiert werden muss dieser Eintrag am Ende der pri.example.com Datei stehen, also nach:

*.{DOM_HOSTNAME}.       IN      A       {DOM_IPNUMBER}

Danach legt man im Zielpaket die Subdomain an:

hsadmin -c domain.add -s name=subdomain.example.tld -s user=xyz12

Nach einer Änderung an einem selbstverwalteten Zonefile dauert es noch einige Minuten, bis die Änderungen von unserem DNS-Servern übernommen werden. Bis die DNS-Caches der Welt eine Änderung mitbekommen, kann es natürlich noch etwas länger dauern. (Mindestens entsprechend der Zeitangaben im oberen Teil des zuvor aktiven Zonefiles.)

Hinweis:

Wenn man ein eigenes Zonefile in /home/doms/example.org/etc löscht, bleibt in den HS Nameservern der letzte Stand erhalten! Falls man für eine Domain wieder ein Hostsharing-Standard-Zonefile haben möchte, muss man ein leeres (= 0 Bytes) Zonefile anlegen:

echo -n >  /home/doms/example.org/etc/pri.example.org

Das -n ist wichtig, sonst ist die Datei nicht wirklich leer und es gibt Fehlermeldungen!

Logfile und Kontrolle

Die Logfiles des Nameservers sind im Verzeichnis /var/log/named einsehbar. Das aktuelle Log wird unter dem Namen named.log angelegt. Dieses wird beim Neustart des DNS-Servers immer neu angelegt und zeigt bei einer erfolgreichen Änderung etwa folgenden Inhalt:

 Oct 11 18:32:21.400 info: zone example.org/IN: loaded serial 1065889567
 Oct 11 18:32:21.435 info: zone example.org/IN: sending notifies (serial 1065889567)
 Oct 11 18:32:21.755 info: client 213.133.116.2#57100: transfer of 'example.org/IN': 
 AXFR-style IXFR started
 Oct 11 18:32:22.264 info: client 62.75.149.27#45282: transfer of 'example.org/IN': 
 AXFR-style IXFR started

Die Zeilen bedeuten jeweils:

• Das geänderte Zonefile wurde vom DNS-Server erfolgreich geladen
• Der lokale Server sendet eine Benachrichtigung an die Secondaries, damit diese die Änderung ebenfalls übernehmen können.
• Die Secondaries 213.133.116.2 und 62.75.149.27 holen die geänderten Daten ab. (Pro Secondary jeweils ein Eintrag.)

Tippfehler oder falsche Angaben im Zonefile werden hier ebenfalls gemeldet.

 -------- Original-Nachricht --------
 Betreff: [Global] DNS Zonenfile Änderungen
 Datum: Thu, 4 Mar 2010 08:30:34 +0100
 
 Moin Moin,
 
 aus gegebenem Anlass: Immer wieder kommt es vor, dass jemand sein
 Zonenfile ändert, und es (scheinbar) funktioniert. Tage oder Wochen
 später dann sind die Domains nicht mehr erreichbar und es heißt "in den
 letzten ... Tagen/Wochen habe ich aber gar nichts mehr geändert". Das mag
 auch gut sein - ist mir auch selbst schon passiert, gerade wenn es um
 "mal eben schnell noch ... " ging.
 
 Nur ist der Fehler dann aber schon vor Tagen/Wochen passiert, und solange
 die Datensätze nicht abgelaufen (expired) sind, sind sie - die alten -
 noch im DNS System vorhanden. Die neuen aber, die aus der o.g. Änderung,
 sind bei einem Fehler im Zonenfile nie ins DNS System hinein gekommen!
 
 Was also tun? Zunächst kann man nach einer Änderung in einer
 Shell beobachten, ob es zu Fehlermeldungen kommt:
 
 tail -f /var/log/named/named.log 
 
 oder ggf nur Zeilen, in denen die eigene Domain (z.B. example.com)
 vorkommt:
 
 tail -f /var/log/named/named.log | grep example.com
 
 Diese Log-Datei ist daher genau aus diese Grunde auch auf dem
 Server lesbar.
 
 Auch sollte die in den DNS-Servern befindliche Seriennummer mit der
 aktuellen in der Zonendatei verglichen werden:
 
 dig -t SOA @dns1 example.com | grep '^example.com.*SOA' | awk '{ print $7 }'
 
 grep serial /etc/bind/pri.example.com | awk '{ print $1 }'  

Platzhalter für eigene Zonenfiles

Folgende Platzhalter können und sollten in eigenen Zonenfiles verwendet werden. Sie ermöglichen uns das Ändern von IP-Adressen und Hostnamen, ohne daß jeder Domainadmin seine Zonefiles anpassen muß. Insbesondere wird das Verschieben von Paketen zwischen physikalischen Hosts damit vereinfacht.

{PAC_IPNUMBER}

IP-Nummer des Pakets

{PAC_HOSTNAME}

Hostname des (Paket)s

{DOM_IPNUMBER}

IP-Nummer der Domain

{DOM_HOSTNAME}

Hostname der Domain

{PAC_DNS_MASTER}

{HS_DNS1_HOSTNAME}

{HS_DNS2_HOSTNAME}

{HS_DNS3_HOSTNAME}

{TTL}

{SIO}

Timestamp (Millisekunden)

{MX_HOSTNAME}

Die Hostnamen verstehen sich allesamt ohne den in Zonenfiles oft benötigten abschließenden Punkt.

Es wird dringend empfohlen, in eigenen Zonenfiles diese Platzhalter zu verwenden. Nur so können Domains bei Änderungen von IP Nummern oder anderen Umstrukturierungen weiter erreichbar bleiben, ohne selbst auf solche Ankündigungen und Ereignisse achten zu müssen und Anpassungen selber vornehmen zu müssen.

Beispiele

Domain Delegation

HowTo: erläutern.

[...]
pic.example.org. IN NS {HS_DNS1_HOSTNAME}.
pic.example.org. IN NS {HS_DNS2_HOSTNAME}.
pic.example.org. IN NS {HS_DNS3_HOSTNAME}.

---