Building Automation Knowledge Base

Issue Cannot change the IP address or host a SpaceLogic IP device, MP or RP controllers, or IP-IO modules in a second EBO Server. Product Line EcoStruxure Building Operation Environment IP address BACnet Building Operation Multi-purpose Controller Building Operation Multi-purpose VAV Building Operation Room Controller  Building Operation IP-IO Building Commission Application Cause 1. IP settings are saved (eg in Building Commission), but the IP address of the Controller does not change. (Option to change most settings is grayed out from Building Commission for hosted SpaceLogic IP devices) 2. The Controller is already hosted by an EBO server and cannot be hosted by a second EBO server, thus data objects cannot be read. 3. Rehosting an SpaceLogic IP device to a different EBO server Resolution 1. Changing the IP address "settings" can be done with Building Commission application, formely know as eCommission Tool, in some earlier versions but if the SpaceLogic IP device, formely known as SmartX IP device, is already fully hosted by an EBO Server, then a warm start from the Building Commission is inhibited. (Option to change most settings is grayed out from Building Commission for hosted SpaceLogic IP devices) Without the hosting Server initiated warm start the new IP setting will not be used. If the SpaceLogic IP device is not hosted then the IP address can be changed from the Building Commission, using the warm start option. Notes A local warm start initiated at the SpaceLogic IP device(manually with the reset button) will not force the SpaceLogic IP device to use these new settings. See BACnet/IP Controller Commissioning Scenarios The IP address of a Hosted SpaceLogic IP device cannot be modified from eCommission Tool A factory reset will force the SpaceLogic IP device to return to AutoIP and DHCP, the BACnet Id will generally be retained see Automatic Association after a Factory Reset in a BACnet Controller or IO Module 2. When a SpaceLogic IP device is fully hosted by an EBO Server, it can be BACnet hosted by a second EBO Server, but this will only contain the standard BACnet Applications folder. This hosted BACnet Device needs to be manually created using the SpaceLogic IP device instance Id.  Below, it can be seen that the fully hosted SpaceLogic IP device and the BACnet only hosting under ASP_22   3. When a SpaceLogic IP device is configured or programmed via the hosting EBO Serving using WorkStation, some of the objects (eg. Scripts or Function Block) data is not fully contained within the SpaceLogic IP device. Thus if the hosting EBO server is changed, some of the configuration data will be lost and a simple upload to the new hosting EBO Server will not upload all the data required to recreated these objects. In such a case, an export from the original hosting EBO Server should be imported into the new hosting EBO Server to ensure no data is lost.

Issue Alarms not received at the Enterprise Server Product Line EcoStruxure Building Operation, Satchwell BAS & Sigma Environment Sigma Transition Alarms Cause Alarms are being generated by the controller but do not appear at the Enterprise Server. Resolution If any changes are made to the Sigma system using the Sigma Server, then either all, or part of the Sigma configuration must be re-imported into the Building Operation Enterprise Server.

Issue Certificate for FDA regulations in the manufacturing of pharmaceuticals, 21 CFR Part 11 "Electronic Records / Electronic Signatures." Can Building Operation incorporate a comment section to capture a reason for change made by an operator/user? Product Line EcoStruxure Building Operation Environment EcoStruxure Building Operation Cause Building Operation site in need of the compliance certificate for 21 CFR Part 11 "Electronic Records / Electronic Signatures." Usually, these are pharmaceutical manufacturing sites, and the full FDA document PRT11Elect.pdf is attached to this article. Resolution EcoStruxure Building Operation 3.2 and higher Compliance Pack enables 21 CFR Part 11 compliance for regulated industries. The Compliance Pack is an add-on module to EcoStruxure Building to help regulated industries meet the compliance requirements for Electronic Signatures & Electronic Records that are in place in the region.   This feature in our EcoStruxure Building Operation software provides facility-wide accountability and traceability of the environmental conditions that can impact the quality and safety of products developed in controlled environments in line with the 21CFR Part 11 regulation.   Compliance Pack is a licensed feature and compatible with EcoStruxure Building Operation V3.2.1 and later. Part Number Description SXWSWCMPLPK001 Compliance Pack – includes TimescaleDB, Digital PDF Signing, Change Control, For one Enterprise Server or one Enterprise Central For technical documentation and sales enablement tools for the Compliance Pack, please visit The Exchange Building & Power Extranet and use the search keyword: 21cfr ebo   EcoStruxure Building Operation 3.1 and below EcoStruxure Building Operation V3.1 and below has not addressed the pharmaceutical market and there is no electronic signature feature set that meets the FDA regulations 21 CFR part 11.   For sales issues surrounding FDA regulations, please contact through your sales channel to the local Category Manager. Americas: Americas.EcoStruxureBuilding@schneider-electric.com EMEA: EMEA.EcoStruxureBuilding@schneider-electric.com Asia Pacific: AsiaPac.EcoStruxureBuilding@schneider-electric.com

