Release notes for older Gateway versions

It is strongly recommended that you update your Gateway to the latest version. See how   Gateway 1.20.2   Enhancements   This release replaces a certificate that enables device library updates. The Gateway must be at a minimum of version 1.20.2 to receive new device library updates. See How to update the Gateway device library   Gateway 1.20.1   Issues fixed   Incomplete firmware updates are now terminated as expected when the Gateway is rebooted.   Gateway 1.20.0    Enhancements   Firmware update and device configuration improvements You can now select specific device file transfer credentials to use in a device discovery. Click Configure Credentials to select only the credentials to use for the devices being discovered. Otherwise, all configured credentials will be used.      Click Manage credentials to view the credentials you have configured in the Gateway.   To comply with stricter cybersecurity requirements across various product groups, it is recommended that you review your username/password lists in EcoStruxure IT Gateway and confirm that configured credentials are both active and accurate. See New cybersecurity requirements in NMC3     Issues fixed   Polling is disabled during device firmware update to prevent erroneous alarms. Sorting the IP address column on the Devices page or editing the polling interval no longer displays a 400 error. The device discovery summary no longer shows deleted credentials as invalid.   Known issues   Complete list of EcoStruxure IT Gateway known issues

EcoStruxure IT Gateway 1.19.0   It is now required that new installations of Gateway 1.19+ on Linux be installed in the default location.   Enhancements   Improved firmware update file transfer validation Improved device connectivity to address communication issues affecting some users Various security fixes   Issues fixed   Files necessary for updates are no longer blocked when using a proxy server to communicate with the EcoStruxure IT cloud.

SNMPv3 traps and informs Gateway 1.18 and newer supports SNMPv3 traps and informs for discovered APC NMC and third party devices. Discovered SNMPv3 devices are not automatically registered as trap receivers. The SNMPv3 device must be configured for SNMPv3 traps. More... Firmware update improvements More rigorous checks were included to improve the reliability of firmware updates. Checksums are validated before firmware update.  Installer Updated Java to jdk-11.0.17 Gateway Linux OS support EcoStruxure IT Gateway 1.18.0.1 supports installing on Rocky Linux 8.7 and 9.1. See System requirements for EcoStruxure IT Gateway Gateway appliance OS update This release updates the appliance OS to 7.2022.11.18. See What's new in the EcoStruxure IT Gateway appliance Known issues EcoStruxure IT Gateway 1.18 for Linux must be installed in the default installation directory. The .stage directory may be left behind during a backup. The backup is successful. The error displayed can be disregarded. For a list of known issues, see EcoStruxure IT Gateway known issues

Gateway 1.17.1 release notes It is strongly recommended that you update your Gateway to version 1.17.1. See how Gateway Addressed an issue that prevented sending device data from the Gateway to EcoStruxure IT on Linux. Installer Addressed an issue that prevented users in some time zones from installing the Gateway on Linux. Gateway 1.17.0 release notes Gateway session timeout The inactivity timeout for EcoStruxure IT Gateway user sessions is now 30 minutes. The session expires once you interact with the Gateway after the timeout has been exceeded. For example, if the Alarms page is displayed when the session expires, that page will continue to update until you click to navigate. Serial Modbus polling Serial Modbus polling was optimized to prevent erroneous alarms.

