x

Ways to Configure DAL Devices

Ways to Configure DAL devices

Background

Digi products that run DAL firmware offer multiple methods for configuring the device, both remotely and locally onsite. This article outlines these various methods, which are:

  • Digi Remote Manager

  • Digi aView

  • Local web UI

  • Admin CLI

  • Shell Console

  • Offline Configuration Storage

, to sync its configuration settings. The benefit of central management is users can easily configure and maintain a fleet of devices in the field. Users can remotely configure the Digi products as part of staging the units before deployment. Devices also automatically sync with the Digi management portals, which helps keep the devices running working configuration settings, and ensuring that any incorrect configurations are resolved.

In addition to the methods for configuring the Digi devices through Digi Remote Manager or Digi aView, users can disable central management and locally manage the configuration settings of the device, thereby providing an isolated environment for configuring and managing the Digi device.

Applicable Digi devices

  • Digi Enterprise routers

  • Digi IX-series Industrial routers

  • Digi Connect IT console servers

  • Digi AnywhereUSB+

Using Digi Remote Manager

Start by ensuring your Digi router is powered on, is online with an active Internet connection, and shows as connected in the Digi Remote Manager portal. Below are links that detail setting up a login to access Digi Remote Manager, as well as how to add Digi devices to Remote Manager.

Remote Manager Trial Access

Adding devices to Digi Remote Manager

.


You are then presented with subset of configuration sections. Refer to the configuration examples in the various Digi product user guides for details on configuring specific settings on Digi devices.

button is selected, Digi Remote Manager immediately contacts the Digi device to apply the configuration changes to the unit. If the device is unreachable, the Remote Manager portal prompts the user with the option to apply the configuration changes after the device reconnects to the Remote Manager portal.

In addition to configuring Digi devices individually, the Remote Manager portal also provides a profile manager that can be used to configure multiple devices. These profiles can be used to apply the same configuration settings, firmware version, and local filesystem contents to multiple devices at once. Digi Remote Manager can also be configured to regularly inspect each device associated to a profile to ensure its configuration, firmware, and filesystem contents are in sync with what is specified in the profile. Instructions for setting up a device profile in Digi Remote Manager can be found in the link below.

Device Profiles in Remote Manager

Reminders

  • By default, the configuration shown for a Digi device in Digi Remote Manager is tied to local configuration settings on the device.

  • The configuration profile created through Digi Remote Manager's Profile Manager is created based on a selected "master" device's local config settings at the time of creating the profile.

  • The configuration settings reside initially on the device. Profile Manager can be used to create a "group config" for the Digi device, which gets pulled from the device, stored in Digi Remote Manager, and then Digi Remote Manager can be set to push those config settings immediately or at an interval to one or more Digi devices of the same model.

  • Digi Remote Manager's device Profile Manager can override some or all of the configuration settings of a device.

Using Digi aView

Configuring a Digi device through the Digi aView portal is similar to configuring the device through Digi Remote Manager. A walkthrough for creating configuration profiles in Digi aView and applying configurations to a device through aView can be found in the following link.

Digi aView Device Configuration

Reminders

  • The configuration profile for a device in Digi aView is independent of the local configuration settings on the device. If the Digi device is erased or restored to default settings, the configuration profile still exists in Digi aView, and if the Digi device's default behavior is to sync with Digi aView, it automatically pulls this configuration profile once it obtains an active Internet connection.

  • The group configuration profile always resides in Digi aView. The Digi device pulls this configuration via an HTTPS query to Digi aView at a configured interval. The default is once every 24 hours.

  • if central management is enabled, whatever configuration settings the device pulls from Digi aView override any locally configured settings

Using the local web UI

If you are not using the Digi Remote Manager or Digi aView portals, you can instead locally manage and configure your Digi device. The most common way of doing so is through the Digi device's local web UI.

192.168.210.1

