| 30.1. Dynamic DNS (DDNS) resource | ||
|---|---|---|
 | Chapter 30. DDNS - Dynamic DNS |  |
| 30.1. Dynamic DNS (DDNS) resource | ||
|---|---|---|
| | Chapter 30. DDNS - Dynamic DNS | |
DYNAMIC DNS allows to find Abilis with its dynamic address, using a fixed name.
Enter into the Abilis control-program or open the configuration file with the Console configurator and type the following commands.
[10:34:45] ABILIS_CPX:a res:ddnsCOMMAND EXECUTED [10:34:50] ABILIS_CPX:save confVALIDATION IN PROGRESS ... WARNING: RES:Tcp Changed "SESNUM" from 103 to 104 VALIDATION SUCCESSFULLY EXECUTED SAVE EXECUTED
On a working Abilis, a system restart (warm start) is required to make the DDNS resource running.
Then activate the resource:
[10:45:08] ABILIS_CPX:s p ddns act:yesCOMMAND EXECUTED [10:45:32] ABILIS_CPX:d p ddnsRES:DDns - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------ ------------------------------------------------------------------------ DESCR:Dynamic_DNS_Protocol_Client LOG:DS ACT:YES sesnum:1 TOS:0-N SERVICE:dyndns.org SERVER:AUTO (members.dyndns.org) PORT:80 RETRY-DELAY:60 CHECK-IP:YES CHECK-IP-PERIOD:600 UPDATE-PERIOD:AUTO USER: PWD: [10:45:41] ABILIS_CPX:init res:ddnsCOMMAND EXECUTED [10:46:48] ABILIS_CPX:save confVALIDATION IN PROGRESS ... VALIDATION SUCCESSFULLY EXECUTED SAVE EXECUTED
Use the following command to view the resource parameters, the command d p ddns ? displays the meaning of all parameters.
[15:03:23] ABILIS_CPX:d p ddns
RES:DDns ----------------------------------------------------------------------
Run DESCR:Dynamic_DNS_Protocol_Client
LOG:DS ACT:YES sesnum:1 TOS:0-N
SERVICE:dyndns.org
SERVER:AUTO (members.dyndns.org)
PORT:80 RETRY-DELAY:60 CHECK-IP:YES CHECK-IP-PERIOD:600
UPDATE-PERIOD:AUTO
USER: PWD:
Meaning of the most important parameters:
LOGState changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).
ACTOperation activation [NO, YES].
sesnumMaximum number of client sessions [1..255].
TOSType Of Service octet or Differentiated Services Field (DS): -' p-t', i.e. PRECEDENCE and TOS values, where 'p' can be [0..7] and 't' can be [N=None, D=Min. Delay, T=Max. Throughput, R=Max. Reliability, C=Min. Monetary Cost] - 'bbbbbb', i.e. DS value bit by bit, where 'b' can be [0, 1].
SERVICEDDNS service name [dyndns.com, dyndns.org, dyndns.it, no-ip.com, zoneedit.com, dtdns.com, minidns.net].
SERVERDDNS server FQDN. “AUTO” or from 0 up to 64 characters in the range ['0'..'9', 'a'..'z', '-', '.']. Case isn't preserved. When “AUTO”, the service's server is used.
PORTRemote TCP port of the server [0..65535].
RETRY-DELAYDelay between subsequent TCP reconnections [30..3600 sec.]. NOTE: There is no limit to the reconenction attempt.
CHECK-IPActivate/deactivate IP address checks [NO, YES].
CHECK-IP-PERIOTime interval beween subsequent successful IP address checks [60..86400 sec.]
UPDATE-PERIODUpdate period of dynamic DNS records on the server [AUTO, 1..60 days]. When AUTO the provider's default rules are obeyed.
USERUser identification on the server. From 0 up to 32 ASCII characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: “/aaa bbb/”).
PWDUser password on the server. From 0 up to 32 ASCII characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: “/aaa bbb/”).
The following command allows the administrator to change the configuration of the resource:
s p ddns parameter:value...
![[Caution]](../images/caution.png) | Caution |
|---|---|
To activate the changes made on the upper case parameters, execute the initialization command init res:ddns; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command). |
Add the DDNS resource and configure it choosing the service name and inserting name and password of an active dyndns account.
![[Tip]](../images/tip.png) | Tip |
|---|---|
Please refer to chapter Section 72.18.1, “How to setup DDNS service using dyndns.org” to learn how to create an account on dyndns.org. |
[18:32:46] ABILIS_CPX:s p ddns service:dyndns.org user:abilistest pwd:abilistestCOMMAND EXECUTED [18:32:54] ABILIS_CPX:d p ddnsRES:DDns - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------ ------------------------------------------------------------------------ Run DESCR:Dynamic_DNS_Protocol_Client LOG:DS ACT:YES sesnum:1 TOS:0-N SERVICE:dyndns.org SERVER:AUTO (members.dyndns.org) PORT:80 RETRY-DELAY:60 CHECK-IP:YES CHECK-IP-PERIOD:600 UPDATE-PERIOD:AUTO USER:abilistest PWD:********
Configure the IP resource, so type the following commands:
[17:38:10] ABILIS_CPX:s p ip-24 ddns:yes ddns-fqdn:abilistest.dyndns.orgCOMMAND EXECUTED [17:38:42] ABILIS_CPX:d p ip-24RES:Ip-24 - Not Saved (SAVE CONF), Not Refreshed (INIT) ----------------------- - IP over PPP (PPP) ---------------------------------------------------- New DESCR: OPSTATE:UP LOG:NO STATE-DETECT:NORMAL LOWRES:Dsl-1 IPADD:RETRIEVE NEIGH:RETRIEVE REDIS:EXT HIDE:NO RP:NONE IPSEC:NO VRRP:NO NAT:NO DIFFSERV:NO DDNS:YES OUTBUF:100 OUTQUEUE:FAIR MTU:1500 OUTSPL:NO INBUF:0 mru:1500 SRCV:NO - DDNS section --------------------------------------------------------- DDNS-FQDN:abilistest.dyndns.org - TRFA section --------------------------------------------------------- TRFA:NO - Ppp ------------------------------------------------------------------ LOG:DS NRTY3:3 PPP-ENC:RFC2364-VCMUX RADIUS:NO VPI:8 VCI:35 - Tcp-MSS/Lcp/IpCp ----------------------------------------------------- TCP-MSS-CLAMP:NO maxmru:1500 DNS:NO - Authentication ------------------------------------------------------- USERNAME:provider_user PASSWORD:******** LOCAL:CHAP,PAP SERVNAME: REMOTE:NONE REPEAT:0 RES:Dsl-1 -------------------------------------------------------------------- Run DESCR:adsl-operatorA LOG:DST MODE:ADSL payload-rxbuf:30 - Specific for Abilis-VDSL2 modem -------------------------------------- MORE-ADSL-ANNEX:L,M - Specific for Abilis-5800UB modem ------------------------------------- 5800UB-MODULATION:AUTO - Adsl-ATM ------------------------------------------------------------- max-vc:1 adsl-usb-rxbuf:3 adsl-usb-txbuf:1 - Vdsl-PTM ------------------------------------------------------------- vdsl-usb-rxbuf:15 vdsl-usb-txbuf:15
On a working Abilis, an initialization of DDNS and IP-24 resources are required (init res:ddns and init res:ip-24). Remember to save the configurations (save conf)
The following commands are used to display the diagnostics of the DDNS resource:
It informs about the state of the resource, the IP address of the resource, the account used on dyndns.org and the state of the authentication.
[15:25:58] ABILIS_CPX:d d ddns
RES:DDns ----------------------------------------------------------------------
Dynamic_DNS_Protocol_Client
STATE:ACTIVE SESNUM:1 CLIENTS:3
SERVER:members.dyndns.org
PORT:80 CUR-QUERIES:0 PEAK-QUERIES:1
------------------------------------------------------------------------
RES STATE IP UPDATE-TIME
FQDN
SERVER-RESPONSE
------------------------------------------------------------------------
Ip-2 REGISTERED 192.168.001.100 03/06/2015 15:25:58
abilistest.dyndns.org
good 192.168.1.100
------------------------------------------------------------------------To display the statistics of the DNS resource the following commands are used:
Statistics show many information like: TCP protocol errors, the number of requests, the number of successful/wrong request, etc.
[15:30:30] ABILIS_CPX:d s ddns
RES:DDns ----------------------------------------------------------------------
Dynamic_DNS_Protocol_Client
--- Cleared 0 days 00:08:50 ago, on 05/06/2015 at 13:10:06 -------------
-----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
CHAR | 284| 560|REQUESTS | | 2|
DNS-ERRS | 0| |SUCCESS | 1| |
TCP-ERRS | 0| |ERRORS | 1| |
DDNS-ERRS | 1| |
------------------------------------------------------------------------Type the following command to view the commands allowed:
[15:20:28] ABILIS_CPX:debug res:ddns
RES:DDns ----------------------------------------------------------------------
Dynamic_DNS_Protocol_Client
BufferLength:64512 Date/Time:02/08/2016 15:20:35 TraceTime:4201741
DEBUG RES:<Ddns>
LSN:0 - This help
LSN:1 - Complete debug
LSN:2 - Statistics
LSN:3 - DDNS client log
LSN:3 CMD:CLR - Clear DDNS client log
LSN:3 CMD:SET:[DFT,FULL] - Set log event level
DFT - Log default events (reduced)
FULL - Log all events (dump of messages)
LSN:5 CMD:N,FQDN,IP - Execute DDNS update on IP port N
LSN:6 CMD:N - Stop DDNS update on IP port N![[Note]](../images/note.png) | Note |
|---|---|
To use these commands you need to have administrator or super user rights. |
Type the following command to view the DDNS client log:
[14:20:53] ABILIS_CPX:debug res:ddns lsn:3
RES:DDns ----------------------------------------------------------------------
Dynamic_DNS_Protocol_Client
BufferLength:64512 Date/Time:02/08/2016 15:24:15 TraceTime:4421984
02/08 14:10:26 PORT Selected DDNS service: dyndns.org
02/08 14:10:26 PORT Selected DDNS server: members.dyndns.org
02/08 14:10:26 PORT Selected update period: 20 days| |  | |
| Chapter 30. DDNS - Dynamic DNS |  | Chapter 31. SMTP - Simple Mail Transfer Protocol |