Difference between revisions of "Ddclient"

From SME Server
Jump to navigationJump to search
(18 intermediate revisions by 4 users not shown)
Line 25: Line 25:
 
This contrib is the official and maintained version for SME Server 8, some Free or paid services of dynamic dns had been incorporated to the contribs.  
 
This contrib is the official and maintained version for SME Server 8, some Free or paid services of dynamic dns had been incorporated to the contribs.  
 
====Installation====
 
====Installation====
* For SME8
+
= For SME8 =
{{Note box|msg=The new version is now in smecontribs,see [[bugzilla: 8019]]}}
 
 
  yum install --enablerepo=smecontribs smeserver-ddclient
 
  yum install --enablerepo=smecontribs smeserver-ddclient
 +
then
 +
signal-event ddclient
 +
or
 +
signal-event post-upgrade; signal-event reboot
  
 +
= For SME9 =
 +
yum install --enablerepo=smecontribs smeserver-ddclient
 
then  
 
then  
 
  signal-event ddclient
 
  signal-event ddclient
Line 34: Line 39:
 
  signal-event post-upgrade; signal-event reboot
 
  signal-event post-upgrade; signal-event reboot
  
{{Note box|IF you want the latest version of smeserver-ddclient you have to install from [[stephdl]] repository}}
+
= For SME10 =
 
+
  yum install --enablerepo=smecontribs,openfusion smeserver-ddclient
You have to enable the [[stephdl]] and [[epel]] repositories.
+
then
 
 
  yum install --enablerepo=stephdl,epel smeserver-ddclient
 
 
  signal-event ddclient
 
  signal-event ddclient
 
or
 
or
Line 44: Line 47:
  
  
* For SME9
+
<headertabs/>
{{Note box|msg=The new version is now in smecontribs,see [[bugzilla: 8338]]}}
+
 
You have to enable the [[stephdl]] and [[epel]] repositories.
 
yum install --enablerepo=stephdl,epel smeserver-ddclient
 
  
then
 
signal-event ddclient
 
or
 
signal-event post-upgrade; signal-event reboot
 
  
 
A new panel will be added to the server manager.  
 
A new panel will be added to the server manager.  
Line 85: Line 82:
 
  config setprop ddclient DeamonUpdate 60
 
  config setprop ddclient DeamonUpdate 60
 
  signal-event ddclient
 
  signal-event ddclient
 
* full db ddclient
 
# config show ddclient
 
ddclient=service
 
    DeamonUpdate=300
 
    status=enabled
 
    urlcheckip=checkip.dyndns.org
 
  
 
* use SSL
 
* use SSL
Line 101: Line 91:
 
then
 
then
 
  signal-event ddclient
 
  signal-event ddclient
 +
 +
* full db ddclient
 +
# config show ddclient 
 +
ddclient=service
 +
    DeamonUpdate=300
 +
    SSL=yes
 +
    status=enabled
 +
    urlcheckip=checkip.dyndns.org
 +
 +
* method
 +
this will allow you to set the way you retrieve the new IP. By default this use the web request to an external url, which you can set. THis would work for all server, even if not gateway. However you can get many timeout depending of the website you try to reach to get the IP.
 +
 +
available methods :
 +
** smeIF : will get IP from external interface. BEST choice if your SME act as gateway.
 +
** smeCMD : will get the IP from the configuration DB : /sbin/e-smith/db configuration getprop ExternalInterface IPAddress
 +
** web : will get the ip from webpage at the URL in property 'urlcheckip' and use the filter from property 'webskip'
 +
** if : will get the IP from the network interface which name is in property 'Extinterface'
 +
** ip : will manually force the ip in property 'ForceIP'
 +
** cmd : will call the script in property 'cmd' and use the filter in the property 'cmdskip' to get the IP
 +