The default user for logging into the device will vary:

  • The default user is root:

    • If the device is at a firmware level 19.8.x or older.

    • If the device has been upgraded from 19.8.x or older to 19.11.x or newer.

  • The default user is admin:

    • If the device is at 19.11.x or newer when manufactured.

    • If the device has been upgraded from 19.8.x or older to 19.11.x or newer and has been factory reset after the upgrade.

The default password is the unique password printed on the label packaged with your device.

drop-down menu. You may initially be shown a limited set of configuration options. Start by disabling central management of the device.

  1. .

  2. .

    Passwords are case sensitive

  3. .


After saving the profile, the device no longer attempts to sync with either the Digi Remote Manager or Digi aView portals, and a full range of available configuration options are visible. Click the question-mark next to the name of a configuration option to display a pop-up providing help details about that option, including any default values.

The local web UI offers the same configuration options as Digi Remote Manager or Digi aView, although changes made here will not sync with the cloud.

Using the Admin CLI

link. See the following link for more details on accessing the Admin CLI:

Accessing the Admin CLI

command from the prompt to enter into configuration mode on the CLI. Details on both interfaces of the Admin CLI are listed in the links below:

Execute configuration commands at the root Admin CLI prompt

Admin CLI configuration mode

Using the shell console

The shell console provides a standard Linux-style terminal for the Digi device. It is based on a busybox shell environment to provide a lightweight terminal with common Linux commands. Shell access is obtained through similar methods as described above for gaining Admin CLI access. However, shell access is not enabled by default in Digi devices, so a user must first enable shell access in the Digi device's configuration settings. Below is a link that details how to enable shell access.

Enabling Shell Access

command in the shell console:
# config help
Usage: config <cmd> [arg...]

If not started:
eval $(config start)
config get <path>
config set <path> <val>
config dump [<path>]
config dump-public [<path>]
config json [<path>]
config map <name>

If started:
eval $(config stop)
config load
config load-json
config load-baked
config update
config create <file>
config try-create <file>
config validate
config commit [-f]
config cancel
config free
config get <path>
config set <path> <val>
config type <path>
config exists <path> <key>
config keys <path>
config count <path>
config new <path> [<key>]
config delete <path>
config find <path> [<name> <val>...]
config json [<path>]
config dump [<path>]
config dump-public [<path>]
#

command that can be used to either reboot or reset the Digi device.
# flatfsd -h
usage: flatfsd [-a|-b|-H|-P|-c|-r|-w|-i|-s|-v|-h|-?] [-n1234] [-d <dir>] [-f <file>]
    -a <action> send a command to the running flatfsd
    -b safely reboot the system
    -H safely halt the system
    -P safely power the system off
    -c check that the saved flatfs is valid
    -d <dir> with -r to read from flash to an alternate filesystem
       and -s to save an alternate config to flash
    -f <file> file or device node for flatfs storage
    -r read from flash, write to config filesystem
    -w read from default, write to config filesystem
    -n with -r or -w, do not write to flash
    -i initialise from default, reboot
    -s save config filesystem to flash
    -S save config filesystem to flash (rate limited)
    -1 force use of version 1 flash layout
    -2 force use of version 2 flash layout
    -3 force use of version 3 flash layout
    -4 force use of version 4 flash layout (default)
    -v print version
    -h this help
#

This can be used to quickly reset a Digi device back to firmware default settings:
flatfsd -i

Offline Configuration Storage

The configuration settings on a Digi device can be downloaded from its web UI for offline storage. This configuration file can also be loaded onto additional Digi devices as a local method for applying the same configuration settings to multiple devices.

section above for details on how to access the web UI of the Digi device.

button to download the configuration settings from the Digi device. An option passphrase can be provided to encrypt the configuration file.


button. Note that if a passphrase was entered when the configuration file was originally saved and downloaded from the device, the same passphrase must be entered when restoring the configuration.

Reminder

, etc.)

Summary

for additional documentation.

Last updated: Dec 06, 2019

Recently Viewed Articles

No recently viewed articles