Product Updates
2023

Litmus Edge 3.11.0

4min

Release Date: December 19, 2023

Review the current list of Limitations.

New Features

Description

DeviceHub:

  • Support is now provided for the following drivers:
    • AB DF1 Ethernet
    • AB DF1 Serial
    • Emerson FB107 Ethernet
    • Enron Modbus
    • IEC60870-5-104 Ethernet (Gen1)
    • Mitsubishi iQ-F Ethernet
    • OSI Agent Advanced
    • Profinet Acyclic Turck
    • Siemens S7 CommPlus Symbolic

Integration:

  • The following connectors are now available:
    • Aveva Data Hub
    • AWS SiteWise
    • Snowflake

Network:

  • A new firewall management feature is now available by navigating to System > Network > Firewall. This feature allows you to manage firewall rules to open specific ports or port ranges for inbound communication.
    • The Firewall pane allows you to do the following:
      • Review what ports are being used by Litmus Edge system components, applications, and containers.
      • Ensure that any DeviceHub drivers and Docker container applications are not running on conflicting ports.
      • Open ports and port ranges with appropriate protocol (TCP/UDP) for Docker applications, containers, and DeviceHub drivers.
      • Manage and close ports as needed.
    • These firewall rules apply only to IPv4 traffic.
  • A new static route management feature is now available by navigating to System > Network > Routes. This feature allows you to control the routing of messages in a complex network with multiple interfaces and gateways.
    • The Routes pane allows you to do the following:
      • Review the list of current static routes.
      • Add new static routes.
      • Edit and remove static routes.
    • Warning: Incorrect static routes can disconnect your network access to Litmus Edge. Please add or modify routes with caution.

External Storage:

  • The new Cloud Sync Storage feature allows you to transfer files from Litmus Edge to a cloud storage service. You can set up cloud storage with AWS S3 and Azure Blob Storage.
    • To enable this feature, navigate to System > Support > Features and click the toggle for Cloud Storage Sync.

Digital Twins:

  • You can now view a count of the number of attributes when viewing models and instances.

Enhancements and Improvements

Description

System:

  • The Wi-Fi section has moved to System > Network as a new tab.
  • A new NTP Client Status section in System > Network > DNS / NTP Servers displays information on the status and time synchronization of the NTP Client.
  • The OPC UA Server performance is now enhanced by moving to the Unified Automation Stack.
  • When you activate Litmus Edge through Litmus Edge Manager, a validation is now available to ensure the connection is valid.
  • You can download an event history in a CSV file by navigating to System > Events > Events History.
  • You can retrieve topics for events by navigating to System > Events.
  • When upgrading Litmus Edge by uploading or downloading the upgrade file, you will now need to download a backup of your Litmus Edge before proceeding with the upgrade.
  • When downloading a support bundle, you now have the option to download config and log details, or only download log details.
  • When importing a template and one component fails to be imported, the import process doesn't stop. The failed component is skipped and the template process continues.
  • When a license activation fails, the error messages now provide more relevant information on the cause of the error.
  • The Enable Data Store setting for DeviceHub devices is now saved in template files.
  • The grace period to allow a disconnection from the license server is now increased from 8 hours to 24 hours.

Users:

  • When configuring roles, you can now specify which Flows Managers users can modify.

DeviceHub:

  • Several enhancements have been made to the Server Search feature.
  • You can now search for tags in all devices from DeviceHub > Tags.
  • If there is a system reboot, the status of devices is maintained. For example, if a device is stopped and Litmus Edge is rebooted, the device will remain stopped when Litmus Edge restarts.
  • When you click a device tile and then click the Tags tab, you can now manage the list of tags for the device.
  • New data types are now available for Omron NJ Ethernet (Gen1) and Keyence Nano Ethernet (Gen1).
  • The following options are now available when connecting a device.
    • Publish on Polling Interval
      • Only available for Gen 2 drivers.
      • If this option is selected, the driver will always publish messages according to the polling interval configuration. If the driver has not completed the request to read the data at a polling interval, the payload will have a success=false message.
      • If this option is not selected, the driver will not publish a message at the polling interval if the request to read data has not completed.
    • Watchdog
      • This option is not available for all drivers. For example, drivers that act as servers don't have this option, such as Industrial OT Server and OSI Agent.
      • If this option is selected, the driver will be monitored based on the Watchdog period (in seconds) you configure. If an issue is detected, then the driver will restart.
  • The Browse Tags feature is now available for the Beckhoff TwinCAT3 Ethernet(Gen1) driver.

