Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Downloads for the current stable release (SmartServer IoT 3.2 Update 1) are available here:

...

Descriptions and direct links for the current and previous releases are available in the following sections.

SmartServer IoT 3.2 Update 1

Release Date: May 26, 2021

Versions:

  • SmartServer IoT Software: 3.20.121
  • IzoT Net Export Utility: 1.30.335
  • Platform
    • Ubuntu Linux: 20.04
    • Ubuntu kernel: 5.4
    • Node.js: 14
    • Java VM: 11
    • Python: 3.8
    • PHP: 8.0
    • NginX: 1.18.0

Downloads: 

Changes: 

  • The LON IP-852 router sometimes failed to route large network variables.  This problem has been fixed. (AP-8426)

Warnings: 

  • Limited testing has been completed for this release.  The fix for routing 222-byte LON NVs has been verified, but there has been no regression testing completed for this update.  If you are looking for a fully tested stable release, use SmartServer 3.2.
  • You can update an installed SmartServer running an earlier release of the SmartServer software to the 3.2 release.  However, you cannot go back without clearing all devices out of the SmartServer.  If you attempt to load an earlier version of the SmartServer software on a SmartServer with 3.2 and provisioned devices, the earlier software is not compatible with the 3.2 database and will fail to run.  Always backup your SmartServer prior to updating it to the 3.2 software.  If you have to go back to an earlier release, either restore one of your backups with the earlier release, or re-image your SmartServer with a clean version of the earlier release as described in Updating with the SmartServer Configuration Page.  Links to prior releases are available on this page. (LUM-8271)
  • The source of datapoint names has changed with this release to make the names easier to understand and recognize.  If you update a SmartServer with a prior release, the datapoint names may change for any new devices you install, whereas they will stay the same for devices you installed with the previous release.  Both sets of names will appear in the CMS Datapoint Properties widget, but only the new names will work for any new devices you install.  To simplify system maintenance, redefine your datapoint properties, calendar events, and Sequencing widget flows to use the new datapoint names.
  • You cannot use the apollo-reset command from the SmartServer console.  The command is available from the console, but if you enter the command your SmartServer may fail or become corrupted.  To reset the SmartServer database, or to return a SmartSever to factory defaults, follow the procedure at Resetting the SmartServer to Factory Defaults. (AP-8427)
  • You cannot view logged data in the CMS Datapoint Browser.  Logged data is available to custom applications and web pages that use IAP/REST or IAP/WS to view the data log contents. (LUM-8529)
  • You cannot include leading zeros in the device unique ID (UID) and the BACnet object instance numbers that you specify in the BACnet XIF (BAC) file.  The CMS will accept the definitions, but some operations will fail due to the leading zeros. (AP-8018)
  • You cannot update IAP output datapoints (which are the same as BACnet input datapoints) from calendar events.  You can update IAP input datapoints (which are the same as BACnet output datapoints).  This includes writes to BACnet inputs such as BACnet AI and BI objects. (LUM-7839)
  • If you create a calendar event with a sunset or sunrise time, in some cases you will not be able to edit the event after you create it.  If you cannot change an event that requires a change, delete the event and create a new one with your desired changes. (LUM-8268)
  • In some cases, when you create a connection between two LON datapoints, the devices involved in the connection may be deprovisioned.  You can recover by reprovisioning the devices after they become deprovisioned. (AP-8360)
  • If your SmartServer has any BACnet devices with a discovered device interface (XIF) and you export your device types using the Settings button or the Devices Widget Export action, your discovered BACnet XIF will not be included in the export.  You can get a copy of the discovered XIF in the /var/apollo/data/bacnetrouter/res directory on your SmartServer. (LUM-8265)
  • In some cases, the CMS displays stale data after you make a change.  If a datapoint value, context, preset, or other value is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers).  If you are using the CMS Datapoint Browser, you can click the Refresh button in the upper right corner of the widget. (LUM-7145, AP-7677)
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing the SmartServer SD Card. (LUM-7271)
  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.

SmartServer IoT 3.2

Release Date: May 19, 2021

