Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
This document is written for and on behalf of Schneider Electric and is supplied on the express terms
that it is to be treated as confidential and that it may not be copied, used or disclosed to others except
as authorized in writing by this Company. This document is intended for internal use only.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 1 of 48 Company Confidential
Table of contents
1. Introduction ........................................................................................................................................................ 4
1.1 Change History .................................................................................................................................... 4
2. StruxureWare Building Operation Release v1.8.1 Availability ............................................................................ 5
3. New Features in StruxureWare Building Operation Release v1.8.1................................................................... 6
3.1 General enhancements ....................................................................................................................... 6
3.1.1 Notification object modifications .............................................................................................. 6
3.1.2 Notification report template ..................................................................................................... 6
3.1.3 Alarm modifications ................................................................................................................. 6
3.1.4 Trend modifications ................................................................................................................. 6
3.2 -B (New in v1.8.1) ........................................................................................... 7
3.3 WebStation Enhancements ................................................................................................................. 7
3.3.1 Alarm Filter enhancements ..................................................................................................... 7
3.3.2 New Property grid ................................................................................................................... 7
3.3.3 Xenta Central Time Schedules................................................................................................ 7
3.3.4 Xenta Time Schedules ............................................................................................................ 7
3.4 Graphics .............................................................................................................................................. 8
3.4.1 Shared Graphics ..................................................................................................................... 8
3.4.2 View and Console objects ....................................................................................................... 8
3.4.3 Enable Pan and Zoom ............................................................................................................ 8
3.5 WorkStation Enhancements ................................................................................................................ 8
3.5.1 A faster Binding View .............................................................................................................. 8
3.5.2 Event modifications ................................................................................................................. 8
3.5.3 Trend modifications ................................................................................................................. 8
3.5.4 User Interface modifications .................................................................................................... 8
3.6 Cybersecurity Hardening ..................................................................................................................... 9
3.6.1 Document policy...................................................................................................................... 9
3.7 Backup / Restore and Upgrade (New in v1.8.1) .................................................................................. 9
3.7.1 Validate backup sets ............................................................................................................... 9
3.8 Assorted BACnet Improvements.......................................................................................................... 9
3.8.1 ReadRange service for all List type properties ........................................................................ 9
3.8.2 New TimeSynch properties ..................................................................................................... 9
3.8.3 New Deadband property to the Loop object ............................................................................ 10
3.8.4 New error codes in accordance with the BACnet standard ..................................................... 10
3.8.5 New Reliability enumeration to Reliability properties ............................................................... 10
3.9 Lon Enhancements .............................................................................................................................. 10
3.9.1 Updated Lon object model ...................................................................................................... 10
3.9.2 Delete obsolete Lon objects after upgrade to v1.8.1 (New in v1.8.1) ...................................... 10
3.9.3 Validate Lon bindings on Size ................................................................................................. 10
3.9.4 Symbolic constants for LonMark defined values ..................................................................... 11
3.9.5 Scan network for Lon devices ................................................................................................. 11
3.9.6 Change the default Lon binding profile (New in v1.8.1)........................................................... 11
3.10 Modbus Enhancements ....................................................................................................................... 11
3.11 TAC I/A Series MNB Controller Programmability ................................................................................. 11
3.12 Sigma Enhancements.......................................................................................................................... 11
3.13 TAC I/NET Enhancements .................................................................................................................. 11
3.13.1 Additional TAC I/NET Point Extension Support ....................................................................... 11
3.13.2 Application Specific Controller (ASC) Support ........................................................................ 12
3.14 SmartDrivers ........................................................................................................................................ 12
3.15 NETWORK 8000 PEM1 Overrides ...................................................................................................... 12
3.16 Andover Continuum b3 Conversion Program ...................................................................................... 13
3.17 Reports ................................................................................................................................................ 13
4. Defects Fixed in StruxureWare Building Operation Release v1.8.1 ................................................................... 14
5. Known Defects in StruxureWare Building Operation Release v1.8.1 ................................................................. 26
6. Important Engineering Information ..................................................................................................................... 36
6.1 General Engineering ............................................................................................................................ 36
6.2 WebStation .......................................................................................................................................... 37
6.2.1 Graphics Viewer ...................................................................................................................... 37
6.2.2 Workspace and Panels ........................................................................................................... 37
6.2.3 General information ................................................................................................................. 37
6.3 Graphics .............................................................................................................................................. 37
6.4 LonWorks ............................................................................................................................................ 38
6.5 b3 Devices ........................................................................................................................................... 39
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 2 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 3 of 48 Company Confidential
1. Introduction
The StruxureWare™ Building Operation Release v1.8.1 Release Notes document includes
information about the new release as well as some general information about the StruxureWare
Building Operation products. The general information can be found in the numerous APPENDIX
sections.
Release v1.8.1 allows a user to upgrade a v1.7.y.xx system. Runtime compatibility is only
provided between v1.7.1.xxx, v1.7.0, and v1.8.1. Prior to accomplishing any upgrade, refer to the
upgrade documentation.
Release v1.8.1 of StruxureWare Building Operation provides many new features for the user.
Among them are:
Support for the new SmartX Controller AS-B (Automation Server - Bundled)
Notification object redesign
Introduction of Shared Graphics
Remodeled and improved LON operation
Performance improvements in BACnet
Cybersecurity hardening
TAC I/A Series™ BACnet controller programmability
Introduction of SmartDrivers
These major modifications and more are described in greater detail in Section 3. All features that
are new in v1.8.1 and were not in v1.8.0 RC area tagged with (New in v1.8.1) in the section
header.
It is imperative that any upgrades be accomplished only after reading and understanding this
document, especially those areas that are related to the upgrade process.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 4 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 5 of 48 Company Confidential
Write to file notifications are now available in the system tree and can be reached and managed in
WorkStation.
There is also a new type of Notification, called the Variable Triggered Notification. The variable
Triggered Notification allows a binary variable, e.g. a Digital Schedule or a digital value object, to
trigger a Notification. It is also possible to trigger any Notification manually by using a context menu
command.
It is now possible to configure the number of decimals and the date format in the notification. Default
number of decimals is 2.
When using Email as distribution method in your Notifications, there is now support for encrypted
email messages, TLS and SSL.
The template concept is very flexible. Since it is based on plain text, the advanced user can structure
the template as any plain text format such as xml or html. In order to deliver good results, all of the
user documentation should be read carefully.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 6 of 48 Company Confidential
AS-B is a new Smartstruxure Server device. For total installed cost reduction it has power supply and
highly flexible I/O built-in with overall functionality that is very similar to other SmartStruxure server
devices.
The As-B requires a slightly different method to enter DFU mode that is required by other
SmartStruxure server devices. The procedure is as follows:
Refer to specific release information from The Exchange for detailed AS-B
information, such as:
PA-00476 SmartX -B
uc -B
Release Note for AS-B
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 7 of 48 Company Confidential
3.4 Graphics
3.4.1 Shared Graphics
We have w p “ G p c ”, w c “ G p c ” T
Vista. You can now have multiple instances of a TGML Graphic and when the user has chosen to
“ b yp ” c G p c will be updated whenever the TGML is edited and
saved. Bindings are unique to each instance which makes it possible to reuse the TGML Graphics
and bind the instances to different variables.
N w c c w y u c py G p c bj c , bu u u “ b red
yp ” “ ”b v .T c v b c x uu v c .I
you want to copy existing bindings when you create a new instance (copy the Graphics), use the
“ p c ”c .
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 8 of 48 Company Confidential
Local backup on a standalone server. The validation will take place on the server and a
system alarm will be raised if a corrupt backup set is identified.
Local backup on a sub-server. The validation will take place on the sub-server. The backup
set will also be validated on the Enterprise Server before it is stored there. A system alarm will
be raised if a corrupt backup set is identified during validation.
Restore on a standalone server. The validation will take place on the server and a system
alarm will be raised if a corrupt backup set is identified.
Restore on a standalone server from a backup set stored on the computer file system. The
validation will take place on the server, during the restore process. A system alarm will be
raised if a corrupt backup set is identified during validation.
Restore on a sub-server. The validation will take place on the server and a system alarm will
be raised if a corrupt backup set is identified.
Restore on a sub-server from a backup set stored on the computer file system. The validation
will first be done when the backup set is imported. The second validation will take place on
the server, during the restore process. A system alarm will be raised if a corrupt backup set is
identified during validation.
Restore configurations with new IDs. Same validation strategy as Restore.
Add new sub-server, based on a backup set. Same validation strategy as Restore on a sub-
server.
Upgrade of sub-server using Device Administrator. The validation will take place in the Device
Administrator. A message box will be showed if a corrupt backup set is identified. Additional
information will also be recorded in the upgrade log.
When backup sets are purged on ES. A validation of the backup set structure will be done
each time the Enterprise Server purge the archive to store a new backup set. This is not a full
validation, just the structure. A system alarm will be raised if a corrupt backup set is identified
during validation and the corrupt backup set will be deleted.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 9 of 48 Company Confidential
As a result of the changes to the Lon model, other changes are required to update path dependent
internal functions if they reference LonWorks network variable fields. Check and update your saved
searches, saved watches and binding templates.
The structure in v1.7 and earlier:
.../SNVT/Member1/Value
The structure in v1.8:
.../SNVT/Value.Member1
After the upgrade to version 1.8 you also need to update external utilities that either generate
structured LonWorks network variables to the system or collect structured LonWorks network
variables from the system. Examples of external utilities are EWS, Expert Tool or other transition tools
using the WorkStation transition SDK.
3.9.2 Delete obsolete Lon objects after upgrade to v1.8.1 (New in v1.8.1)
During the upgrade process from version 1.7.1 to v1.8.x all servers, hosting Lon networks using
LonWorks imported Lon device templates (.XIF) or Lon resource kits (.DRF), need to keep objects
representing references between servers in both the "old" Lon format and in the updated format. This
is done to support runtime compatibility during upgrade, when servers in a multi server system is
temporarily running different versions. When the upgrade is completed and an internal "reference
synchronization" is done, the now obsolete objects can be deleted. The "reference synchronization"
can take all from a couple of minutes, up to a couple of hours, depending on how many servers and
how many bindings there are in the system.
The Delete obsolete Lon objects command is found in the Actions menu when the server object is
selected. If the command is launched from the enterprise server (ES), all servers in the multi server
system will be handled. It is possible to launch the command logged on to each sub-server
separately. If so, make sure all servers have been updated to 1.8.1 before you launch the command,
or you may break references (bindings) between servers.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 10 of 48 Company Confidential
Note! NaN, Infinity and -Infinity are localized values and different for other languages.
Bit mask can only be used with 16 bit unsigned register type and any other register type
causes an error to be shown to the user when the changes are saved. Originally reported in
defect 28885.
Create, import, and edit I/A Series MNB applications in SBO WorkPlace Tech Editor
Assign I/A Series applications to MNB devices in SBO WorkStation
Download I/A Series applications to MNB controllers in SBO WorkStation
p c , , , MNB v c c “ u ”
Controllers supported: MNB-70, MNB-V1,MNB-V2, MNB-300, MNB-1000
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 11 of 48 Company Confidential
Consumption (CN)
These extensions can now be added, deleted, and modified directly within StruxureWare Building
Operation.
ASC Parameters
You now have the ability to upload ASC parameters into StruxureWare Building Operation.
You can then view and modify the parameters settings without having to use the legacy I/NET
product.
3.14 SmartDrivers
With the release of v1.8.1 StruxureWare Building Operation will introduce SmartDrivers.
SmartDrivers w“ v ” b p y , u p v SmartX
Controller - AS-P. SmartDrivers is only available on the Enterprise Server and AS-P.
A driver is a component that can be added after installation of the server software. Drivers are
typically developed to communicate with proprietary third party systems that are not natively
supported by StruxureWare Building Operation. An example of such a third party system is a fire
monitoring system.
Data in the third party system is realized in StruxureWare Building Operation by the creation of
SmartDriver Interfaces, Devices, Points and Values. This very similar to how Modbus registers are
realized.
A maximum of two SmartDriver Interfaces are to be created on an Enterprise Server and AS-P.
In order to be able to deploy drivers to the Enterprise Server and AS-P, SmartDrivers must be
enabled in Security Settings. By default deploy of drivers is disabled in all servers.
For the v1.8.1 release, development of drivers is being restricted to a single team.
ASD session security is now handled with authentication properties stored in the Network 8000
Interface object. The default values of the these authentication properties are the same as the default
values that were in a GCM or in the ASD controllers. This means no changes will need to be made
unless your controllers have non-default username or password. In that case simply update the
authentication in the interface and save it.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 12 of 48 Company Confidential
3.17 Reports
StruxureWare Building Operation v1.8.1 introduces a new Installer package for Building Operation
WebReports installation. Outlined below are the highlights of the new installer:
System check, Enterprise Server configuration, and SQL configuration are taken care of by
the new installer.
o The System Check determines if the recommended Operating System, Internet
Information Services, and required disk space are available.
o The Enterprise Server configuration checks if the communication is established
between Report Server and Enterprise Server.
o Using the SQL Server page, you can select the existing instance of SQL to create
Reports database. WebReports Installer detects all the existing instances of SQL
installed in the local machine.
o The SQL Configuration checks if Reports database, Reporting services, User
permissions, and scripts are configured and executed correctly. If configuration of any
of the components fail, you can correct the error and start the configuration again.
Improved uninstallation process. Uninstalling WebReports does not remove the Reports
database.
The upgrade process is simple and efficient.
Now supported on Windows 7 Professional (32 or 64 bit)
Now supported on Windows 8 Pro (64 bit)
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 13 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 14 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 15 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 16 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 17 of 48 Company Confidential
16994927,2155
27576 LonWorks/Xenta Import of XIF file just stops, no error messages 5455
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 18 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 19 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 20 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 21 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 22 of 48 Company Confidential
30435 Upgrade AS fail to upgrade if the server name starts with - 25440367
(hyphen)
SBO AS with a Russian Name cannot be 25204314
30543
Upgrade upgraded to 1.7.1.89 over a network.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 23 of 48 Company Confidential
27530509,2736
31264 Upgrade Pre-upgrade add-on error WorkStation crash 9696
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 24 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 25 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 26 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 27 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 28 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 29 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 30 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 31 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 32 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 33 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 34 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 35 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 36 of 48 Company Confidential
u “W u ID p w ” W k
will be restarted. The message is somewhat benign since the actual operation
started by the user will be successfully completed by the server.
Resource limitations to consider during engineering
When designing and engineering a system, make sure not to over-engineer a
server. Make sure to follow stated engineering guidelines and do not add, for
example, too many trend logs in an AS where resources are the most limited.
Adding too much content and logs can cause performance reduction and even a
crashed server if disk ends up being full. Reference the Architectural Guidelines
from The Exchange for further information.
Uninstall one of many versions of SBO WorkStation
If you have many versions of SBO WorkStation and uninstall one of the versions,
y u “R p ” remaining installations in order for external editors
(Graphic, Function Block Program, Script) to work properly.
PCS and LON
In order to configure and deploy your configuration properties for your LON-
devices in PCS 1.8, you need to use a LNS-plugin. If you change a configuration
property outside the LNS-plugin, then that value will not be deployed. Instead
only the default value is deployed.
6.2 WebStation
6.2.1 Graphics Viewer
Global variables that are already defined in IE, Firefox and Chrome will not work.
Example: top,x,y, width, height
Functions are called that actually are properties shows a script error.
Example: array.length() instead of array.length
Scripts that do 'drag' need to call preventDefault() on mousedown. This disables
standard touch/drag panoration
Use of java classes is unsupported.
Please use 'var' when declaring variables inside your TGMLscripts instead of assigning
global variables. This enables you to use global scripts (UseGlobalScripts flag in TGML
root element) that make it possible to share functions between Script nodes. Having
UseGlobalScripts set to True will also improve performance substantially in
WebStation. See section 6.3.
There is a simple tool in the Statistics tab of the Graphics Editor that will tell you if your
image has some of these commons issues.
6.2.2 Workspace and Panels
The use of toolbars in WebStation is restricted. The Statusbar, Historybar and
Addressbar have no effect in WebStation. Hidden and Not available have the same
results (Hidden).
6.2.3 General information
Status overlays on the icons in the System tree are not available in WebStation.
6.3 Graphics
The JavaScript engine in the Graphics Editor and WorkStation has been updated in this
release. This has a number of advantages; bugs fixed, better performance, stronger
compliance with the JavaScript standard and better compatibility with the JavaScript
engines that are used by web browsers. The stronger compliance with the standard
may result in compatibility issues with JavaScript code written in older versions of
StruxureWare Building Operation. The old version was sometimes more forgiving when
running JavaScripts that were not written correctly.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 37 of 48 Company Confidential
By default, each Script element (script block) creates a JavaScript context. In this
mode, function calls between script blocks (contexts) are not supported, that is, no
support for global script functions. It is possible to enable scripts to run in one single
context for the whole graphic so that functions and variables can be shared between
script blocks, by setting the TGML element property UseGlobalScripts in the Graphics
Editor to True. The default is False for backward compatibility reasons. Setting
UseGlobalScripts to True has a very positive effect on graphics loading performance in
some of the viewers, depending on technology used.
In order to improve performance in the WorkStation Graphics Viewer the behavior of
links has been changed. Before, when a graphic was shown, all links were validated to
find out if they were resolved or not. This took some time. Now the link is not validated
until the user clicks on it.
W TGML p c , c “ v ” v TGML
t , “ v ” bu w b b w b p b v
changes to StruxureWare Building Operation. If the desire is to save a copy to file, then
u c xp “ v ”.
6.4 LonWorks
When creating folders beneath a LonWorks Network, naming is more restrictive than
other StruxureWare Building Operation names. The name is restricted to 20 characters
with no minus sign.
When a LON binding is created to a CPT, the delta is displayed as a property, but there
will be no effect if the user changes this delta. Consequently, the CPT will be written to
even on changes that are less than the entered delta. As a workaround, the user can
create a StruxureWare Building Operation binding to allow for adjustable polling
properties.
When the Local Node is imported, it is necessary to perform a commission on the node
order to activate the bindings.
u y ’ p b up w BO, up
mainly used for navigation from Xenta OP. Due to prioritizations this function is
postponed to a later version. The workaround is to remove, rename and re-
commissioning the network.
To view network variables and configuration parameters in WorkStation select the
Variable Fields tab in Properties.
To edit properties of a Network Variable (NV) in WebStation, simply left click on the NV
in the System Tree and the property grid is displayed. Alternatively, right click the NV in
the System Tree and select Properties and a Property Dialog is displayed. The Variable
Fields tab contain the values of the NV.
After the upgrade to version 1.8 you need to manually update some path dependent
internal functions if they reference LonWorks network variable fields. Check and update
your saved searches, saved watches and binding templates.
The structure in 1.7 and earlier:
.../SNVT/Member1/Value
The structure in 1.8:
.../SNVT/Value.Member1
After the upgrade to version 1.8 you also need to manually update external utilities that
either generates structured LonWorks network variables to the system or collect
structured LonWorks network variables from the system. Examples of external utilities
are EWS, Expert Tool or other transition tools using the WorkStation transition SDK.
If a Xenta 401 device has an overall high load, with a large application program and
many trend logs, the following settings of the device Non-group receive timer are
recommended:
768 ms, if the number of Network Variables <=50
1024 ms if 50 < the number of Network Variables <=100
1536 ms if the number of Network Variables > 100
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 38 of 48 Company Confidential
6.5 b3 Devices
When selecting and downloading from the application folder, it is necessary to select
and download in the appropriate order to satisfy all of the referencing accomplished in
the bindings. Downloading the entire device avoids this type of problem.
When creating BACnet schedules, it is important to add those items to be controlled by
the schedule to the Object Property Reference List and NOT to use the binding tool to
bind c u ’ v u .
In order for extended log data to capture b3 log data successfully, they must be
configured in a very specific way: a) Smart Logs = False b) The intrinsic b3 logs must
be evenly divisible by the maximum transfer interval of the ETL Reference on The
Exchange Knowledgebase.
Defect 30806 causes script programs that are triggered by system variables to continue
to be triggered even when the trigger is removed. To stop the trigger, it is necessary to
delete and recreate the program.
D c 31329 p v b y u “ v ”w
Script Editor from functioning correctly. The problem is fixed in 1.9, To work around the
problem while operating in1.8, import the Plain English code into a 1.7 or earlier
system, convert into Script syntax and use the Building Operation export function to
save it for 1.8 projects.
6.6 Trends
When a COV trend log is created in an Automation Server to monitor an object from a
field bus device, attention should be given to the capability of the field device. If the field
device supports COV, as many BACnet devices do, then the BACnet device will supply
the Automation Server with data via COV, but it will do so at an interval that
corresponds to the devices interval not to the delta as established by the trend log. If
the device does not support COV, then the trend will function as a polling trend with an
interval of 500ms. In those cases, users should create an interval log to avoid
unnecessary field bus communication.
In order for extended log data to capture b3 log data successfully, they must be
configured in a very specific way: a) Smart Logs = False b) The intrinsic b3 logs must
be evenly divisible by the maximum transfer interval of the ETL Reference on The
Exchange Knowledgebase.
Each SmartStruxure server in an installation has two properties relating to trend logs:
Trend storage capacity and Trend storage usage. Whenever the usage exceeds the
capacity, a system alarm will be generated. There is also an indication whenever a
trend log of any type is created of how many records the new log will consume and
what the available storage is.
Previous versions of the Architectural Guidelines contained erroneous information
concerning BACnet trend logs. All SmartStruxure server devices have a limit of BACnet
trend log size limit of 1,000 records. The 1.8.1 Architectural Guidelines have been
updated to include this limit.
Several defects were resolved in 1.8.1 to eliminate the likelihood of a corrupt database.
In the course of resolving the defects, it was found that the likelihood of database
corruption increases dramatically as the quantity and frequency of trending increases. If
you are logging more than 300 trend logs per hour (and that could be any interval /
CoV) then you are in much greater risk of the database write error occurring. The
problems are mitigated by upgrading, but, until a site is upgraded it is wise to be
reasonable in the amount of trending that is done at the AS.
6.7 Archiving
When archiving using the CSV format, the maximum size limit for the archive will be 65,536,
which is the maximum allowed in an Excel spreadsheet.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 39 of 48 Company Confidential
6.9 Reports
I yp ‘I ’ HTT p v URL y.
The user account used for connection with the Enterprise Server should be a part of
‘R p ’ up.
If Enterprise Server is renamed, after collecting few events, and Reports Server is
installed at this time, then the first event details with the new server name (i.e. first
sequence number associated with the new server name) should be manually entered
into the tbEvents table to make the agent collect events data successfully.
If Enterprise Server is generating around 2500000 ETLog records per day then the
maxHistoricalReadcount in reporting agent config file should be modified to 250000
6.10 Authentication
If the Enterprise Server is offline when logging on to an Automation Server there is only
one log on attempt. If that attempt is failed a timer is started which will not allow any log
on attempts until 2 minutes have passed.
When setting up a site with a Windows Active Directory, make sure the Enterprise
Server is running with rights to read at least those AD-groups that are intended to be
used for authentication via SBO.
6.11 Schedules
In order to accommodate as many resolution settings as possible for the graphic
display of the WorkStation Schedule editor, it was decided that the smallest event
duration for that editor would be 5 minutes. If an event duration of less than 5 minutes is
desired, the user is directed to use either the text editor that is located on the Advanced
tab of the graphical schedule editor or to use WebStation.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 40 of 48 Company Confidential
6.14 BACnet
Defect 30015 was fixed and this affected the operation of a BBMD during an upgrade. SBO
servers whose BBMD Distribution Table (BDT) is taught, lose a BDT entry during upgrade and
hosted BACnet devices may become offline. The fix prepared in v1.8 fixes the teach operation,
such that after a teach, the first entry will refer to the local server's address, and not be dropped
during upgrade (avoiding corruption of the BBMD table). However, in prior versions (v1.6 or
v1.7) a teach will produce a BDT table which becomes corrupt during upgrade. To fix the
problem in v1.8, the user must delete the corrupted BDT tables (in SBO WorkStation), and then
redo the BBMD Teach operation to restore all BBMDs.
6.15 Search
If a saved Search-object from previous versions, has contained a type that no longer exist in the
server, e.g. an E-mail-notification that is converted to an Alarm Triggered Notification, then the
search operation will not find any object in v1.8 and need to be manually re-configured in order
to present the expected result.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 41 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 42 of 48 Company Confidential
1. Many problems arise when the Enterprise Server and Automation Servers are renamed.
Consequently, it is only possible to rename a server when no connection exists between the
Enterprise Server and any Automation Server or vice versa. The Enterprise Server must be
named first and the Automation Servers are named at the time of adding them as child
servers to the Enterprise Server. Do not attempt to restore a backup file that was generated
when the server had a different name. Once a server has been given a name, it should be
backed up for future protection.
2. Some elements of the system will occasionally fail to remove the temporary files that are
created on the WorkStation PC. Consequently, it is prudent to check the Temp directory and
accomplish deletions manually. This should be accomplished when WorkStation is not
running.
3. Occasionally, trend objects may look empty, but retain values in the List View. This can
happen if a Xenta device has been reused without emptying it first.
4. It is not possible to move a folder that contains a LON device from one Network to another.
5. When upgrading an Automation Server, the Device Administrator will indicate the upgrade
has completed successfully before it is actually possible to log on. The time difference can be
quite long for a large size database.
6. When two engineers are simultaneously editing the same program (Function Block or Script)
or using WorkPlace Tech Editor, they will have no idea that someone else may be editing the
same object. The final save of the object in question will be the final copy that is in the server.
7. Alarm polling for an alarmed object on a LON device will continue to take place even if the
alarm shunt has been activated.
8. Alarms in the Reset state will be removed from the active alarm list if the Enterprise Server
abruptly loses power.
9. TAC I/A Series text reports do not function in the WebStation.
10. If a binding name is changed in the graphics or script editor, any binding that might exist for
that component is removed.
11. If a value is displayed in the spreadsheet view with localized units, then any copying of that
value to another location will also copy the localized units.
12. When a hot fix is applied, the true revision number can only be found from the properties of
the Automation Server as viewed from the WorkStation.
13. When working with Schedules on Xenta devices, it is p b “ v - ” v
“D y W k” xc p c y u M .
14. In some instances, when the Enterprise Server and License Server are on the same PC, the
Enterprise Server may attempt to start before the license server has successfully started. It
may be possible to delay the starting of the Enterprise Server using a batch file.
15. An event view can only show 6000 entries. If there are entries that are older than 6000
entries, a filter will need to be created that allow the entries of interest to be included in the
view.
16. I ’ p b v w MNB v c by p y c ck bu
WorkStation while the BACnet application folder of an MNB device is shown in the list view.
When this occurs, values from the MNB device will stop updating for several minutes and
then return to normal. To avoid the problem do not click the refresh button in the list view.
Values in the list view update automatically without the need to refresh.
17. It is possible to fill the disk of an Automation Server and cause it to crash by setting Log sizes
over the maximums stated in the Architectural Guidelines. Refer to the third bullet in Section
6.6.
18. Due to changes that were made in several areas of the Linux server operation, there are
more frequent spikes to the CPU utilization percentage. The average CPU utilization is not
substantially increased but there will be spikes that could generate false alarms if alarms are
attached to the CPU percentage. It is recommended that CPU percentage alarms include a
time delay of at least 60 seconds.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 43 of 48 Company Confidential
9. APPENDIX C – Procedures
9.1 Installing
For installation of StruxureWare Building Operation v1.8.1 WorkStation, Enterprise Server,
or Report Server, please reference the Web Help for that topic.
Note: The new SmartX Controller - AS-B product and SmartX Controller - AS-P will be
shipped from the factory with no SBO operating system. When the software (v1.8.1 or later)
is downloaded and Device Administrator is run, there will be an option to select either New
Database or Upgrade Database. New Database is the only option that will work, since there
is no database to upgrade.
9.2 Upgrading
9.2.1 General Upgrade Information
IMPORTANT: Sites using LonWorks Externally Managed Network together with
Stibil specific network variables in the Local Node should not upgrade to 1.8.1RC.
The network variable values in the Local Node will be wrong and applications such
as Function Block or Script will not execute correctly. The problem will be fixed in
SBO v1.8.1.
IMPORTANT – Depending upon the size of the system and the quantity of trends, it
is possible that the database on the Enterprise Server could be quite large. When
upgrading, always make certain that you have at least twice as much disk space
available as the size of your database. It should also be expected that the
p v y pp “ ” uc 20 30 minutes upon the first
initial start up after the upgrade, but only on the first start.
If ES-up w “-4”, w v
problem. See known defect 30772.
Note - CPU-load can be high some minutes in the AS after upgrade to v1.8
depending on how large historical db there is.
Note – When upgrading Automation Servers, it is much faster to upgrade via the
network (IP) rather than via USB. Automation Server will upgrade in a two-stage
process where the first step copies the backup file from the Automation Server to
the PC running Device Administrator and completes all of the necessary activities
to upgrade the database. During this time, the Automation Server will remain
operational. Once the database upgrade has been completed, the user must
choose to deploy the new database. During the deployment period the Automation
Server will not be operational from a controls perspective.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 44 of 48 Company Confidential
Important - The upgrade process is sequential, for example, v1.1 to v1.2 to v1.3,
v1.4, etc. There will be runtime compatibility between Revision 1.7 and v1.8.
It is also possible to prepare each server individually by running the command logged
on to each server separately. The command can be launched multiple times, in any
order, at any time, as long as the server is running version 1.7.1/1.7.2. Not all servers
have to prepared at the same time. If you for some reason decide to upgrade your
installation step by step, you can prepare the servers one at a time.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 45 of 48 Company Confidential
9.2.3 Delete obsolete objects after upgrading a System with LON devices
During the upgrade process from version 1.7.1 to 1.8.x all servers, hosting Lon
networks using LonWorks imported Lon device templates (.XIF) or Lon resource kits
(.DRF), need to keep objects representing references between servers in both the
"old" Lon format and in the updated format. This is done to support runtime
compatibility during upgrade, when servers in a multi server system are temporarily
running different versions. When the upgrade is completed and an internal "reference
synchronization" is done, the now obsolete objects can be deleted. The "reference
synchronization" can take all from a couple of minutes, up to a couple of hours,
depending on how many servers and how many bindings there are in the system.
The Delete obsolete Lon objects command is found in the Actions menu when the
server object is selected. If the command is launched from the enterprise server (ES),
all servers in the multi server system will be handled. It is possible to launch the
command logged on to each sub-server separately. If so, make sure all servers have
been updated to 1.8.1 before you launch the command, or you may break references
(bindings) between servers.
9.2.4 Update objects and tools that use path based Lon references
As a result of the changes to the Lon model, other changes are required to update
path dependent internal functions if they reference LonWorks network variable fields.
Check and update your saved searches, saved watches and binding templates.
The structure in 1.7 and earlier:
.../SNVT/Member1/Value
The structure in 1.8:
.../SNVT/Value.Member1
After the upgrade to version 1.8 you also need to update external utilities that either
generate structured LonWorks network variables to the system or collect structured
LonWorks network variables from the system. Examples of external utilities are EWS,
Expert Tool or other transition tools using the WorkStation transition SDK.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 46 of 48 Company Confidential
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 47 of 48 Company Confidential
9.3 Commissioning
1. In order to maximize the productivity of multiple engineers, it is best for each engineer to
work on one individual StruxureWare Building Operation Server. Allocate one engineer to
work on each Automation Server and then after the Automation Server devices are
approaching completion, they can be added as children to the Enterprise Server and the
necessary binding can be accomplished. It is possible that, when the Automation Server is
first added to the system and multiple Extended Logs are created at the Enterprise Server
which point to logs in the Automation Server, there will be a slowdown in the Enterprise
Server until the log updates are completed. Once an Automation Server has been added
beneath an Enterprise Server, it is still recommended that multiple engineers be
accommodated by logging directly into separate Automation Servers rather than the
Enterprise Server.
2. As in all software activity, frequent backups should be made. Perform backups when the
system is either unused or very lightly used.
3. As part of the regular system monitoring and maintenance plan, it is recommended that
Automation Server CPU usage and memory usage be monitored with alarms that trigger if
either item is at an excessively high level for a period of time. You can determine the
appropriate trigger values after configuring the system and validating normal operation. If
the alarms become active, evaluate your system storage and usage and if it cannot be
explained, then contact PSS to determine what might be at the root cause and how the
situation can be resolved
4. Be vigilant about closing unused panes, panels, tabs, etc.
Schneider Electric Boston ONE Campus, 800 Federal Street, Andover, MA 01810 Telephone +1 978-794-0800 www.schneider-electric.com
RN_SBO_v1.8.1 06072016 Page 48 of 48 Company Confidential