Changes

From SME Server
Jump to navigationJump to search

Ddclient (view source)

Revision as of 15:58, 18 December 2023

3,637 bytes added ,  15:58, 18 December 2023
→‎Installation
Line 1: Line 1:  +
 +
 +
==Version==
 +
{{#smeversion:smeserver-ddclient}}
 +
 
== ddclient - DNS record updating ==
 
== 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.
 
ddclient is a client for updating dynamic DNS entries for domains hosted at different DNS providers.
   −
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.
+
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 ====
 +
[mailto:stephdl@de-labrusse.fr Stéphane de Labrusse] AKA [[User:Stephdl|Stephdl]]
 +
 
 +
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====
 +
<tabs container><tab name="For SME 10">
 +
yum install --enablerepo=smecontribs smeserver-ddclient ddclient
 +
 
 +
</tab>
 +
<tab name="For SME 9 and before">
 +
yum install --enablerepo=smecontribs smeserver-ddclient
 +
then
 +
signal-event ddclient
 +
or
 +
signal-event post-upgrade; signal-event reboot
 +
 
 +
</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====
 +
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 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====
 +
[[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=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 ~]#
   −
This page provides a link to an externally hosted ddclient contrib for sme7.x
     −
Download the latest rpm version from
+
</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====
 +
yum remove smeserver-ddclient ddclient
 +
signal-event post-upgrade; signal-event reboot
   −
http://smeserver.free.fr/Files/index.php?dir=sme7/
+
====Debug====
 +
{{Note box|Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.}}
   −
to an empty folder eg /tmp
+
You can keep an eye on log
 +
watch 'cat /var/log/messages|grep SUCCESS'
   −
Alternatively use the wget command shown below.
+
* You can supervise dns record
 +
watch 'dig any your_dynamic_dns_host.xxx @dns_server_of_your_dynamic_dns_provider'
   −
The currently available rpm is:
+
* 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.
   −
sme7-ddclient-3.7.3-4.noarch.rpm
+
* 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
   −
Then cd to that folder and install the rpm (change the rpm name in the following command to match the latest available version)
+
==== 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}}.
−
cd /tmp
  −
wget http://smeserver.free.fr/Files/sme7/sme7-ddclient-3.7.3-4.noarch.rpm
  −
yum localinstall sme7-ddclient*.rpm
     −
There is no need to run the signal-event post-upgrade and reboot commands.
+
{{#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.
   −
A new panel will be added to the server manager.
+
{{ #smechangelog: smeserver-ddclient }}
   −
Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib
  −
      
----
 
----
−
[[Category:Howto]]
+
[[Category:Contrib]]
 
[[Category:Administration]]
 
[[Category:Administration]]
Retrieved from "https://wiki.koozali.org/Special:MobileDiff/10268...42441"

Navigation menu