The Gateway must be at a minimum of version 1.6.0 to upgrade to newer Gateway versions.   Gateway 1.16.2 release notes This release improves the stability of device firmware updates in IT Expert. All Gateways in your organization must be at version 1.16.2 to perform firmware updates in IT Expert.   Gateway 1.16.1 release notes This release addresses an issue in the installer.   Gateway 1.16.0 release notes Improvements to unsupported device list The list of unsupported devices on the Discover Devices page can now be cleared. Click View details and then select the devices you want to clear from the list. GW116_unsupported_devices_list_5652045522845.png GW116_unsupported_devices_list_1_5652045522845.png To view information about devices that were previously cleared from the list, click View details and select Show cleared. GW116_unsupported_devices_list_2_5652045522845.png Updated installer Updates from Gateway version 1.8+ perform a backup that is stored in the install directory. See Updating EcoStruxure IT Gateway to the latest version Windows 11 is supported in Gateway versions 1.16 and newer. See System requirements for EcoStruxure IT Gateway Spring Boot replaced Tomcat to address security issues. The web server now supports TLS 1.3. Improvements to rPDU control The Control option is now available for all supported switched rack PDU devices. Command to import an SSL certificate changed As of Gateway 1.16, the path to import a self-signed SSL certificate has changed. See How to replace the self-signed SSL certificate in EcoStruxure IT Gateway versions 1.16 and newer Device walk utility The device walk utility has been updated. See How to create a device walk file for EcoStruxure IT Gateway and Data Center Expert Issues fixed Linux installations with non-default directories now install and upgrade as expected. Security See EcoStruxure IT security   For information about previous releases, see What's new in EcoStruxure IT Gateway  

EcoStruxure IT Gateway 1.15.1 This release addresses an issue in Gateway 1.15.0 that prevented device data from synchronizing with EcoStruxure IT, and prevented firmware update and device configuration from executing as expected. Note: When Gateway updates are initiated from IT Expert, status messages may not be shown until the update is complete.   SNMPv3 discovery requirements You can now discover SNMPv3 devices with the encryption and authentication phrases set to None.  Issues fixed Refined the criteria for triggering the device communication alert that occurs when a new device is detected at the IP address of a previously discovered device More efficient Samsung BMS discovery Device control support This release contains support for device control features that will be available in upcoming releases of IT Expert. Security Various security updates Known issues EcoStruxure IT Gateway known issues  

EcoStruxure IT Gateway 1.14.2 This release updates Spring to version 5.2.20. EcoStruxure IT Gateway 1.14.1 Log4j2 This release updates the log4j2 version to 2.17.1. Device communication alert It is now easier to manage device replacement, such as RMA. A device communication alert is now triggered when a new device is detected at the IP address of a previously discovered device. GW_new_device_detected_4419182765457.png Improved detection of offline devices during discovery When communication with a device is lost during discovery, the device is considered offline and is no longer added to the device list. Security Various security updates

EcoStruxure IT Gateway 1.13.2 Log4j2 This release updates the log4j2 version to 2.17, to address CVE-2021-45105 NOTE: EcoStruxure IT Gateway is not vulnerable to CVE-2021-44832. This vulnerability requires use of the JDBC Appender, which the Gateway does not use as part of its log4j configurations. Supported operating systems The operating systems supported by the Gateway are now: Microsoft® Windows® 10 64-bit, Server 2016, Server 2019, and Server 2022 Red Hat Enterprise Linux 7 or CentOS 7 See System requirements for EcoStruxure IT Gateway EcoStruxure IT Gateway 1.13.1 This release updates the log4j2 version to 2.16, to address CVE-2021-44228 and CVE-2021-45046 EcoStruxure IT Gateway 1.13.0 One minute polling EcoStruxure IT Gateway can now poll up to 25 devices at 1 minute instead of the normal 5 minute polling rate. The actual number of devices depends on protocol and server resources. For more information, see Configure 1 minute polling in EcoStruxure IT Gateway Updated system requirements The system requirements have been updated for: CPU requirements for the small configuration Monitoring SNMPv3 devices One minute polling See EcoStruxure IT Gateway system requirements Issue fixed The Gateway now reconnects to the EcoStruxure IT cloud after network connectivity is interrupted. Security See EcoStruxure IT security   For information about previous releases, see What's new in EcoStruxure IT Gateway

  This release contains security updates only. For information about previous releases, see What's new in EcoStruxure IT Gateway

This release updates Java to AdoptOpenJDK 11.0.11_9. Issues fixed The console log rotation is now capped at the most recent ten log files with a maximum of 20MB each. The Gateway software updates as expected for all locales. Security See EcoStruxure IT security