Flows Manager:

  • The number of Flows Managers you can create is now increased from 4 to 16.
  • The maximum size of logs for flows is now 80 MB, rotated between two log files of 40 MB each.

Integration

  • The Google Pub/Sub connector has the following enhancements:
    • You can define custom attributes.
    • You can upload the value for the Service Account Key field.
    • The client email parameter is now available
  • You now have the option of uploading a CSV file of topics for connectors.
  • You can now download the topics for a connector.
  • You can now clear logs for connectors.
  • Connectors that have certificate variables now allow you to upload certificate files.
  • The inbound option for topics has been removed from connectors that only support outbound topics.

OPC UA:

  • You can now do the following:
    • Define the network interface to expose the OPC UA server from.
    • Re-initialize the server when any changes are made to the server configuration.
    • Place items under the root or at the parent level.
    • Create a custom hierarchy with folders, devices, and tags.
    • Reset the hierarchy with the following options: All, Manually Created Only, Imported Only.
    • Pass any NATS topic as a message as long as it follows the standard DeviceHub structure.
  • The OPC UA server now does the following:
    • Converts all the data types of the respective driver to standard OPC UA server data types.
    • Allows bi-directional communication (read/write) to the topics.
  • A new OPC UA server Node ID field is now available.
  • The following new policies are now available:
    • Aes256_Sha256_RsaPss
    • Aes128_Sha256_RsaOaep

Digital Twins:

  • In the event of system reboot, the output payload provides the last known attribute timestamps and values for instances.
  • The following data types are now supported for dynamic attributes:
    • JSON
    • Number
    • String
    • Boolean
    • Array
  • Models and instances are now tagged with version numbers based on changes made.
  • You now have the option to rename nodes and items in hierarchies.
  • You have the option of importing and exporting static attributes, dynamic attributes, and hierarchies in model and instance configurations.
  • The fields for uploading CSV files have been updated.
  • Models and instances are now saved by new Save Model and Save Instance buttons.

Analytics:

  • Two new options are now available for the DataHub Subscribe input processor:
    • Ignore Failed Data: Select to ignore data with the output success=false.
    • Ignore Null Value: Select to ignore data with the output value=null.

DataHub:

  • Starting with Litmus Edge version 3.5.2, the user interface prompted you to configure an external timeseries database and not an internal one. You now have the option of configuring either an internal or external timeseries database with no plan to deprecate internal timeseries databases.

Applications:

  • In Applications > Containers, a new Status column displays the uptime and current status of the containers.

Resolved Issues

Description

Terminal User Interface (TUI):

  • Fixed issue with a blank username or password not displaying an error message.
  • Fixed issue with the activation and deactivation function not working.
  • Fixed issue with the initial reboot sequence allowing you to access the main menu and make changes before the reboot initialization finishes and the reboot occurs.
  • Fixed issue with some fields, such as Cloud Activation URL and Docker Subnet, accepting blank entries before submitting.
  • Fixed issue with Cloud Activation not allowing to cancel or timeout.
  • Fixed issue with the Managed Services section not displaying any options.
  • Fixed issue with being able to access all TUI options if an admin user cancels the end-user license agreement (EULA) and logs in again to the TUI.

System:

  • Fixed issue with not being able to generate support bundles.
  • Fixed issue with the Docker version not creating events for DeviceHub, Connectors, and Flows.
  • Fixed issue with the source timestamp not updating in an OPC UA server.
  • Fixed issue with applications not running successfully after upgrading Litmus Edge.
  • Fixed issue with users with the Auth:Modify permission having issues navigating to System > Device Management.
  • Fixed issue with downloaded template files including components that weren't selected.
  • Fixed issue with a connected DB-InfluxDB SSL connector significantly increasing its CPU usage after upgrading Litmus Edge.
  • Fixed issue with templates not loading Marketplace catalogs and registries.
  • Fixed issue with LDAP Group Mapping not being available after updating Litmus Edge.
  • Fixed issue with Raspberry PI ARM64 not displaying CPU info.
  • Fixed issue with backup files with over 25 DeviceHub devices not uploading successfully.

