Messaging Bus Reference

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

Note: If you select the Enable SSL checkbox, a SSL server URL is mandatory. The non-SSL EMS Server URL is optional.

Property Required? Editable? Accept 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 nonsuperusers, 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.

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 Restarting Nodes.

Reconnect Attempt Delay (ms) N Y N

Time interval between successive attempts to reconnect to the server. Default : 500.

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? Accept SVars? Description
Enable SSL Y Y N

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

Default: Unchecked.

SSL Client Provider Y Y Y

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.