Gateway 1.10.1 This release addresses an issue in Gateway version 1.10 that prevented some users from logging in to the user interface. All Gateway users can now log in as expected. Gateway 1.10 New management interface for the Gateway appliance A more secure and easier-to-use management interface replaced Webmin on the private network of the Gateway appliance. It includes options to manage and configure the appliance private network, public network, and NTP server; controls to reboot, reset, or shut down the appliance; and a command line interface for access to advanced options via SSH. See EcoStruxure IT Gateway appliance installation and setup - version 1.10 and newer GWA_up_360018815238.png Gateway appliance OS update in IT Expert You now update the operating system on Gateway appliances in EcoStruxure IT on the Administration > Gateways tab.  See Updating the Gateway appliance - version 1.10 and newer Configure SNMP trap ports The Gateway now listens for traps on port 162 by default for better third party device support. Note: The Gateway listens for SNMPv1 traps only. The new Settings > Advanced > SNMP trap ports option allows you to configure SNMP trap ports in addition to 1062. The configurable port list contains port 162 to support the default for most third party devices.  To receive traps for third party devices, you must manually add the Gateway as an SNMP trap receiver in the device's user interface. See Configure SNMP trap ports GW110_advanced_SNMP_ports_sm_360018815238.png NMC 3 firmware update support As of this release, you can now use IT Expert to update the firmware on devices that use an APC Network Management Card 3 (AP9640).  Additional device configuration options in IT Expert  More config.ini options are available to update device settings using IT Expert device configuration and single device configuration: device name, location, and contacts. Domain change to us.ecostruxureit.com Some URLs used for Gateway communication with EcoStruxure IT reflect outdated branding and are being retired. The URL us.struxureon.com will soon be replaced by us.ecostruxureit.com. You must define a DNS server for the network that connects to EcoStruxure IT. Make sure your Gateway can resolve us.struxureon.com and us.ecostruxureit.com via DNS. Note: Firewall settings to connect using static IP addresses 40.84.62.190, 23.99.90.28 and 52.230.227.202 are unaffected by this change. See System requirements for EcoStruxure IT Gateway   Security See EcoStruxure IT security  