Issue The 6 character PIN for the SmartXKiosk has been forgotten so the user cannot exit Kiosk mode Note the PIN is case sensitive Product Line EcoStruxure Building Operation Environment SmartXKiosk Advanced Display v1 Advanced Display v2 SmartX Controller Cause The 6 characters PIN for the SmartXKiosk has been forgotten or lost and the user cannot locate it. Resolution In order to reset your SmartXKiosk PIN, follow the steps below:   In the SmartXKiosk application, click on Exit Kiosk Mode in the bottom right corner of the screen. In the Exit Kiosk Mode window, click on Forgot PIN?. An 8 characters or 15 characters Session ID will be generated.  Take note of this Session ID.    Open a ticket with Support to request a SmartXKiosk PIN reset and provide them with the Session ID. Once Support sends you back the Recovery PIN, click Continue on the Session ID window. In the next window fill in the Session ID from step 2. and the Recovery PIN that Support has provided. Click Continue. You can now reset your PIN. Enter your new 6-digit PIN number and confirm it before clicking Submit. The PIN is case sensitive. It must be exactly 6 characters, otherwise an error will occur.  Important Note: The Session ID generated and the Recovery PIN provided to you by Support will expire at midnight on the day that the Session ID was generated.   Note: For Advanced Display v3 please see How to recover the password for Advanced Display version 3

Issue The address used to access the Generate Authentication URL up to and including PME 9.0 no longer works. Product Line EcoStruxure Building Operation Environment EcoStruxure Building Operation EcoStruxure Energy Expert (formerly Power Manager) EcoStruxure Power Monitoring Expert Cause Up to and including PME 9.0 the following address could always be used to access the 'Generate Authentication URL' page which allows a user to manually create urls/hyperlinks for specific PME pages (with and without authentication) to use in EBO: http://<yourservername>/SystemDataService/Auth/GenerateAuthURL .     However with the advent of PME2020 this address is no longer valid. Resolution The address for the 'Generate Authentication URL' page has changed in PME2020 and permission to access this new address must also be activated via a Query run on the SQL database of the PME2020 install. Page 1676 of the PME 2020 System Guide  - Manual integration steps without using the Integration Utility - shows the required steps and the new address to be used.

