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	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
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]