** 'CUSTOM' : replace CUSTOM by one of the accepted value of the ddclient command for use option. Yo also have to fill the property 'fwaddress' which is the gateway address, and could also fill the properties 'fwlogin', 'fwpassword' and 'fwskip'
 +
 +
    -use=2wire                  : obtain IP from 2Wire 1701HG Gateway at the -fw {address}.
 +
    -use=3com-3c886a            : obtain IP from 3com 3c886a 56k Lan Modem at the -fw {address}.
 +
    -use=3com-oc-remote812      : obtain IP from 3com OfficeConnect Remote 812 at the -fw {address}.
 +
    -use=alcatel-510            : obtain IP from Alcatel Speed Touch 510 at the -fw {address}.
 +
    -use=alcatel-stp            : obtain IP from Alcatel Speed Touch Pro at the -fw {address}.
 +
    -use=allnet-1298            : obtain IP from Allnet 1298 at the -fw {address}.
 +
    -use=cayman-3220h          : obtain IP from Cayman 3220-H DSL at the -fw {address}.
 +
    -use=cisco                  : obtain IP from Cisco FW at the -fw {address}.
 +
    -use=cisco-asa              : obtain IP from Cisco ASA at the -fw {address}.
 +
    -use=dlink-524              : obtain IP from D-Link DI-524 at the -fw {address}.
 +
    -use=dlink-604              : obtain IP from D-Link DI-604 at the -fw {address}.
 +
    -use=dlink-614              : obtain IP from D-Link DI-614+ at the -fw {address}.
 +
    -use=e-tech                : obtain IP from E-tech Router at the -fw {address}.
 +
    -use=elsa-lancom-dsl10      : obtain IP from ELSA LanCom DSL/10 DSL FW at the -fw {address}.
 +
    -use=elsa-lancom-dsl10-ch01 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}.
 +
    -use=elsa-lancom-dsl10-ch02 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}.
 +
    -use=linksys                : obtain IP from Linksys FW at the -fw {address}.
 +
    -use=linksys-rv042-wan1    : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}.
 +
    -use=linksys-rv042-wan2    : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}.
 +
    -use=linksys-ver2          : obtain IP from Linksys FW version 2 at the -fw {address}.
 +
    -use=linksys-ver3          : obtain IP from Linksys FW version 3 at the -fw {address}.
 +
    -use=linksys-wcg200        : obtain IP from Linksys WCG200 FW at the -fw {address}.
 +
    -use=linksys-wrt854g        : obtain IP from Linksys WRT854G FW at the -fw {address}.
 +
    -use=maxgate-ugate3x00      : obtain IP from MaxGate UGATE-3x00 FW at the -fw {address}.
 +
    -use=netcomm-nb3            : obtain IP from NetComm NB3 at the -fw {address}.
 +
    -use=netgear-dg834g        : obtain IP from netgear-dg834g at the -fw {address}.
 +
    -use=netgear-rp614          : obtain IP from Netgear RP614 FW at the -fw {address}.
 +
    -use=netgear-rt3xx          : obtain IP from Netgear FW at the -fw {address}.
 +
    -use=netgear-wgt624        : obtain IP from Netgear WGT624 at the -fw {address}.
 +
    -use=netgear-wpn824        : obtain IP from Netgear WPN824 FW at the -fw {address}.
 +
    -use=netopia-r910          : obtain IP from Netopia R910 FW at the -fw {address}.
 +
    -use=olitec-SX200          : obtain IP from olitec-SX200 at the -fw {address}.
 +
    -use=rtp300                : obtain IP from Linksys RTP300 at the -fw {address}.
 +
    -use=sitecom-dc202          : obtain IP from Sitecom DC-202 FW at the -fw {address}.
 +
    -use=smc-barricade          : obtain IP from SMC Barricade FW at the -fw {address}.
 +
    -use=smc-barricade-7004vbr  : obtain IP from SMC Barricade FW (7004VBR model config) at the -fw {address}.
 +
    -use=smc-barricade-7401bra  : obtain IP from SMC Barricade 7401BRA FW at the -fw {address}.
 +
    -use=smc-barricade-alt      : obtain IP from SMC Barricade FW (alternate config) at the -fw {address}.
 +
    -use=sohoware-nbg800        : obtain IP from SOHOWare BroadGuard NBG800 at the -fw {address}.
 +
    -use=sveasoft              : obtain IP from Sveasoft WRT54G/WRT54GS at the -fw {address}.
 +
    -use=vigor-2200usb          : obtain IP from Vigor 2200 USB at the -fw {address}.
 +
    -use=watchguard-edge-x      : obtain IP from Watchguard Edge X FW at the -fw {address}.
 +
    -use=watchguard-soho        : obtain IP from Watchguard SOHO FW at the -fw {address}.
 +
    -use=westell-6100          : obtain IP from Westell C90-610015-06 DSL Router at the -fw {address}.
 +
    -use=xsense-aero            : obtain IP from Xsense Aero at the -fw {address}.
 +
  
 
