====== DDNS mit ddclient ======
[[http://ddclient.sourceforge.net/|ddclient]] ist ein DynDNS-Client für Unix und Linux der viele verschiedene Protokolle zum Verwalten von dynamischen Domains spricht. Auch für unseren [[:ddns|DDNS-Dienst]] ist dieses Multitalent geeignet.

===== Über ddclient =====

^ getestete Version | [[http://sourceforge.net/project/showfiles.php?group_id=116817&package_id=127036&release_id=424749|3.7.0]] |
^ Autor(en)         | Ursprüngliche Version von Paul Burry, wimpunkt und andere |
^ Plattformen       | UNIX/Linux (Perl) |
^ Lizenz            | GNU Public License |
^ DDNS-Support      | tiggersWelt.net DDNS-Service und einige weitere |
^ SSL-Support       | Ja, sofern entsprechende Perl-Libraries installiert sind |
^ mit eingeschränkten Benutzerrechten nutzbar | Ja, jedoch nicht ausführlich getestet |

===== Installation und Konfiguration =====
Nach dem Download von ddclient auf [[http://ddclient.sourceforge.net/|der Homepage]] oder [[http://sourceforge.net/projects/ddclient/|der Projektseite bei Sourceforge]] ist das Programm von jeder Position im Dateisystem aus ohne Probleme zu starten. Abgesehen von dem Hauptprogramm und der Konfigurtionsdatei werden keine weiteren Dateien benötigt.

ddclient erwartet seine Konfigurationsdatei per Default im Verzeichnis /etc/ddclient. Diese Einstellung ist jedoch jederzeit mit dem Parameter "-file" abzuändern. Sofern ddclient als Systemdienst laufen soll, wird jedoch die Standard-Position empfohlen.


==== Konfigurationsdatei ====
Wir gehen von dem Fall aus, dass die Konfigurationsdatei unter /etc/ddclient/ddclient.conf zu finden ist.

<code>protocol=dyndns2
server=[ddns|ssl].tiggerswelt.net

ssl=yes|no
use=web, web=ddns.tiggerswelt.net/nic/checkip, web-skip='Current IP Address:'

login=<Benutzername>
password=<DDNS-Passwort></code>

  * Der Parameter //ssl// gibt an, ob SSL-Verschlüsselung für die Verbindung zum Server verwendet werden soll
  * //<Benutzername>// und //<DDNS-Passwort>// muss durch einen gültigen tiggersWelt.net-Benutzeraccount ersetzt werden, der DDNS-Rechte besitzt

Sofern ddclient als Systemdienst laufen soll, sind folgende Einstellungen zu beachten:

<code>daemon=300
syslog=yes
mail=root
mail-failure=root
pid=/var/run/ddclient.pid</code>

  * Die Einstellung //deamon// gibt an, dass ddclient als Dienst im Hintergrund laufen soll und alle //n// Sekunden (im Beispiel 300) ein Update der Domain vornehmen soll.
  * Die Option //syslog// schickt alle Meldungen von ddclient an den lokalen Syslog-Dienst, wo diese Nachrichten weiterverarbeitet werden können
  * //mail// und //mail-failure// definieren E-Mail-Konten an die Status-Änderungen der Domain geschickt werden

Optional und zur besseren Ausnutzung der DDNS-Features sind folgende Parameter

<code>
wildcard=yes|no
mx=mail.server.tld
backupmx=yes|no
static=yes|no
custom=yes|no</code>

  * //wildcard// (de)aktiviert das heiß begehrte Wildcard-Feature bei dem alles unterhalb der DDNS-Zone (sofern nicht anderweitig definiert) auf die aktuell gesetzte IP verweist.
  * //mx// setzt einen eigenen Mailserver für die DDNS-Zone
  * //backupmx// gibt an, ob dieser Mailserver als primärer oder sekundärer Mailserver fungieren soll
  * //static// und //custom// wählen den entsprechenden DynDNS-Dienst aus. Beim tiggersWelt-DDNS haben diese Optionen nur auswirkungen auf die Lebensdauer (TTL) der DNS-Datensätze und sind in der Regel nicht notwendig.

Am Ende der Konfigurationsdatei steht immer das wohl Wichtigste überhaupt: Die DDNS-Domainnamen.
Entweder eine einzelne Domain:

<code>dyn.domain.tld</code>

Oder mehrere Domains durch ein Komma getrennt:

<code>dyn.domain.tld,dyndom.tld,www.dyn.domain.tld</code>

Hilfreich vielleicht auch die [[.ddclient:config|Beispiel-Konfiguration]]

==== ddclient als Systemdienst ====
ddclient liefert von Haus aus dieverse Beispiel-Konfigurationen mit, darunter auch ein paar Skripte um ddclient auf verschiedenen Linux-Distrubutionen beim Systemstart automatisch mitzustarten.

Die beiliegenden rc-Skripte laufen auf gängigen Linux-Distributionen wie z.B. SuSE/Novell Linux, Redhat Linux, Ubuntu oder Debian.

Sofern das ddclient-Programm nicht unter /usr/sbin vorzufinden ist, sollte im entsprechenden Skript dieser Pfad angepasst werden. Ansonsten den Skript einfach nach /etc/init.d bzw. /etc/rd.d kopieren und Symlinks für die gewünschten Runlevels anlegen oder ein der Distribution beiliegendes Tool (z.B. insserv oder YaST) verwenden.








===== Hilfe und andere Links =====
  * Eine Zusammenfassung der Kommandozeilen-Parameter von ddclient gibt es [[http://ddclient.sourceforge.net/?page=1|hier]]
  * Eine Dokumentation aller [[http://ddclient.sourceforge.net/?page=2|unterstützter Protokolle]]

Eine Garantie auf die Funktionalität von ddclient und die unversehrtheit des Systemes auf dem ddclient ausgeführt wird kann leider nicht gegeben werden. Bei Problemen mit der Bedienung von ddclient im Bezug auf die Nutzung des tiggersWelt.net DDNS-Services hilft der Support gerne weiter. E-Mail: [[dyndns@tiggerswelt.net]] (Bei Fehlerfällen bitte genaue Fehlerbeschreibung mit ggf. der Log-Datei mitsenden.)

=== Tipp: Max-Interval (Heartbeat) ===
Manchmal kommt es vor, dass der "Heartbeat" ([[ddns:#heartbeat|siehe]]) die Domain nach 30 Stunden auf "offline" setzt, wenn sich innerhalb dieser Zeit die IP nicht geändert hat. Um dies zu vermeiden, kann man das maximale Intervall für DDNS-Updates manuell einstellen:
Es gibt einen schlecht dokumentierten Konfigurationsparameter namens "max_interval". Dieser ist per Default auf 60 Tage gesetzt, kann aber manuell auch niedriger eingestellt werden. Hierzu einfach die Zeile

<code>
max-interval=43200 # 60*60*12 Sekunden = 12 Stunden
</code>

der Datei ddclient.conf hinzufügen. In dieser Beispielkonfiguration wird alle 12 Stunden ein Update des DDNS-Servers forciert, auch wenn die IP-Adresse sich nicht geändert hat.