IoT Gateway 22.03 Release Notes

What's new in the IoT Gateway 22.03 release

The latest released build is 22.03.06.

We updated our version naming convention for deviceWISE Gateway releases in 2021. The first two digits indicate the year when we started work for that release. The second two digits increment with each release during that year. The third two digits indicate the build number associated with a release. Smaller updates to a previous release will increment this third number.

Customers upgrading a node from previous deviceWISE versions should reference the “Upgrading from previous version” section near the bottom of these release notes before starting the upgrade.

deviceWISE Runtime

  • Fix defects;

  • Move HTTP Client from Sandbox to Runtime and add support for DELETE command;

  • Update Runtime to support Export and Import of dW View Galleries and Displays;

  • Allow Regular Expression (Regex) to be defined from a deviceWISE Variable;

  • Add BOOLEAN filter to data array event;

  • Add Serial Number to list of valid hardware IDs;

  • Update JSON Encode to use FLOAT8 for all decimals.

Gateways

We removed the Local Portal feature beginning with the 21.09 release.

deviceWISE View (version 1.6.0)

  • Fix defects;
  • Add ability to Import and Export dW View Displays and Galleries from the Workbench;
  • Add Dynamic reference for Apex Charts annotations;
  • Add support to use variables to set the Style and Background Color;
  • Add ability to change the Gallery name without affecting local variables;
  • Add ability to dynamically set Min and Max value of Slider Widget;
  • Add ability to set Min and Max value of Progress Bar Widget;
  • Support cut and paste of many items in a canvas;
  • Add option to suppress some error notifications in a gallery;
  • Allow button navigation to work after changing the name of a display;
  • Add ability to limit the number of characters to display in a Value Card Widget.

Gateways

Note: Each Asset Gateway license is limited to 5 devices. If you want to add more devices, please contact your sales representative and request additional licenses.

  • Add support for OPC DA Server in Windows 64-bit platforms;
  • Add ability to activate serial ports on Teltonika RUTX and TRB140 gateways.

Note: 20.1.9 was the final release for the following VxWorks-based gateways. These were removed from builds beginning with the 20.1.10 release. If you need assistance, please contact us here.

  • Asset Gateway for Mitsubishi CCPU
  • Enterprise Gateway for Mitsubishi MESInterfaceIT
  • Enterprise Gateway for Siemens ERPC

Customers using our Windows products should review the section below covering "Upgrading from previous versions".  We moved to a new installation architecture for Windows products with version 19.1.6.

Transaction Server

  • Fix defects;

  • Add more info in HTTP Transaction output fields;

  • For HTTP Transport Store & Forward - add option to discard malformed messages;

  • Update Transport Mapping so that log data points to a Transport Map;

  • Add way for Project trigger to read the last error message of a Transport Map.

Tunnel Manager

  • Debounce and grey-out "Open" and "Close" buttons;
  • Improve visibility of Copy IP address action with a ToolTip;
  • Clean up when any tunnel is terminated by closing tunnels on system exit.

Workbench

  • Fix defects

  • Add support to Export and Import dW View Displays and Galleries;

  • Allow user to identify what character can be a delimiter for a CSV export;

  • In Trigger Overview - allow right-click to view last trigger report;

  • Capture platform mismatch and firmware update to show error when wrong update file is sent to a node;

  • Improve Software Update process to handle variable content types from the Portal;

  • Remove TSL (Technical Support License) warning (if Tr50 is used) since Portal users are under support;

  • Add "Description" column to Variables Watch window;

  • Add Storage Utilization to Device Overview Panel;

  • Enable copying to clipboard in tree tables (e.g. Variable panel);

  • Add ability to Clone/Duplicate an instance of the Workbench using Ctrl-Alt-Shift-N.

Drivers

Navigate to the Management Portal -> Developer page -> Resources item to identify the drivers and driver versions supported on a specific platform with this release. Both new installations and updates should include the drivers for this release.

  • AWS IoT Core - Bug Fixes

  • AWS IoT Sitewise - Bug Fixes

  • Azure

    • Update to newer SDK (v1.9)

  • BACnet (Technology Preview)

    • Allow the use of an adapter name instead of IP in local endpoint channel;

    • Added wildcard support for BACnet COV items.

  • Beckhoff: Fix crash when enumerating items with characters that are not supported

  • All Cloud Connectors (Azure, GCP, AWS IoT Core, AWS Sitewise) to reference the component name when exporting it

  • Codesys: Fix crash when enumerating variables beyond the size of an array

  • Modbus - Add support for INT8/UINT8

  • IBM Visual Inspect (Technology Preview)

    • Add ability to export when used in trigger;

    • Add Validate and token-based authentication in hosted mode.

  • IFM-IOLINK (Technology Preview) - New Driver with Read support in 22.03!

    • Supported on Generic Windows X86 and X64 platforms;

    • Supported on Generic Linux X86 and X64 platforms.

  • Maximo Visual Inspection (Technology Preview) - Fix defect

  • MTConnect - Fix issue where device is stuck in a stopping state. Fix issues when processing malformed XML payloads

  • OPTO22 (Technology Preview) - New Driver in 22.03!

  • OPC DA Client - Bug fix

  • OPC DA Server

    • Bug fixes;

    • Add Support for Windows X64 platforms

  • OPC UA Client

    • Fix crash when unsubscribing from the OPC UA Server

  • Allen Bradley Rockwell driver

    • Add Allowlist/Denylist option when Program Tag enumeration is selected;

    • Reduce CIP data buffer size from 20KB to 2KBFix to continue querying Program tags when CIP 0x06 error is received.

  • Sandbox - HTTP Client

    • Move HTTP Client to deviceWISE Runtime

  • NLS Enablement updated for: Atlas Copco, Acradyne, Bosch, Cleco, Estic, Ingersoll, Rand, Stanley, Sturtevant, along with Danlaw, GEFanuc, GPS, Lua, Mitsubishi, MELSEC, MQTT, Oauth2, OPC UA Server, and SNMP.

  • TCP - Fix defects.

The following defects were fixed in this release.

deviceWISE Gateways

MAP-17643: BBE can't start 22.02

Description: This issue was introduced in the 22.02 release with the fix for MAP-17420 where we “populate the key field in the network info object” and we did not handle null characters properly. We fixed this in the 22.02.08 build by adding null checking to network.unix.c. Fixed in updated build 22.02.08 and in 22.03.