Issue What features are included in Building Operation evaluation (demo) licenses? Product Line EcoStruxure Building Operation Environment Building Operation evaluation license Cause The features included in evaluation licenses are not shown in the documentation. Resolution License Administrator (Software Evaluation License) After adding the evaluation license in License Administrator,   Click on the "Diagnostics" Tab. Click on "Refresh the list". Local licenses list generates. Example of generated list: Local licenses: -------------------------------------------------------------------- Trust Flags: FULLY TRUSTED Fulfillment Type: TRIAL Status: ENABLED Fulfillment ID: LOCAL_TRIAL_FID_498 Activation ID: SC_57LRIHRFBOXC28SGYTPKCH98WIRKMWE Product ID: NAME=EcoStruxure Building Operation Demo License;VERSION=5.0 Suite ID: NONE Expiration date: 01-Feb-2024 Concurrent: 0 Concurrent overdraft: 0 Hybrid: 0 Hybrid overdraft: 0 Activatable: 1 Activatable overdraft: 0 Repairs: 0 Feature line(s): server.mssql (Version 5.0) client.zoning (Version 5.0) client.dashboard (Version 5.0) server.ec.auth.saml (Version 5.0) server.ws.generic.consume (Version 5.0) server.dig.signed.docs (Version 5.0) server.alarms.snmp (Version 5.0) server.ec.es (Version 5.0) server.device.es (Version 5.0) server.ws.ews.history (Version 5.0) Sigma.Server (Version 4) server.mqtt.rw (Version 5.0) graphdb.base (Version 1.0) server.esignature (Version 5.0) server.enterprise.base (Version 5.0) server.ws.ews.consume (Version 5.0) client.cad.import.tool (Version 5.0) smartdriver.license (Version 5.0) server.timescale (Version 5.0) client.script (Version 5.0) server.es.as (Version 5.0) client.graphiceditor (Version 5.0) server.device.as (Version 5.0) server.ws.ews.serve (Version 5.0) server.es.auth.saml (Version 5.0) server.enterprise.central (Version 5.0) client.functionblock.view (Version 5.0) client.station (Version 5.0)   Refer to the Webhelp EcoStruxure Building Operation Software Feature License String Description topic for an explanation of the license feature strings. Device Administrator (Embedded Evaluation License) After adding the evaluation license to the Device Administrator (see the article How to activate a demo license on an Automation Server at EBO 2022) follow the steps to view the available features: Click on the Entitlements. Click on Product Licenses. - The individual features are then shown as column headings The best way to see all the features available is to right-click on the license name under Product Name and choose Add/Remove columns.   A Select columns popup is then shown, and the available features are much easier to read.  

Issue A script program status is halted with an error indicating "Tried to divide a value by zero"   Product Line EcoStruxure Building Operation Environment Building Operation MP-C Controllers  Building Operation MP-V Controllers  Building Operation RP-C Controllers  Building Operation RP-V Controllers  Cause The halted program, or a function used within the program, has within itself a divisor that equals or can equate to zero.  An example would be if using Scan as a divisor - (Err - Lerr) / Scan Resolution Ensure that no divisor within the program or function can possibly become zero.  One way to do this would be to either set the divisor to a value greater than zero prior to using it or add a small value to the divisor.  For example:  (Err - Lerr) / (Scan + 0.00001)

Issue "You need to enable JavaScript in your web browser to be able to use Building Operation" message is displayed in the browser window when accessing EBO WebStation using the URL "https://<IP>/login/login.html" Product Line EcoStruxure Building Operation Environment Building Operation Webstation 5.0.3 and later Cause In order to bypass automatic guest account login, some sites have used https://<IP>/login/login.html as a direct URL to the login page. In EBO 5.0.3 this direct URL has been changed to "https://<IP>/login.html" to allow PCT 2.0 to operate correctly. Resolution Use the new "https://<IP>/login.html" URL to bypass automatic guest account login and update any saved browser bookmarks.

Issue Communications with an AS can fail due to high CPU usage and it goes offline in the ES.  Product Line EcoStruxure Building Operation Environment Building Operation Automation Server Premium(AS-P) Building Operation Automation Server(AS) Cause A large graphic was being edited and when saved, the AS appeared to crash, but had actually gone offline to the ES. Resolution This issue was due to the AS CPU usage, which was found to be very high and was making the AS appear to be offline to the ES, when the graphic was saved. The graphic that was being edited was accessing a large number of Universal Inputs, and these input values were changing frequently, this in turn was causing the increased CPU usage. Changing the threshold setting of a Universal Inputs. Select the properties of the universal input to be adjusted. View the configuration section and select the threshold value. Enter an appropriate value for the input being modified.  

