Due to a known issue do not use JDK1.8.0_151 with WSO2 products. Use JDK 1.8.0_144 until JDK 1.8.0_162-ea is released.
This documentation is for WSO2 Message Broker version 3.2.0. For the latest documentation, see the documentation for WSO2 Enterprise Integrator.

Versions Compared


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


If you are upgrading from WSO2 MB 3.1.0 to WSO2 MB 3.2.0 version, see the upgrading instructions for WSO2 Message Broker.


Configuring the server

WSO2 Message Broker (WSO2 MB) is shipped with default configurations that will allow you to download, install and get started with your product instantly. However, when you go into production, it is recommended to change some of the default settings to ensure that you have a robust system that is suitable for your operational needs. Also, you may have specific use cases that require specific configurations to the server.


Configuring security

After you install WSO2 MB, it is recommended to change the default security settings according to the requirements of your production environment. As MB is built on top of the WSO2 Carbon Kernel (version 4.4.6), the main security configurations applicable to MB are inherited from the Carbon kernel.


For instructions on performance tuning recommendations that are specific to WSO2 MB functionality, see the topics given below.

Changing the default ports


For details on how you can troubleshoot and trace errors that occur in your WSO2 MB server, see Troubleshooting WSO2 MB.