Introduction - Metasys - LIT-12011279 - General System Information - Metasys System - 13.0

Network and IT Guidance Technical Bulletin

Product
Building Automation Systems > Building Automation Systems > Metasys System
Document type
Technical Bulletin
Document number
LIT-12011279
Version
13.0
Revision date
2023-09-29
Product status
Active

As implemented in the Metasys system, RabbitMQ supports trending and Site Management Portal UI navigation tree features. The Site Director queue receives trend data and navigation tree changes from other system devices. When the Site Director is busy, the messages remain in the queue until the Site Director is available to process them. Using RabbitMQ allows the system to avoid bottlenecks by separating the actions of receiving and processing data. All message queuing functions happen within the server itself; no messages from RabbitMQ broadcast over the network between the server and other devices.

Metasys installs RabbitMQ on all computers where ADS, ADX, or OAS software is installed. Once installed, do not stop, disable, or uninstall RabbitMQ. If RabbitMQ is stopped, disabled, or uninstalled, the Site Director does not receive or process messages. Lost trending data may be irrecoverable. The queue fills at a rate determined by your site configuration and system use; for example, trend frequency or number of additions, changes, or deletions made to the navigation tree.

Note: Each Site Director contains all the navigation information for an entire site in a cache. This cache allows the Site Management Portal UI to display quickly without repeated requests to system devices. Updates received through the RabbitMQ queue keep the information current.
An alarm is generated in the Metasys system when any trend or alarm sample remains in the RabbitMQ for more than 10 minutes. This alarm usually indicates a problem with Microsoft SQL Server® or a remote forwarding destination is offline. See the following figure for an example of the Metasys alarm.
Figure 1. RabbitMQ Alarm

An alarm is generated in the Metasys system when trend samples remain in the queue after failing two bulk inserts. If this scenario occurs, trend samples go into a single insert mode. An alarm is generated for each trend sample that falls back to a single insert mode. JavaScript Object Notation (JSON) files are created for each trend object that has a sample that cannot be processed. The JSON files are located at C:\ProgramData\Johnson Controls\Metasys Services\TimeSeriesService\DataIngestion.