Warning Potential for Data Loss: The steps detailed in the resolution of this article may result in a loss of critical data if not performed properly. Before beginning these steps, make sure all important data is backed up in the event of data loss. If you are unsure or unfamiliar with any complex steps detailed in this article, please contact Product Support Services for assistance. Issue Information needed about how to change the "appuser" password used by the Report Server Agent Product Line EcoStruxure Building Operation Environment Web Reports Cause There is no information available on whether the Web Reports "appuser" account password can be changed and how it's done Resolution NOTE: Refer to the following article Report Server "appuser" clarification for additional information on the appuser   The password defined for the user in the configuration file needs to match the actual password in the operating system. To change the password, do the following   Stop the WebReports Agent service Change the password defined for the "appuser" in Windows Change the password defined for the "appuser" in the WebReports Agent config file: C:\Program Files (x86)\Schneider Electric\StruxureWareReports\StruxureWare Reporting Agent\SE.WebReports.StruxureWareReportingAgent.exe.config Restart the WebReports Agent service

Issue Enterprise Server will not start due to no valid license file error: "nsp.csc.licensemanager No valid Enterprise Server license found. Terminating server." or Cannot find license file. (Error code: -1) Product Line EcoStruxure Building Operation Environment Building Operation Software Administrator Building Operation License Administrator Building Operation Workstation Cause Enterprise Server is not started and states no valid license file is found. License Server is installed on the same computer and has valid license(s). Similarly, WorkStation may not start even with a License Server installed with a valid license. If you get error -1, it means that you didn't enter the required @ before the license server address. Resolution In general, any licensed Building Operation software (Enterprise Server, WorkStation, Editors) needs to know where the license server is located. That means that the license server path needs to be entered on any PC having licensed Building Operation software installed. The "License Administrator" part of the license installer can be installed on any PC, and the license server address set using the administrator. The license server itself does not need to be installed on all PC's, but only on the PC hosting e.g. the Enterprise Server. The IP or DNS name of the PC hosting the license server is entered with an initial @, e.g. if the IP of the license server PC is 1.2.3.4 you enter @1.2.3.4 Checkpoints Remember to enter the license server address starting with a @. For example, don't use "localhost" but "@localhost". Is your evaluation license current? If not, download from EcoXpert Extranet Check that antivirus software is configured to allow the operation of the license server. (refer to SmartStruxure Workstation or editors can't get license when using firewall (errors -15 or -96)) Reboot the machine where the License Server is running. It has been observed in some cases where the error 'No valid license or Cannot find license file error' appeared after an upgrade that rebooting the machine solves the problem. Check to see if there are multiple versions of the License Server installed on the machine. If multiple versions are installed, make sure to only run the highest installed version as a Windows Service. All other License Server and License Administrator software should be uninstalled from the machine.

Issue With Script Programs in Continuum we were able to check the variable time against an integer value. Like "if time>500 then...".  In StruxureWare Building Operation time is of the type datetime, no longer an integer. Product Line EcoStruxure Building Operation Environment Script Program Cause In StruxureWare Building Operation a datetime internally is now a 64 bit number, so dates can go beyond the year 2038 which was the top limit for Continuum.  Numbers in script for StruxureWare, like in Continuum are just floats ( 32 bits ) so when trying to map a 64 bit number ( the date ) into a float it is not going to work.  You will get very erroneous readings, therefore the ban. Resolution Here are some examples of the correct StruxureWare program: Remember that for the dates, you can only compare dates to dates, not dates to numbers… In general,   you CAN do the following:       compare dates to dates                ==>   if Date1 > Date2  then     add numbers to dates                   ==>    LaterDate = LastDate + 24*3600     subtract numbers from dates         ==>    EarlierDate = LastDate - 24*3600   you CANNOT do the following   compare dates to numbers                ==>   if Date1 > 500  then

Issue The License Server does not start automatically when the server reboots. Product Line EcoStruxure Building Operation Environment Building Operation Licensing Cause The License server is attempting to start before some dependent process has started. Resolution To edit the FlexNet Service go to Control Panel > Administrative Tools > Services Right click on FlexNet Licensing Service and FlexNet Licensing Service 64  and select Properties. Change the Startup Type from Automatic to Automatic (Delayed Start)

