Usage Note 56208: SAS® Event Stream Processing RabbitMQ connector and adapters using RabbitMQ require rabbitmq-c v0.5.2 client run-time libraries
 |  |  |  |
SAS Event Stream Processing (ESP) can communicate with a RabbitMQ server in multiple ways. The C++ adapters and the RabbitMQ connector use the rabbitmq-c run-time libraries to communicate with the RabbitMQ server. The requirements to use the rabbitmq-c run-time libraries are:
- Download rabbitmq-c version 0.5.2.
- Install rabbitmq-c on each host that is running an instance of the RabbitMQ connector or C++ adapter.
- Define a path to the library with a run-time environment variable. For example, you specify the path on the LD_LIBRARY_PATH variable on Linux platforms.
If you install a later version of rabbitmq-c, the RabbitMQ connector or adapter fails to find the libraries or fails when it connects to the RabbitMQ server.
For example, rabbitmq-c version 0.7.0 triggers the following errors on a Linux machine.
- The XML server issues these messages when it tries to start an XML model that uses a RabbitMQ connector:
2015-07-17T13:59:50,290; WARN ; 00000034; DF.ESP; (dfESPconnectorMgr.cpp:150); connectorManagerInitialize(): Unable to load connector plugin libesp_rmq_cpi-3.1.0.so from /home/sas/esp31/SASEventStreamProcessingEngine/3.1.0/lib/plugins/, error: librabbitmq.so.1: cannot open shared object file: No such file or directory 2015-07-17T13:59:50,308; WARN ; 00000044; DF.ESP; (dfESPwindow.cpp:1123); dfESPwindow::getConnector(): <esp>::<project>::<contquery>::<src_window> could not get a connector of type: rmq. 2015-07-17T13:59:50,308; ; 00000045; DF.ESP; (Window.cpp:1721); 'cannot get connector rmq_pub (rmq)'
- The ESP adapters issue these messages when you start any adapter that uses RabbitMQ:
2015-07-17T14:52:54,332; WARN ; 00000010; DF.ESP; (dfESPconnectorMgr.cpp:150); connectorManagerInitialize(): Unable to load connector plugin libesp_rmq_cpi-3.1.0.so from /home/sas/esp31/SASEventStreamProcessingEngine/3.1.0/lib/plugins/, error: librabbitmq.so.1: cannot open shared object file: No such file or directory 2015-07-17T14:52:54,334; ERROR; 00000011; DF.ESP; (C_dfESPpubsubApi.cpp:137); C_dfESPpubsubInit(): Unable to load pubsub plugin libesp_rabbitmq_ppi-3.1.0.so from /home/sas/esp31/SASEventStreamProcessingEngine/3.1.0/lib/plugins/, error: librabbitmq.so.1: cannot open shared object file: No such file or directory
In both of the above examples, the RabbitMQ connector or adapter searches for librabbitmq.so.1, which is not built by newer versions of the rabbitmq-c library.
If the RabbitMQ connector or adapter successfully loads a newer version of rabbitmq-c, it returns the following error when it connects to the RabbitMQ server:
- The XML server issues these messages when it tries to start an XML model that uses a RabbitMQ connector:
2015-07-17T14:04:00,001; ERROR; 00000056; DF.ESP; (dfESPrmqConnector.cpp:1702); dfESPrmqConnector::start(): amqp_exchange_declare failed, error message = library error: table too large for buffer
- The ESP adapters issue these messages when you start any adapter that uses RabbitMQ:
2015-07-17T15:03:31,448; ERROR; 00000013; DF.ESP; (C_dfESPpubsubApi.cpp:417); createConnection(): amqp_exchange_declare() failed, library error: table too large for buffer 2015-07-17T15:03:31,448; ERROR; 00000014; DF.ESP; (dfESPconnector.cpp:301); dfESPconnector::start(): Could not create client Connector failed to start Could not start connector
Operating System and Release Information
| Product Family | Product | System | Product Release | SAS Release | ||
| Reported | Fixed* | Reported | Fixed* | |||
| SAS System | SAS Event Stream Processing Engine | Linux for x64 | 2.3 | |||
| Microsoft® Windows® for x64 | 2.3 | |||||
| Type: | Usage Note |
| Priority: |
| Date Modified: | 2016-01-20 10:19:29 |
| Date Created: | 2015-07-17 14:11:00 |