DDNS (Dynamic DNS)
Introduction
DDNS is a service offered by many Internet Service Providers (ISPs) to allow end-users to register a dynamic (DHCP/PPPoE/PPPoA) address with a DNS record.
When the switch acquires its IP address dynamically (via DHCP or PPP) from an ISP, maintaining the DNS server entry is cumbersome. To that end the system includes support for dynamic DNS (DDNS). With DDNS enabled, the switch updates its DNS server entry automatically when acquiring a new IP address.
Below is a non-exhaustive list of supported DDNS providers:
- DYN: http://www.dyndns.org
- FreeDNS: http://freedns.afraid.org
- no-ip: http://www.noip.com
- LOOPIA: http://www.loopia.com
Basic DDNS configuration
DDNS configuration context can be found under IP context in the CLI:
example:/#> configure
example:/config/#> ip
example:/config/ip/#> ddns
example:/config/ip/ddns/#>Syntax
[no] enable
[no] enableDescription
Enable/disable DDNS. Useful to disable a fully configured DDNS before deployment, the configuration will remain dormant while disabled.
Options
| Option | Description |
|---|---|
no | Disable DDNS |
[no] interval [1-864000]
[no] interval [1-864000]Description
This setting controls the IP address check interval, and is in range 1 - 864000. Default value is 43200 seconds (12 hours)
Options
| Option | Description |
|---|---|
no | Reset interval to its default value (43200 seconds) |
[no] ca-store [auto|local]
[no] ca-store [auto|local]Description
This setting controls the Root CA certificate store. Default value is 'auto'.
Options
| Option | Description |
|---|---|
no | Reset CA certificate store to its default value: auto |
auto | WeOS' builtin certificate store. This includes all certificates shipped directly with WeOS. |
local | Local store includes certificates imported by user and overrides WeOS' builtin certificate store (auto). |
[no] provider-id [PROVIDER_UID]
[no] provider-id [PROVIDER_UID]Description
Create/remove DDNS provider instance with specified UID. UIDs are unique numbers in range 1 - 999. Maximum 7 simultaneous provider instances may be configured.
Options
| Option | Description |
|---|---|
no | Delete provider with specified UID |
PROVIDER_UID | Unique identifier for DDNS provider. This simply represents DDNS provider instance. |
DDNS Provider configuration
In order to configure DDNS provider, a provider-instance must be created first by specifying UID.
example:/config/ip/ddns/#> provider-id 1
example:/config/ip/ddns/provider-1/#>Syntax
[no] provider [freedns|dyn|cloudflare|loopia|...]
[no] provider [freedns|dyn|cloudflare|loopia|...]Description
Add/remove builtin DDNS provider.
Options
| Option | Description |
|---|---|
no | Remove builtin DDNS provider |
freedns | Freedns DDNS provider. |
dyn | Dyndns DDNS provider. |
cloudflare | Cloudflare DDNS provider. |
loopia | Loopia DDNS provider. |
noip | NoIP DDNS provider. |
yandex | Yandex DDNS provider. |
duiadns | Duiadns DDNS provider. |
dnspod | Dnspod DDNS provider. |
[no] custom [NAME]
[no] custom [NAME]Description
Set custom DDNS provider name.
This setting is mutually exclusive with provider setting.
Options
| Option | Description |
|---|---|
no | Remove custom DDNS provider |
NAME | Custom DDNS provider name. |
[no] ssl
[no] sslDescription
Enable/disable HTTPS. Enabled by default.
Options
| Option | Description |
|---|---|
no | Disable HTTPS. HTTP will be enabled instead. |
[no] username [USERNAME] [hash] [PASSWORD]
[no] username [USERNAME] [hash] [PASSWORD]Description
Set username and password for DDNS provider. Password can be omitted when setting username.
Options
| Option | Description |
|---|---|
no | Remove username and password |
USERNAME | username for DDNS provider account. |
PASSWORD | password for DDNS provider account. |
hash | specify password as a hash. |
[no] password [hash] [PASSWORD]
[no] password [hash] [PASSWORD]Description
Set password for DDNS provider. Password may be set either in plain text or as a hash.
Options
| Option | Description |
|---|---|
no | Remove password |
PASSWORD | password for DDNS provider account. |
hash | specify password as a hash. |
[no] hostname [HOSTNAME[,HOSTNAME,...]]
[no] hostname [HOSTNAME[,HOSTNAME,...]]Description
Set hostname(s) for DDNS provider.
Options
| Option | Description |
|---|---|
no | Remove hostnames |
HOSTNAME | name of the host. |
[no] server [SERVER] [PATH]
[no] server [SERVER] [PATH]Description
Set server and url for custom DDNS provider.
Options
| Option | Description |
|---|---|
no | Remove custom DDNS server and url |
SERVER | DDNS server string (example: twodns.de). |
PATH | path that follows ddns server string, (example: /) |
[no] checkip-server [SERVER] [PATH]
[no] checkip-server [SERVER] [PATH]Description
Set checkip server and url for custom DDNS provider.
Options
| Option | Description |
|---|---|
no | Remove checkip server and url |
SERVER | Checkip server string (example: updatemyip.org). |
PATH | path that follows checkip server string, (example: /update/now) |
[no] checkip-ssl
[no] checkip-sslDescription
Enable/disable HTTPS for checkip serever.
Options
| Option | Description |
|---|---|
no | Disable HTTPS, HTTP will be used instead |