Issue Need more than 50000 registers in a Modbus device Product Line EcoStruxure Building Operation Environment Building Operation Workstation Cause The Modbus specification sets a limit of 65535 as the largest register number. Resolution Enter the value into the Register number configuration property. The Modbus specification sets a limit of 65535 as the largest register number.

Issue Unable to find the latest firmware for ADv3 in EcoXpert Extranet Product Line EcoStruxure Building Operation Environment Advanced Display v3 (ADv3) Cause The firmware is not publicly posted since the process to load the firmware should not be attempted without guidance from Product Support. Resolution All customers must to open a support case to receive fixes or enhancements.

Issue A new Automation Server won't load in Device Administrator versions earlier than EBO 2022. A "Failed to process USB connection event for DevicePath:\\?" error is shown when adding the device.   Product Line EcoStruxure Building Operation Environment Building Operation Automation Server AS-P with Secure Boot Building Operation Automation Server AS-B Scalable Cause Secure Boot/Scalable Automation Server hardware is not supported in EBO versions prior to EBO 2022. Resolution It is not possible to install EBO versions prior to EBO 2022 in Secure Boot/Scalable Automation Server hardware. Verify the Automation Server part number to ensure it is a non-scalable/non-secure boot version. Refer to the Part Number and Hardware and Software Matrix for a list of parts numbers and their associated EBO version compatibility.

Issue Automation Server CPU Specifications Product Line EcoStruxure Building Operation Environment Building Operation Automation Server Building Operation Automation Server Premium Building Operation Automation Server Basic Cause Automation Server Family CPU specifications are required for projects requirements and specifications. Resolution There are three Automation Server models, each with unique CPU specifications:   Automation Server (AS): The Automation Server (AS) has been withdrawn from sale. CPU: ATMEL AT91RM9200, ARM9 core microcontroller. Processor: ARM920T. CPU Clock Speed: 160 MHz. Automation Server Premium (AS-P): CPU: STMicroelectronics SPEAr1380, ARM Cortex-A9 dual-core microcontroller. Processor: ARM Cortex-A9. CPU Clock Speed: 500 MHz. Automation Server Bundled (AS-B): CPU: STMicroelectronics SPEAr320S, ARM926 core microcontroller. Processor: ARM926. CPU Clock Speed: 333 MHz.

Issue Can not save the Diagnostic Files from IP Controller using Building Commission Share button Product Line EcoStruxure Building Operation Environment Building Commission Cause By default, the only apps you can share are Mail and OneNote for Windows. Neither allows you to save a file to the Windows File System. Resolution Install Clipboard by Justin Chase via MS Store or link.  In Building Commission, navigate to the controller -> Device Settings -> Diagnostics Files Select either Device Report, Error Log, or Crash Report Click Share icon in the upper right corner.  Select Clipboard icon.  Click Copy button  Right-click Paste on the desktop or in File Explorer folder.