...

  • You can update an installed SmartServer running an earlier release of the SmartServer software to the 3.2 release.  However, you cannot go back without clearing all devices out of the SmartServer.  If you attempt to load an earlier version of the SmartServer software on a SmartServer with 3.2 and provisioned devices, the earlier software is not compatible with the 3.2 database and will fail to run.  Always backup your SmartServer prior to updating it to the 3.2 software.  If you have to go back to an earlier release, either restore one of your backups with the earlier release, or re-image your SmartServer with a clean version of the earlier release as described in Updating with the SmartServer Configuration Page.  Links to prior releases are available on this page. (LUM-8271)
  • The source of datapoint names has changed with this release to make the names easier to understand and recognize.  If you update a SmartServer with a prior release, the datapoint names may change for any new devices you install, whereas they will stay the same for devices you installed with the previous release.  Both sets of names will appear in the CMS Datapoint Properties widget, but only the new names will work for any new devices you install.  To simplify system maintenance, redefine your datapoint properties, calendar events, and Sequencing widget flows to use the new datapoint names.
  • You cannot use the apollo-reset command from the SmartServer console.  The command is available from the console, but if you enter the command your SmartServer may fail or become corrupted.  To reset the SmartServer database, or to return a SmartSever to factory defaults, follow the procedure at Resetting the SmartServer to Factory Defaults. (AP-8427)
  • You cannot view logged data in the CMS Datapoint Browser.  Logged data is available to custom applications and web pages that use IAP/REST or IAP/WS to view the data log contents. (LUM-8529)
  • You cannot include leading zeros in the device unique ID (UID) and the BACnet object instance numbers that you specify in the BACnet XIF (BAC) file.  The CMS will accept the definitions, but some operations will fail due to the leading zeros. (AP-8018)
  • The SmartServer LON IP-852 router will not work with LON datapoints with a size larger than 198 bytes. (AP-8426)
  • You cannot update IAP output datapoints (which are the same as BACnet input datapoints) from calendar events.  You can update IAP input datapoints (which are the same as BACnet output datapoints).  This includes writes to BACnet inputs such as BACnet AI and BI objects. (LUM-7839)
  • If you create a calendar event with a sunset or sunrise time, in some cases you will not be able to edit the event after you create it.  If you cannot change an event that requires a change, delete the event and create a new one with your desired changes. (LUM-8268)
  • In some cases, when you create a connection between two LON datapoints, the devices involved in the connection may be deprovisioned.  You can recover by reprovisioning the devices after they become deprovisioned. (AP-8360)
  • If your SmartServer has any BACnet devices with a discovered device interface (XIF) and you export your device types using the Settings button or the Devices Widget Export action, your discovered BACnet XIF will not be included in the export.  You can get a copy of the discovered XIF in the /var/apollo/data/bacnetrouter/res directory on your SmartServer. (LUM-8265)
  • In some cases, the CMS displays stale data after you make a change.  If a datapoint value, context, preset, or other value is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers).  If you are using the CMS Datapoint Browser, you can click the Refresh button in the upper right corner of the widget. (LUM-7145, AP-7677)
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.

...

  • You cannot include leading zeros in the device unique ID (UID) and the BACnet object instance numbers that you specify in the BACnet XIF (BAC) file.  The CMS will accept the definitions, but some operations will fail due to the leading zeros. (AP-8018)
  • Automatic application image loading for field devices may fail if you use the manual option to create the device and the program ID in the device does not match the program ID specified for the device interface.  You can use automatic application image loading with guided device discovery. (AP-8026)
  • You cannot update IAP output datapoints (which are the same as BACnet input datapoints) from calendar events.  You can update IAP input datapoints (which are the same as BACnet output datapoints).  This includes writes to BACnet inputs such as BACnet AI and BI objects. (LUM-7839)
  • Historical data logs may contain adjacent duplicate entries when you specify the option to only log values after a change in value. (LUM-7831)
  • In some cases, the CMS displays stale data after you make a change.  If a datapoint value, context, preset, or other value is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers).  If you are using the CMS Datapoint Browser, you can click the Refresh button in the upper right corner of the widget. (LUM-7107, LUM-7104, LUM-7145, AP-7677)
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.

...

  • If you use the beta BACnet COV support in the SmartServer BACnet Server to subscribe to a SmartServer BACnet Server datapoint from a BACnet workstation, COV updates may be delayed by up to one minute, (AP-8027)
  • You cannot include leading zeros in the device unique ID (UID) and the BACnet object instance numbers that you specify in the BACnet XIF (BAC) file.  The CMS will accept the definitions, but some operations will fail due to the leading zeros. (AP-8018)
  • Automatic application image loading for field devices may fail if you use the manual option to create the device and the program ID in the device does not match the program ID specified for the device interface.  You can use automatic application image loading with guided device discovery. (AP-8026)
  • You cannot update IAP output datapoints (which are the same as BACnet input datapoints) from schedule events.  You can update IAP input datapoints (which are the same as BACnet output datapoints).  This includes writes to BACnet inputs such as BACnet AI and BI objects. (LUM-7839)
  • Historical data logs may contain adjacent duplicate entries when you specify the option to only log values after a change in value. (LUM-7831)
  • In some cases, the CMS displays stale data after you make a change.  If a datapoint value, context, preset, or other value is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers).  If you are using the CMS Datapoint Browser, you can click the Refresh button in the upper right corner of the widget. (LUM-7107, LUM-7104, LUM-7145, AP-7677)
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.
  • You cannot install more than a total of five network interfaces (U60 or U70) and IOX modules in a single SmartServer.  If you have five total, or if you have four and require a spare USB port, use a powered USB 3.0 compliant hub and plug all the U60 and U70 network interfaces into the hub.  Always plug any IOX modules directly into the SmartServer and do not plug them into a hub.