====Providers available====
 
====Providers available====
Line 126: Line 183:
  
 
====Debug====
 
====Debug====
If stuff goes bad you can debug
+
{{Note box|Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.}}
 +
 
 +
For debug mode you may need per-JSON-Any
 +
 
 +
To install that you will need the EPEL repo: https://wiki.contribs.org/Epel
 +
 
 +
Then
 +
yum --enablerepo=epel install perl-JSON-Any
 +
 
 +
* You can keep an eye on log
 +
watch 'cat /var/log/messages|grep SUCCESS'
 +
 
 +
* You can supervise dns record
 +
watch 'dig any your_dynamic_dns_host.xxx @dns_server_of_your_dynamic_dns_provider'
 +
 
 +
* If you want to know the dns servers of your dynamic provider, do
 +
dig any your_dynamic_dns_host.xxx
 +
and look about hosts in '''NS''' columns.
 +
 
 +
* If stuff goes bad you can debug and see what is happening to the deamon
 
  ddclient -daemon=0 -debug -verbose -noquiet
 
  ddclient -daemon=0 -debug -verbose -noquiet
 
and report please
 
and report please
 +
 +
* keep an eye on the ddclient cache
 +
less /var/cache/ddclient/ddclient.cache
 +
 
==== Bugs ====
 
==== Bugs ====
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla] and select the smeserver-ddclient component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ddclient|title=this link}}.
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla] and select the smeserver-ddclient component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ddclient|title=this link}}.
 +
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ddclient |noresultsmessage="No open bugs found."}}
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
 +
{{ #smechangelog: smeserver-ddclient }}
  
 
===smeserver.free.fr version===
 
===smeserver.free.fr version===

Revision as of 14:47, 23 July 2020


Version

Devel 10:
Contrib 10:
Contrib 9:
smeserver-ddclient
The latest version of smeserver-ddclient is available in the SME repository, click on the version number(s) for more information.






ddclient - DNS record updating

Use this contrib when you have a sme server connected to a ISP service using a dynamic IP, and you wish to host multiple domains.

ddclient is a client for updating dynamic DNS entries for domains hosted at different DNS providers.

Configure your dynamic host domains via the ddclient server manager panel.

ddclient can be used on servers configured in server gateway mode or in server only mode.

Smecontribs repository version

Maintainer

Stéphane de Labrusse AKA Stephdl

This contrib is the official and maintained version for SME Server 8, some Free or paid services of dynamic dns had been incorporated to the contribs.

Installation

[edit]
yum install --enablerepo=smecontribs smeserver-ddclient

then

signal-event ddclient

or

signal-event post-upgrade; signal-event reboot
yum install --enablerepo=smecontribs smeserver-ddclient

then

signal-event ddclient

or

signal-event post-upgrade; signal-event reboot
yum install --enablerepo=smecontribs,openfusion smeserver-ddclient

then

signal-event ddclient

or

signal-event post-upgrade; signal-event reboot



A new panel will be added to the server manager.

Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib

How to use

First you need to create a domain in the server-manager (domains panel) which must match the domain you set with your dynamic dns provider.

For example if the domain you made at DTdns is :

home.dtdns.net 

You have to create a relevant domain with this name.

Then go to the panel of "Dynamic clients", choose the domain you made then set your dynamic DNS provider eg (dtdns) and associated credentials to that provider.

DB settings

  • There are some of the services that you can use to detect your external ip
  • ip.changeip.com
  • ipdetect.dnspark.com
  • checkip.dyndns.org:8245
  • checkip.dyndns.org

If you want to change the service which verifies your external ip you can do :

config setprop ddclient urlcheckip ip.changeip.com
signal-event ddclient
  • Every 300s the contrib perform a check to verify if your ip has been changed to http://checkip.dyndns.org/. you can change the interval of the deamon update by a db command (by default it is 300 seconds). It seems that the minimum accepted is 60s. Possibly you could be blacklisted by providers if you decrease the time-out under of 300s.
config setprop ddclient DeamonUpdate 60
signal-event ddclient
  • use SSL

since ddclient 3.7.0 you can encrypt transactions to avoid clear messages. by default forced to yes

config setprop ddclient SSL yes

or

config setprop ddclient SSL no

then

signal-event ddclient
  • full db ddclient
# config show ddclient  
ddclient=service
   DeamonUpdate=300
   SSL=yes
   status=enabled
   urlcheckip=checkip.dyndns.org
  • method

this will allow you to set the way you retrieve the new IP. By default this use the web request to an external url, which you can set. THis would work for all server, even if not gateway. However you can get many timeout depending of the website you try to reach to get the IP.

available methods :

    • smeIF : will get IP from external interface. BEST choice if your SME act as gateway.
    • smeCMD : will get the IP from the configuration DB : /sbin/e-smith/db configuration getprop ExternalInterface IPAddress
    • web : will get the ip from webpage at the URL in property 'urlcheckip' and use the filter from property 'webskip'
    • if : will get the IP from the network interface which name is in property 'Extinterface'
    • ip : will manually force the ip in property 'ForceIP'
    • cmd : will call the script in property 'cmd' and use the filter in the property 'cmdskip' to get the IP
    • 'CUSTOM' : replace CUSTOM by one of the accepted value of the ddclient command for use option. Yo also have to fill the property 'fwaddress' which is the gateway address, and could also fill the properties 'fwlogin', 'fwpassword' and 'fwskip'
   -use=2wire                  : obtain IP from 2Wire 1701HG Gateway at the -fw {address}.
   -use=3com-3c886a            : obtain IP from 3com 3c886a 56k Lan Modem at the -fw {address}.
   -use=3com-oc-remote812      : obtain IP from 3com OfficeConnect Remote 812 at the -fw {address}.
   -use=alcatel-510            : obtain IP from Alcatel Speed Touch 510 at the -fw {address}.
   -use=alcatel-stp            : obtain IP from Alcatel Speed Touch Pro at the -fw {address}.
   -use=allnet-1298            : obtain IP from Allnet 1298 at the -fw {address}.
   -use=cayman-3220h           : obtain IP from Cayman 3220-H DSL at the -fw {address}.
   -use=cisco                  : obtain IP from Cisco FW at the -fw {address}.
   -use=cisco-asa              : obtain IP from Cisco ASA at the -fw {address}.
   -use=dlink-524              : obtain IP from D-Link DI-524 at the -fw {address}.
   -use=dlink-604              : obtain IP from D-Link DI-604 at the -fw {address}.
   -use=dlink-614              : obtain IP from D-Link DI-614+ at the -fw {address}.
   -use=e-tech                 : obtain IP from E-tech Router at the -fw {address}.
   -use=elsa-lancom-dsl10      : obtain IP from ELSA LanCom DSL/10 DSL FW at the -fw {address}.
   -use=elsa-lancom-dsl10-ch01 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}.
   -use=elsa-lancom-dsl10-ch02 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}.
   -use=linksys                : obtain IP from Linksys FW at the -fw {address}.
   -use=linksys-rv042-wan1     : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}.
   -use=linksys-rv042-wan2     : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}.
   -use=linksys-ver2           : obtain IP from Linksys FW version 2 at the -fw {address}.
   -use=linksys-ver3           : obtain IP from Linksys FW version 3 at the -fw {address}.
   -use=linksys-wcg200         : obtain IP from Linksys WCG200 FW at the -fw {address}.
   -use=linksys-wrt854g        : obtain IP from Linksys WRT854G FW at the -fw {address}.
   -use=maxgate-ugate3x00      : obtain IP from MaxGate UGATE-3x00 FW at the -fw {address}.
   -use=netcomm-nb3            : obtain IP from NetComm NB3 at the -fw {address}.
   -use=netgear-dg834g         : obtain IP from netgear-dg834g at the -fw {address}.
   -use=netgear-rp614          : obtain IP from Netgear RP614 FW at the -fw {address}.
   -use=netgear-rt3xx          : obtain IP from Netgear FW at the -fw {address}.
   -use=netgear-wgt624         : obtain IP from Netgear WGT624 at the -fw {address}.
   -use=netgear-wpn824         : obtain IP from Netgear WPN824 FW at the -fw {address}.
   -use=netopia-r910           : obtain IP from Netopia R910 FW at the -fw {address}.
   -use=olitec-SX200           : obtain IP from olitec-SX200 at the -fw {address}.
   -use=rtp300                 : obtain IP from Linksys RTP300 at the -fw {address}.
   -use=sitecom-dc202          : obtain IP from Sitecom DC-202 FW at the -fw {address}.
   -use=smc-barricade          : obtain IP from SMC Barricade FW at the -fw {address}.
   -use=smc-barricade-7004vbr  : obtain IP from SMC Barricade FW (7004VBR model config) at the -fw {address}.
   -use=smc-barricade-7401bra  : obtain IP from SMC Barricade 7401BRA FW at the -fw {address}.
   -use=smc-barricade-alt      : obtain IP from SMC Barricade FW (alternate config) at the -fw {address}.
   -use=sohoware-nbg800        : obtain IP from SOHOWare BroadGuard NBG800 at the -fw {address}.
   -use=sveasoft               : obtain IP from Sveasoft WRT54G/WRT54GS at the -fw {address}.
   -use=vigor-2200usb          : obtain IP from Vigor 2200 USB at the -fw {address}.
   -use=watchguard-edge-x      : obtain IP from Watchguard Edge X FW at the -fw {address}.
   -use=watchguard-soho        : obtain IP from Watchguard SOHO FW at the -fw {address}.
   -use=westell-6100           : obtain IP from Westell C90-610015-06 DSL Router at the -fw {address}.
   -use=xsense-aero            : obtain IP from Xsense Aero at the -fw {address}.


Providers available

Here the official wiki

  • Dyndns.org
  • ZoneEdit.com
  • Easydns.com
  • Hammernode (hn.org)
  • dslreports.com
  • eurodyndns.org
  • Dtdns.com
  • loopia.se
  • dnspark.com
  • Dynhost (ovh.com)
  • Noip.com
  • Changeip.com
  • Namecheap

If your dynamic dns provider is not available in smeserver-ddclient, please raise a bug and provide the settings for your provider with ddclient (search for settings with google).

Removal

yum remove smeserver-ddclient
signal-event post-upgrade; signal-event reboot

Debug

Important.png Note:
Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.


For debug mode you may need per-JSON-Any

To install that you will need the EPEL repo: https://wiki.contribs.org/Epel

Then

yum --enablerepo=epel install perl-JSON-Any
  • You can keep an eye on log
watch 'cat /var/log/messages|grep SUCCESS'
  • You can supervise dns record
watch 'dig any your_dynamic_dns_host.xxx @dns_server_of_your_dynamic_dns_provider'
  • If you want to know the dns servers of your dynamic provider, do
dig any your_dynamic_dns_host.xxx

and look about hosts in NS columns.

  • If stuff goes bad you can debug and see what is happening to the deamon
ddclient -daemon=0 -debug -verbose -noquiet

and report please

  • keep an eye on the ddclient cache
less /var/cache/ddclient/ddclient.cache

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-ddclient component or use this link .

