Messaging Bus Reference

The below reference table provides information required to confiture the Messaging Bus while creating an ActiveMatrix environment.

Property Required? Editable? Accepts SVars? Description
EMS Server URL Y Y N Enterprise Message Service server location or locations. Can be a comma-separated list of URLs for fault tolerance and reconnection. If a comma-separated list is specified, the Enterprise Message Service server must be configured for fault-tolerant mode.

Default: tcp://localhost:7222

Login Credentials Y Y N

Indicate how the credentials required to authenticate to a server are provided:

  • Username + Password - Provide inline username and password credentials. When selected, the Username and Password fields are activated.
  • Identity Provider - Provide username and password credentials encapsulated in an identity provider resource. When selected, the Identity Provider field is activated.
Username N Y N The username used to authenticate connections to the server.
Password N Y N

The user's password used to authenticate connections to the server.

(Administrator only) For superusers, passwords display encrypted. For non-superusers, the password doesn't display even if it was set when it was created. If you have permission to edit the password, you can specify a new value and save. If you edit other fields, the old value for the password field is retained. If you want to set an empty value as password, click the link Set Blank Password.

Identity Provider N Y Y The name of the Identity Provider resource instance used to authenticate the user.
Connection Pool Size N Y N Maximum number of connections used for sending or receiving messages. Although messaging can work with just one connection, the multiple connections allow parallel message processing.

Default: 12.

Outbound Session Pool Size N Y N Maximum number of sessions available to send messages to the server.

Default: 24.

Reconnect Attempt Count N Y Y Number of times a node attempts to establish a connection to the server before an error is returned.

Default : 600.

Note: Modify the default reconnect attempt values to suit your environment. If the messaging bus fails to connect with the messaging server, restart the node manually.
Reconnect Attempt Delay (ms) N Y N Time interval between successive attempts to reconnect to the server.

Default : 500.

Note: For example, multiply the Reconnect Attempt Delay (ms) with the Reconnect Attempt Count. Default is 300000 ms. The messaging bus attempts to reconnect to the messaging server for the specified time and then stops reconnect attempts.
EMS Server SSL URL N Y Y The SSL URL of the Enterprise Message Service server.
SSL Client Provider N Y N The name of an SSL Client Provider.

SSL

Property Required? Editable? Accepts SVars? Description
Enable SSL

Y Y N Enable SSL connections. When checked, the SSL properties display.

Default: Unchecked.

SSL Client Provider

Y Y N The name of an SSL Client Provider resource.
Configure SSL N N N (Not applicable to some resource templates) Invokes a wizard to import certificates from an SSL-enabled server, optionally create an SSL Client Provider resource, and configure the trust store of the newly created or an existing SSL Client Provider with the imported certificates. When you complete the wizard, the SSL Client Provider field is filled in.