Home|Cudeso|Linux|*NIX / BSD|Misc|
 

DDclient

Contents

1. Introduction

2. Useful resources

3. Install

4. Configuration



This page has been translated into Spanish language by Maria Ramos from Webhostinghub.com/support/edu.



1. Introduction

DDclient is a small but full featured client requiring only Perl and no additional modules. It runs under most UNIX OSes and has been tested under GNU/Linux and FreeBSD. Supported features include: operating as a daemon, manual and automatic updates, static and dynamic updates, optimized updates for multiple addresses, MX, wildcards, abuse avoidance, retrying failed updates, and sending update status to syslog and through e-mail.

2. Useful resources

The homepage of DDClient http://ddclient.sourceforge.net/.

3. Install

Installation of DDClient is extremely easy. Download the new package and untar it.
tar zxvf ddclient.tar.gz
Now navigate to the newly created ddclient directory and copy the ddclient script to /usr/sbin/ .
cd ddclient
cp ddclient /usr/sbin
That's all there is! There's no other installation required.

4. Configuration

DDClient uses a configuration script that needs to be placed in /etc/ or in /etc/ddclient (depending on the kind of distribution you're using). After the first run, you will notice that there's also a 'cache' file. This is used to store temporary data. During installation, an example config-file is created and it's fairly easy to use this as a start.

Copy the file sample-etc_ddclient.conf to /etc/and give it a new name.
cp sample-etc_ddclient.conf /etc/ddclient.conf
Now edit the file ddclient.conf with your favorite editor.

Because I'm only using the services of www.dyndns.org and www.easydns.org I can only speak for their configuration. These are the settings that you need to adjust.

syslog=yes
This gives you the ability to have a nice entry in your syslog-files.

use=if,   if=ppp0
By this, you specify that ddclient needs to look to the ppp0 interface. For normal DSL or Cable connections this will be your external interface.

protocol=dyndns2
Use the DYNDNS2 protocol (default)

server=members.dyndns.org   server=members.easydns.org
Update your account at dyndns.org or easydns.org


login=xxxxx   password=xxxxxx
Use these as your default login and password for the service that needs to be updated.

server=members.dyndns.org,   protocol=dyndns2, mydomain.dyndns.org
Update 'mydomain.dyndns.org' at dyndns.org (don't forget the comma's). You can add as many domains as you want. Just follow the same syntax for every seperate domain. Off course, the same goes for easydns :
   server=members.easydns.org,
   protocol=easydns,
   my-domain-to-update.com


That's all for the config-file. To get the updating to work automatic when your ip changes, you need to add the following line to /etc/ppp/ip-up.local/
/usr/sbin/ddclient -daemon=0 -syslog -use=if -if=$1 >/dev/null 2>&1
On the other hand, if you're using DHCP, you need to copy the file sample-etc_dhcpc_dhcpcd-eth0.exe to /etc/dhcpc/.

To make it easier, I've included a sample config-file :
daemon=300 # check every 300 seconds
syslog=yes # log update msgs to syslog
mail=webmaster@localhost.localdomain # mail update msgs to root
pid=/var/run/ddclient.pid # record PID in file.
use=if, if=ppp0


protocol=dyndns2
server=members.dyndns.org
login=mylogin
password=what-do-you-think?


server=members.dyndns.org, \
protocol=dyndns2 \
myhost.dyndns.org


server=members.easydns.com,
protocol=easydns,
login=mylogin,
password=what-do-you-think?
cudeso.be
That's everything you need to get DDClient working with a dyndns-account on Red Hat. Have Fun!!
Copyleft 2002-2007 - cudeso.bewebmaster@cudeso.betop