Version: 4.4

DD Manager

DD Manager configuration

Once the DD Engine is installed and the required Local admin settings have been completed, the DD Engine can be administered using the DD Manager web interfaces. The DD Manager setup must be completed on both the Upstream and Downstream DD Engines.

DD Manager enables configuration of the unidirectional data transfer via services that transmits and receives data on the corresponding source and destination networks. The services must be configured from both source and destination networks.

Access DD Manager

To be able to access the DD Manager securely, a client certificate and CA certificate must be imported to the web browser. For more information about the certificates, see Certificates.

Connect to the DD Manager

Step 1Step 2

Step 1
Import a client and CA certificate to the web browser, see Certificates.
Step 2
Enter https://<admin_ip> in the web browser to connect to the DD Manager. The address is the <admin_ip> configured using Local admin.
- Default Upstream admin IP: 192.168.0.100
- Default Downstream admin IP: 192.168.0.101

System overview

When the Upstream or Downstream DD Manager is accessed, the DD Manager main view is displayed. In this view, the following is available:

DD Manager indicator - displays the DD Manager (Upstream or Downstream) the administrator is connected to.
Sidebar menu - displays the following menu options:
- Overview - when selected, currently configured service channels and system information are displayed.
- Configuration - when selected, device and service configurations can be managed.
- Settings - when selected, service and device settings can be managed.
Selected option section - displays information related to selected menu option. Overview is displayed by default.

The sidebar menu can be collapsed or expanded (default) using the double arrow icon at the bottom of the sidebar. When collapsed, only icons representing each option is displayed.

Manage configurations

Both the Upstream and Downstream sections of the device must be configured in order to apply the necessary services enabling data transfer from the source to the destination network. The process for configuring the Upstream DD Engine is explained below. Remember to repeat the process for the Downstream DD Engine.

note

Services on Upstream and Downstream DD Engines must match and be started to properly receive and transmit data.

Configure the device

Step 1Step 2Step 3Step 4Step 5Step 6Step 7Step 8

Select Configuration in the sidebar menu or click Configuration when Overview is displayed.
The Configuration page is now visible and Metadata and Features can be configured. Metadata consists of name and description, Features consist of SNMP and remote logging. More information about the features and their configuration can be found in Monitoring.
note
The Name and Description fields both have a maximum allowed length of 255 characters.
In the sidebar, click Service channel 1. The Service channel configuration page is now displayed. The Service Channel Id's must correlate in both Upstream and Downstream DD Engine configurations. The Id can be edited by clicking the pencil icon, .
Select an Upstream service from the leftmost Choose service... dropdown menu.
- The dropdown menu will show all available services.
- The latest version of the service will be selected automatically. If an older version is required, select it in the Version dropdown menu.
It is optional to configure the Downstream service. If configured, it will be saved but not applied to the Downstream DD Engine. To apply the service on Downstream DD Engine, the configuration must be applied from the Downstream DD Manager. To configure Downstream DD Engine on the Downstream DD Manager, select a Downstream service from the rightmost Choose service... dropdown menu.
- The dropdown menu will show all available services compatible with the selected Upstream service.
- The latest version of the service will be selected automatically. If an older version is required, select it in the Version dropdown menu.
Configure the service according to the input forms. Displayed parameters will vary depending on service. More information about the services can be found in Services.
(Optional) Add additional Service channels, click + Add in the left menu. Repeat steps 3-6 for each added Service channel.
When the correct parameters have been provided to all forms, click Submit to save the configuration and apply it to the selected device section.

info

When a DD Engine is being configured, all its services enter stopped state. Services must be manually started as described in Start & Stop Services.

Download & Upload configuration

DD Engine enables export and import of configuration files via the download and upload buttons in the DD Manager. The configuration file can be downloaded and uploaded as a complete (both Upstream and Downstream DD Engine) or partial (Upstream or Downstream DD Engine) configuration.

Download configuration

Download a configuration

Step 1Step 2Step 3Step 4

Select Configuration in the sidebar menu or click Configuration when Overview is displayed.
Click the download button in the upper right corner of the Configuration page.
Select the sides (Upstream, Downstream or both) of the configuration that should be downloaded from DD Manager.
Confirm the selection by clicking Download.

Upload configuration

Upload a configuration

Step 1Step 2Step 3Step 4Step 5

Select Configuration in the sidebar menu or click Configuration when Overview is displayed.
Click the upload button in the upper right corner of the Configuration page.
Click Browse and select a a previously downloaded configuration .json file.
Click Upload and review the configuration.
In order for the uploaded configuration to be applied to DD Engine, click Submit.

Manage services

Start & Stop services

Start or stop a service

Step 1Step 2Step 3

Select Overview in the sidebar menu.
Click on the current state for a service, Running or Stopped, to be able to change state.
Select Start or Stop from the dropdown menu to enable or disable traffic.

