Configuring BAM Server Profiles and Streams

Before adding a BAM mediator to a mediator sequence BAM mediator configurations should be updated as below. Configuration information are basically considered as a set of BAM server profiles which contains transport and credential data required to connect to the BAM server. In each BAM server profile one or many Event Stream configurations should be defined. Streams contains CEP event stream related information like Stream Name, Stream Version etc and data to be extracted from the configuration context of the mediation sequence.

  1. To go to the configuration of BAM Mediator go to ESB management console Configure→BAM Server Profile menu.

  2. If there are no existing Profiles (in the very first time) click Add Profile to add a new BAM Server Profile.



  3. If there are Profiles already existing either creation of new profiles or editing an already existing Profile is possible by clicking on their Edit Profile link. If there are unnecessary profiles they can be deleted by clicking on their Remove Profile link.



  4. Enter a name for BAM server profile in Profile Name.

  5. In Server Credential enter admin as User Name and admin as Password by default.

  6. In Server Transport select Thrift as the default Protocol.

  7. If message confidentiality is required from ESB server to BAM server tick on Enable Security.

  8. Enter the IP address of the BAM server's Thrift server as the IP Address. By default it is the IP address of the localhost.

  9. If security was not enabled Receiver Port will be asked and enter 7611 by default which is the Thrift server port.

  10. Authentication Port should be given the port number of 100 higher than the Receiver Port if it exists. Default Authentication Port number is 7711.



  11. Then you can define a set of Stream Configurations among which we select the required Stream Configuration in the mediator definition time. In each Stream Configuration there must have,
    Name : Stream Name can be any string with alpha-numeric characters
    Version : Stream Version distinguishes different streams with the same Stream Name. Default version should be 1.0.0 .
    Nickname : This is a user preferred nick name to the Stream Name in alpha-numeric characters
    Description : A description describing about the particular stream defined by Stream Name, Stream Version pair. Description should also consists of alpha-numeric characters.

  12. For more configurations of a particular stream click on Edit Stream. To remove an existing stream click on Remove Stream.

  13. When editing a stream check on Dump header or Dump body if you want to record SOAP header or SOAP body of messages respectively.

  14. In Stream Properties the user can can extract several types of properties from the message. Basically Stream Properties are divided into two.
    Value : A constant alpha-numeric string value entered to Value field is set as the property.
    Expression : The given expression in Value field is considered as an expression and executed on the message to get the property. XPath properties and functions available in ESB are valid in the expression.



  15. After Stream Payload and Stream Properties are added or updated Update should be clicked to update them to the specific Stream Configuration.

  16. Add button adds a new Stream Property to the properties list and Cancel button ignores the updated Stream Properties data.

  17. After all the changes are properly made to the BAM Server Profile click on Save button to save all the configuration data to the secondary storage.

  18. After modifying the BAM Server Profile data the user can go back to BAM Server Profiles list to see the new set of existing BAM Server Profiles by clicking on the BAM Server Profile link on the top of the page.

  19. Similarly the user may add enough number of BAM Server Profiles and many unique Stream Configurations under a one BAM Server Profile.