Apama Documentation : Connecting Apama Applications to External Components : Using Message Services : Using Universal Messaging in Apama Applications : Configuring the Universal Messaging connectivity plug-in : Configuring the dynamicChainManagers
Configuring the dynamicChainManagers
The Universal Messaging dynamic chain manager monitors channels that are subscribed to or sent-to within the correlator and, as per its configuration, connects these to Universal Messaging channels as needed. This is where you specify how to connect to Universal Messaging. When the dynamic chain manager identifies a channel that should be connected to a Universal Messaging channel, it will create a chain using one of the templates in the dynamicChains section of the YAML configuration (see also Configuring the dynamicChains).
One instance is created under dynamicChainManagers for each Universal Messaging realm or cluster of realms you are connecting to. Typically, this will be only one. The managerConfig stanza contains all of the configuration for connecting to that Universal Messaging realm.
dynamicChainManagers:
UMManager:
transport: UMTransport
managerConfig:
rnames: nsp://localhost:8000/
session:
poolSize: 8
authentication:
username: me
certificate: ${CERTIFICATE_PATH}
certificatePassword: ${CERTIFICATE_PASSWORD}
certificateAuthority: ${CERTIFICATE_AUTHORITY}
channel:
prefix: "um:"
missingChannelMode: error
escapeNamesOnUM: true
includePrefixOnUM: false
The following table describes the options that can be used in the managerConfig section:
Option
Description
rnames
Required. The Universal Messaging connection string of realm names to connect to.
You can specify one or more Universal Messaging realm names (RNAME) separated by commas or semicolons.
Commas indicate that you want the correlator to try to connect to the Universal Messaging realms in the order in which you specify them here. For example, if you have a preferred local server you could specify its associated realm name first and then use commas as separators between specifications of other realm names, which would be connected to if the local server is down.
Semicolons indicate that the correlator can try to connect to the specified Universal Messaging realms in any order. For example, use semicolons when you have a cluster of equally powered machines in the same location and you want to load balance a large number of clients.
You can specify multiple Universal Messaging realms only when they are connected in a single Universal Messaging cluster. That is, all realm names you specify must belong to the same Universal Messaging cluster. Since channels are shared across a cluster, connecting to more than one Universal Messaging realm lets you take advantage of Universal Messaging's failover capability.
For additional information on communication protocols and realm names, and on clusters, see the Universal Messaging documentation.
Default value: none.
session/poolSize
The number of sessions to create to the Universal Messaging realm. Either a number of sessions or a string of the form /N which indicates a divisor applied to the number of CPUs to obtain the number of sessions. Channels are allocated to sessions in a round-robin style.
Default value: 8.
authentication/username
The username that is to be used to connect to the Universal Messaging realm. The default is the user which the correlator is running as.
Default value: none.
authentication/certificate
The path to a certificate that is used to authenticate to the Universal Messaging realm.
Default value: none.
authentication/certificatePassword
The password for the certificate.
Default value: none.
authentication/certificateAuthority
The path to a CA certificate for the UM realm.
Default value: none.
channel/prefix
A prefix for the channel. Only channels with this prefix will be considered as Universal Messaging channels.
Default value: um:.
channel/includePrefixOnUM
If set to false, the channel prefix is stripped from the Apama channel name before it is looked up on Universal Messaging.
Default value: false.
channel/escapeNamesOnUM
If set to true, non-alphanumeric characters in the Apama channel name are escaped on Universal Messaging. Set this to false if you want to use the slash (/) for hierarchical channels on Universal Messaging.
Default value: true.
channel/missingChannelMode
Defines the behavior when subscribing to channels which do not exist. You can define one of the following options:
*error - Print an error to the correlator log file. The channel remains only accessible within the correlator.
*ignore - Silently ignore the failure and therefore do not print an error to the correlator log. The channel remains only accessible within the correlator.
*create - Create the channel on the Universal Messaging realm, then subscribe/send to it. See also Subscribing to automatically created Universal Messaging channels.
Default value: error.
Copyright © 2013-2017 Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback