Ddclient

Version

Devel 10:

1.3.0-34

Contrib 10:

1.3.0-29

Contrib 9:

1.2.1-15

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

and for SME10 Brian Read AKA brianr

This contrib is the official and maintained version for SME Server 8,9 and 10. Note that some free and paid dynamic dns services have been incorporated into the contrib.

Installation

For SME 10For SME 9 and before

yum install --enablerepo=smecontribs smeserver-ddclient ddclient

yum install --enablerepo=smecontribs smeserver-ddclient

then

signal-event ddclient

or

signal-event post-upgrade; signal-event reboot

	Note:
	With the latest dev version you may see log entry of the form "WARNING: file /etc/ddclient/ddclient.conf: file /etc/ddclient/ddclient.conf must be accessible only by its owner (fixed)." this can be ignored as noise and will be addressed in future versions - as of 16dec23 - this has been fixed

There are panels for both the origoanl Server manager (SM1), and the new Server Manager (SM2)

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

	Note:
	As of Dec 2023 The original panel has not been updated to the latest options for ddclient, but the Server manager 2 panel has, see https://wiki.koozali.org/Server_Manager2 to install SM2. However the SM1 panel does work with the latest ddclient, but not all options are presented.

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 was:

bjrtest.ddns.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 and associated credentials to that provider.

Alternatively you can use the "Custom" are on the Dynamic Clients panel to set the contrib up to update a dynamic DNS entry directly with out needing to have setup a domain.

DB settings

Initial Panel

Modify domain parameters panel

Here is the equivalent DB entries for the screens:

[root@sme10 ~]# db configuration show ddclient
ddclient=service
    DeamonUpdate=360
    Extinterface=eth1
    ForceIP=
    SSL=yes
    cmd=
    debug=disabled
    fwlogin=
    fwpassword=
    method=web
    quiet=enabled
    status=enabled
    syslog=enabled
    urlcheckip=googledomains
    verbose=disabled
[root@sme10 ~]#

if you change any of these parameters, then you must run the update event as follows:

signal-event smeserver-ddclient-update

Removal

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

Debug

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

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 daemon

db configuration setprop debug enabled; 
db configuration setprop verbose enabled; 
db configuration quiet disabled; 
signal-event smeserver-ddclient-update

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 .

ID	Product	Version	Status	Summary (9 tasks) ⇒
12778	SME Contribs	11.0	CONFIRMED	perl-CGI 'startform' and 'endform' are dropped in favor of 'start_form' and 'end_form'
12676	SME Contribs	10.0	RESOLVED	when using pppoe 2nd instance of ddclient running as root
12675	SME Contribs	10.0	RESOLVED	ddclient still using old interface after console reconfigure
12600	SME Contribs	10.0	RESOLVED	old manager free form domain table not localised
12599	SME Contribs	10.0	CONFIRMED	ddclient[3019]: Scalar value @total_payload{$ipv} better written as $total_payload{$ipv} at /usr/sbin/ddclient line 4120.
12598	SME Contribs	10.0	RESOLVED	WARNING: file /etc/ddclient/ddclient.conf, line 50: Invalid Value for keyword 'protocol' = 'DYNHOST'
12448	SME Contribs	10.0	CONFIRMED	Create action script on conf file expansion to delete contents of the cache
12311	SME Contribs	10.0	CONFIRMED	Configuration DB option for getting IP does not work
12240	SME Contribs	10.0	CONFIRMED	Upgrade 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

---