Litmus Edge 3.16.1

important for a seamless upgrade experience in upcoming releases, it's essential to follow the correct upgrade path begin by upgrading from version 3 5 6 to 3 11 6, then proceed to 3 16 1 before making any further updates if you are on 3 5 x versions if you are on 3 11 6 proceed with 3 16 1 skipping these key lts versions may cause issues that can disrupt the upgrade process, so it is highly recommended to follow this sequence release date sept 23, 2024 review the current list of limitations docid\ sfpzg64odatxzkpg2bnk0 new features description devicehub the following drivers are now available syslog server emerson dnp3 ethernet with fb extensions dnp3 master csv stream snmp manager analytics the following new nodes are now available the change node allows you to move the property of a message the filereader node allows you to create a file read with no limitations you can use it to dump any file into string into either a nats message or to the file writer the filewriter node allows you to define a file name with a file path, which will write the file if the path or file doesn't exist, the file will be created the inject node inserts a message into an analytics processor, either manually or at regular intervals the switch node allows you to route or filter messages based on rules tokens you can now create api credentials using an oauth 2 0 client packet capture the new packet capture feature under systems > network allows for advanced diagnosis of network communication issues with any industrial device zerotouch you can now activate litmus edge devices with litmus edge manager through zerotouch you can now automatically configure activation, static ip, and marketplace container apps using zerotouch provisioning integration the following connectors are now available databricks cognite litmus uns osi pi historian enhancements and improvements description system the system menu has been reorganized, and features have been consolidated to improve the user experience the api key creation process now includes a popup dialog box that displays the generated key immediately with a client id and client secret devicehub updates allowing for integration with litmus uns a new user interface workflow is now available when adding a new device the device discovery module has been renamed asset discovery the user interface has also been updated to provide more information on arp and cip protocols the asset discovery feature has been added for litmus edge docker builds to discover plcs and industrial assets on the network a new write response topic, which allows you to view a success/failure response for write requests that the driver sends, is now available for the following drivers bacnet bacnetip opc ua client advanced dnp3 master emerson dnp3 ethernet emerson dnp3 ethernet with fb extensions lumberg automation lion x retry count is now available for the enron modbus driver the following focas libraries can now be read for the fanuc cnc ethernet (gen1) driver cnc modal cnc rdexecmcode cnc rdgcode cnc rdcommand the count tag parameter is now available for the koyo ethernet (gen1) driver when using batch write , you can now use the devicename and tagname parameters to configure it, instead of deviceid and registerid when leveraging this feature with devicename and tagname, make sure to select enable alias topics in the device settings the parameters status, statuscode, and sourcetimestamp are included in devicehub payloads for the following drivers bacnetip dnp3 master lion x emerson dnp3 ethernet with fb extensions opc ua advanced client include extended event data is now enabled to read w\&m events in the emerson roc800 driver fragmented writing is now supported for the emerson dnp3 ethernet driver the siemens s7 commplus symbolic driver now supports encrypted firmware the enron modbus driver now has a restriction that items for history points must be integers equal to or greater than 1 the count tag parameter is now available for the jtekt toyopuc cmp link ethernet (gen1) driver you can now download the default certificate for the osi agent advanced driver the modbus rtu over tcp driver now has a new override station id parameter for devices and station id parameter for tags, which allows the driver to support multiple connections to slaves the following enhancements have been made to the roc800 ethernet driver timestamps are now displayed in iso 8601/rfc3339 format with time zone offset the local time is now used for data and time data points the table parameter properties have been updated to avoid incorrect values from being entered requests only w\&m index only if opcode 6 returns roc800l type include extended event data is now enabled to read w\&m events the following enhancements have been made to the enron modbus driver you can now retrieve history tag data in ascii mode for serial communication read and write is now implemented for the string data type it is possible to configure names for items in sequential history data alarms and events are now automatically acknowledged the new max record number parameter is now available, which improves how archives are read empty events are no longer published null characters are no longer included in strings the algorithm for determining the connection status is now re factored a new string size parameter is now available the device parameter “retry count” is now available a restriction has been added to ensure that items for historypoints must be integers greater than or equal to 1 the following enhancements have been made to the dnp3 ethernet with fb extensions driver history, alarms, events, meter, and transaction history record retrieval for fb3000 devices is now available supports dnp3 group 70, file operations digital twins several improvements have been made to the digital twins user interface to improve appearance and navigation poll once functionality is now available this allows you to poll for the current state of the digital twins model/instance as needed the following system variables can now be used for static/dynamic attributes edge dt system time model version model name you can now view a history of changes made after each model update transformations now allow dot ($ tagname) and no dot ($tagname) notation the upgrade instances button for a model is now disabled when there are no instances associated with the model if an attribute in the schema tab is not included in payloads, it is now identified in gray and in italics a new sync icon is now available in the schema tab you can now add an array type in a hierarchy so you can pass multiple tags in an array the hierarchy tab has been renamed schema a clear hierarchy button is now available you now have the option of adding static attributes based on litmus uns you can now automatically create a hierarchy/schema based on dynamic and static attributes you can now view a list of litmus uns connectors from instances opc ua the user interface for security settings of the opc ua server has been updated the certificates pane is renamed connections logging and telemetry are now available in opc ua > management a new sessions tab displaying active sessions is now available in opc ua > certificates two new parameters are now included with tag data arraydimension valuerank you can now view the list of tags that will be imported from devicehub updates have been made to data type mappings devicehub data type usint opc ua data type byte devicehub data type enum16 opc ua data type uint16 devicehub data type uint opc ua data type uint16 devicehub data type udint opc ua data type uint32 devicehub data type attribute opc ua data type string devicehub data type ltod opc ua data type string devicehub data type dtl opc ua data type string devicehub data type uc10 opc ua data type string devicehub data type uc20 opc ua data type string devicehub data type uc30 opc ua data type string devicehub data type uc40 opc ua data type string you can now log in with ldap/ad users cloud storage the cloud storage page has been moved to integration databricks is now available as an option for cloud storage you now have the option to encrypt credentials for sync jobs cloud storage configurations are now included in templates a new status message now displays when jobs are in progress events are now created in system > events for cloud storage events the notifications for events caused by cloud storage errors will not be displayed integration the influxdb v2 x tcp and influxdb v2 x ssl connectors are now able to publish standard and additional key/value pairs from the payload this allows metadata to be included in the json payloads you can now use one local topic to publish to multiple remote topics for all connectors the kafka connector has been enhanced for increased bidirectional throughput the show mapping option is now available for the following connectors microsoft sql server ssl mysql ssl postgresql ssl mongodb 3 mongo v4+ a new device name column is now included in payloads for sql connectors graphql is now implemented for all connectors you can now upload tags in batches to all the sql connectors you can now edit the following connectors even while they are still connected azure events hub amqp tcp amqp ssl kafka tcp kafka ssl mindsphere splunk aveva rest api the command line interface (cli) is now an option to pre process configurations you can now filter connector logs based on a time range you can now connect to postgres databases using the scram sha 256 authentication method you can now use external account type credentials for the google pub/sub connector all datetime related fields for the aveva datahub connector are now formatted to iso 8601 mqtt connectors will now auto generate the client id parameter if it is blank the copy icon is no longer available for connector parameters that are protected integration sub tab is renamed to streaming now template when uploading a template, you can now view the list of items for each component that will be included when importing a template, if the litmus edge instance already has the same devicehub device as the template with additional tags that are not in the template, the additional tags will be automatically deleted you can seamlessly import and export rbac configs and ldap group mappings using templates flows manager the flows manager canvas is now updated to node red version 3 1 the node red node email palette is upgraded to v 2 1 0 the go to flow definition icon and start/stop buttons are now always enabled, regardless of the status of the flows manager introduced safe mode in flows external storage you can now use multi level folder paths when mounting external storage mounted storage is now continuously monitored, so if the status of the mounted folder is down, the storage is unmounted automatically when the status of the mounted folder is up again, the storage is mounted automatically users role permissions are now available for cloud storage and network utility tools granular permissions are now available for individual devicehub devices the opcua now supports rbac permissions, allowing for more granular control over user access and permissions within the system events a new event now displays when a message fails to publish license if a litmus edge instance doesn't have a license, you can now do the following access network settings download a support bundle user interface input fields now undergo validation for trailing and leading spaces the session expiration timeout warning message has been updated a new " online users " component has been added to the litmus edge toolbar it will display the number of active users and provide a real time list of all active users validation to eliminate leading and trailing spaces in input fields for flows manager opcua datahub analytics integration upgrade when doing an upgrade of litmus edge, you now have the option to skip the automatic backup before proceeding with the upgrade process resolved issues description applications fixed issue with input fields in applications > networks not undergoing validation fixed issue with processes not displaying correct information in container top fixed issue with duplicate registry being added with the same name and credentials analytics fixed issue with the rounding processor not calculating values correctly network fixed issue with not being able to delete static routes after modifying the network interfaces fixed issue with the interface parameter not being correctly included in firewall rule settings devicehub fixed null value in the calibration event and user parameter/application alarm for the dnp3 masterfbx driver fixed missing empty metadata in payloads for the following drivers bacnet/ip dnp3 master emerson dnp3 with fb extensions opc ua client advanced lumberg automation lion x fixed issue with the incorrect timestamp included in payloads for the emerson dnp3 ethernet driver fixed issue with the opc ua advanced client driver generating a could not load certificate or private key from pki after upgrading the database fixed issue with the connection configuration for the enron modbus driver fixed issue with the auto scrolling functionality on the logs screen fixed issue with drivers not reading tag data quickly enough fixed issue of history registers reading null for opcode requests of more than 60 points fixed issue with tag addresses for gen1 drivers being incorrectly rejected address validation is no longer enabled for tag addresses fixed issue with the ab compactlogix ethernet advanced driver not being able to browse udt tags fixed issue with not being able to enter a tag address that ends in 8 or 9 fixed issue with duplicate topics being created for tags with underscore “ ” in the tag name fixed issues in dnp3 ethernet with fb extensions driver no longer includes empty metadata in payloads transactions/histheader data corrections successful return for tunneling 5k tag csv can now history records of user periodic 1 and 2 fixed the following issues with the fb107 ethernet driver history tags no longer send duplicate nats messages location and logical tag parameters have been updated with appropriate default values and upper/lower limits fixed issue with tags timing out and not sending nats messages for the dnp3 ethernet driver fixed issue with the alarms tag type not parsing correctly with the roc800 ethernet driver fixed issue with the compactlogix ethernet advanced driver using the "tagname" parameter instead of "name" to poll data fixed issue with the siemens s7 driver crashing when an incorrect tag address is configured fixed issue with the system hanging when importing a large number (3000+) of tags fixed issue with being able to create duplicate topic names with tags that have similar names, but one uses a hyphen , and another uses an underscore (for example, c2 1 and c2 1 create one topic (c2 1) for both tags) fixed issue with the bacnetip driver showing a connected status even though the ethernet cable is disconnected fixed issue with the fanuc cnc ethernet (gen1) driver not being able to read values from the x, y, and z axes fixed issue with not being able to configure decimal point values for the polling interval parameter fixed issue with devicehub metrics displaying an incorrect status for device online status fixed issue with the modbus tcp (gen2) driver displaying an incorrect tag status fixed issue with the watchdog option not being enabled by default after upgrading from version 3 5 6 fixed issue with not being able to configure positive float values for tag poll intervals fixed issue with devices showing a polling status for several minutes when visiting the page for the first time fixed issue with the format of opcode 7 values for the emerson fb107 driver fixed issue with not being able to manually change the tag data type for the euromap 63 driver fixed issue with all tags not being selected when using browse tags, selecting tags, using search to filter the results, and then selecting additional tags fixed issue with tag formulas not functioning properly for litmus edge version 3 11 1 when trying to divide the tag value fixed issue that was causing increased cpu and memory usage over time with some devicehub devices integration fixed issue with a restart of the docker service causing the persistence layer to be corrupted and data to stop being sent fixed issue with panic and error messages generating for connectors fixed issue with the nats connector not reconnecting successfully after a network issue fixed issue with integration tiles disappearing after opening the browser debug window and navigating to the subsequent page of integration tiles fixed issue with connectors generating a too many open files error fixed issue with unsupported data types for the following connectors db microsoft sql server db microsoft sql server ssl db mysql db mysql ssl fixed issue with litmus edge generating an excessive number of connections to confluent fixed issue where cloud storage sync job did not save the source path as entered now it saves the source path correctly as entered by the user system fixed issue with errors being generated when trying to download a template file if there are a lot of applications being used fixed issue with not being able to edit tokens when there is more than one access account fixed issue with templates not uploading successfully if it has a large number of applications fixed issue with the error message not displaying information if the disk limit size is exceeded fixed issue with not being able to delete a catalog with an incorrect marketplace catalog url fixed issue with not being able to add a mount point with ftp fixed issue with activation showing as successful if the activation remote domain name is not correctly configured fixed issue with not being able to update group permissions for ldap users fixed issue with an "authorization" missing from the header error message displaying if you navigate to system > events the purging of system events from the ui now correctly reduces the size of the events to 0 opc ua fixed issue with hierarchy names only allowing one whitespace character fixed issue with the management page incorrectly allowing you to add new users fixed issue with a restriction on the number of segments allowed in topic names there is no longer a restriction flows manager fixed issue with the flows manager not restarting automatically when killed manually with the kill 9 \<pid> command user interface fixed issue that was causing passwords do not match error when the user copies and pastes the password using the mouse in the new password and confirm new password fields security resolved several vulnerabilities deprecated components and features description devicehub the expandall icon in the browse tags dialog is no longer available to address issues with the browser window freezing integration the ibm watson iot platform is no longer supported with litmus edge, which affects the functionality of the mqtt ibm watson over ssl connector analytics the view icon (eye) is no longer available from the output processor data can be viewed by clicking the view icon for input and function processors opc ua you can no longer create new users opc ua users from the opc > management page you can manage users from the opc ua server