set ddns

Purpose

A Dynamic DNS ((DDNS) service allows a user whose IP address is dynamically assigned to be located by a host or domain name. Before a DDNS service may be used, and before using this command, you must create an account with the DDNS service provider. The provider gives you account information such as username and password. Use this account information to register your IP address and update it as it changes.

A DDNS service provider may support registration of both public and private IP addresses. If the service provider does not support private IP address registration, and you attempt to register a private IP address (for example, 192.168.x.x or 10.x.x.x), the service provider may reject your update requests. If the service provider permits registration of private IP addresses, and you register a private IP address, your Digi device may be accessible (by resolving the associated hostname) only from other hosts with access to that private IP subnetwork.

Your Digi device monitors the IP address it is assigned for a selected network interface. It typically updates the DDNS service or server automatically, but only when its IP address has changed from the IP address is previously registered with that service.

DDNS service providers may consider frequent updates to be an abuse of their service. In such a circumstance, the service provider may block updates from the abusive host for some period of time, or until the customer contacts the provider. Observe the requirements of the DDNS service provider to ensure compliance with possible abuse guidelines.

Required permissions

For Digi products with two or more users, to use this command, permissions must be set to set permissions s‑ddnsupdater=read to display Dynamic DNS settings, and to set permissions s‑ddnsupdater=rw. to display and configure Dynamic DNS settings. See set permissions for details on setting user permissions for commands.

Syntax

Set basic DDNS settings

set ddns [service={disabled|dyndnsorg}]
  [ifname=network interface name]
  [action={updatenow|clearstatus}]

Note If action is specified, other options are not used.

Set service settings for Dynamic DNS (service=dyndnsorg):

set ddns [ddconntype={standardhttp|alternatehttp|securehttp}]
  [ddsystem={dyndns|statdns|custom}]
  [ddusername=user name]
  [ddpassword=password for DynDNS.org account]
  [ddhostname=full host name]
  [ddwildcard={off|on|nochg}]

Display current DDNS settings

set ddns

Options

Basic DDNS settings

service={disabled|dyndnsorg}

Specifies the DDNS service used for handling dynamic DNS updates, or disables use of the DDNS service.

disabled

Turns off the Dynamic DDNS service. This the default setting for the Dynamic DNS feature. Use this option if you have configured the Dynamic DNS feature and you want to temporarily turn off the service for some reason.

dyndnsorg

Update the DDNS service at DynDNS.org. When you select a specific DDNS service provider, you must also provide the related account information for that service provider.

ifname=network interface name

The network interface name; allowed network interfaces vary among products.

action={updatenow|clearstatus}

The action to be performed on the DDNS service. If you specifyaction, other command options are not used.

updatenow

Force a DDNS service update now.

clearstatus

Clears the last information returned from the Dynamic DNS service from your Digi device.

DynDNS.org service settings

These settings are specific to your account information with DynDNS.org; please consult their website for more information on account terms and settings.

ddconntype={standardhttp|alternatehttp|securehttp}

The method to use to connect to the DynDNS.org server:

standardhttp

Connect to the Standard HTTP port (80).

alternatehttp

Connect to the Alternate HTTP port (8245).

securehttp

Connect to the Secure HTTPS port (443).

ddsystem={dyndns|statdns|custom}

The DynDNS.org system to use for the update.

dyndns

Update a Dynamic DNS host name.

statdns

Update a Static DNS host name.

custom

Update a Custom DNS host name.

ddusername=user name

The user name for the DynDNS.org account.

ddpassword=password

The password for DynDNS.org account.

ddhostname=full host name

The full host name to update for DynDNS.org account, for example, myhost.dyndns.net.

ddwildcard={off|on|nochg}

Enables/disables wildcards for this host. The wildcard aliases *.yourhost.ourdomain.tld to the same address as yourhost.ourdomain.tld. Using this option has the same effect as selecting the wildcard option on the DynDNS.org web site. To leave the wildcard option unchanged from the current selection on their website, use the “no change” option (the nochg keyword) in the device settings. DynDNS.org support for this option may vary according to the DynDNS system you are registered to use.

off

Disables wildcards.

on

Enables wildcards.

nochg

Specifies that there should be no change to service setting from the current selection for wildcards in the DDNS settings at the DynDNS.org Web site.

Examples

This example shows set ddns being used to display the current status of the Dynamic DNS service:

#> set ddns

 DDNS Service Update Configuration :

    service     : dyndnsorg
    ifname      : mobile0

    ddconntype  : securehttp
    ddsystem    : statdns
    ddusername  : "test"
    ddpassword  : (Not shown for security reasons)
    ddhostname  : "test-static.dnsalias.com,test-static.dnsalias.org"
    ddwildcard  : nochg

 Current IP address: 166.213.228.220 (ppp1)

 Most recent DDNS service update status:

    Service              : DynDNS.org
    IP address reported  : 166.213.228.220
    Update status        : successful
    Result information   : [good] The update was successful.
    Raw result data      :
      good 166.213.228.220
      good 166.213.228.220

 Most recent DDNS service update log message:
    IP address for "ppp1" is now 166.213.228.220, but no DDNS update is needed
(last reported IP address is unchanged).