deviceWISE Runtime

MAP-17624: Trying to write 5.32 to the table, yet it only stores 5.3

Description:: FLOAT8 was missing the delimiter in variable_to_string. Fixed in 22.0.

MAP-17763: The page is really slow to load bound data

Description: No code change required. There are limited of resources on every HTTP connection. Every time when a browser is refreshed, new HTTP connection is made, and the browser does not kill the old connection which has a 240 sec lingering time. The resource will be reclaimed after 240sec. Shorten this time by changing the property "service.notification.multi.timeout_in_ms=240000" to 60000 milli-seconds eliminates the problem created by the test scenario. The test case customer used is not really a good scenario anyway and should avoid doing.

MAP-17678: Gateway crashed due to runtime exception - v22.02

Description: Btree delete will wait for btree foreach to finish before removing the mutex. This will also log a message to system.log when that happens so we can verify the potential fix is actually effective.

MAP-15652: Email Action fails sending to MS 365 email server

Description: Fixed in 22.03.

MAP-17583: Customer node core memory high issue

Description: Fixed a memory leak on http variable subscribe V1 request when session is closed and there are still publishes in the queue.

MAP-17697: Customer node - Runtime exception caught: [0xC0000005]- v22.02

Description: Added code to send an error if the string length is zero. Fixed in 22.03.

MAP-17611: Cannot Disconnect from AWS IoT Core

Description: Fix to allow the Disconnect button to work. It was associated with the Security setting defined for the button. Fixed in 22.03.

MAP-17765: TSL Warning not being dismissed in Client of Pooled Implementation

Description: License pooling needed to pass additional information (expiration date) on top of the feature bit. Fixed in 22.03.

MAP-17721: Furuno - high latency communication issues over tunnels

Description: Set TLS min version to v1.2. Add send timeout to TR50 Tunnel. Add SSL timeout to property file in 22.03.

MAP-17868: Email notification settings from LDAP not found in full backup

Description:Add import/export to LDAP email notification in 22.03.

MAP-17814: Deloitte #101 - String compare - wrong result when comparing empty strings

Description: Fixed string compare error when comparing empty strings in 22.03.

deviceWISE View

MAP-17846: Deloitte View #64 - View - Float variables are displayed with more decimals than expected

Description: Code Widget updated to fix the number of decimal places to 2 in 22.03.

MAP-17680: New HTTP server not loading the page

Description:Added default cert/key to new HTTP Server. Fixed in 22.03.

MAP-17772: Replace “${${currentDevice}_${homePageValues}.CounterGradingsA}” with "****" in Button Text

Description:We do not display messages with a $ in the string in Code Widget for 22.03. Customer to update timeout property to reduce delays.

MAP-17736: deviceWISE View Write Widget Floating Point Error

Description: Write Widget Floating Point Error was fixed in 22.03.

MAP-17673: DeviceWISE View Binary Widget Binding

Description: Check Box and Toggle button fixed to write binary values in 22.03.

MAP-17628: Pie Chart Legend Does Not Apply in Runtime

Description: Fixed issue pie chart legend defaults back to its original text once the user enters live view mode in 22.03.

Transaction Server

MAP-17564: XSD Transport Map - Long Response Time

Description: : Fixed slow response issue while parsing XSD response. This fix effects WSLD & XSD response parsing. Fixed in 22.03.

MAP-17565: XSD Transport Map - Row Count Not Returning

Description: Fixed with MAP-17564 in 22.03.

MAP-17566: XSD Transport Map - Repeating Rows

Description: Fixed with MAP-17564 in 22.03.

MAP-17677: Enterprise JMS Listener was not automatically connected after Node crash v22.02

Description:Fixed Thread’s synchronization while closing JMS connection in 22.03.

MAP-16915: Transport Map Last Error Message cannot be used in an application

Description:Added Http Status (200, 401 etc) code output variable to the Transaction Action, this indicates if the transaction was successful/unsuccessful. Fixed in 22.03.

MAP-17831: Local DB Sqlite not returning IDENTITY in the resultKey

Description: Fixed Sqlite not returning autogenerated key after inserting into the table. Fixed in 22.03.

Tunnel Manager

MAP-17739: Tunnel Manager -- not placing the logs in the proper place – Logs now stored in appdata/roaming directory, same as workbench

Drivers

MAP-17743: Beckhoff TwinCAT 3 ADS Driver | AGW Crash

Description: Beckhoff was crashing because we were setting a variable in a vinfo that was NULL. Fixed in 22.03.

MAP-17665: Codesys driver crash on Windows 64

Description: Add a check to prevent walking past the last element of an array. Fixed in 22.03.

MAP-17482: Unresponsive node till mutex shut down

Description: Fixed in another TCP Listener issue in 22.03 (MAP-17674).

MAP-17674: Need to Investigate dwtcp(TCP Listener) crash w.r.t bad socket

Description: Cleanup of sequence of device stop of the TCP driver to avoid invalid access on socket handles which in turn avoids crash.

MAP-17813: TCP Device Takes Up To 2 Minutes To Stop When Endpoints Become Unreachable

Description: Added Timeout device property to use for connect socket and send socket APIs in 22.03.

Workbench

MAP-17652: AWS Cloud Connector connections not established automatically after restoring from backup

Description: Issue introduced in 22.02.06. Fixed by restoring licenses first. Fixed in 22.02.08 and in 22.03.

MAP-17871: All variables under the system monitor device should be labeled as Read-Only in DeviceWise>Variables

Description: Added better error message in 22.03.

MAP-17759: Issue with Variable Group Add

Description: Issue with auto generated indexes and clash detection when there are fewer entries at edit start than the highest generated index. Changed index generation and clash detection. Fixed in 22.03.

MAP-17830: Webservice Transport does not return data

Description: Fixed WSDL Parser Issue, where the transport would not return data if the name of the variable was used in multiple places of WSDL. Fixed in 22.03.

