物联网网关 19.1.6 版本说明
物联网网关 19.1.6 版本新增内容
最新发布的版本是 19.1.6-002。
以下是对从 19.1.6 以下版本 Windows 安装程序到 19.1.6 及以上版本 Windows 安装程序进行一次性过渡的特殊说明。如果要将用于 Windows 产品的企业网关升级到 19.1.6 或以上版本，则必须执行以下操作：
- 执行 deviceWISE 的节点备份
- 备份暂存浏览器文件夹中使用的所有文件或原始 deviceWISE 安装之外添加的属性文件。（例如：C:\deviceWISE\Runtime\staging 和 C:\deviceWISE\Runtime\dwcore）
- 卸载用于 Windows 产品的企业网关的（19.1.6 之前）版本
- 使用提供的安装程序安装用于 Windows 的 deviceWISE 企业网关或用于 Windows 的 deviceWISE 资产网关。
- 将暂存浏览器文件夹或属性文件中包含的从步骤 #2 备份的文件复制到新的安装文件夹中。（例如：C:\Program Files (x86)\deviceWISE\Gateway\staging 和 C:\Program Files (x86)\deviceWISE\Gateway\dwcore）
- 重启 deviceWISE
- 还原节点。
- 更新到 19.1.6 后，您需要从新的 19.1.6 版本添加所有设备驱动程序和扩展。
升级用于 WinCPU 产品的企业网关的客户应安装 19.1.4 或等待后续版本。
新增功能和现有功能增强
客户文档提醒
- 2018 年 12 月 1 日之后的客户文档更新托管在 https://docs.devicewise.com 上
- 原客户文档网站 https://help.devicewise.com 现在指向新客户文档网站的主页。
用于 Linux 64 位 Snap 的资产网关
- 在 19.1.6 中发布了新平台。
用于 Windows 的资产/企业网关
- 安装程序架构已升级为使用 WiX 技术
- 符合最新的 Windows 安装程序安全要求
deviceWISE 运行时
- 全局设备会使用订阅，而不是轮询
- 更新全局发布服务器以清理并提高性能
- 系统变量和日志记录更新
- 限制队列上的最大发布总数
- 删除多重订阅上的常规超时并将其更改为不活动超时
- 修复次要错误
文档
- 驱动程序软件包已更新为指向 https://docs.devicewise.com 帮助链接
- 物联网网关用户指南中的编辑修复
- 已将项目与触发器下的主题更新。
HTTP API
- 添加订阅参数，只发送带有数据的设备名称和变量名称
- 订阅期间，允许选项发送/发布初始数据
- OPTIONS 响应中允许多源访问控制
- 增加多重登录支持和单一登录多重显示
- 增加多重订阅请求，不在数组中包括类型，而是作为指定数组
- 删除多重订阅上的订阅 ID
- 多重订阅 - 出现错误时如有可能则返回特定变量和通道。
事务服务器
- 通过配置导入动作增加对 TE 项目导入的支持
驱动程序
请导航至 Management Portal（管理门户）-> Developer（开发者）页面 -> Resources（资源）项目，以识别此版本在特定平台上支持的驱动程序和驱动程序版本。新安装和更新均应包含此版本的驱动程序。
- Mindsphere - 为每个活动触发器动作添加通信句柄以提高吞吐量。修复缺陷。
- Modbus - XML 描述文件现在支持 data_conversion 静态属性的“wordswap”值。
- MQTT - 确认收到的消息时，未遵循 MsgID 静态属性。
- OPC UA Client - 修复缺陷，请参阅下文。
- Rockwell - 为主动提供的匹配增加其他诊断条目。增加对在目标地址中使用远程路径的主动提供的消息的支持。进行纠正以改进错误捕获。
物联网网关 19.1.6 版本中修复的问题
此版本已修复以下缺陷。
版本
MAP-13826：新的工作台安装程序不应在产品名称中包含版本
描述：已在 19.1.5 中修复
MAP-13916：由于无初始化脚本 LSB 标头，因此无法在计算模块上安装 NTP 软件包
描述：已在 19.1.5 中修复
MAP-13884：在 MultiTech rCell 上启动 deviceWISE 时，未应用防火墙规则
描述：已在 19.1.5 中修复
deviceWISE 运行时
MAP-13913：ERR_VAR_COUNT_OVERFLOW 和 ERR_VAR_BITOFS_MISSING 从内核传递到驱动程序函数
描述：已在 19.1.5 中修复
MAP-13901：导入事务引擎项目时配置导入动作失败，出现授权错误
描述：已在 19.1.5 中修复
MAP-13900：内核 - DW_VARIABLE_DATA 针对偏移量 -1 报告错误的 var->offset
描述：已在 19.1.5 中修复
MAP-14013：HTTP 服务器无法响应（套接字问题）
描述：已在 19.1.6 中修复
MAP-13990：非常活跃的节点冻结并使用互斥锁重启
描述：已在 19.1.6 中修复
MAP-13988：变量块写入崩溃
描述：已在 19.1.6 中修复
MAP-13987：从数组偏移量读取变量崩溃
描述：已在 19.1.6 中修复
MAP-13986：通用管理面板上的读取无效
描述：已在 19.1.6 中修复
MAP-13963：event.c dw_event_complete 缺失 indirect_unget
描述：已在 19.1.6 中修复
MAP-13933：企业网关 - 使用 LDAP 身份验证的安全漏洞
描述：已在 19.1.6 中修复
MAP-14028：无效读取导致崩溃
描述：已在 19.1.6 中修复
驱动程序、代理和软件包
MAP-13521：Modbus 驱动程序 - 增加对“wordswap”XML 静态属性的支持
描述：已在 19.1.5 中修复。Modbus XML data_conversion 静态属性支持“wordswap”值。这一支持针对 FLOAT4、INT4 和 UINT4 变量。
MAP-12950：使用监视窗口时，OPC UA Client 可能在变量面板中显示错误值
描述： 已在 19.1.5 中修复
MAP-12463：OPC UA Client 无法读取数组中的某些字符串
描述： 已在 19.1.5 中修复
MAP-12457：带结构的 OPC UA Client 允许读取超过最大数组大小的 1 个计数
描述： 已在 19.1.5 中修复
MAP-13903：读取计数超过 16 个 Rockwell ControlLogix TCP STRING10 数组时，节点崩溃
描述： 已在 19.1.5 中修复。此状况占满 256 字节的缓冲区，读取额外字符串导致缓冲区溢出。
MAP-13893：-6237：设备协议错误。Ext.写入一个长度为 10、数组为 300 的字符串标签时，出现 Ext. Status 5。
描述： 已在 19.1.5 中修复。修复了为多个小字符串管理缓冲区的问题，以纠正将错误数据包发送到控制器时导致的协议错误。
MAP-13934：Rockwell：并非所有数据都能进入 ControlLogix 设备
描述： 已在 19.1.6 中修复。已将包含混合数据类型的大型写入请求格式化为多重写入消息。有时，创建的数据包超出 EIP 最大允许大小。
MAP-13891：由于可能的 Rockwell 互斥死锁，deviceWISE 重启
描述： 已在 19.1.6 中修复。已将更多错误捕获添加到驱动程序，以便在请求发送到 PLC 之前将其拒绝。其中某些情况可能会导致驱动程序挂起，等待不存在的数据包到达
MAP-13891：由于可能的 Rockwell 互斥死锁，deviceWISE 重启
描述： 已在 19.1.6 中修复。已将更多错误捕获添加到驱动程序，以便在请求发送到 PLC 之前将其拒绝。其中某些情况可能会导致驱动程序挂起，等待不存在的数据包到达
MAP-13960：MQTT 向所有消息回复 MsgID = 1
描述： 已在 19.1.6 中修复。已发送 MsgID 值为 1 的确认答复。已修复驱动程序，现在确认会使用所收到消息中的 MsgID 值。
事务服务器
MAP-13902：需要事务引擎更新来支持通过配置导入动作导入 TE 项目
描述： 已在 19.1.5 中修复
MAP-13905：如果使用 Linux 环境，则不会报告映射日志实时事务
描述： 已在 19.1.6 中修复
工作台
MAP-13914：工作台部分更新因新的安装程序位置而失败
描述： 已在 19.1.5 中修复
MAP-13904：未生成工作台日志文件
描述： 已在 19.1.5 中修复
支持的驱动程序版本
可在设备驱动程序列表中找到有关驱动程序的更多信息。
此版本完全支持以下驱动程序，视为“普遍可用”。
| 驱动程序名称 | 版本号 |
|---|---|
| Atlas Copco | 3.4.4 |
| Beckhoff | 2.1.4 |
| Apex Cleco | 1.6.3 |
| Danlaw | 2.12.2 |
| GE Fanuc | 2.3.1 |
| NMEA GPS | 1.0.2 |
| LDAP - 19.1.6 中更新 | 1.1.1 |
| Lua | 1.1.2 |
| Mitsubishi Electric | 3.3.0 |
| MindSphere - 19.1.6 中更新 | 2.0.0 |
| Modbus Client - 19.1.5 中更新 | 2.8.4 |
| Modbus Server | 1.1.5 |
| MQTT Client | 1.3.0 |
| MTConnect | 1.2.6 |
| OAuth2 | 2.2.0 |
| Omron | 3.6.7 |
| OPC DA Client | 2.6.0 |
| OPC DA Server | 1.1.5 |
| Allen-Bradley（罗克韦尔自动化）- 19.1.6 中更新 | 2.17.4 |
| Siemens | 2.10.3 |
| Sysmon | 1.0.0 |
| TR50 - 19.1.5 中更新 | 2.0.4 |
以下驱动程序的状态为“试用”。
| 驱动程序名称 | 版本号 |
|---|---|
| FANUC CNC | 1.2.1 |
| OPC-UA Client - 19.1.5 中更新 | 2.4.2 |
| Pointer | 1.12.0 |
| Emerson Rocplus | 2.0.2 |
| SNMP | 1.0.0 |
| Sturtevant Richmont | 1.7.3 |
| TCP | 2.2.0 |
以下驱动程序和软件包为“原型”级。
| 驱动程序名称 | 版本号 |
|---|---|
| 高级显示协议 | 1.0.1 |
| BACnet IP | 2.2.0 |
| Banner Engineering | 1.0.0 |
| Bosch Rexroth | 1.7.3 |
| CTI | 2.1.4 |
| Davis | 1.0.0 |
| Escort Memory Systems (EMS) | 1.0.0 |
| E-Sensors | 1.0.0 |
| Fuji | 1.0.0 |
| GrovePi（仅限 Raspbian 目录中） | 1.0.1 |
| Hawkeye (MicroScan Systems) | 1.0.0 |
| Hue | 1.0.0 |
| iCaddy | 1.0.0 |
| Lora (Semtech) | 1.0.0 |
| ScanTools OBD-II | 1.0.0 |
| Oramoc | 1.0.0 |
| Pepperl+Fuchs | 1.0.1 |
| Pike Aero | 1.0.0 |
| Sandbox | 1.0.0 |
| SICK CLV Scanner | 1.0.0 |
| Sigfox | 1.0.0 |
| SQElectronics | 1.0.0 |
| Symbol | 1.0.2 |
| Virtual | 1.3.0 |
| WebMI | 2.0.0 |
| WSAPI | 1.1.0 |
| Xirgo | 1.3.0 |
| Z-Wave | 1.0.0 |
支持的平台
deviceWISE 企业网关产品
- 软件产品
- AIX 32 位（版本 6.1 和版本 7.1）
- AIX 64 位（版本 6.1 和版本 7.1和版本 7.2）
- Linux 32 位（CentOS 5 和 CentOS 6）
- Linux 64 位（CentOS 6 和 CentOS 7）
- 无 CentOS 5 支持
- 完整版 - 针对安装在 64 位 CentOS 操作系统上的用于 32 位 Linux 的 deviceWISE 企业网关（需要 32 位 glibc，例如 CentOS 7 上的 glibc.i686）
- 完整版 - 针对用于 64 位 Linux 的 deviceWISE 企业网关
- Windows（Windows XP SP3、Windows 7、Windows 10 和 Windows Server 2008 R2、Windows Server 2012 R2、Windows Server 2016 64 位）
- 嵌入式产品
- Dell Edge 5000 - WindRiver Linux 7；Ubuntu 服务器
- Mitsubishi MES Interface IT
- Mitsubishi WinCPU
- Rockwell ControlLogix
- Siemens ERPC
deviceWISE 资产网关产品
- 软件产品
- Linux 32 位（CentOS 5 和 CentOS 6）
- Linux 64 位（CentOS 6 和 CentOS 7）
- 无 CentOS 5 支持
- 完整版 - 针对安装在 64 位 CentOS 操作系统上的用于 32 位 Linux 的 deviceWISE 资产网关（需要 32 位 glibc，例如 CentOS 7 上的 glibc.i686）
- 完整版 - 针对用于 64 位 Linux 的 deviceWISE 资产网关
- Linux 64 位 (Snap) 19.1.6 中新增
- Windows（Windows XP SP3、Windows 7 和 Windows 10）
- 嵌入式产品
- Advantech Uno*
- B+B SmartWorx Spectre V3
- CalAmp LMU-5000（Rev C 和 Rev G）
- CalAmp CDM-5030
- Cisco 829
- Cisco IE 4000
- Cypress CTM-200
- Dell Edge 5000 - WindRiver Linux 7
- GateTel EZMoto V2
- Mitsubishi CCPU
- MultiTech Conduit（包含串行、GPIO 和蜂窝模块）
- 用于 AT&T 的 MultiTech Conduit AEP**
- MultiTech OCG-D（H4、H5 和 EV2 型号）
- MultiTech rCell（型号 MTR-LAT1-B07）
- NetComm 无线路由器（NTC-6200、NTC-40、NTC-30WV、NWL-12、NWL-11）
- Option CloudGate（型号 CG0192 和 CG0112，配备 v1.x 或 v2.x 固件）
- RedLion（试用）
- Siemens（MicroBox、NanoBox）*
- Siemens IoT 2000（仅限有线）
- Siemens ERPC*
- Systech SysLINK SL-500
- USRobotics 3510
- Vantron VT-M2M-LV
- Xmodus XM1710E（试用）
有限发行**功能
* - 表示未针对此版本进行专门测试的受支持网关。所列资产网关中的大多数使用标准 Linux 或 Windows 负载，或者与某一经过测试的企业网关非常相似。
**- 有限发行功能可满足客户特定的功能和配置。这些功能可能并非在所有硬件和操作系统配置中可用。
物联网网关 19.1.6 版本中的已知问题
动作和事件
MAP-14071： 资产网关 Linux 节点固件更新至版本 19.1.6 受阻
适用于所有使用 Linux 操作系统的资产网关。企业网关未受影响。
描述： 任何使用 Linux 的资产网关节点固件更新到 19.1.6 均受阻。
变通方案：创建一个包含相应 19.1.6 Linux dwu 文件的软件更新包 (SUP *.sup) 文件。将该文件作为软件包添加到工作台软件包面板中以便进行固件更新。有关更多信息，请参见软件更新包和软件更新包处理。
MAP-7740： 日志消息动作未在日志消息中记录 $ 字符
描述： 日志消息动作未在异常日志消息中写入 $ 字符。 可以通过使用 2 个背靠背的 $ 字符来绕过此动作。
已启动触发器的热编辑
MAP-11421： 编辑和保存已启动触发器时，deviceWISE 崩溃
描述： 间歇性问题，尝试编辑和保存已启动且已加载的触发器时，deviceWISE 崩溃
用于 CalAmp 的资产网关
MAP-5369： 操作系统关闭动作在 CalAmp RevC 或 RevG 上不起作用
描述：在 CalAmp RevC 或 RevG 上执行时，操作系统关闭动作不执行任何操作。用于 CalAmp 的资产网关中尚未实现此功能。
用于 Linux X64 Snap 的资产网关
MAP-14050：Linux X64 Snap 暂存目录中缺失 /www/deviceWISE 文件夹
描述：由于用于 Linux X64 Snap 的资产网关的 19.1.6 版本中缺失此文件夹，因此 JavaScript API 不适用于发布的产品。如果需要此 JavaScript API，请与泰利特代表联系以获取文件和安装这些文件的说明。
用于 MultiTech 的资产网关
MAP-4860： 布鲁塞尔当地时区落后 2 小时
描述：在用于 MultiTech 的资产网关中，为比利时布鲁塞尔设置本地时间时落后两个小时。
变通方案：在用于 MultiTech 的资产网关中选择法国巴黎的本地时间选项。
MAP-12085： MultiTech OCG 平台本地 I/O 初始化失败
描述： 17.1.13 到 17.2.8 版本中本地 I/O 功能不起作用。 此问题已在 17.2.9 中修复。
用于 Option CloudGate 的资产网关
MAP-8230： Option V2 CDMA：发送短信时消息损坏
描述： 对于 Option CloudGate 配备 CDMA 的型号，不支持与短信发送和接收有关的蜂窝动作和事件。
MAP-8231： Option V2 CDMA：发送大型短信消息失败，出现内部 CloudGate api 错误
描述： 对于 CloudGate Option 配备 CDMA 的型号，不支持与短信发送和接收有关的蜂窝动作和事件。 发送大于 160 个字符的大型短信失败，在 Option V2 CDMA 节点上出现 CloudGate API 错误。
MAP-10092： Option CloudGate V1 不支持 TR50 S&F 磁盘存储类型
描述： 存在 TR50 S&F 支持，但是 S&F 磁盘存储类型不可用。
用于 USRobotics 的资产网关
MAP-10662： USRobotics 不支持 TR50 S&F 磁盘存储类型
描述： 存在 TR50 S&F 支持，但是 S&F 磁盘存储类型不可用。
设备类型
MAP-9212：导入或导出全局变量设备和数据值时需注意字节序
描述：从一个节点导出全局变量设备及其数据值，然后将全局变量设备和数据值导入另一节点时，必须考虑节点的字节序。例如：从大端存储节点 (Power PC) 导出，然后导入小端存储节点 (X86)。数字数据值将无法在导入的节点中正确表示。
导入后，应编辑全局变量设备，检查和修改数据值。
用于 Siemens ERPC 的企业网关
MAP-1933：在用于 Siemens ERPC 的企业网关上，受控的侦听器在首次尝试时无法连接到队列管理器
描述：通过传输或侦听器访问 WebSphere MQ 服务器时，由于固件限制，启动后的第一个连接请求失败。后续连接请求正常工作。
变通方案：重复连接请求。
MAP-3634：用于 Siemens ERPC 的企业网关上将传输模式设置为 Active（主动）的 FTP 动作失败
描述：在使用触发器 FTP 动作时，在 ERPC 上将传输模式设置为 Active（主动）时，Put（放入）和 Get（获取）操作不起作用。
变通方案：在未来版本修复该问题之前，先将传输模式参数设置为 Passive（被动）而不是 Active（主动）。
MAP-5707：ERPC 上被动模式下 FTP 客户端无法连接到服务器
描述：用于 Siemens ERPC 的企业网关中 deviceWISE FTP 服务器在被动模式下无法支持 FTP 客户端。
变通方案：改用 FTP 主动模式。
MAP-6793： ERPC 上 TR50 连接 SSL 失败
描述： ERPC 平台不支持 TR-50
MAP-9820： Windows 更新后，基于 VxWorks 的企业网关平台会失去 SQLServer 连接
描述： Windows 更新为 Windows 密码套件添加了新项目，并更改了密码套件中项目的默认顺序。 这会妨碍与 SQLServer 成功连接。
变通方案： 将此密码套件“TLS_RSA_WITH_AES_256_CBC_SHA (53)”移动到密码套件列表的顶部。 请参阅此 Microsoft 页面上的 More Information（更多信息）部分，以获取配置 SSL 密码套件顺序组策略设置的说明： https://support.microsoft.com/en-us/kb/3161639。 使用此方法可在后续 Windows 更新后保留密码套件的顺序。
MAP-11664： 基于 VxWorks 的企业网关平台无法处理来自 Oracle 存储过程的空结果集
描述：执行一个在输出参数中返回结果集的 Oracle 数据库存储过程传输映射时，如果结果集输出参数为空，事务动作将失败。
MAP-11665： 基于 VxWorks 的企业网关平台无法处理 SQLServer 存储过程中的空结果集
描述：执行一个返回结果集的 SQLServer 数据库存储过程传输映射时，如果结果集为空，事务动作将失败。
用于 WinCPU 的企业网关
MAP-14053：WinCPU 产品不是 19.1.6 版本的一部分
描述：我们发现 19.1.6 版本中 WinCPU 产品存在问题，暂时删除了该产品。运行用于 WinCPU 的企业网关的客户应使用 19.1.4 版本或等待下一个 deviceWISE 版本。
用于 Windows 的企业网关
MAP-3455：Node Administration（节点管理）选项卡中的“用于 Windows 的企业网关重启”功能无法按照设计正常工作
描述：无法彻底停止 Workbench（工作台）-> Administration（账户管理）-> Node Administration（节点管理）选项卡提供的 Restart（重启）功能并重启运行时。存在多个活动的传输和侦听器时，事务服务器将无法正确重启。
变通方案：请按照启用 MySQL 支持页面上“手动重启节点”部分中的说明进行操作。
MAP-10766：deviceWISE 升级或降级之后，会重置 Windows 服务“deviceWISE 事务引擎”和“deviceWISE 内核”的登录凭据
描述： 如果更改 deviceWISE Windows 服务条目（包括“deviceWISE 事务引擎”和“deviceWISE 内核”）的登录凭据，则在固件更新到较新或较早版本后，这些服务会被重置为默认服务凭据。
变通方案：固件更新并重启服务条目后，导航至服务面板并重新输入登录凭据。
本地数据库（本地 DB）
MAP-4732：“第一行为标头”参数设置为 True 时，本地数据库导入动作失败。
描述：将带有标头行的 csv 文件导入本地数据库表将导致失败。
变通方案：将“第一行为标头”参数设置为 false，将其导入，然后删除第一行。
MAP-5404：数据库条目列表中的最后一项是逗号/换行符组合时，读取数据库条目出现问题
描述：如果数据库条目列表中的最后一项是逗号/换行符组合，则会出现问题。
变通方案：在数据库中添加一个虚拟列来表示逗号后的空格。例如，如果有 15 个数据条目，而最后一个条目带有逗号，则在数据库中添加第 16 列。
调制解调器
MAP-3167：同时进行蜂窝连接/断开连接和调制解调器电源开/关可能导致资产网关重新启动
描述：我们发现了一种场景：同时执行控制动作时，资产网关会重新启动。反复同时执行“设置调制解调器功率水平”动作和“控制蜂窝连接”动作（或工作台操作）时，可能会发生崩溃，导致重新启动。
正常操作期间，很少使用“设置调制解调器功率水平”动作使电源在“在线”和“低功率”之间循环，尚未观察到此问题。
事务服务器
MAP-685：无法从“存储和转发”正确恢复传输
描述：使用 WMQ 传输且传输报告错误 MQJMS007 时，即使事务已成功传递到 WMQ 队列，也可能导致传输来回切入切出“存储和转发”。
变通方案：选中 WMQ 队列管理器。如果侦听器显示除 Started（已启动）之外的状态，说明可能遇到此问题。将侦听器设置为 Started（已启动）以恢复正常功能。
MAP-2972：用于 Siemens ERPC 的企业网关出现故障，删除软件包后事务服务器无法连接
描述：添加或删除软件包（例如设备驱动程序）之后，节点可能出现故障，事务服务器无法连接。
变通方案：需要重启 deviceWISE。请按照软件包页面上关于手动重启 deviceWISE 节点的说明进行操作。
MAP-3930：IFS：有时事务服务器无法启动
描述：在设置传输，尤其是 iTAC 传输时，如果选中“初始化时加载传输”参数，并使用与选中“初始化时加载传输”的传输不匹配且经过内存优化的事务服务器，则事务服务器可能无法在 Mitsubishi MESInterface IT 节点上启动。使用“标准”企业访问选项重新启动模块可成功启动事务服务器，然后可以修改传输以删除“初始化时加载传输”参数。然后可以将此经过内存优化的事务服务器重新设置为所需的服务器。
MAP-4002：在传输映射中更新逻辑变量却未编辑相应触发器可能会导致不良后果。
描述：在这种场景下，触发器在激发时会被禁用，并且该动作会在“异常”日志中返回错误代码 -6409（无效的变量类型）。由于触发器本身无法恢复，因此用户必须手动编辑并重新保存触发器。
MAP-4796：NVARCHAR 支持限制
描述：以下平台不支持 Oracle 的 NVARCHAR 和 NCHAR 数据类型：
- Mitsubishi MESInterface-IT
- 用于 Siemens ERPC 的 deviceWISE 企业网关
MAP-5170：并非所有平台都支持 HTTP 传输的 JSON 有效负载传输映射
描述：以下平台不支持此功能：
- Mitsubishi MESInterface-IT
- 用于 Siemens ERPC 的 deviceWISE 企业网关
MAP-5684：用于 Siemens ERPC 的企业网关上的 JMS Netweaver 传输/侦听器无法初始化与 JMS Netweaver 服务器的连接
描述：以下平台不支持此功能：
- Mitsubishi MESInterface-IT
- 用于 Siemens ERPC 的 deviceWISE 企业网关
MAP-5685：JMS Netweaver 支持 jar 未与 ERPC 或 MESInterface IT 产品安装文件打包
描述：以下平台不支持此功能：
- Mitsubishi MESInterface-IT
- 用于 Siemens ERPC 的 deviceWISE 企业网关
MAP-6604： ERPC 上 HANA 数据库插入失败
描述：用于 Siemens ERPC 产品的 deviceWISE 企业网关不支持 NVARCHAR 和 NCHAR 数据类型。
MAP-7388： 新的 Oracle JDBC 驱动程序传输映射无法枚举 Oracle 9 服务器上的架构/表定义
描述： 从 deviceWISE 15.1 版本开始，用于 Linux、Windows 和 AIX 的 deviceWISE 企业网关产品使用的新版 Oracle JDBC 驱动程序仅支持 Oracle 12.1、11.2、11.1。
Oracle 9.2 的生命周期于 2010 年 7 月终止。
- Oracle 数据库服务器产品的生命周期终止信息如下： http://www.oracle.com/us/support/library/lifetime-support-technology-069183.pdf
用于 MESInterface-IT 和 Siemens ERPC 产品的 deviceWISE 企业网关尚未更新 JDBC 驱动程序，因此能够从 Oracle 9.2 枚举架构。
MAP-9082： 空宏测试：使用格式为 01/11/12 12:45:00.000 的默认时间戳代替返回的空值时，选择失败
描述： 如果在使用以下企业网关产品时需要为日期和时间指定 SQLServer 数据类型的默认值：
- Mitsubishi MESInterface-IT
- 用于 Siemens ERPC 的企业网关
则需要使用一个表示自 1970 年 1 月 1 日以来的毫秒数的长值，而不是默认格式 'mm/dd/yy HH:MM:SS.sss'。
MAP-11311： AIX java8：试图连接到 SQLServer 2008 及以下版本时出现 SSL 错误
描述： 由于与 SSL 不兼容，在用于 AIX 和 AIX64 的 deviceWISE 企业网关上，数据库传输无法与 Windows XP 上运行的 SQLServer 2008 完成连接。解决方法是在较新的操作系统上访问 SQLServer 数据库。
MAP-12324： VxWorks 平台：无法使用 SQLException 连接到 Oracle 12c 服务器：没有匹配的身份验证协议
描述： 具有 Oracle 数据库传输的基于 VxWorks 的平台无法连接到 Oracle 12c 服务器，出现以下错误： “java.sql.SQLException：ORA-28040：没有匹配的身份验证协议”
之所以出现此问题，是因为 Oracle 12c 配置为使用 Oracle 11 的默认最低身份验证协议，而基于 VxWorks 的网关产品使用了与 JDK 1.5 关联的较早且不受支持的 JDBC 驱动程序。这相当于 Oracle 8 客户端，因此使用 Oracle 8 身份验证协议。
变通方案：
- 使用以下参数配置 sqlnet.ora 文件，以允许版本 8 身份验证协议。
- SQLNET.ALLOWED_LOGON_VERSION_SERVER=8
- SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8
- SEC_CASE_SENSITIVE_LOGON=FALSE
- 重启服务器以使这些更改生效。
- 如果打算使用 VxWorks 运行时的现有登录 ID，则需要使用 PL/SQL 并更改用户密码，以强制服务器重新处理兼容版本的密码。
- 建议采用的方法是创建一个新的登录 ID，并在 VxWorks 运行时的 Oracle 12c 传输上指定这些凭据。
参考链接：
- https://docs.oracle.com/database/121/NETRF/sqlnet.htm#NETRF2016（请参阅关于 SQLNET.ALLOWED_LOGON_VERSION_SERVER 的部分。）
- https://developer.ibm.com/answers/questions/177075/after-upgrading-to-oracle-12c-database-i-start-get.html
- https://mikedietrichde.com/2017/04/24/having-some-fun-with-sec_case_sensitive_logon-and-ora-1017/。
MAP-12453： 访问提供不受信任服务器证书的 HTTP 或 SOAP 服务器
描述： 从企业网关版本 17.2.3 开始，HTTP 和 WS_SOAP 传输在建立 HTTPS 连接时已更改其行为。服务器需要提供由全局受信任 CA 签名的服务器证书。否则传输会收到 SSL 握手异常。
解决方法是：
- 使用由受信任 CA 签名的证书更新 HTTPS 服务器上的服务器证书。
- 使用 keytool 实用程序创建包含服务器 CA 证书的 Java 密钥库。然后在传输面板的 'Keystore'（密钥库）和 'TrustStore'（信任库）字段中指定此密钥库。
- 次优的选择是将帐户/公司的根 CA 证书添加到 'cacerts' 文件中。请注意，重新安装企业网关产品时会替换此文件。
MAP-12885： MySQL 连接器/J 8 版本的 JDBC 驱动程序与企业网关数据库传输不兼容
描述： mySQL 连接器/J v8 JDBC 驱动程序已更改实现驱动程序的类的软件包名称。使用 mySQL 连接器 v5.x JDBC 驱动程序以便在企业网关中启用 mySQL 支持。
事务服务器 XSD 支持
MAP-3141： XSD：如果在标头复选框中选中“指定映射和序列键值”，则不应将 Xpath 表达式保存在 XML 中
描述： 此问题仅影响具有 XSD 有效负载的 JMS 侦听器。如果在 JMS 侦听器 XSD 有效负载面板上同时指定了 XPath 表达式和 JMS 标头属性，并且传入的 JMS 消息中缺少标头属性，则会使用 XPath 表达式而不是默认的侦听器映射 ID 来确定侦听器映射 ID。
MAP-3695： XSD：会错误地使用 XSD 中提供的默认值或固定值
描述： 如果用于创建侦听器映射的 XSD 包含具有默认值或固定值的必需静态属性，则会将其视为有效。在运行时，会错误地使用 XSD 中提供的默认值或固定值，而不是将 XML 视为无效。
MAP-4665： XSD：除非再次查询 XSD，否则从较旧运行时导入到较新运行时的传输映射和侦听器映射定义不支持命名空间
描述： 如果要导入使用 XSD 定义并在 12.4 或之前版本中创建的传输映射或侦听器映射，需要再次查询并保存该映射，以便正确处理 'nil' 元素。
MAP-4666：侦听器不支持含有命名空间的 XSD
描述： 配置为处理基于 XSD 的有效负载的侦听器无法成功处理含有命名空间限定元素的 XML。
变通方案： 变通方案是提供不含命名空间的 XML 请求。
事务服务器 Web 服务 SOAP
MAP-5181： SOAP 标头参数有限支持
描述： 用于 Siemens ERPC 和 Mitsubishi MESInterface-IT 产品的企业网关上不提供 SOAP 标头参数支持。
TR-50
MAP-7007： TR50：死锁
描述： 运行几天或几周后，网关在极少情况下可能会发生死锁情况。 如果发生这种情况，watchdog 将会到期并重置网关以恢复操作。
MAP-8236： time_sync 之后未重新安排 WAIT（等待）动作。
描述： 存在一个已知问题，涉及在存在 2 秒或更长时间漂移的 TR50 连接上启用时间同步时， WAIT（等待）动作立即完成。这意味着在调整操作系统时间以与物联网设备管理门户平台的时间同步时，触发器的时间敏感事件序列的执行速度可能比预期要快。
MAP-10092： 运行 TR50 S&F 磁盘存储类型测试时，Option CloudGate V1 失败，出现错误 storage->create_storage 失败 [-33533]
描述： Option CloudGate V1 网关不支持 TR50 存储和转发磁盘存储类型。
驱动程序
MAP-3140： 用于 Siemens ERPC 的企业网关上 Siemens S7 侦听器卡在正在停止状态
描述： Siemens S7 侦听器设备接收到数据并执行相应的触发器后，停止 Siemens S7 侦听器设备将导致侦听器卡在 Stopping（正在停止）状态。在 Siemens S7 侦听器设备使用正常 TCP 模式（非 ISO-n-TCP）时，操作期间会发生此问题。触发器接收主动提供的消息之后，无法停止 S7 侦听器设备。
预计需要 Siemens 固件升级来解决此问题。
MAP-5066： CloudLINK 软件包删除无法删除该功能，MAP-5158 软件包删除失败 - 操作系统错误
描述： 在内存或磁盘（持久性存储）的操作系统资源有限的某些平台上，尝试添加或删除软件包时可能会失败。这些故障是由于系统资源有限和可能的运行时行为（例如内存碎片）而导致。发生这些故障时，在操作系统级别重启节点（先断电再通电）可能实现成功添加或删除软件包。在其他场景下，可能是已达到基于应用程序定义、添加的软件包数量和大小以及其他动态运行时要求的平台限制。
MAP-6082： 为长度为 207 或以上的 Siemens 字符串写入空字符串无法按照预期清除字节
描述： 如果将空字符串写入 Siemens PLC，则该字符串的所有字节均会设置为 0x00，而实际长度字节会设置为 0。当字符串的最大长度为 207 到 254 个字节时，此行为会发生变化。在这种情况下，实际的字符串长度字节会设置为 0，但不会清除字符串字节。不清除字节是为了减少驱动程序和 PLC 之间的网络流量。字符串大于 206 个字节时，需要驱动程序向服务器发送多条消息。写入空字符串的关键是将实际长度字节设置为 0，使该字符串为空值。
MAP-6811： Siemens LOGO PLC 设备定期禁用
描述： 实验室测试表明，Siemens LOGO PLC 不会保持来自多个节点的同步套接字连接。LOGO PLC 会终止连接，从而导致关联设备被禁用。禁用的设备将重新建立与 LOGO 的套接字连接，但最终只会导致 LOGO 重置该连接。建议一次限制一个节点连接到 LOGO PLC。
MAP-6938： 当“一个元素的大小”字段设置为 0 并且字符串的字符数超过 444 个时，Rockwell CIP 事件将不起作用
描述： Rockwell CIP 事件允许将“一个元素的大小”字段设置为 0，并允许接收任何使用字符数不大于 444 的字符串的消息。但是，任何字符数大于 444 的字符串都会导致错误。变通方案是确保在“一个元素的大小”字段中指明正在读取的字符串的大小。
MAP-7694：设备停止后，订阅生成读取错误
描述： 如果订阅已启动设备，而该设备后来停止，订阅仍会尝试从该设备读取，从而产生错误。
变通方案： 工作台可以通过在已停止的设备上停止订阅并在设备启动时重启订阅来解决此问题，但是在设备已停止时保持订阅处于活动状态会减少发送的命令。
MAP-9022： OPC UA Client 上无法读取名称超过 128 个字符的变量
描述： 变量位置名称最长可为 128 个字符。 变量位置名称由父结构名称加上变量名称组成。 重命名变量以符合 128 个字符限制，即可读取和写入变量。 位置名称长度超过 128 个字符的变量将无法访问，并且返回“错误：变量不存在”错误。 此页面包含更多信息： 访问设备变量。
MAP-9303： OPC UA Client 驱动程序在 StartStopStress 测试 (Linux) 期间的内核句柄和内存使用增加
描述： 尝试在 Linux 上启动和停止多个 OPC UA 客户端会导致节点崩溃。
变通方案： 将每个 deviceWISE 节点的 OPC UA 设备数量限制为五个。
MAP-9176： OPC UA Client 驱动程序在 StartStopStress 测试 (Windows) 期间的内核句柄和内存使用增加
描述： 尝试启动和停止多个 OPC UA 客户端会导致内存泄漏。作为参考，在 3 小时内连续启动和停止 15 个客户端会导致大约 15 MB 的内存丢失。重启节点将清除这些泄漏的内存。
MAP-9968： BACNet 版本 1.2.0 不支持 Linux x64 平台
描述： 64 位 Linux 平台不支持 BACnet。
MAP-10011： 在触发器读取 BACnet 设备变量时断开以太网电缆连接，节点发生崩溃
描述： 在实验室中发现一个问题，如果在设备启动过程中与 BACnet 设备的网络连接丢失，系统会重启
MAP-10145： OPC-DA Client 无法写入大于或等于 2147483648 的 UINT4 值
描述： OPC-DA Client 可写入的最大无符号整数值为 2147483647。
MAP-12201： 即使未执行拧紧操作，Atlas Copco 跟踪数据触发器也会激发。
描述： 实验室测试发现在一些实例中，即使未发生故障，Atlas 控制器也会向 deviceWISE 发送跟踪数据 (MID0900) 消息。如果已启动的 Atlas Copco 跟踪数据触发器与该控制器相关联，则会导致此触发器激发。触发器的结果数据标识符事件变量可用于确定这是否是重复的跟踪数据消息。
MAP-12442： OPC-UA Client 驱动程序无法在 NetComm、CalAmp LMU5000 RevC 和 Lanner 上运行
描述： 并非所有平台都支持 OPC-UA Client 驱动程序。请参阅支持的 OPC-UA Client 环境中的 OPC-UA Client 驱动程序文档。
MAP-12780： Rockwell MicroLogix 1100 和 1400 设备在 Siemens ERPC 上卡在 Stopping（正在停止）状态
描述：读取和写入多个变量后，停止设备可能会导致设备卡在正在停止状态，然后在大约 10 分钟后重置。
从以前的版本升级
升级前请先备份！ 在升级到新版本的 deviceWISE 之前，应该先从工作台对配置执行备份和还原节点配置。
从较早版本的企业网关更新到 19.1.6
如果要将用于 Windows 产品的企业网关升级到 19.1.6 或以上版本，则必须备份节点，卸载用于 Windows 产品的企业网关，执行完整安装，然后还原节点。在 19.1.6 版本中过渡到了新的安装程序架构。
如果要从 17.2.3 到 19.1.6（含）之间的版本更新企业网关，可以使用固件更新选项。不支持从 17.2.3 以下版本的固件更新。
如果要将企业网关从 17.1.14 或以下版本更新到 19.1.6，则必须执行完整产品安装。必须这样才能安装支持库和第三方支持文件。这些支持文件并未包含在企业网关的固件更新中，而是包含在完整安装中。
更新到 19.1.6 后，您需要从新的 19.1.5 版本添加所有设备驱动程序和扩展。
CentOS 7 或 systemd 安装不支持从 16.1.8 或以下版本到 19.1.6 的固件更新。 必须完整安装。
从较早版本的资产网关更新到 19.1.6
如果要将用于 Windows 产品的资产网关升级到 19.1.6 或以上版本，则必须备份节点，卸载用于 Windows 产品的资产网关，执行完整安装，然后还原节点。在 19.1.6 版本中过渡到了新的安装程序架构。
如果要从 17.2.3 到 19.1.5（含）之间的版本更新资产网关，可以使用固件更新选项。
如果要将资产网关从 17.1.14 或以下版本更新到 19.1.6，则必须执行完整产品安装。 不支持从 17.2.3 以下版本的固件更新。或者，您可以使用固件更新选项，先将较早版本更新到 17.2.3，然后再将固件更新到 19.1.6。 必须这样才能安装支持库和第三方支持文件，这些文件包含在 17.2.3 固件更新中。这些支持文件并未包含在资产网关的 19.1.6 固件更新中。
更新 deviceWISE 运行时 19.1.6 后，您需要从新的 19.1.6 版本添加所有设备驱动程序和扩展。
CentOS 7 或 systemd 安装不支持从 16.1.8 或以下版本到 19.1.6 的固件更新。 必须完整安装。
有关更新软件的更多信息，请参见更新产品。