IDProductVersionStatusSummary (8 tasks)
12676SME Contribs10.0RESOLVEDwhen using pppoe 2nd instance of ddclient running as root
12675SME Contribs10.0RESOLVEDddclient still using old interface after console reconfigure
12600SME Contribs10.0RESOLVEDold manager free form domain table not localised
12599SME Contribs10.0CONFIRMEDddclient[3019]: Scalar value @total_payload{$ipv} better written as $total_payload{$ipv} at /usr/sbin/ddclient line 4120.
12598SME Contribs10.0RESOLVEDWARNING: file /etc/ddclient/ddclient.conf, line 50: Invalid Value for keyword 'protocol' = 'DYNHOST'
12448SME Contribs10.0CONFIRMEDCreate action script on conf file expansion to delete contents of the cache
12311SME Contribs10.0CONFIRMEDConfiguration DB option for getting IP does not work
12240SME Contribs10.0CONFIRMEDUpgrade Server manager to incorporate ddclient 3.10 new options.

Changelog

Only released version in smecontrib are listed here.

smeserver-ddclient Changelog: SME 10 (smecontribs)
2024/03/01 Brian Read 1.3.0-29.sme
- Edit Menu entry to conform to new arrangements [SME: 12493]

2023/11/10 Brian Read 1.3.0-28.sme
- Update template for deprecated commands and v3.11.1 ddclient [SME: 12427]

- Update SM2 code to show all new protocols etc
2023/11/08 Brian Read 1.3.0-27.sme
- Alter require to greater than or equal to 3.11.1 [SME: 12425]
2023/02/13 Brian Read 1.3.0-26.sme
- Remove 3.10 as a requirement in spec

2023/01/25 Brian Read 1.3.0-25.sme
- Remove the ddc_ from the front of the (translateble) messages [SME: 12217]

- Update Template files for changes in conf format and contents for 3.10.0


smeserver.free.fr version

Important.png Note:
This contribs is no longer maintained and may be unstable or broke your system


Warning.png Warning:
When you have the smeserver.free.fr sme7-ddclient contrib installed and you run yum upgrade with the smecontribs repository enabled on your server, watch out! There is a smeserver-ddclient package that will get installed as an upgrade and this conflicts with the sme7-ddclient package ! Remove the sme7-ddclient first, see instructions below.


Note: This RPM works with SME 8 or SME 7

The smeserver.free.fr site appears to be defunct (since at least April 2012), so this article provides a link to the contrib at another external file download site.

This contrib has some additional features like the ability to select the method on how the detect the external IP address and the ability to publish arbitrary domain names (i.e. not just the ones that are on your server).

Installation

Download the latest rpm version from

http://www.files.com/shared/4f89e32b9c187/sme7-ddclient-3.7.3-7.noarch.zip

to an empty folder eg /tmp and unzip the file

unzip sme7-ddclient*

The currently available rpm is:

sme7-ddclient-3.7.3-7.noarch.rpm

Then cd to that folder and install the rpm (change the rpm name in the following command to match the latest available version)

cd /tmp
yum localinstall sme7-ddclient*.rpm

Removal

yum remove sme7-ddclient
signal-event post-upgrade;signal-event reboot

Using SME default dynamic client & external DNS CNAME entries

In many cases, you really do not need to use ddclient or some variation of it eg sme7-ddclient or smeserver-ddclient

You can use the built in dynamic client for your main domain (accessible by running Configure this server from the admin console).

Then create CNAME entries in external DNS records which point at the main domain name.

SME will update the main domain name/dynamicIP change, and the additional domains will follow it as the external IP changes.

The use of this method is only possible where the full DNS records are accessible & editable by admin users.

In some situations with DNS service providers, these DNS records are not accessible, in that case you will need to use one of the ddclient methods.

Also see http://bugs.contribs.org/show_bug.cgi?id=6206#c9 which says:

"I notice that you mention two dyndns domains, but you should be able to set up domain2.x.y to be a CNAME for domain1.x.y, then configure domain1.x.y with the builtin client."