Generally Available
Device Driver Version
AcraDyne driver 1.1.3
Advanced Display Protocol 1.0.2
Apex Cleco driver 1.9.4
Atlas Copco driver 3.10
AWS 1.0
Azure 2.1.12
Beckhoff driver 2.1.9
Bosch Rexroth driver 1.8.4
Danlaw 2.12.3
Estic driver 1.2.0
FANUC CNC Driver 2.0.3
Fanuc driver 2.3.3
GPS 1.0.4
Industrial driver Updated with each release
Ingersoll Rand driver 1.4.0
Kawasaki 1.4.0
Keyence 1.0.6
LDAP – do not use with Linux X86 in versions 21.10 and later 1.1.2
Lua 1.1.4
IBM Maximo 1.1.4
IFM IO-Link 1.0.1
Melsec 3.5.7
Mitsubishi driver 3.3.7
Modbus driver 2.11.5
Modbus Server driver 1.1.8
Modem 1.5.1
MQTT driver 2.1.9
MTConnect driver 1.3.3
NMEA GPS 1.0.4
OAuth2 2.3.2
Omron driver 3.8.2
OPC-UA Client driver 3.1.22
ROC Plus driver 2.0.3
Rockwell ControlLogix driver Updated with each release
Schneider Electric 2.9.0
Siemens S7 driver 3.0.5
SNMP driver 1.1.1
Sparkplug B Included and Updated as part of MQTT
Stanley Tools driver 1.3.0
Sturtevant Richmont driver 1.8.4
Sysmon 1.0.2
TCP Listener 2.4.0
Toyopuc 1.0.5
TR50 2.6.2
deviceWISE View 2.3.7


Technology Preview
Device Driver Version
Amcrest 1.0.1
AWS SiteWise 1.0.3
BACnet / IP driver 3.2.12
Barcode Scanner 1.1.1
CODESYS driver 1.0.0
CTI (Control Technologies Inc.) driver 2.1.5
EDU (not built for Windows 64-bit) 1.0.1
E-Sensors 1.0.1
File Watcher - Updated with 23.04 1.0.8
Google Cloud Platform (GCP) 1.0.0
HAAS 1.0.0
GrovePi driver(Only in Raspbian directory) 1.0.2
HTTP Server 1.0.1
J1939 IXXAT device Driver 1.1.1
JSON 1.0.0
Melsec 1.0.1
Nachi – (Windows Only - Win32 and Win64) 1.0.0

ScanTools OBD-II

1.0.1
OPTO22 1.0.0
Sandbox 1.3.0
Serial 1.3.0
SICK CLV Scanner 1.1.7
Simulation 1.0.0
Telit SmartIO 2.2.1
Trending 1.3.14
Visual Inspection 1.0.12
Virtual  1.3.0
Xirgo 1.3.0
Zaxis (only built for Windows products) 1.0

deviceWISE Enterprise Gateway products

  • Software Products
    • AIX 64-bit (Version 6.1 and Version 7.1 and Version 7.2)
    • Linux 32-bit (CentOS 6)
      • No CentOS 5 Support
    • Linux 64-bit (CentOS 6 and CentOS 7)  
      • No CentOS 5 support
      • Full - for deviceWISE Enterprise Gateways for 32-bit Linux installed on 64-bit CentOS Operating Systems (requires 32-bit glibc, e.g. glibc.i686 on CentOS 7)
      • Full - for deviceWISE Enterprise Gateway for 64-bit Linux 
      • Red Hat Enterprise Linux v8
      • SUSE Linux Enterprise Server 15 (64-bit)
      • Ubuntu 18.04. 20.04 (64-bit)
    • Windows 32-bit (Windows 7, Windows 10, Windows Server 2012 R2, Windows Server 2016; Windows Server 2019 )
      • No support for Windows Home Edition
    • Windows 64-bit (Windows 7, Windows 10, Windows Server 2012 R2, Windows Server 2016 64-bit, Windows Server 2019 64-bit )
      • No support for Windows Home Edition
  • Embedded Products   
    • Rockwell ControlLogix Compute Module
    • Dell Edge 5000 - WindRiver Linux 7; Ubuntu Server - **Discontinued**
    • Mitsubishi MES Interface IT **** We discontinued this with 20.1.10 ****
    • Mitsubishi WinCPU ** Supported through 21.06 **
    • Siemens ERPC **** We discontinued this with 20.1.10 ****

deviceWISE Asset Gateway products

  • Software Products
    • Linux 32-bit (CentOS 6)
      • No CentOS 5 support
    • Linux 64-bit (CentOS 6 and CentOS 7)
      • No CentOS 5 support
      • Full - for deviceWISE Asset Gateways for 32-bit Linux installed on 64-bit CentOS Operating Systems (requires 32-bit glibc, e.g. glibc.i686 on CentOS 7)
      • Full - for deviceWISE Asset Gateway for 64-bit Linux
    • Red Hat Enterprise Linux v8
    • SUSE Linux Enterprise Server 15 (64-bit)
    • Ubuntu 18.04 20.04 (64-bit)
    • Linux 64-bit (Snap) - Discontinued
    • Windows (Windows 7, and Windows 10)
      • No support for Windows Home Edition
    • Windows 64-bit (Windows 10)
      • No support for Windows Home Edition
  • Embedded Products
    • B+B SmartWorx Spectre V3
    • CalAmp LMU-5000 (Rev C and Rev G) - Discontinued with version 22.01
    • CalAmp CDM-5030 - Discontinued with version 22.01
    • Cisco 829  
    • Cisco IE 4000 - Discontinued with version 21.10
    • Cypress CTM-200  
    • Dell Edge 5000 - WindRiver Linux 7 **Discontinued with 22.01**
    • GateTel EZMoto V2
    • Mitsubishi CCPU - **** We discontinued this with 20.1.10 ****
    • MultiTech Conduit (with Serial and GPIO and cellular modules)
    • MultiTech Conduit AEP for AT&T**
    • MultiTech OCG-D (Models H5)
    • MultiTech rCell (Model MTR-LAT1-B07)
    • Option CloudGate (Models CG0192 and CG0112 with v1.x or v2.x firmware)
    • RedLion (Pilot Ready)
    • Siemens (MicroBox, NanoBox)* - Discontinued with 22.02
    • Siemens IoT 2000 (Wired only)
    • Siemens ERPC* - **** We discontinued this with 20.1.10 ****
    • Systech SysLINK SL-500 
    • Teltonika TRB Gateway (Requires glib c build from Teltonika)
    • Teltonika RUTX Router(Requires glib c build from Teltonika)
    • USRobotics 3510
    • Vantron VT-M2M-LV 
    • Xmodus XM1710E (Pilot Ready) - *** Discontinued with 22.02 ***

