Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The goal of Reliable Messaging in Web services is to allow helps applications to send and receive messages in an efficient and reliable secure manner amidst application, platform, or network failurefailures. The WS-Reliable Messaging specification (WS-RM) defines a protocol and a set of mechanisms that to ensure that messages are delivered reliably between two endpoints. WS-RM handles both simple and complex scenarios arising in message transmission.

Reliable Messaging capability is provided by the Reliable Messaging Core/UI features in the WSO2 feature repository, which are currently bundled by default in the Service Management feature. These features provides a Reliable Messaging tool that is used to enable enable WS-RM to services at global-level and service-level.

  • Global-Level - For information on enabling/disabling reliable messaging on a global-level, refer to section Axis2 Modules -> Configuring the "sandesha2" : Engages reliable messaging to all services. For information, see Configuring the sandesha2 Module.
  • Service-Level - Reliable messaging can be engaged to a selected service as well as described below.
Service-Level Reliable Messaging AnchorService-Level Reliable MessagingService-Level Reliable Messaging
  • : If you activate reliable messaging for a particular service, your configurations
will be applied
  • apply to that
particular
  • service only.
WS-Reliable Messaging handles and solves both simple and complex scenarios arising in message transmission. Given below are instructions on how to

Service-level reliable messaging

Follow the steps below to enable and manage reliable messaging on a service-level. 

1.
  1. Log
on
  1. in to the
product's
  1. management console and click
"
  1. Services > List
"
  1. under
"Services
  1. the Main menu.
"

Image Removed

2. The "
  1. In the Deployed Services
"
  1. page that appears
. Click
  1. , click on the service
, for
  1. to which you want to activate
Reliable Messaging. For example,

Image Removed

3. The "Service Dashboard" page appears. Click "Reliable Messaging" in the "
  1. reliable messaging.
  2. The service's dashboard opens. Click Reliable Messaging from the Quality of Service Configuration
"
  1. panel.
  1. Image Modified  

4. The "Enable Reliable Messaging" page appears. Click "Yes."

Image Removed

5. The current "
  1. Enable reliable messaging to the service by selecting Yes. Image Added
  2. Change the default Reliable Messaging Sequence Configuration
" appears.

Image Removed

Field Descriptions
  1. settings as you need. Image AddedThe options of the above window are as follows:

    WS-RM defines a one-way sequence. The sender (source) is called the RMS (reliable messaging source) and the receiver (destination) is called the RMD (reliable messaging destination). Therefore, for in-out operations, the RM uses two sequences.

For request messages the
  1. The server acts as the RMD for request messages and RMS for response messages

, the server act as the RMS
  1. .

    • Inactivity Timeout Interval
-
    • : The maximum inactive time for any RM session. After the sequence timeout, the RM session is terminated.
    • Inactivity Timeout Measure
-
    • : The unit in which the inactivity timeout interval is specified.
    • Sequence Removal Timeout
-
    • : Shows the interval. If the sequence is inactive during this time period, the sequence is removed from the storage.
    • Sequence Removal Timeout Measure
-
    • : The unit, in which the sequence removal timeout interval is specified.
    • Acknowledgment Interval
-
    • : The time interval that the RMD uses to send the acknowledgments.
    • Retransmission Interval
-
    • : The time interval, after which the RMS retransmits the message if it does not get an acknowledgment.
    • ExponentialBackoff
-
    • : Whether RMS exponentially increases the retransmission time or not.
    • Maximum Retransmission Count
-
    • : The maximum number of retransmits the RMS sends.
6. Modify the configuration if required.
  1. Click

"
  1. Finish

." Reliable Messaging will be activated for that particular service.

Functions of Buttons:

  • Finish - Click "Finish" to submit the current data. When finished, your throttle configuration will be applied and the page will be redirected to the previous page.
  • Reset - Click "Reset" to load the last submitted configuration.
  • Default - Click "Default" to load the default throttle configuration. If you want to submit those data, you have to click "Finish."
  • Clear - Click "Clear" to clear all the text boxes in the UI.
  • Cancel - Click "Cancel" to go to the "Deployed Modules" page.
7. To disable reliable messaging, in the "Enable Reliable Messaging" page, select "No."

Image Removed

8. Confirm your request by clicking "Yes."

Image Removed

Excerpt
hiddentrue
Reliable messaging configuration in WSO2 Application Server.
  1. after the config is done.

    The rest of the function of buttons on this window are as follows:

    • Finish : Submits the current data
    • Reset : Loads the last submitted configuration
    • Default : Loads the default RM configuration. (Click Finish to submit)
    • Clear : Clears he text boxes
    • Cancel : Goes to the main page