Configuring WS-Event Broker

WS-Event broker is an external event broker like the WSO2 Message Broker, that can handle WS-Events. Here we are configuring WSO2 Message Broker (WSO2MB) as the external event broker. For more information on WSO2 MB, refer to http://wso2.com/products/message-broker.

In order to start a separate instance of Message Broker with the CEP in the same machine, we need to offset Message Brokers ports by at least 1. Assuming CEP is started with the default port 9443, let's increase the port offset of the Message Broker by 1. Then WSO2  MB will be started on port 9444.

Open <MB_HOME>/repository/conf/carbon.xml file and change the offset value.

<!-- Ports offset. This entry will set the value of the ports defined below to the define value + Offset. e.g. Offset=2 and HTTPS port=9443 will set the effective HTTPS port to 9445-->

<Offset>1</Offset>

This will prevent any server port conflicts.

Configuring through the User Interface

1. Log on to the product's management console and select "Broker -> Add" under the "Configure" menu.



2. The "Create a New Broker" window opens. For example, enter the following details to create a WS-Event broker

Broker Name	: wsEventBroker
Broker Type	: ws-event
URI		: https://localhost:9444/services/EventBrokerService (Here we assume you started WSO2 MB on port 9444 to have this URI)
User Name	: admin
Password	: admin

3. Click the "Add Broker" button once configuration details are added. You will be directed to the "Available Brokers" window.

Broker configurations can be viewed by clicking on the broker name and brokers can be deleted by clicking on the "Delete" button.

Configuring through broker-manager-config.xml

Broker management configuration can be specified in the <CEP_HOME>/repository/conf/broker-manager-config.xml file, whose configurations are loaded at server start-up.

1. Open the file and enter the following WS-Event broker configurations inside the "brokerManagerConfiguration" element.

<brokerManagerConfiguration>
	..
	<brokerConfiguraton name="wsEventBroker" type="ws-event">
         <property name="uri">https://localhost:9444/services/EventBrokerService</property>
         <property name="username">admin</property>
         <property name="password">admin</property>
    </brokerConfiguraton> 
	..
	..
</brokerManagerConfiguration>

Configuring topics for WS-Event broker

The topic used when using WS-Event broker will be the topic defined under Topic Management

Input/Output mapping supported by WS-Event Broker

WS-Event broker can be configured with XML input mapping, and XML output mapping of a query.