Line 1: |
Line 1: |
| + | |
| + | |
| + | ==Version== |
| + | {{#smeversion:smeserver-ddclient}} |
| + | |
| == ddclient - DNS record updating == | | == ddclient - DNS record updating == |
| | | |
Line 9: |
Line 14: |
| ddclient can be used on servers configured in server gateway mode or in server only mode. | | ddclient can be used on servers configured in server gateway mode or in server only mode. |
| | | |
− | {{Warning box|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.}}
| + | ===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]] |
| | | |
− | ===SME contribs repo version===
| + | 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. |
| | | |
− | {{Warning box|There are serious installation & functional problems with the smeserver-ddclient contrib that is in both the smecontribs and smetest repos. Until such time as they are fixed, please use the sme7-ddclient contrib from smeserver.free.fr, see below.}}
| + | 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==== |
| + | <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 | | 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.}} |
| | | |
− | There is no need to run the signal-event post-upgrade and reboot commands.
| + | ====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 /> |
| | | |
− | A new panel will be added to the server manager.
| + | For example if the domain you made was: |
| + | bjrtest.ddns.net |
| + | You have to create a relevant domain with this name. |
| | | |
− | Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib
| + | 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. |
| | | |
− | ====Removal====
| + | 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. |
| | | |
− | yum remove smeserver-ddclient
| + | ====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]] |
| | | |
− | ===smeserver.free.fr version===
| + | Here is the |
| | | |
− | '''Note: RPM at smeserver.free.fr works with SME 8'''
| + | 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
| |
| | | |
− | ====Installation==== | + | </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 |
| + | |
| + | ====Debug==== |
| + | {{Note box|Even with the lower value acceptable (60s) it needs between 60 to 180s to see change in dns record.}} |
| | | |
− | Download the latest rpm version from
| + | You can keep an eye on log |
| + | watch 'cat /var/log/messages|grep SUCCESS' |
| | | |
− | http://smeserver.free.fr/Files/index.php?dir=sme7/ | + | * You can supervise dns record |
| + | watch 'dig any your_dynamic_dns_host.xxx @dns_server_of_your_dynamic_dns_provider' |
| | | |
− | to an empty folder eg /tmp | + | * 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. |
| | | |
− | Alternatively use the wget command shown below.
| + | * 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 |
| | | |
− | The currently available rpm is:
| + | * keep an eye on the ddclient cache |
| + | less /var/cache/ddclient/ddclient.cache |
| | | |
− | sme7-ddclient-3.7.3-7.noarch.rpm
| + | ==== 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}}. |
| | | |
− | Then cd to that folder and install the rpm (change the rpm name in the following command to match the latest available version)
| + | {{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ddclient |noresultsmessage="No open bugs found."}} |
− |
| + | ===Changelog=== |
− | cd /tmp
| + | Only released version in smecontrib are listed here. |
− | wget http://smeserver.free.fr/Files/sme7/sme7-ddclient-3.7.3-7.noarch.rpm
| |
− | yum localinstall sme7-ddclient*.rpm
| |
| | | |
| + | {{ #smechangelog: smeserver-ddclient }} |
| | | |
− | ====Removal====
| |
− | yum remove sme7-ddclient
| |
− | signal-event post-upgrade;signal-event reboot
| |
| | | |
| ---- | | ---- |
| [[Category:Contrib]] | | [[Category:Contrib]] |
| [[Category:Administration]] | | [[Category:Administration]] |