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:

   <syntaxhighlight lang="xml" enclose="div">

<user name="[USER_NAME]" password="[PASSWORD]">

  <role name="admin"/>

</user> </syntaxhighlight>

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

   <syntaxhighlight lang="xml" enclose="div">

<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> </syntaxhighlight>

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 – to IP address of the server where you installed HornetQ server (by default “localhost”)
   • HornetQ Port – only change it if you changed port configuration in hornetq-configuration.xml for “netty” acceptor (by default 5445)
   • HornetQ User and HornetQ Password – credentials that to you used in hornetq-users.xml configuration file.
   • HornetQ QoS – count of simultaneously working MQ listeners\
5. Click [Save]