...

  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.
  • You cannot install more than a total of five network interfaces (U60 or U70) and IOX modules in a single SmartServer.  If you have five total, or if you have four and require a spare USB port, use a powered USB 3.0 compliant hub and plug all the U60 and U70 network interfaces into the hub.  Always plug any IOX modules directly into the SmartServer and do not plug them into a hub.
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • In some cases, the CMS displays stale data after you make a change.  If a datapoint value, context, or other value is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers). (LUM-7107, LUM-7104, AP-7677)
  • When you edit a preset value in the CMS Datapoint Properties with a localization rule, the CMS may save a slightly different value than the value you entered. For example, if you enter 35 for a preset value, the CMS may store 35.1 instead of 35. (LUM-7315)

...

  • If you are using an IOX I/O Expansion Module, always plug the IOX into a USB port on the SmartServer and do not plug it into a USB hub.
  • You cannot install more than a total of five network interfaces (U60 or U70) and IOX modules in a single SmartServer.  If you have five total, or if you have four and require a spare USB port, use a powered USB 3.0 compliant hub and plug all the U60 and U70 network interfaces into the hub.  Always plug any IOX modules directly into the SmartServer and do not plug them into a hub.
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • In some cases, the CMS displays stale datapoint values and context information.  If a datapoint value or context is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers). (LUM-7107, LUM-7104)
  • If all the widgets in the CMS disappear from your CMS dashboard, click any widget name in the list of widgets on the left side of the dashboard. (LUM-7324)
  • When you edit a preset value in the CMS Datapoint Properties with a localization rule, the CMS may save a slightly different value than the value you entered. For example, if you enter 35 for a preset value, the CMS may store 35.1 instead of 35. (LUM-7315)
  • When you modify a preset value or localization rule in the Datapoint Properties, click the Refresh button in the upper right of the Datapoint Browser to activate the change. (LUM-7145)
  • In some cases, connections to BACnet devices do not function correctly. (AP-5906)

...

  • You cannot change the host name for a SmartServer from the default.  Each SmartServer has a unique hostname printed on the bottom label.  Some operations will fail if you change the host name. (AP-6914, AP-7470)
  • The SmartServer requires free space on the SD card for normal operation and requires logged data to be less than 8 GB.  For optimal performance, keep logged data below 100 MB.  The SmartServer includes a 32 GB SD card.  You can run out of free space on the SD card if you create many backups or retain too much data in the data log, and performance will degrade if the storage for logged data exceeds 100 MB, and will degrade significantly if the storage for logged data exceeds 8 GB.  The Datapoint Properties widget displays an estimate of how much SD card space will be required for logged data based on your data log configuration.  You can use this value to manage the space required for data logs and keep the size below 100 MB for best performance, or keep the size below 8 GB for acceptable performance.  If required, you can free up space on the SD card by deleting backups.  To delete backups from the SD card, see Managing Backup Files on the SmartServer SD Card. (LUM-7271)
  • If you update your SmartServer from the CMS, the update may fail if you have a large amount of data log data on your SD card.  Backup your SmartServer before doing an update.  If the update fails, re-image your SmartServer from the console interface as described in Updating with the SmartServer Console. (LUM-6493)
  • The Devices widget Test command may sometimes return an incorrect result for BACnet or Modbus devices. (AP-6239)
  • The order of datapoints in the Datapoint Browser sometimes changes.  Verify you have the correct datapoint before changing a datapoint value. (LUM-7376)
  • In some cases, the CMS displays stale datapoint values and context information.  If a datapoint value or context is not displayed as you expect, refresh your browser window (Ctrl-F5 in many browsers). (LUM-7370, LUM-7107, LUM-7104)
  • If all the widgets in the CMS disappear from you CMS dashboard, click any widget name in the list of widgets on the left side of the dashboard. (LUM-7324)
  • When you edit a preset value in Datapoint Properties with a localization rule, the saved value may be slightly different than the value you entered. For example, if you enter 35 for a preset value, the saved value may be 35.1. (LUM-7315)
  • When you modify a preset value or localization rule in the Datapoint Properties, click the Refresh button in the upper right of the Datapoint Browser to activate the change. (LUM-7145)
  • In some cases, connections to BACnet devices do not function correctly. (AP-5906)

...