Difference between revisions of "Bering-uClibc 4.x - User Guide - Advanced Topics - Setting Up a Dynamic DNS Client"

From bering-uClibc
Jump to: navigation, search
(Created page with '==About ez-ipupdate== Ez-ipupdate is a small utility for updating your host name IP for any of the dynamic DNS service offered at: http://www.ez-ip.net<br> http://www.justlinux…')
 
(Added navigation Header and Footer (plus a few cosmetic WikiMarkup tidy-ups))
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{| summary="Navigation header" width="100%"
 +
! colspan="3" align="center" | [[Bering-uClibc 4.x - User Guide - Advanced Topics - Setting Up a Dynamic DNS Client|Advanced Topics - Setting Up a Dynamic DNS Client]]
 +
|-
 +
| width="20%" align="left"  |
 +
! width="60%" align="center" | [[Bering-uClibc 4.x - User Guide]]
 +
| width="20%" align="right"  | [[Bering-uClibc 4.x - User Guide - Advanced Topics - Setting Up a Wireless Access Point|Next]]
 +
|}
 +
----
 +
 +
 
==About ez-ipupdate==
 
==About ez-ipupdate==
  
Ez-ipupdate is a small utility for updating your host name IP for any of
+
Ez-ipupdate is a small utility for updating your host name IP for any of the dynamic DNS services offered at:
the dynamic DNS service offered at:
+
* http://www.ez-ip.net
 +
* http://www.justlinux.com
 +
* http://www.dhs.org
 +
* http://www.dyndns.org
 +
* http://www.ods.org
 +
* http://gnudip.cheapnet.net (GNUDip)
 +
* http://www.dyn.ca (GNUDip)
 +
* http://www.tzo.com
 +
* http://www.easydns.com
 +
* http://www.dyns.cx
 +
* http://www.hn.org
 +
* http://www.zoneedit.com
 +
 
  
http://www.ez-ip.net<br>
+
The key features are:
http://www.justlinux.com<br>
+
* Support for multiple service types
http://www.dhs.org<br>
+
* Updating your IP address if it changes.
http://www.dyndns.org<br>
+
http://www.ods.org<br>
+
http://gnudip.cheapnet.net (GNUDip)<br>
+
http://www.dyn.ca (GNUDip)<br>
+
http://www.tzo.com<br>
+
http://www.easydns.com<br>
+
http://www.dyns.cx<br>
+
http://www.hn.org<br>
+
http://www.zoneedit.com<br>
+
  
The key features are: support for multiple service types and updating your
 
IP address if it changes.
 
  
To install the <tt>ezipupd.lrp</tt> package, edit <tt>leaf.cfg</tt> file and add <tt>ezipupd.lrp</tt> in the list of packages to be loaded at boot.
+
To install the <code class="filename">ezipupd.lrp</code> package, edit <code class="filename">leaf.cfg</code> file and add <code class="filename">ezipupd.lrp</code> in the list of packages to be loaded at boot.
 
   
 
   
 
==Configuring ez-ipupdate==
 
==Configuring ez-ipupdate==
You can edit the ez-ipupdate configuration file through the package
+
You can edit the ez-ipupdate configuration file through the package configuration menu:
configuration menu:
+
  
 
                         ez-ipupd configuration files
 
                         ez-ipupd configuration files
Line 35: Line 45:
  
  
The parameters allowed in the configuration file are the followings:
+
The parameters allowed in the configuration file are the following:
 
   address              usage: address=[ip address]
 
   address              usage: address=[ip address]
 
   cache-file            usage: cache-file=[cache file]
 
   cache-file            usage: cache-file=[cache file]
Line 91: Line 101:
 
  #url=<url>
 
  #url=<url>
  
The four most important entries for a typical LEAF Bering-uClibc
+
The four most important entries for a typical LEAF Bering-uClibc installation will be explained below:
installation will be explained below:
+
 
 +
;service-type : make sure to add the according service-type. See above for the list of available services.
 +
;user : here you have to provide your username and password for the choosen service seperated by a colon.
 +
;interface : this defines your interface to the internet - the one which is changing from time to time and whose ip should be changed at your dynamic DNS service (usually eth0 or ppp0)
 +
;host : the host(s) you like to have been updated. It is possible to update more than one host for a service-type. To allow that, add all your hosts separated by a comma.
  
'''service-type''' - make shure to add the according service-type. See above the
 
list of available services.<br>
 
'''user''' - here you have to provide your username and password for the choosen
 
service seperated by a colon.<br>
 
'''interface''' - this defines your interface to the internet - the one which is
 
changing from time to time and whose ip should be changed at your dynamic
 
DNS service (usually eth0 or ppp0)<br>
 
'''host''' - the host(s) you like to have been updated. It is possible to update
 
more than one host for a service-type. To allow that, add all your hosts
 
separated by a comma.
 
  
 
'''Please note:''' The options <tt>cache-file</tt> and <tt>daemon</tt> aren't needed. <tt>notify-email</tt> doesn't work today.
 
'''Please note:''' The options <tt>cache-file</tt> and <tt>daemon</tt> aren't needed. <tt>notify-email</tt> doesn't work today.
Line 127: Line 131:
  
 
==Configure shorewall==
 
