681
edits
Changes
From SME Server
Jump to navigationJump to search→Installation
==Version==
==Version==
{{#smeversion:smeserver-ddclient}}
{{#smeversion:smeserver-ddclient}}
== ddclient - DNS record updating ==
== ddclient - DNS record updating ==
[mailto:stephdl@de-labrusse.fr Stéphane de Labrusse] AKA [[User:Stephdl|Stephdl]]
[mailto:stephdl@de-labrusse.fr Stéphane de Labrusse] AKA [[User:Stephdl|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.
and for SME10 [mailto:brianr@koozali.org Brian Read] AKA [[User:brianr|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.
Also note that ddclient is maintained on github [https://github.com/ddclient/ddclient here] and the full help manual page is [https://wiki.koozali.org/Ddclient-help here].
====Installation====
====Installation====
= For SME8 =
<tabs container><tab name="For SME 10">
yum install --enablerepo=smecontribs smeserver-ddclient
yum install --enablerepo=smecontribs smeserver-ddclient ddclient
= For SME9 =
</tab>
<tab name="For SME 9 and before">
yum install --enablerepo=smecontribs smeserver-ddclient
yum install --enablerepo=smecontribs smeserver-ddclient
then
then
or
or
signal-event post-upgrade; signal-event reboot
signal-event post-upgrade; signal-event reboot
<headertabs/>
</tab>
</tabs>
There are panels for both the original 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 box| 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====
====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.<br />
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.<br />
For example if the domain you made at DTdns is :
For example if the domain you made was:
bjrtest.ddns.net
You have to create a relevant domain with this name.
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.
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====
====DB settings====
[[File:Screenshot from 2023-12-17 12-02-50.png|alt=|thumb|600x600px|Initial Panel|none]]
[[File:Screenshot from 2023-12-17 12-26-20.png|Modify domain parameters panel|alt=|thumb|600x600px|none]]
Here is the
equivalent DB entries for the screens:<syntaxhighlight lang="shell">
[root@sme10 ~]# db configuration show ddclient
ddclient=service
DeamonUpdate=300
DeamonUpdate=360
Extinterface=eth1
ForceIP=
SSL=yes
SSL=yes
cmd=
debug=disabled
fwlogin=
fwpassword=
method=web
quiet=enabled
status=enabled
status=enabled
urlcheckip=checkip.dyndns.org
syslog=enabled
urlcheckip=googledomains
verbose=disabled
[root@sme10 ~]#
</syntaxhighlight>if you change any of these parameters, then you must run the update event as follows:<syntaxhighlight>
signal-event smeserver-ddclient-update
</syntaxhighlight>
====Removal====
====Removal====
yum remove smeserver-ddclient ddclient
yum remove smeserver-ddclient
signal-event post-upgrade; signal-event reboot
signal-event post-upgrade; signal-event reboot
{{Note box|Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.}}
{{Note box|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'
watch 'cat /var/log/messages|grep SUCCESS'
and look about hosts in '''NS''' columns.
and look about hosts in '''NS''' columns.
* If stuff goes bad you can debug and see what is happening to the deamon
* 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
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}}.
===smeserver.free.fr version===
{{#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.
====Installation====
{{ #smechangelog: smeserver-ddclient }}
