====== ddclient ======

**General Information**

Using ddclient to update your dynamic IP for OpenDNS.

**Checklist**
  * Distro(s): Enterprise Linux

----

===== Prep OpenDNS Account =====

  - Login to OpenDNS (https://login.opendns.com)
  - Click on the Settings tab.
  - Select the desired network in the drop down box.
  - Click on Advanced Settings on the left.
  - Ensure that "Enable dynamic IP update" is checked.

----

===== ddclient setup =====

Download, install, configure ddclient.

==== Download ====

  * Website: http://sourceforge.net/projects/ddclient/
  * Wget 3.8.3 (current as of 08/04/2015)
  * <code bash>
wget http://downloads.sourceforge.net/project/ddclient/ddclient/ddclient-3.8.3.tar.bz2
</code>

==== Install ====

Install perl ssl library
<code bash>
yum install perl-IO-Socket-SSL
</code>

Extract and un-archive
<code bash>
tar -jxvf ddclient-3.8.3.tar.bz2
</code>
  * Note: if you receive an error while extracting, you might be on a minimal install and need to install bzip2 (yum install bzip2)

Create required directories
<code bash>
mkdir /etc/ddclient
mkdir /var/cache/ddclient
</code>

Copy files to system locations
<code bash>
cp sample-etc_ddclient.conf /etc/ddclient/ddclient.conf
cp ddclient-3.8.3/ddclient /usr/sbin/
cp ddclient-3.8.3/sample-etc_rc.d_init.d_ddclient /etc/rc.d/init.d/ddclient
</code>

==== Configure ====

Change perms, edit config file
<code bash>
chown root:root /etc/ddclient/ddclient.conf
chmod 600 /etc/ddclient/ddclient.conf
vi /etc/ddclient/ddclient.conf

## OpenDNS.com account-config
use=web, web=myip.dnsomatic.com
ssl=yes
server=updates.opendns.com
protocol=dyndns2
login=email@domain.com
password=mypasshere
MyNetwork
</code>
  * Replace login and password with OpenDNS login credentials.
  * Replace "MyNetwork" with the name of the network in your OpenDNS dashboard.

Test the config
<code bash>
ddclient -daemon=0 -debug -noquiet
</code>
  * Should see debug output, followed by "SUCCESS:  updating MyNetwork: good: IP address set to xxx.xxx.xxx.xxx"

Enable/start the service
<code bash>
chkconfig --add ddclient
service ddclient start
</code>

----