Warning Potential for Data Loss: The steps detailed in the resolution of this article may result in a loss of critical data if not performed properly. Before beginning these steps, make sure all important data is backed up in the event of data loss. If you are unsure or unfamiliar with any complex steps detailed in this article, please contact Product Support for assistance. Issue When upgrading EcoStruxure Building Operation to version 2.0 or newer, the existing Power Manager software should also be upgraded to EcoStruxure Energy Expert to maintain compatibility Product Line EcoStruxure Building Operation EcoStruxure Energy Expert Environment Power Monitoring Expert (PME) Power Manager Cause The proper procedure is required when upgrading from older versions of Power Manager to the latest Energy Expert version. Guidance and best practices are needed for upgrading a PME server from PME 7.2 to PME 9.0. Resolution A Power Manager 1.0 site should be taken to 1.1 first, then upgraded to Energy Expert 2.0 Below are the recommendations for a side-by-side upgrade from PME 7.2 to PME 9.0: On the old server: Run the PME_8.2.iso file to do an in-place upgrade from PME 7.2.3 to PME 8.2 After completing that upgrade, the system will default to using a PME 8.2 trial license Install and run the PME 8.2 CM 2.1.0 Tool which will perform necessary actions for the side-by-side upgrade; we will use it to create a .zip file containing configuration components such as reports, dashboards, diagrams, users, devices, etc. Transfer this .zip file from the CM Tool to the new server On the new server: Run the PME_8.2.iso file to install PME 8.2 (this can be done while the above steps are performed on the old server) After transferring the .zip file from the old server, install and run the PME 8.2 CM 2.1.0 Tool on the new server and have it load the archived data from the .zip file into the program, and then write it to the system (essentially performing a PME 8.2 server to server migration) After that finishes, we can run the PME_9.0.iso file to upgrade from PME 8.2 to PME 9.0 After PME 9.0 is installed, we can activate the PME 9.0 license(s) in the Floating License Manager using the activation ID(s) that were already acquired, then remove the PME 9.0 trial license using License Manager (different from Floating License Manager) Running into issues with the install? Receiving error messages related to PME? Check out the Technical FAQ for a solution to your problem.  Links to relevant documentation and files: Where can I find documentation for Power Monitoring Expert 8.2 (PME 8.2)? Where can I download Power Monitoring Expert 8.2 installation files? Where can I find documentation for Power Monitoring Expert 9.0 (PME 9.0)? Where can I download Power Monitoring Expert 9 installation file? PME 8.2 CM Tool Exchange Community post  PME 9.0 CM Tool Exchange Community link  

Issue The binding between an Enterprise Server and Automation Server or between two Automation Servers shows Unresolved Product Line EcoStruxure Building Operation Environment Building Operation Enterprise Server Building Operation Automation Server Binding Diagnostics Cause The communication between the two servers is incorrectly configured, blocked by software such as firewalls or antivirus or another application is using the port. Resolution For Firewall Issues: Ensure the Windows firewall on the Enterprise Server PC is set up correctly, for example follow Creating Windows Firewall rules to allow Building Operation to communicate on the TCP port to set up inbound and outbound rules.   Alternatively configure the Windows firewall using the Firewall Config tool on all PC's having EcoStruxure software installed. Problems with firewall settings can arise if the Enterprise Server PC is removed during the commissioning process and the firewall settings swap between Private Networks and Public Networks. For example All the Automation Servers may appear online, but the "Unresolved" bindings issue may be seen. Automation Servers cannot be restored via the Enterprise Server If a suitable option temporarily disable the firewall to see if it fixes the issue.   For 1.4 or 1.5 Servers with a name containing the "&" symbol: Ask Product Support for Hotfix R1.4.1.16201 (or later version) for version 1.4 and R1.5.0.1601 (or later version) for version 1.5.    For other Causes: Follow these troubleshooting steps in order until the issue has been resolved. Check that the ES IP address is the same as the PC IP address.  If they do not match, follow How to set the Enterprise Server IP address to change the ES IP.  All ports must be open between the ES and AS, for port numbers search "Network Ports" in the Information Technology System Planning Guide. If the address of the ES is a domain name, try using the IP address instead. If there are more than one network adaptor on the ES can, for example, take the address of a wireless adaptor, VMware virtual adaptor or VirtualBox adaptor.  The ES should be using the NIC adaptor, either follow the link in item 1 or disable the other network adaptors. Right click on the ES and select Advanced > Repair Server Communication.  This should update the Communication tables of the servers. Detach the automation servers from the ES and then add the automation servers back.  Follow Unable to add an Automation Server underneath an Enterprise Server. Select each server and click on the Communication Tab.  If communication is valid, it should list the details of every other server. Try to disable any network monitor function of anti-virus software on the computer. If a Schneider laptop is used, right click the Trellix software in the system tray and Enable Firewall Timed Groups. Although not a supported architecture if a user installs the Enterprise Central and Enterprise Server on the same PC with default settings the ports will conflict.  Either remove the unsupported Enterprise Central or if for testing stop the service and set appropriate usable ports.