Line 25: |
Line 25: |
| 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. | | 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. |
| ====Installation==== | | ====Installation==== |
| + | = For SME8 = |
| + | yum install --enablerepo=smecontribs smeserver-ddclient |
| + | then |
| + | signal-event ddclient |
| + | or |
| + | signal-event post-upgrade; signal-event reboot |
| | | |
| + | = For SME9 = |
| yum install --enablerepo=smecontribs smeserver-ddclient | | yum install --enablerepo=smecontribs smeserver-ddclient |
| + | then |
| + | signal-event ddclient |
| + | or |
| + | signal-event post-upgrade; signal-event reboot |
| | | |
| + | = For SME10 = |
| + | yum install --enablerepo=smecontribs,openfusion smeserver-ddclient |
| then | | then |
| signal-event ddclient | | signal-event ddclient |
| or | | or |
− | signal-event post-upgrade and reboot commands. | + | signal-event post-upgrade; signal-event reboot |
| + | |
| + | |
| + | <headertabs/> |
| + | |
| + | |
| | | |
| A new panel will be added to the server manager. | | A new panel will be added to the server manager. |
| | | |
| Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib | | Use this panel to configure domain records you wish to keep updated with your dynamic IP using the ddclient contrib |
− | ====how to use====
| |
− | You need to create in first a domain in the server-maner (panel of domains) which must match the domain you set with your provider of dynamic dns.
| |
− | for example if the domain you make at DTdns is : home.dtdns.net then 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 credentials associated. | + | ====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 at DTdns is : |
| + | home.dtdns.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 eg (dtdns) and associated credentials to that provider. |
| | | |
− | Every 300s the contrib perform a check to verify if your ip has been changed to http://checkip.dyndns.org/. Do not try to decrease the time-out under of 300s else you could be blacklisted by providers
| + | ====DB settings==== |
| | | |
− | There are some services that you can use | + | *There are some of the services that you can use to detect your external ip |
| | | |
− | * ip.changeip.com | + | :* ip.changeip.com |
− | * ipdetect.dnspark.com | + | :* ipdetect.dnspark.com |
− | * checkip.dyndns.org:8245 | + | :* checkip.dyndns.org:8245 |
− | * checkip.dyndns.org | + | :* checkip.dyndns.org |
| | | |
− | If you want to change the service which verify your external ip you can do : | + | If you want to change the service which verifies your external ip you can do : |
| | | |
| config setprop ddclient urlcheckip ip.changeip.com | | config setprop ddclient urlcheckip ip.changeip.com |
| signal-event ddclient | | signal-event ddclient |
| + | |
| + | * Every 300s the contrib perform a check to verify if your ip has been changed to http://checkip.dyndns.org/. you can change the interval of the deamon update by a db command (by default it is 300 seconds). It seems that the minimum accepted is 60s. Possibly you could be blacklisted by providers if you decrease the time-out under of 300s. |
| + | |
| + | config setprop ddclient DeamonUpdate 60 |
| + | signal-event ddclient |
| + | |
| + | * use SSL |
| + | since ddclient 3.7.0 you can encrypt transactions to avoid clear messages. by default forced to yes |
| + | |
| + | config setprop ddclient SSL yes |
| + | or |
| + | config setprop ddclient SSL no |
| + | then |
| + | signal-event ddclient |
| + | |
| + | * full db ddclient |
| + | # config show ddclient |
| + | ddclient=service |
| + | DeamonUpdate=300 |
| + | SSL=yes |
| + | status=enabled |
| + | urlcheckip=checkip.dyndns.org |
| + | |
| + | * method |
| + | this will allow you to set the way you retrieve the new IP. By default this use the web request to an external url, which you can set. THis would work for all server, even if not gateway. However you can get many timeout depending of the website you try to reach to get the IP. |
| + | |
| + | available methods : |
| + | ** smeIF : will get IP from external interface. BEST choice if your SME act as gateway. |
| + | ** smeCMD : will get the IP from the configuration DB : /sbin/e-smith/db configuration getprop ExternalInterface IPAddress |
| + | ** web : will get the ip from webpage at the URL in property 'urlcheckip' and use the filter from property 'webskip' |
| + | ** if : will get the IP from the network interface which name is in property 'Extinterface' |
| + | ** ip : will manually force the ip in property 'ForceIP' |
| + | ** cmd : will call the script in property 'cmd' and use the filter in the property 'cmdskip' to get the IP |
| + | ** 'CUSTOM' : replace CUSTOM by one of the accepted value of the ddclient command for use option. Yo also have to fill the property 'fwaddress' which is the gateway address, and could also fill the properties 'fwlogin', 'fwpassword' and 'fwskip' |
| + | |
| + | -use=2wire : obtain IP from 2Wire 1701HG Gateway at the -fw {address}. |
| + | -use=3com-3c886a : obtain IP from 3com 3c886a 56k Lan Modem at the -fw {address}. |
| + | -use=3com-oc-remote812 : obtain IP from 3com OfficeConnect Remote 812 at the -fw {address}. |
| + | -use=alcatel-510 : obtain IP from Alcatel Speed Touch 510 at the -fw {address}. |
| + | -use=alcatel-stp : obtain IP from Alcatel Speed Touch Pro at the -fw {address}. |
| + | -use=allnet-1298 : obtain IP from Allnet 1298 at the -fw {address}. |
| + | -use=cayman-3220h : obtain IP from Cayman 3220-H DSL at the -fw {address}. |
| + | -use=cisco : obtain IP from Cisco FW at the -fw {address}. |
| + | -use=cisco-asa : obtain IP from Cisco ASA at the -fw {address}. |
| + | -use=dlink-524 : obtain IP from D-Link DI-524 at the -fw {address}. |
| + | -use=dlink-604 : obtain IP from D-Link DI-604 at the -fw {address}. |
| + | -use=dlink-614 : obtain IP from D-Link DI-614+ at the -fw {address}. |
| + | -use=e-tech : obtain IP from E-tech Router at the -fw {address}. |
| + | -use=elsa-lancom-dsl10 : obtain IP from ELSA LanCom DSL/10 DSL FW at the -fw {address}. |
| + | -use=elsa-lancom-dsl10-ch01 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}. |
| + | -use=elsa-lancom-dsl10-ch02 : obtain IP from ELSA LanCom DSL/10 DSL FW (isdn ch01) at the -fw {address}. |
| + | -use=linksys : obtain IP from Linksys FW at the -fw {address}. |
| + | -use=linksys-rv042-wan1 : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}. |
| + | -use=linksys-rv042-wan2 : obtain IP from Linksys RV042 Dual Homed Router WAN Port 2 at the -fw {address}. |
| + | -use=linksys-ver2 : obtain IP from Linksys FW version 2 at the -fw {address}. |
| + | -use=linksys-ver3 : obtain IP from Linksys FW version 3 at the -fw {address}. |
| + | -use=linksys-wcg200 : obtain IP from Linksys WCG200 FW at the -fw {address}. |
| + | -use=linksys-wrt854g : obtain IP from Linksys WRT854G FW at the -fw {address}. |
| + | -use=maxgate-ugate3x00 : obtain IP from MaxGate UGATE-3x00 FW at the -fw {address}. |
| + | -use=netcomm-nb3 : obtain IP from NetComm NB3 at the -fw {address}. |
| + | -use=netgear-dg834g : obtain IP from netgear-dg834g at the -fw {address}. |
| + | -use=netgear-rp614 : obtain IP from Netgear RP614 FW at the -fw {address}. |
| + | -use=netgear-rt3xx : obtain IP from Netgear FW at the -fw {address}. |
| + | -use=netgear-wgt624 : obtain IP from Netgear WGT624 at the -fw {address}. |
| + | -use=netgear-wpn824 : obtain IP from Netgear WPN824 FW at the -fw {address}. |
| + | -use=netopia-r910 : obtain IP from Netopia R910 FW at the -fw {address}. |
| + | -use=olitec-SX200 : obtain IP from olitec-SX200 at the -fw {address}. |
| + | -use=rtp300 : obtain IP from Linksys RTP300 at the -fw {address}. |
| + | -use=sitecom-dc202 : obtain IP from Sitecom DC-202 FW at the -fw {address}. |
| + | -use=smc-barricade : obtain IP from SMC Barricade FW at the -fw {address}. |
| + | -use=smc-barricade-7004vbr : obtain IP from SMC Barricade FW (7004VBR model config) at the -fw {address}. |
| + | -use=smc-barricade-7401bra : obtain IP from SMC Barricade 7401BRA FW at the -fw {address}. |
| + | -use=smc-barricade-alt : obtain IP from SMC Barricade FW (alternate config) at the -fw {address}. |
| + | -use=sohoware-nbg800 : obtain IP from SOHOWare BroadGuard NBG800 at the -fw {address}. |
| + | -use=sveasoft : obtain IP from Sveasoft WRT54G/WRT54GS at the -fw {address}. |
| + | -use=vigor-2200usb : obtain IP from Vigor 2200 USB at the -fw {address}. |
| + | -use=watchguard-edge-x : obtain IP from Watchguard Edge X FW at the -fw {address}. |
| + | -use=watchguard-soho : obtain IP from Watchguard SOHO FW at the -fw {address}. |
| + | -use=westell-6100 : obtain IP from Westell C90-610015-06 DSL Router at the -fw {address}. |
| + | -use=xsense-aero : obtain IP from Xsense Aero at the -fw {address}. |
| + | |
| | | |
| ====Providers available==== | | ====Providers available==== |
| + | Here the official [http://sourceforge.net/p/ddclient/wiki/protocols/ wiki] |
| + | |
| * Dyndns.org | | * Dyndns.org |
| * ZoneEdit.com | | * ZoneEdit.com |
Line 69: |
Line 174: |
| * Noip.com | | * Noip.com |
| * Changeip.com | | * Changeip.com |
− | | + | * Namecheap |
− | If your provider of dynamic dns is not available in smeserver-ddclient, please raise {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-transmission|title=a bug }}and provide workable settings of your provider with ddclient (make search with google). | + | If your dynamic dns provider is not available in smeserver-ddclient, please raise {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ddclient|title=a bug }}and provide the settings for your provider with ddclient (search for settings with google). |
| | | |
| ====Removal==== | | ====Removal==== |
Line 76: |
Line 181: |
| yum remove smeserver-ddclient | | yum remove smeserver-ddclient |
| signal-event post-upgrade; signal-event reboot | | 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.}} |
| + | |
| + | For debug mode you may need per-JSON-Any |
| + | |
| + | To install that you will need the EPEL repo: https://wiki.contribs.org/Epel |
| + | |
| + | Then |
| + | yum --enablerepo=epel install perl-JSON-Any |
| + | |
| + | * 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 deamon |
| + | ddclient -daemon=0 -debug -verbose -noquiet |
| + | 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}}. |
| + | |
| + | {{#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. |
| + | |
| + | {{ #smechangelog: smeserver-ddclient }} |
| | | |
| ===smeserver.free.fr version=== | | ===smeserver.free.fr version=== |