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-7.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-7.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]] |