30.1. Dynamic DNS (DDNS) resource

DYNAMIC DNS allows to find Abilis with its dynamic address, using a fixed name.

30.1.1. Activating the DDNS resource

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:ddns

COMMAND EXECUTED

[10:34:50] ABILIS_CPX:save conf

VALIDATION 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:yes

COMMAND EXECUTED

[10:45:32] ABILIS_CPX:d p ddns

RES: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:ddns

COMMAND EXECUTED

[10:46:48] ABILIS_CPX:save conf

VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

30.1.2. DDNS resource parameters

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:

LOG

State 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).

ACT

Operation activation [NO, YES].

sesnum

Maximum number of client sessions [1..255].

TOS

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

SERVICE

DDNS service name [dyndns.com, dyndns.org, dyndns.it, no-ip.com, zoneedit.com, dtdns.com, minidns.net].

SERVER

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

PORT

Remote TCP port of the server [0..65535].

RETRY-DELAY

Delay between subsequent TCP reconnections [30..3600 sec.]. NOTE: There is no limit to the reconenction attempt.

CHECK-IP

Activate/deactivate IP address checks [NO, YES].

CHECK-IP-PERIO

Time interval beween subsequent successful IP address checks [60..86400 sec.]

UPDATE-PERIOD

Update period of dynamic DNS records on the server [AUTO, 1..60 days]. When AUTO the provider's default rules are obeyed.

USER

User 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/”).

PWD

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

30.1.2.1. Example

Add the DDNS resource and configure it choosing the service name and inserting name and password of an active dyndns account.

[Tip]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:abilistest

COMMAND EXECUTED

[18:32:54] ABILIS_CPX:d p ddns

RES: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.org

COMMAND EXECUTED

[17:38:42] ABILIS_CPX:d p ip-24

RES: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)

30.1.3. DDNS diagnostics, statistics and debug

30.1.3.1. DDNS diagnostics

The following commands are used to display the diagnostics of the DDNS resource:

d d ddns / d de ddns

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

30.1.3.2. DDNS statistics

To display the statistics of the DNS resource the following commands are used:

d s ddns / d se ddns

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

30.1.3.3. DDNS debug

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