Limited Release** features

* - Denotes a supported gateway that was not specifically tested for this release. Of the Asset Gateways listed, most use a standard Linux or Windows load or they are very similar to a tested Enterprise Gateway.
** - Limited Release features meet customer specific features and configurations. These features may not be available in all hardware and operating system configurations.

Actions and Events

MAP-7740:  Log Message action not logging the $ char in a log message

Description:  The Log Message action does not write the $ char in an exception log message.  This can be bypassed by using 2 $ chars back to back.

MAP-14633: Segfault crash on CalAmp RevG when doing a Local DB Select action

Description: When executing a trigger with the Local DB Select action on a CalAmp RevG, the node will crash with a segfault. The crash seems to only occur when the Return Result as Array parameter is set to True. No other platforms (including CalAmp RevC and CalAmp CDM-5030) exhibited this behavior.

MAP-14696: SSL Certificate Expired

Description: The self-signed SSL Certificate expired. Updating the certificate will not help because browsers are blocking all self-signed certificates. The user should provide their own valid certificate through properties when using deviceWISE HTTP server or else the browser may not allow HTTPS requests. The following properties described in Properties file management are available to configure the certificate used by the HTTP Server. For adding properties:

  1. To change cert file, add/modify http.ssl.cert_file to point to a cert in PEM format relative to $INSTALL_PATH#/dwcore directory. By default, deviceWISE ships with a dummy certificate. http.ssl.cert_file=cert/server.pem
  2. The cert file can have a passphrase to it. The user can add the property "http.ssl.cert_pass" to specify the passphrase. http.ssl.cert_pass=PLAINTEXT

MAP-14751: Node failed to install SUP due to file_chmod failure

Description:  chmod failed because we used it on a command instead of just the executable.

Hot-Edit of Started Triggers

MAP-11421:  deviceWISE crashed when Editing and Saving a Started trigger

Description:  Intermittent issue where deviceWISE crashed when attempting to Edit and Save a Started and Loaded trigger

Asset Gateway for CalAmp

MAP-5369:  OS Shutdown action does not work on a CalAmp RevC or RevG

Description: The OS Shutdown action does nothing when executed on a CalAmp RevC or RevG. This feature has not been implemented in the Asset Gateway for CalAmp.

Asset Gateway for MultiTech

MAP-4860:  Local time zone for Brussels is 2-hours off

Description: Setting the local time for Brussels, Belgium is two hours off in the Asset Gateway for MultiTech.

Workaround: Select the local time option for Paris, France in the Asset Gateway for MultiTech.

Asset Gateway for Option CloudGate

MAP-8230:  Option V2 CDMA: Message corruption on Send SMS

Description:  For Option CloudGate CDMA-equipped models, cellular Actions and Events related to SMS send and receive are not supported.

MAP-8231:  Option V2 CDMA: Sending a large SMS message fails on with internal CloudGate api error

Description:  For CloudGate Option CDMA-equipped models, cellular Actions and Events related to SMS send and receive are not supported.  Sending a large SMS > 160 characters fails with a CloudGate API error on an option V2 CDMA node.

MAP-10092:  No TR50 S&F disk storage type support for Option CloudGate V1

Description:  TR50 S&F support is present, but the S&F disk storage type is not available.

Asset Gateway for USRobotics

MAP-10662:  No TR50 S&F disk storage type support for USRobotics

Description:  TR50 S&F support is present, but the S&F disk storage type is not available.

Device types

MAP-9212: Be aware of endianness when importing or exporting Global Variables device and data values

Description: When exporting a Global Variables device with its data values from one node and then importing the Global Variables device and the data values into another node, the endianness of the nodes must be taken into consideration. For example: exporting from a big endian node (Power PC) and then importing into a little endian node (X86). The numeric data values will not be correctly represented in the imported node.

After the import, the Global Variables device should be edited, and the data values reviewed and modified.

Enterprise Gateway for Siemens ERPC

MAP-1933: On a Enterprise Gateway for Siemens ERPC, a controlled Listener fails to connect to queue manager on first attempt

Description: When accessing a WebSphere MQ server via a transport or a listener, the very first connect request after boot fails due to a limitation in the firmware. Subsequent connect requests work correctly.

Workaround: Repeat the connect request.

MAP-3634: FTP action with Transfer Mode set to Active fails on Enterprise Gateway for Siemens ERPC

Description: When using a trigger FTP action, the Put and Get operations do not work when Transfer Mode set to Active on ERPC.

Workaround: Set the Transfer Mode parameter to Passive instead of Active until the problem is fixed in a future release.

MAP-5707: FTP client does not connect to server in passive mode on ERPC

Description: The deviceWISE FTP Server in the Enterprise Gateway for Siemens ERPC cannot support a FTP client in passive mode.

Workaround: Use the FTP active mode instead.

MAP-6793:  A TR50 connection with SSL will fail on ERPC

Description:  TR-50 is not supported on the ERPC platform.

MAP-9820:  VxWorks-based Enterprise gateway platforms lose SQLServer Connectivity after Windows updates

Description:  Windows updates add new items to the Windows cipher suite and change the default order of items within the cipher suite.  This prevents a successful connection with SQL server. 

Workaround:  Move this cipher suite “TLS_RSA_WITH_AES_256_CBC_SHA (53)”, to the top of the list of cipher suites.  See the More Information section on this Microsoft page for instructions to configure the SSL Cipher Suite Order Group Policy setting :  https://support.microsoft.com/en-us/kb/3161639.  Using this method retains the order of the cipher suites across subsequent Windows updates.

MAP-11664:  VxWorks-based Enterprise gateway platforms cannot process empty ResultSets from an Oracle Stored procedure 

Description: If you execute an Oracle database stored procedure transport map that returns result sets in output parameters the transaction action will fail if the result set output parameter is null.

MAP-11665:  VxWorks-based Enterprise gateway platforms cannot process empty ResultSets from a SQLServer Stored procedure 

Description: If you execute an SQLServer database stored procedure transport map that returns result sets the transaction action will fail if the result set is empty.