Improved device support Starting in EcoStruxure IT Gateway 1.9.0, the device library will be released more frequently, independent from Gateway software releases. EcoStruxure IT Gateway device library release notes EcoStruxure IT Gateways configured for auto-update will get the new device library automatically. Gateways not configured for auto-update require an Administrator user to manually update the device library in EcoStruxure IT. Note: Updates to the device library are only available through EcoStruxure IT, not as a separate downloadable file. How to update the Gateway device library Have an unsupported device?   Strong passwords enforced The EcoStruxure IT Gateway password policy now requires: At least 10 characters in length At least 3 of the following 4 types of characters: Lower case letters (a-z) Upper case letters (A-Z) Numbers (0-9) Special characters (Example: !@#$%^&*) No more than 2 identical characters in a row (Example: aaa is not allowed) Strong passwords are enforced when you first create your password and when you change your password. You are not required to change your existing password after updating your Gateway. SCP support SCP is now supported as a secure alternative to FTP for event.txt, device configuration, and firmware update.  It is strongly recommended that you use SCP and disable FTP on your APC NMC-based devices. IMPORTANT: You must update the device configuration settings in the Gateway and rediscover the devices that you modified to use SCP credentials. See Configure Gateway device file transfer settings Log rotation Gateway log rotation on Linux installations now occurs as expected. Backup output email An email is no longer sent for a Gateway backup on Linux installations, was previously sending large email for each backup.  Backup results are still stored in cli.log. Security updates Various security updates See also EcoStruxure IT Gateway known issues    

Issues fixed Measurements and logs are now sent from the Gateway to EcoStruxure IT as expected. The Discover Devices page now loads as expected.

Updating the Gateway from 1.8.1 to the current version There is an issue updating Gateway 1.8.1 to the current Gateway version. Only the update from version 1.8.1 is affected. Updating from Gateway 1.7.0 and earlier is not affected. Updating from 1.8.2 and later is not affected. Windows Due to an issue with 1.8.1, the software update from 1.8.1 to 1.8.2 appears to fail when performing an upgrade from the EcoStruxure IT Web application. This failure message is erroneous. It can take up to 30 minutes for the Gateway to start running the new version and to clear the message. If the message doesn't clear, contact support for assistance. Linux Due the same issue in 1.8.1, the update from the EcoStruxure IT Web application will always fail.  If you have installed Gateway version 1.8.1 on a computer, updating to 1.8.2 requires that you manually download and install the installation file from EcoStruxure IT.  To update the software on a Gateway appliance, contact support for assistance.   DDF updates Corrected the name of the controller in some Uniflair Modbus DDFs Improvements for Uniflair Modbus device discovery Other improvements Improved the Gateway software update process   See also  Updating EcoStruxure IT Gateway to the latest version  

Updated Gateway user interface More intuitive onboarding A setup wizard in the Gateway user interface simplifies the initial setup and onboarding flow and gives you better guidance. See Installing and setting up EcoStruxure IT Gateway Improved device discovery  You can now import IP address lists when you create discovery entries. It is easier to see and fix why certain devices fail to discover. You can now retrieve the latest device details values directly from the device details page. Improved device communication credential management Device credentials can now be shared across all discoveries. Enter them once and use them as often as needed without re-entering. Easier network proxy management For organizations requiring use of a SSL/TLS inspection proxy, trusted certificate authority (CA) root certificates can now be directly uploaded in the Gateway user interface. Cloud-based alarm threshold management Alarm threshold management was moved from Gateway to the EcoStruxure IT user interface. For organizations with multiple Gateways connected, alarm thresholds for notifications are now managed from a single place. Log in to EcoStruxure IT and go to Alarms > Thresholds.  How to configure alarm thresholds in EcoStruxure IT All the Gateways in your organization must be updated to version 1.8 or greater to see thresholds in EcoStruxure IT. Thresholds created in previous Gateway versions are migrated to EcoStruxure IT once you update the Gateway(s) to 1.8 or greater. Other improvements Firmware update  The reliability of firmware updates was improved, particularly on networks with more restrictive firewall settings. Simplified backup and restore Gateway backups can be stored to the local file system, eliminating the need to configure remote file shares. Gateway is automatically backed up weekly to the local file system, keeping the 3 most recent backups. Gateway backup configuration and manual creation is now performed via the command line. It is no longer configured via the Gateway web interface. Local or remote terminal access is required to create and maintain Gateway backups. Note: For Gateway appliances, technical support assistance is required to enable local or remote (SSH) console access to create Gateway backups. These changes simplify and align the Gateway backup and restore procedures. See Configure Gateway backup in Gateway 1.8 and Configure Gateway restore in Gateway 1.8 Linux Gateway log rotation Gateway log files are rotated as expected on Linux systems. Modbus The Modbus server address is now displayed in the Inventory tab to help you differentiate multiple Modbus devices at a single IP address. Security updates Software vulnerabilities fixed ICSA-20-126-01 - Uncontrolled search path element Numerous additional security patches and general hardening improved the security posture of the Gateway web server. DDF updates Significant DDF updates Schneider Electric, Easy UPS, UPS, SNMP - Fixed a scaling issue on the battery time remaining and fixed an issue with some devices not being able to be discovered Schneider Electric, Galaxy VS, UPS, SNMP - Addition of new sensors coming with new NMC firmware updates. Schneider Electric, Gutor, UPS, SNMP - Numerous updates to add new sensors and fix issues on existing sensors. New DDFs  (Vendor, Series, Type, Protocol) Luminous, LD1000, UPS, SNMP NTI, Environmux 16D, Environmental Monitor, SNMP Socomec, DIRIS Digiware, power meter, SNMP Socomec, NetVision 6, UPS, SNMP Stulz, WIB8000, Cooling and Environmental Monitoring, SNMP Toshiba, 1600XP, UPS, SNMP Vertiv, Cooling, CRV, Modbus Woodward, EasyGen 3000, Generator, Modbus Schneider Electric, ACRD300, Cooling, SNMP Schneider Electric, Uniflair, Cooling, SNMP (see this article for more details on how to discover these devices) Aquacentr BCEx (pCO5+/UG50) BCWx (pCO5+/UG50) Aquascrew BREx (pCO5+/UG50) Aquascroll ERAx (pCO5+/UG50) ERCx (pCO5+/UG50) ISAx (pCO5+/UG50) ISCx (pCO5+/UG50) TRAx (pCO5+/UG50) ARAx (pCO1/MP20II) BCEx (pCO5/UG50) BCWC (pCO3/UG50) BRAx (pCO1/MP20II) BREx (pCO1/MP20II) BRWx/BRRC (pCO1/MP20II) ERAx (pCO1/UG40) ERCx (pCO1/UG40) ISAx (pCO1/UG40) ISCx (pCO1/UG40) LRAx (pCOXS) Monoblock Room Cooling (MB) XMAx/XDAx (pCO1/UG40) XMFx/XDFx (pCO1/UG40) Ceiling Mounted Split Room Cooling (SP) UCAx/UWAx (pCO1/UG40) UCFx/UWFx (pCO1/UG40) UCFx (Schneider J5/4.3-inch Touchscreen) Wall Mount Room Cooling (WM) WMAx/WDAx (pCO1/UG40) WMFx/WDFx (pCO1/UG40) Amico/AM SDCx/SUCx (pCO1/UG40) SDXx/SUXx (pCO1/UG40) Leonardo/LE TDxR/TDxV (pCO1/UG40) TUxR/TUxV (pCO1/UG40) TxCx (pCO1/UG40 NAM Semi-graphic display) HDCV (pCO5+/UG50) HDCV (pCO5+/7-inch Touchscreen) LDCV (pCO5+/7-inch Touchscreen) TxxG (pCO5+/7-inch Touchscreen) IxAV (pCO5+/UG50) Important Uniflair device definition files (DDF) updates The device definition files for Uniflair devices in this release contain significant changes for more robust support. After updating to Gateway 1.8, you must delete previously discovered Uniflair devices and then rediscover them. Existing device data will not be preserved. Once you delete the devices, you rediscover them using an SNMP targeted discovery. See Uniflair device discovery for Gateway 1.8.0+ for instructions. Affected devices Uniflair devices with the following Model field in EcoStuxure IT Gateway are affected: ERA*/ERC*/ISA*/ISC*/TR******A (Aquascroll Firmware) - *Gateway 1.7.x Aquascrew - Imperial Aquascrew - Metric Aquascroll - *Gateway 1.6.2 and older Aquascroll - Imperial Aquascroll - Metric ARAnew - Imperial ARAnew -Metric BCE - Imperial BCE - Metric BCWC - Imperial BCWC - Metric BRA - Imperial BRA - Metric BREF - Imperial BREF - Metric BRWC - Imperial BRWC - Metric ERA - Imperial ERA - Metric ISA - Imperial ISA - Metric LRA - Imperial LRA - Metric MSTMAF - Imperial MSTMAF - Metric Telnew - Imperial Telnew - Metric UG40/MP40 - Imperial UG40/MP40 - Metric UG50 - Imperial UG50 - Metric How to delete and rediscover Uniflair devices In the Gateway user interface, go to Devices. Find the devices you want to delete by model. Click Delete devices. GW_Uniflair_1_360004801678.png Click Delete next to the device(s) you want to remove. Click Done once the devices you want to rediscover have been deleted. GW_Uniflair_2_360004801678.png  See Uniflair device discovery for Gateway 1.8.0+ for instructions on how to rediscover these devices using an SNMP targeted discovery.

It is recommended that you upgrade to 1.7.0.64 to mitigate potential security vulnerabilities. Is your Gateway software older than 1.4.0? Download and install version 1.5.2 before you update to the latest version. If your Gateway software is older than version 1.4.0, the installer will direct you to download and install Gateway version 1.5.2. Once you log in, you'll see a message that an update is available. You can then update your Gateway to the latest version. If your Gateway version is 1.4.0 or newer, you can update to the latest version directly. Log in to your EcoStruxure IT account. Go to Administration > Gateways. Click Update on the gateway tile. idea_icon_360007070737.png You can enable automatic Gateway software updates in EcoStruxure IT. More   EcoStruxure IT Gateway 1.7.0.64 California state legislature security updates for network-connected devices EcoStruxure IT Expert Gateway was updated to comply with California law for the security of connected devices. APC network-enabled devices are being updated to improve security and comply with regulations.  New versions of APC Network Management Card (NMC) firmware will have the SNMP protocol disabled by default. Devices that have these cards cannot be discovered by EcoStruxure IT Expert or Data Center Expert until SNMP is enabled.  More information on specific changes This release provides support for NetBotz 750. Device support NetBotz 750 support, requires a minimum of NetBotz 750 version 5.2.0 Enhanced support for APC UPS System updates The APC Network Management Card is no longer listed as a device in the EcoStruxure IT Inventory. You can now launch to a device from the Gateway using either HTTPS or HTTP. Units for Apparent Energy (VAh) and Reactive Energy (VARh) are now displayed as expected. Security Various security improvements  Checksum SHA1 Linux:  3f6e828a9928007d4ef0a868c9452e3194393991 Windows:  b7ae6cec249e2c34907ab4a112cff2a6a8fd0012  

It is recommended that you upgrade to 1.6.2.14 to mitigate potential security vulnerabilities. Is your Gateway software older than 1.4.0? Download and install version 1.5.2 before you update to the latest version. If your Gateway software is older than version 1.4.0, the installer will direct you to download and install Gateway version 1.5.2. Once you log in, you'll see a message that an update is available. You can then update your Gateway to the latest version. If your Gateway version is 1.4.0 or newer, you can update to the latest version directly. Log in to your EcoStruxure IT account. Go to Administration > Gateways. Click Update on the gateway tile. idea_icon_360007070737.png You can enable automatic Gateway software updates in EcoStruxure IT. More EcoStruxure IT Gateway 1.6.2.14 This release improves the security of the Windows and Linux installers.  Checksum SHA1 Linux: 5aa4a13737a4c7ac7641495b2818f84e66a5f16a Windows: ca0c04c70effd85b9823593eeadcfb05998e13f6   EcoStruxure IT Gateway 1.6.1.9 Software updates are now successful on systems with very long APC Network Management Card config.ini text fields. Checksum SHA1 Linux: c1f452939674f97d2ae31f8d82609fbd003b8259 Windows: 2f7a838ac3a76a77b996f5741127b365c523cf30 EcoStruxure IT Gateway 1.6.0.39 Installer The EcoStruxure IT Gateway 1.6.0.39 installer was updated to meet the latest security requirements. Security enhancements If you have run a Gateway backup and stored it in a vulnerable location, data in the backup file may be at risk of being compromised. For the utmost security, it is recommended that you change these credentials after updating to the 1.6.0.39 release: Gateway user accounts Discovered devices Backup locations You must now supply a password for the Gateway (zipPw) to restore from backup. This is the serial number of the Gateway. How to find the Gateway serial number Database security was improved. Possible cross site scripting exploits were addressed. Device support Added support for: Liebert EPMP Liebert cooling PCW/PDX APC Power Management Module  Issues fixed UPS Battery Age is now displayed as expected. Galaxy VS Bypass Switch sensor is now supported. PPC UPS sensors and attributes System updates Updated TomCat to version 8.5 Replaced the Oracle JRE with Amazon Open JDK Browser support EcoStruxure IT no longer supports Microsoft Internet Explorer. Use Microsoft Edge, Firefox, Chrome, or Safari. Checksum SHA1 Linux: 29a6be32763361c8469b0df7e39b15be378137dc Windows: 6ed63edd6d5d00a7dcdf196b5950260806934abd