==Configure shorewall==
You need to add a rule to allow accessing port 80 from your firewall on the
+
You need to add a rule to allow accessing port 80 from your firewall on the net zone to make <tt>ez-ipupdate</tt> work.
net zone to make <tt>ez-ipupdate</tt> work. Therefor add to <tt>/etc/shorewall/rules</tt>
+
Therefore add to <tt>/etc/shorewall/rules</tt>
  HTTP/ACCEPT        fw      net
+
 
 +
  HTTP(ACCEPT)         fw      net
  
 
Don't forget to save your configuration with <tt>lrcfg -> s</tt>!
 
Don't forget to save your configuration with <tt>lrcfg -> s</tt>!
 +
 +
 +
----
 +
{| summary="Navigation footer" width="100%"
 +
| width="40%" align="left"  |
 +
| width="20%" align="center" | [[Bering-uClibc 4.x - User Guide - Advanced Topics|Up]]
 +
| width="40%" align="right"  | [[Bering-uClibc 4.x - User Guide - Advanced Topics - Setting Up a Wireless Access Point|Next]]
 +
|}
 +
 +
[[Category:Bering-uClibc 4.x]]
 +
[[Category:User Guide]]

Latest revision as of 20:59, 29 November 2010

Advanced Topics - Setting Up a Dynamic DNS Client
Bering-uClibc 4.x - User Guide Next


About ez-ipupdate

Ez-ipupdate is a small utility for updating your host name IP for any of the dynamic DNS services offered at:


The key features are:

  • Support for multiple service types
  • Updating your IP address if it changes.


To install the ezipupd.lrp package, edit leaf.cfg file and add ezipupd.lrp in the list of packages to be loaded at boot.

Configuring ez-ipupdate

You can edit the ez-ipupdate configuration file through the package configuration menu:

                       ez-ipupd configuration files

      1) ez-ipupdate configuration file

 q) quit
---------------------------------------------------------------------------
       Selection:


The parameters allowed in the configuration file are the following:

 address               usage: address=[ip address]
 cache-file            usage: cache-file=[cache file]
 cloak-title           usage: cloak-title=[title]
 daemon                usage: daemon=[command]
 execute               usage: execute=[shell command]
 debug                 usage: debug
 foreground            usage: foreground
 pid-file              usage: pid-file=[file]
 host                  usage: host=[host]
 interface             usage: interface=[interface]
 mx                    usage: mx=[mail exchanger]
 max-interval          usage: max-interval=[number of seconds between updates]
 notify-email          usage: notify-email=[address to email if bad things happen]
 offline               usage: offline
 retrys                usage: retrys=[number of trys]
 server                usage: server=[server name]
 service-type          usage: service-type=[service type]
 timeout               usage: timeout=[sec.millisec]
 resolv-period         usage: resolv-period=[time between failed resolve attempts]
 period                usage: period=[time between update attempts]
 url                   usage: url=[url]
 user                  usage: user=[user name][:password]
 run-as-user           usage: run-as-user=[user]
 run-as-euser          usage: run-as-euser=[user] (this is not secure)
 wildcard              usage: wildcard
 quiet                 usage: quiet
 connection-type       usage: connection-type=[connection type]
 request               usage: request=[request uri]
 partner               usage: partner=[easydns partner]

Here is how it could look like:

service-type=zoneedit
user=myname:mypassword
interface=eth0
host=mydomain.com
#notify-email=john.doe@mydomain.com
# other options:
#address=<ip address>
#cache-file=/tmp/ez-ipup
#daemon
#debug
#foreground
#host=<host>
#interface=<interface>
#mx=<mail exchanger>
#retrys=<number of trys>
#run-as-user=<user>
#run-as-euser=<user>
#server=<server name>
#timeout=<sec.millisec>
#max-interval=

The four most important entries for a typical LEAF Bering-uClibc installation will be explained below:

service-type 
make sure to add the according service-type. See above for the list of available services.
user 
here you have to provide your username and password for the choosen service seperated by a colon.
interface 
this defines your interface to the internet - the one which is changing from time to time and whose ip should be changed at your dynamic DNS service (usually eth0 or ppp0)
host 
the host(s) you like to have been updated. It is possible to update more than one host for a service-type. To allow that, add all your hosts separated by a comma.


Please note: The options cache-file and daemon aren't needed. notify-email doesn't work today.

Using ez-ipupdate

Through dhclient exit-hook script:

reload_all() {
  /sbin/shorewall restart
echo "Starting ez-ipupd from dhclient ..."
  /etc/init.d/ez-ipupd start
}

Through ppp's /etc/ppp/ip-up script: All you need is to add the command /etc/init.d/ez-ipupd -start to /etc/ppp/ip-up.

# Main Script starts here
#
/etc/init.d/ez-ipupd restart
run-parts /etc/ppp/ip-up.d
[ -x /bin/beep ] && /bin/beep -f 600 -n -f 900 -n -f1200 -n -f1800
# last line

Configure shorewall

You need to add a rule to allow accessing port 80 from your firewall on the net zone to make ez-ipupdate work. Therefore add to /etc/shorewall/rules

HTTP(ACCEPT)         fw       net

Don't forget to save your configuration with lrcfg -> s!



Up Next