DeviceHub:

  • Fixed issue with the Siemens S7 driver not being able to collect tags with the data type S5Time.
  • Fixed issue with the Browse Tags feature not working after browsing tags, canceling the operation, and attempting to browse tags again.
  • Fixed issue with the API sending empty responses if a DeviceHub device is stopped.
  • Fixed issue with a "Successfully copied" message displaying after copying a topic in DeviceHub but after pasting "undefined" displays.
  • Fixed issue with issues trying to read data a Profinet device using the PROFIdrive profile.
  • Fixed issue with the AB CompactLogix Ethernet FreeTag driver not being able to re-connect after a power outage for the PLC connected to the driver.
  • Fixed issue with devices not receiving all license features from the license server.
  • Fixed issue with address ranges for the following drivers:
    • AB PLC5 (Gen1)
    • AB PLC5 Ethernet (Gen1)
    • Beckhoff ADS/AMS Ethernet (Gen1)
    • Siemens S5-Ethernet (Gen1)
    • Siemens S7-200 Ethernet (Gen1)
    • Siemens S7-200 Serial (Gen1)
    • Siemens S7-300 Serial (Gen1)
    • Siemens S7-Advanced (Gen1)
  • Fixed the following issues with the AB CompactLogix Ethernet Advanced driver:
    • The driver not publishing NATS messages when the driver has a large number of tags.
    • Polling of tags affected by incorrect grouping of Boolean tags.
  • Fixed issue with the Browse Tags feature returning the incorrect number of tags for the OPC UA Client Advanced driver.
  • Fixed issue with the Roc800 Ethernet driver crashing after adding a tag with type Opcode180.

Analytics:

  • Fixed formatting and navigation issues with the Tengo Script processor.
  • Fixed issue with the Export option on the Analytics canvas not working successfully.
  • Fixed issue with an error persisting for the Change of Value node even after resetting Litmus Edge.
  • Fixed issue with an error message displaying after connecting a Statistical Prediction node to a Moving Average node.
  • Fixed issue with the Next button in the Create Flow dialog not being available after selecting DataHub Subscribe.
  • Fixed issue with the Change of Value processor using the incorrect data type for values.
  • Fixed issue with the output of values written as string values when they should be written as integer values.
  • Fixed issue with the debug window not displaying correctly unless the browser page is refreshed.

Flows Manager:

  • Fixed issue with new flows not displaying or the admin flow instance not starting unless Litmus Edge is rebooted.
  • Fixed issue with errors displaying after importing a file of flows.
  • Fixed issue with uploading a node_module file in an incorrect format, and a message displays incorrectly notifying you the file was successfully uploaded.
  • Fixed issue with the poll-once topic only displaying data after clicking the inject node the first time. Subsequent clicks of the inject node now correctly display data.
  • Fixed issue with Flows Managers displaying a warning status incorrectly.

Digital Twins:

  • Fixed issue with write and Poll-once topics being listed as options for dynamic attributes.
  • Fixed issue with the order of model hierarchies not saving properly.

Integration:

  • Fixed issue with the MongoDB 4+ connector consuming a large amount of RAM and consequently crashing.
  • Fixed issue with the Google Pub/Sub connector restarting topics after they are deleted.
  • Fixed issue with duplicate topics being created for connectors.
  • Fixed issue with frequent disconnections from the InfluxDB 2.x TCP connector.
  • Fixed issue with the Mindsphere connector not being able to send data.
  • Fixed issue with the log window not resetting when returning to view it.

OPC UA:

  • Fixed issue with errors after starting and stopping the OPC UA Server.
  • Fixed issue with write requests being sent to the OPC UA server as empty payloads.
  • Fixed issue with importing an OPC UA hierarchy and not all nodes are imported.
  • Fixed issue with the OPC UA server showing tags with the bit data type as a string data type.
  • Fixed issue with importing a hierarchy from DeviceHub from a JSON file and the NodeID Settings are ignored.
  • Fixed issue with the OPC UA Server not being able to handle all data types.

Applications:

  • Fixed issue with not being able to fetch logs for a container with the filter of one minute.

Deprecated Components and Features

Description

System:

  • Functionality in System > Remote Access is no longer available.

Terminal User Interface (TUI):

  • You can no longer enter a site-based license through the TUI. To enter a site-based license or to complete offline license activation, you will need to use the Web UI for Litmus Edge or Litmus Edge Manager.

DeviceHub:

  • The Koyo Ethernet driver is no longer available. It has been replaced with the Koyo Ethernet (Gen1) driver.
  • The Siemens S7-400 driver is no longer available. We recommend using Siemens S7 or Siemens S7-Advanced (Gen1) instead.

Integration:

  • The Loopback connector is no longer available.