Enterprise Gateway for WinCPU

MAP-17091: WinCPU does not support latest version of OpenSSL library

Description: WinCPU is not supported on releases after 21.06. The platform uses an older Microsoft Embedded Windows operating system that is incompatible with newer versions of the OpenSSL library.

Asset and Enterprise Gateway for Linux

MAP-17041: LDAP driver crashes when using Linux X86 products

Description: The LDAP package was removed from all Linux X86 products in 21.10.

Enterprise Gateway for Windows

MAP-3455: The Enterprise Gateway for Windows Restart feature from the Node Administration tab does not work as designed

Description: The Restart feature available from Workbench -> Administration -> Node Administration tab may not cleanly stop and then restart the runtime. When there are many active transports and listeners, the Transaction Server does not restart properly.

Workaround: Follow the instructions in the section "Manually restarting a node" on Restarting a Node.

MAP-15124: Can't install older version of Gateway software on Windows

Description: Windows customers attempting to install an older version of deviceWISE products need to uninstall the newer version of deviceWISE first.

MAP-16801: Firmware Update fails intermittently on Windows Platforms

Description: For 21.08, Firmware updates of Windows products may have intermittent failures so the “dwu” files were removed from the 21.08 release.

MAP-17328: dwmqtt not supported in Windows-32bit. Couldn`t build paho lib

Description: The MQTT driver was withdrawn from the Windows-32bit platform because of an issue in compiling the paho library. Therefore, the dwmqtt driver is not supported in Windows-32bit platform.

Local Database (Local DB) 

MAP-4732: The Local DB Import action with the "First Row is Header" parameter set to true fails.

Description: Importing a csv file with a header row into a Local DB table will cause a failure.

Workaround: Set the "First Row is Header" parameter to false, import it, and then remove the first row.

MAP-5404: Problem reading database entries when a comma/line-feed combination is the last item in a list of database entries

Description: If a comma/line-feed combination is the last item in a list of database entries, then a problem occurs

Workaround: Add a dummy column in the database to represent the blank after the comma. For example, if you have 15 data entries and the last entry has a comma, then add a 16th column to your database.

Modem

MAP-3167: Simultaneous Cellular connect/disconnect and Modem power on/off can cause reboot of Asset Gateway

Description: We found a scenario where the Asset Gateway will reboot when simultaneous control actions are executed. When the Set Modem Power Level action and the Control Cellular Connection action (or Workbench operation) is executed repeatedly and simultaneously, a crash can occur resulting in a reboot.

We have not seen this problem during normal operation where the use of the Set Modem Power Level action cycling of power between "Online" and "Low Power" rarely occurs.

Transaction Server

MAP-685: Transports do not recover properly from Store and Forward

Description: When using the WMQ transport and the transport reports the error MQJMS007, it might cause the transport to switch in and out of Store and Forward, even though the transactions are successfully delivered to the WMQ queue.

Workaround: Check the WMQ queue manager. If the listener shows the state other than Started, then it is likely that you have encountered this issue. Set the listener to Started to restore proper functionality.

MAP-2972: Enterprise Gateway for Siemens ERPC faults with Transaction Server not being able to connect after a package remove

Description: After an Add or Remove of a package, such as a device driver, the node might have a fault where the Transaction Server cannot connect.

Workaround: You will need to restart deviceWISE. Follow the instructions for Manually restarting a deviceWISE node on Packages.

MAP-3930: IFS: sometimes the Transaction Server fails to start

Description: When setting transports, especially an iTAC transport, with "Load transport at initialization" parameter checked, and using a memory optimized Transaction Server that is not a match for the transports with "Load transport at initialization", it is possible that the Transaction Server will fail to start on Mitsubishi MESInterface IT nodes. Rebooting the module with the "Standard" Enterprise Access option will allow the Transaction Server to come up successfully, the transports can then be modified to remove the "Load transport at initialization" parameter. The memory optimized Transaction Server can then be re-set to the desired one.

MAP-4002: Updating logical variables in a transport map and not editing the corresponding trigger can lead to undesirable consequences.

Description: In this scenario the trigger will be disabled when it fires, and the action will return an error code of -6409 (invalid variable type) in the Exceptions log. Because the trigger will not be recovered on its own, the user will have to edit and re-save the trigger manually.

MAP-4796: NVARCHAR Support Limitation

Description: The NVARCHAR and NCHAR datatypes for Oracle are not supported on the following platforms:

  • Mitsubishi MESInterface-IT
  • deviceWISE Enterprise Gateway for Siemens ERPC

MAP-5170: JSON payload transport maps for the HTTP transport are not supported on all platforms

Description: This feature is not supported on the following platforms:

  • Mitsubishi MESInterface-IT
  • deviceWISE Enterprise Gateway for Siemens ERPC

MAP-5684: JMS Netweaver Transport/Listener on an Enterprise Gateway for Siemens ERPC cannot initialize connection with the JMS Netweaver server

Description: This feature is not supported on the following platforms:

  • Mitsubishi MESInterface-IT
  • deviceWISE Enterprise Gateway for Siemens ERPC

MAP-5685: JMS Netweaver support jars are not packaged with the ERPC or MESInterface IT product install files

Description: This feature is not supported on the following platforms:

  • Mitsubishi MESInterface-IT
  • deviceWISE Enterprise Gateway for Siemens ERPC

MAP-6604:  HANA database insert fails ERPC

Description: The NVARCHAR and NCHAR datatypes are not supported on the deviceWISE Enterprise Gateway for Siemens ERPC product.

MAP-7388:  New Oracle JDBC driver transport maps cannot enumerate schemas/table definitions on an Oracle 9 server 

Description:  Beginning with the deviceWISE 15.1 release, the deviceWISE Enterprise Gateway products for Linux, Windows and AIX use a later version of the Oracle JDBC driver that only supports Oracle 12.1, 11.2, 11.1.

 Oracle 9.2 end-of-life is July 2010. 

The MESInterface-IT and deviceWISE Enterprise Gateway for Siemens ERPC products are able to enumerate schemas from Oracle 9.2 because the JDBC driver has not been updated.

MAP-9082:  Null Macro test: Select fails when a default timestamp of format 01/11/12 12:45:00.000 is used in place of a NULL value returned

Description:  If you need to specify a default value for SQLServer datatypes for DATE and TIME when using the following enterprise gateway products: 

  • Mitsubishi MESInterface-IT
  • Enterprise Gateway for Siemens ERPC

then you will need to use a long value that represents milliseconds since 1/1/1970 instead of the default format 'mm/dd/yy HH:MM:SS.sss',

MAP-11311:  AIX java8: SSL Error when attempting to connect to SQL Server 2008 and below

Description:  The database transport on deviceWISE Enterprise Gateway for AIX and AIX64 cannot complete a connection to SQLServer 2008 running on Windows XP due to incompatibility with SSL. The workaround is to access the SQLServer database on a newer operating system.  

MAP-12324:  VxWorks platforms: Failure to connect to Oracle 12c server with SQLException: No matching authentication protocol

Description:  VxWorks-based platforms with Oracle database transport fails to connect to the Oracle 12c server with the following error:   "java.sql.SQLException: ORA-28040: No matching authentication protocol "
The issue is caused because Oracle 12c is configured to use a default minimum authentication protocol of 11 and the VxWorks-based gateway product uses an older unsupported JDBC driver tied to JDK 1.5. This is equivalent to an Oracle 8 client and consequently uses an Oracle 8 authentication protocol.

Workaround:

  • Configure the sqlnet.ora file with the following parameters to allow a version 8 authentication protocol.
    • SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
    • SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8
    • SEC_CASE_SENSITIVE_LOGON=FALSE
  • Restart the server for these changes to take effect.
  • If you are planning on using an existing login id from the VxWorks runtime you will need to use PL/SQL and alter the password of the user to force the server to rehash passwords with compatible versions.
    • A recommended approach would be to create a new login id and specify those credentials on the Oracle 12c Transport on the VxWorks runtime.

Reference links:

MAP-12885:  MySQL Connector/J 8 version of the JDBC driver is incompatible with the Enterprise Gateway DB transport

Description:  The mySQL Connector/J v8 JDBC driver has changed the package name of the class that implements the driver. Use the mySQL Connector v5.x JDBC driver instead to enable mySQL support in the enterprise gateway.

Transaction Server XSD support

MAP-3141:  XSD: Xpath expression should not be saved in the XML if Specify Map and Sequence Keys in header check box is selected

Description:  This issue only affects JMS listeners with the XSD payload. When there is both an XPath expression and a JMS header property specified on the JMS listener XSD Payload panel, and the header property is missing from the incoming JMS message, the XPath expression is used to determine the listener map id, instead of the default listener map id.

MAP-3695:  XSD: Default or fixed value provided in the XSD will be erroneously used

Description:  If the XSD used to create a listener map contains a required attribute with a default or fixed value, it is considered valid. At runtime, instead of the XML being rejected as invalid, the default or fixed value provided in the XSD will be erroneously used.

MAP-4665:  XSD: Imported transport map and listener map definitions from an older runtime into a newer runtime are not namespace aware unless XSD is re-queried

Description:  If you are importing a transport map or listener map that was defined with XSDs and was created in a 12.4 or prior release, then the map needs to queried again and saved in order for 'nil' element processing to be handled correctly.

MAP-4666: Listener doesn't support XSDs with namespaces

Description:  A Listener configured to process XSD based payloads will not be able to successfully handle an XML with namespace qualified elements.

Workaround:  The workaround is to provide an XML request without namespaces.

Transaction Server Web Services SOAP

MAP-5181:  SOAP Header Parameter limited support

Description:  SOAP Header Parameter support is not available on the Enterprise Gateway for Siemens ERPC and Mitsubishi MESInterface-IT products.

TR-50

MAP-7007:  TR50: Deadlock  

Description:  Gateway may experience a rarely occurring deadlock condition after several days or weeks of operation.  If this occurs, a watchdog will expire and reset the gateway to resume operations.

MAP-8236:  Wait action is not being rescheduled after a time_sync. 

Description:  There is known issue relating to WAIT action completing immediately when the timesync is enabled on a TR50 connection that has a drift of 2 seconds or greater. This implied that the trigger's sequence of events that are time sensitive may execute quicker than expected when the OS system time is adjusted to sync with the IoT Portal platforms' time. 

MAP-10092:  Option CloudGate V1 failed when running TR50 S&F disk storage type tests with error storage->create_storage failed [-33533]

Description:  TR50 Store and Forward disk storage type is not supported on Option CloudGate V1 gateways.

deviceWISE View – Technology Preview

MAP-16403: deviceWISE View Toggle breaks states using the BOOL variable being toggled

Description: Local variables are all string type. For Boolean comparisons use the value "1" or "0" instead of "true" or "false".

MAP-16890: deviceWISE View sometimes get stuck on Loading splash screen on first login

Description: The Loading splash screen may sometimes get stuck and will need an additional page refresh to properly update the page.

Drivers

MAP-3140:  Siemens S7 listener gets stuck in stopping state on Enterprise Gateway for Siemens ERPC

Description:  After the Siemens S7 listener device receives data and a corresponding trigger is executed, stopping the Siemens S7 listener device results in the listener becoming stuck in the Stopping state. This happens during operations when the Siemens S7 listener device is using the normal TCP mode (not ISO-n-TCP). After a trigger executes the receipt of an unsolicited message, the S7 listener device cannot be stopped.

A firmware upgrade from Siemens is anticipated in order to resolve this behavior.

MAP-5066:  CloudLINK package remove isn't removing the feature  and  MAP-5158 Package remove failed - OS error

Description:  On some platforms with limited operating system resources for memory or disk (persistence storage), there may be failure when attempting to add or remove packages. These failures are the result of the limited system resources and possible runtime behavior such as memory fragmentation. When these failures occur, restarting the node at the operating system level (power off then power on) may then allow the package add or remove to succeed. In other scenarios, you may have reached a platform limit based on the application definitions, the number and size of packages added and other dynamic runtime requirements.

MAP-6082:  Writing an empty string for Siemens STRINGs of length 207 or more does not clear bytes as expected

Description:  If an empty string is written to a Siemens PLC, all the bytes of the string are set to 0x00 and the actual length byte is set to 0. This behavior changes when the maximum length of the string is 207 to 254 bytes. In this case the actual string length byte is set to 0, but the string bytes are not cleared. Not clearing the bytes is done to reduce the network traffic between the driver and the PLCs. Strings that are greater than 206 bytes requires the driver to send multiple messages to the server. The key to writing an empty string is setting the actual length byte to 0, so the string will have a NULL value.

MAP-6811:  Siemens LOGO PLC device disables periodically

Description:  Lab tests have demonstrated that the Siemens LOGO PLC will not maintain simultaneous socket connections from multiple nodes. The LOGO PLC will terminate connections, which results in the associated device becoming disabled. The disabled device will re-establish a socket connection to the LOGO, only to have that connection eventually reset by the LOGO. It is recommended that connections to the LOGO PLC be limited to one node at a time. 

MAP-6938:  Rockwell CIP Event will not work when Size of One Element is set to 0 and STRINGs have more than 444 characters

Description:  The Rockwell CIP Event allows the Size of One Element field to be set to 0 and any messages using STRINGs of 444 characters or less to be received. However, any STRING with greater than 444 characters will result in an error. The workaround is to make sure you indicate the size of the String being read in the Size of One Element field.

MAP-7694: Subscription on device that becomes stopped generates read errors

Description:  When subscribing to a started device that is later stopped, the subscription still attempts to read from that device and generates errors.

Workaround:  Workbench can workaround this by stopping subs on stopped devices and restarting again on start, but keeping the subs live when the device is stopped results in fewer commands being sent.

MAP-9303:  OPC UA Client driver increases core handles and memory usage during StartStopStress test (Linux)

Description:  Attempting to start and stop many OPC UA clients on Linux causes the node to crash.

Workaround:  Limit the number of OPC UA devices per deviceWISE node to five.

MAP-9176:  OPC UA Client driver increases core handles and memory usage during StartStopStress test (Windows)

Description:  Attempting to start and stop many OPC UA clients will result in leaked memory. For reference, starting and stopping 15 clients constantly for 3 hours results in ~15MB lost. Restarting a node will clear this leaked memory.

MAP-10145:  OPC-DA Client cannot write UINT4 value 2147483648 and greater

Description:  The largest unsigned integer value that the OPC-DA Client can write is 2147483647.

MAP-12201:  Atlas Copco Trace Data trigger fires even though a tightening wasn’t performed.

Description:  Testing in the lab has found instances where a Trace Data (MID0900) message is being sent by the Atlas Controller to deviceWISE, even though a rundown hasn’t occurred. This causes a started Atlas Copco Trace Data trigger to fire, if it is associated with that controller. The Trigger’s Result Data Identifier Event variable can be used to determine if this is a duplicate Trace Data message.

MAP-12442: OPC UA Client driver does not run on NetComm, CalAmp LMU5000 RevC, and Lanner

Description:  The OPC-UA Client driver is not supported on all platforms. Refer to the OPC-UA Client driver documentation at Supported OPC-UA Client environments.

MAP-12780:  Rockwell MicroLogix 1100 and 1400 devices get stuck in Stopping state on Siemens ERPC

Description: After several variable reads and writes, stopping the device might result in the device being stuck in the Stopping state, then resetting after about 10 minutes.

MAP-13702: OPC UA Client Certificate Security does not work on VxWorks-based platforms.

Description: OPC UA Client Certificate Security feature is not enabled for VxWorks-based platforms.

MAP-13859: FANUC CNC Driver Macros floating point value write -12.3456 results in -12.3455999

Description: There is a limitation when representing floating point numbers because of Int4 precision. The max Int4 value is 2147483647, and this limits precision.

MAP-13860: FANUC CNC Driver random write failures to Macros at 500 and 98000 range on NCGuide device

Description: This is an intermittent problem with the NCGuide simulator software.

MAP-14146: FANUC CNC driver reading and writing wrong Tool Offset type

Description: We found that the Tool offset type would not write to the correct offset depending on the range provided. We removed the Tool Offset feature in 19.1.7 and plan to correct the implementation in a future release.

MAP-15099: Linux 64-bit FANUC CNC Driver does not work on CentOS 7

Description: The only Linux 64-bit environment supported by the Fanuc CNC driver is Ubuntu Server.

MAP-14436: OPC UA client and OPC UA Server do not coexist on the same node

We do not support running the deviceWISE OPC UA Server on the same node as the deviceWISE OPC UA Client.

MAP-14610: OPC UA Server retains old stopped devices when browsed by clients

Description: When devices used by the OPC UA Server are stopped, those devices are no longer exposed to clients. In some rare instances, variables from those devices are still exposed but they cannot be accessed since the device is stopped. Restarting the server will clear those device variables.

MAP-15573: MQTT extension doesn't build for AIX64 in 20.1.10 release

Description: The MQTT package for AIX does not include the MQTT updates found in other platforms for the 20.1.10 release. Enterprise GW for AIX64 in 20.1.10 uses the MQTT package from 20.1.9.

MAP-15628: OPC DA Server on Windows 64-bit crashes on start of server

Description: The OPC DA Server and the OPC DA Client are not supported on the Windows 64-bit platform. We will investigate how to add support for these drivers in a future release.

MAP-15585: MQTT extension doesn't load for WinCPU in 20.1.10 release

Description: The MQTT package for WinCPU does not include the MQTT updates found in other platforms for the 20.1.10 release. Enterprise GW for WinCPU in 20.1.10 uses the MQTT package from 20.1.9.

MAP-15838: SNMP Trap Receiver causes Linux nodes to crash

Description: The SNMP Trap Receiver will not work on Linux platforms. Receiving trap messages will only work on Windows 64-bit and Windows 32-bit products.

MAP-15862: SNMP Driver does not fail a write and misleadingly shows write is completed

Description: When writing SNMP variables, sometimes the write will timeout but will not show an error message. Check the value with a read after the write to ensure the write has actually occurred if the write seems to take more than 5 seconds.

MAP-17080: OPC UA Client XML files do not support double byte characters

Description: These characters can be interpreted as having a null character, which causes the XML document to be prematurely terminated.

MAP-16857: OPC UA Client with Startup Improvements cannot handle Unified Automation matrix array

Description: Multi-dimension arrays, also known as Matrix data items, are not supported with the 4.0.0 release of the OPC UA Client. These tags will be displayed, but attempts to read or write elements within the Matrix will fail.

MAP-17547: uninstall OPC-DA server package causes OPC-DA client to Error due to a deleted TBCVS2015x64.dll

Description: When both the OPC DA Client (dwopc_da) and OPC DA Server (dwopc_da_server) packages are installed on the same Node, removing either will require a reinstall of the installed package. Telit does not support the usage of these two packages on the same node.

MAP-17931: IFM-IO Link -- crashes w two identical sensors in the same ALR Master

Description: The initial release will crash if there are two identical sensor names in the same ALR Master. Telit plans to release an update in the next release.

Backup before upgrading!  You should do a Backing up and Restoring a node's configuration of your configuration from the Workbench prior to upgrading to a new version of deviceWISE.

Updating from an earlier release level of an Enterprise Gateway to 22.03

Customers updating from 21.05 or earlier release, will need to update both the deviceWISE runtime and the package files to the 22.03 build level before starting their deviceWISE application.

For Windows Enterprise Gateway products:

Upgrading a Windows Enterprise Gateway product from a version before 19.1.6 to 22.03

We moved to a new installation architecture for Windows Asset Gateway and Enterprise Gateway products with version 19.1.6. These Special Notes apply to a one-time transition from a Windows Gateway version before 19.1.6 to a Windows Gateway version after 19.1.6.

If you are upgrading a Gateway for Windows product to version 19.1.6 or later, you must do the following:

  1. Perform a node backup of deviceWISE
  2. Backup all files used in the Staging Browser folders or properties files that were added outside of the original deviceWISE installation. (For example: C:\deviceWISE\Runtime\staging and C:\deviceWISE\Runtime\dwcore)
  3. Uninstall the (pre-19.1.6) version of the Enterprise Gateway for Windows product
  4. Install deviceWISE Enterprise Gateway for Windows or deviceWISE Asset Gateway for Windows using the given installers.
  5. Copy the files backed up from step #2 contained in the Staging Browser folders or properties files to the new installation folder. (For example: C:\Program Files (x86)\deviceWISE\Gateway\staging and C:\Program Files (x86)\deviceWISE\Gateway\dwcore)
  6. Restart deviceWISE.
  7. After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.
  8. Restore your node.
Upgrading a Windows Enterprise Gateway product from 19.1.6 or later to 22.03

A firmware update from a release for Enterprise Gateway for Windows before version 19.1.6 to 22.03 is not supported. You must do a complete product installation as noted in the previous section.

If you are updating an Enterprise Gateway for Windows 64-bit products from the 19.1.6 release or later, then you can use the firmware update option.

After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.

After updating the runtime and the package files, you may restore your node from a backup if you did a node backup before installing the new version of runtime and packages.

For AIX, Linux, or WinCPU Enterprise Gateway products:

If you are updating an Enterprise Gateway from a 17.2.3 through 22.03 (inclusive) release, then you can use the firmware update option. A firmware update from a release before 17.2.3 is not supported.

If you are updating an Enterprise Gateway from a 17.1.14 or earlier release to 22.03, you must do a complete product installation. This is required to install the supporting libraries and 3rd party support files. These supporting files are not included in a firmware update for an Enterprise Gateway, however they are included in a complete install.

After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.

After updating the runtime and the package files, you may restore your node from a backup if you did a node backup before installing the new version of runtime and packages.

A firmware update from 16.1.8 or earlier to 22.03 is not supported for CentOS 7 or  systemd installations.  A full installation is required.

20.1.9 is the final release for VxWorks-based gateways and got removed from builds beginning with the 20.1.10 release. If you need assistance, please contact us here.

Updating from an earlier release of an Asset Gateway to 22.03

Customers updating from 21.05 or earlier release, will need to update both the deviceWISE runtime and the package files to the 22.03 build level before starting their deviceWISE application.

For Windows Asset Gateway products:

Upgrading a Windows Asset Gateway product from a version before 19.1.6 to 22.03

We moved to a new installation architecture for Windows Asset Gateway and Asset Gateway products with version 19.1.6. These Special Notes apply to a one-time transition from a Windows Gateway version before 19.1.6 to a Windows Gateway version after 19.1.6.

If you are upgrading a Gateway for Windows product to version 19.1.6 or later, you must do the following:

  1. Perform a node backup of deviceWISE
  2. Backup all files used in the Staging Browser folders or properties files that were added outside of the original deviceWISE installation. (For example: C:\deviceWISE\Runtime\staging and C:\deviceWISE\Runtime\dwcore)
  3. Uninstall the (pre-19.1.6) version of the Asset Gateway for Windows product
  4. Install deviceWISE Enterprise Gateway for Windows or deviceWISE Asset Gateway for Windows using the given installers.
  5. After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.
  6. Copy the files backed up from step #2 contained in the Staging Browser folders or properties files to the new installation folder. (For example: C:\Program Files (x86)\deviceWISE\Gateway\staging and C:\Program Files (x86)\deviceWISE\Gateway\dwcore)
  7. Restore your node.
Upgrading a Windows Asset Gateway product from 19.1.6 or later to 22.03

A firmware update from a release for Asset Gateway for Windows before version 19.1.6 is not supported. You must do a complete product installation as noted in the previous section.

If you are updating an Asset Gateway for Windows 64-bit products from the 19.1.6 release or later, then you can use the firmware update option.

After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.

After updating the runtime and the package files, you may restore your node from a backup if you did a node backup before installing the new version of runtime and packages.

For AIX, Linux, or WinCPU Asset Gateway products:

If you are updating an Asset Gateway from a 17.2.3 through 22.02 (inclusive) release, then you can use the firmware update option. A firmware update from a release before 17.2.3 is not supported.

If you are updating an Asset Gateway from a 17.1.14 or earlier release to 22.03, you must do a complete product installation. This is required to install the supporting libraries and 3rd party support files. These supporting files are not included in a firmware update for an Asset Gateway, however they are included in a complete install.

After updating to 22.03, you will need to add all device drivers and extensions from the new 22.03 release level.

A firmware update from 16.1.8 or earlier to 22.03 is not supported for CentOS 7 or systemd installations.  A full installation is required.

For more information about upgrading your software, see Updating products.

20.1.9 is the final release for VxWorks-based gateways and got removed from builds beginning with the 20.1.10 release. If you need assistance, please contact us here.