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]

Creating an SSL Keystore

The Messaging Server accepts only SSL-encrypted connections. It needs a valid SSL certificate to perform a Handshake and data exchange with client systems.

__TBD: Which of the following two paragraphs is correct?__
The same Java keystore, SSL certificate, and private key used for the application server can be used for the Messaging Server.

The same Java keystore used for the application server can be used for the Messaging Server. You can create the SSL certificate and private key in that keystore.

Learn more: Managing SSL Certificates.