Installing the Messaging Server: DEPRECATED

Installing HornetQ

HornetQ is the Message Queue engine used by the Messaging Server.

To install HornetQ

1. Download it from http://www.jboss.org/hornetq/downloads.html
   (For the release to use, see the Software Requirements.)
2. Unpack the archive to the desired location (hornetq-2.2.14, at the the time of this writing).
3. Edit {hornetq-folder}/config/stand-alone/non-clustered/hornetq-users.xml
4. Create a new user by adding the following code to the <configuration> section:

   <user name="[USER_NAME]" password="[PASSWORD]">
      <role name="admin"/>
   </user>
   

5. Edit {hornetq-folder}/config/stand-alone/non-clustered/hornetq-configuration.xml
6. Replace the <security>...</security> section with the following:

   <security-settings>
      <security-setting match="#">
         <permission type="createNonDurableQueue" roles="guest, admin"/>
         <permission type="deleteNonDurableQueue" roles="guest, admin"/>
         <permission type="createDurableQueue" roles="admin"/>
         <permission type="deleteDurableQueue" roles="admin"/>
         <permission type="consume" roles="guest, admin"/>
         <permission type="send" roles="guest, admin"/>
         <permission type="manage" roles="admin"/>
      </security-setting>
   </security-settings>
   

Note: HornetQ is started using [hornetq-folder]/bin/start.sh. It should be started before launching the platform's messaging server. Learn more: Server Restart Sequence

Configuring the Platform's Service Provider Settings

1. Go to the Service Provider URL: http://{yourDomain}/networking/Service?t=1&targetpage=ViewPort.jsp
2. Log in as the admin user
3. Go to Settings > Service Provider Settings > Service Configuration
4. Set values for the following parameters:

HornetQ Host	IP address of the server where HornetQ is installed (default: localhost)
HornetQ Port	Default: 5445.  Needs to be specified only if the port specified for the netty acceptor was changed in hornetq-configuration.xml for “netty” acceptor.
HornetQ User HornetQ Password	Use the same credentials you specified in hornetq-users.xml
HornetQ QoS	The number of simultaneously working Message Queue listeners.

5. Click [Save]