Add & Delete services

In order to make services available for configuration, they must be uploaded using the DD Manager. Services can also be deleted in the DD Manager.

note

The UDP and TCP services are always included in the DD Engine delivery. Whenever a new firmware is applied, updates of the UDP and TCP services are automatically added.

Add services

Add a service

Step 1Step 2Step 3Step 4Step 5

Select Settings in the sidebar menu.
Select Services on the Settings page. Click + Add to add new services or service updates.
Click Browse and select the service .tar.gz files.
Click Submit and wait for the services to be uploaded.
Once the upload has completed, the services will be available in Configuration.

Delete services

Delete a service

Step 1Step 2Step 3Step 4Step 5

Select Settings in the sidebar menu.
Select Services on the Settings page and click the Delete icon ().
Select the services and versions to be deleted.
Click Submit and wait for the services to be deleted.
Once the deletion has completed, the services will no longer be available in Configuration.

Manage firmware

Firmware upgrade

When a new version of the DD Engine has been released, the new firmware can be retrieved by following the instructions in Downloads. Once the new firmware version has been downloaded, the upgrade is performed using the DD Manager.

info

Upstream and Downstream DD Engines should run the same firmware version.

Upgrade firmware

Step 1Step 2Step 3Step 4Step 5

Select Settings in the sidebar menu.
Select Device on the Settings page. Click Upgrade to download the new firmware.
Click Browse and select the firmware .raucb file.
Click Submit and wait for the firmware to be upgraded. This is expected to take some time (~5 min) and the connection to the server will be lost during the upgrade.
Once the upload has completed, the new firmware version will be visible in the System information section.

note

If the new firmware fails to start for any reason, the system will rollback to the old firmware. If this happens, it will be indicated in the System information section. Further details can be found in the device logs.

note

The Firmware upgrade function does not allow downgrading to an older firmware version. If firmware downgrade should be required, follow the instructions in Reinstall firmware using an older version of the DD Engine Installer.

Reinstall firmware

The DD Engine is delivered with a preinstalled firmware. It is, however, possible to reinstall the entire firmware if needed. A bootable USB drive with minimum 12 GB is required to upload the firmware. The USB drive can be prepared using any Linux computer.

Firmware USB drive creation

Step 1Step 2Step 3Step 4

Download the latest version of the DD Engine installer (.iso.gz), see Downloads.
Decompress the .iso.gz file with the following command:
gunzip [PATH_TO_ISO.GZ_FILE]
This will delete the .iso.gz file and replace it with a .iso file.
Insert a USB drive and ensure that it is not mounted.

Run the following command:

dd if=[PATH_TO_DD_ENGINE_INSTALLER_ISO_FILE] of=[PATH_TO_USB_DRIVE] status=progress conv=sync,sparse bs=4M && sync

warning

Running this command will delete all previous data on the USB drive.

Follow the steps below and repeat them for both the Upstream and Downstream DD Engines.

tip

The device boot order might require editing from the BIOS menu.

Reinstall firmware - Upstream

Step 1Step 2Step 3Step 4

Insert the USB drive into a USB port on the Upstream DD Engine and start the device. The DD Engine Installer must be booted from the USB drive.
Once the DD Engine Installer menu appears, select Install DD Engine Upstream followed by Select Installation Disk and Confirm.
Once prompted to enter a default password, enter a password with at least 8 characters. Repeat the password and Confirm.
Once the installation is completed, select Reboot in the menu followed by Confirm. Remove the USB drive shortly after selecting Confirm to allow the DD Engine system to boot from the hard drive.

Reinstall firmware - Downstream

Step 5Step 6Step 7Step 8

Insert the USB drive into a USB port on the Downstream DD Engine and start the device. The DD Engine Installer must be booted from the USB drive.
Once the DD Engine Installer menu appears, select Install DD Engine Downstream followed by Select Installation Disk and Confirm.
Once prompted to enter a default password, enter a password with at least 8 characters. Repeat the password and Confirm.
Once the installation is completed, select Reboot in the menu followed by Confirm. Remove the USB drive shortly after selecting Confirm to allow the DD Engine system to boot from the hard drive.

DD Manager configuration​

Access DD Manager​

System overview​

Manage configurations​

Download & Upload configuration​

Download configuration​

Upload configuration​

Manage services​

Start & Stop services​

Add & Delete services​

Add services​

Delete services​

Manage firmware​

Firmware upgrade​

Reinstall firmware​

DD Manager configuration

Access DD Manager

System overview

Manage configurations

Download & Upload configuration

Download configuration

Upload configuration

Manage services

Start & Stop services

Add & Delete services

Add services

Delete services

Manage firmware

Firmware upgrade

Reinstall firmware