This chapter explains the parameters that can be configured for the FioranoMQ Repeater that is used for exchanging information between different MQ Servers connected in a particular network topology such as hub-spoke, mesh or bus-based. These are the various parameters that are configured under the FioranoMQàFioranoàRepeaterà* tree node in the Repeater Profile in Offline configuration using Studio.
For more information on FioranoMQ Repeater, refer to Chapter 11 Repeater of FioranoMQ Handbook.
FioranoRepeaterManager
Presented below are the details for the parameters present in Fiorano->Repeater->RepeaterManager->FioranoRepeaterManager->config.
Name
This parameter is used to specify the name of the Repeater Instance.
Valid values:
The default value of the Dispatcher parameter is Repeater.
Any String may be used as a valid value for this parameter.
DurableSubscriptionInfoFileName
The DurableSubscriptionInfoFileName parameter is used to specify the name of the XML file that contains information related to durable subscriptions.
Valid values:
The default value of the DurableSubscriptionInfoFileName is rp_durable.xml.
Any valid xml filename is an acceptable parameter.
Given a relative path for a filename the Server looks for the xml file in the directory specified in the system property FMQ_CONFIG_PATH. If an absolute path for a filename then that file is used.
PingInterval
The PingInterval parameter describes the time out in milliseconds after which the connection to the Server is pinged.
The repeater makes sure that the Server it connected to is still alive by pinging it intermittently. The time interval between pings is specified by this parameter.
Valid values:
The default value for the PingInterval parameter is 10000.
The range of integer values considered valid by the PingInterval are -2^31 to 2^31 -1.
All values less than zero retrieve the same result.
AvoidLoopback
The AvoidLoopback parameter is used to specify whether cyclic links are valid in the repeater.
Loopback occurs when there are a set of links connecting FioranoMQ Servers so as to allow the formation of a “cycle”. If a message were to originate at a particular FioranoMQ Server then the message would traverse the entire cycle and return to the originating Server. If AvoidLoopback is enabled the message will not be transferred further. If AvoidLoopback is not enabled the message stays within the cycle indefinitely.
Valid values:
The default value is of the AvoidLoopback parameter is yes.
- yes - Loopback is avoided.
- no - Loopback is not avoided.
TransactionSize
The TransactionAize parameter is used to specify the number of messages that will amount to a complete transaction.
Valid values:
The default value of the TransactionSize parameter is 0.
The range of integer values considered valid by the PingInterval are -2^31 to 2^31 -1.
All values less than zero retrieve the same result.
TransactionTimeout
In a transaction a group of messages together are seen as one transaction. If a message which is a part of the transaction is not received by the subscriber within the TransactionTimeoutPeriod timeout period specified in milliseconds, the transaction commits the messages received as a completed transaction.
Valid values:
The default value of the TransactionTimeout parmeter is 10.
The range of integer values considered valid by the PingInterval are -2^31 to 2^31 -1.
All values less than zero retrieve the same result.
SourceServer
Presented below are the details for the parameters present in Fiorano->Repeater->FioranoRepeaterManager->Link->SourceServer.
Name
This parameter is used to specify the name of the source of the FioranoMQ Server.
Valid values:
The default value of the Dispatcher parameter is LocalhostSourceServer.
Any String may be used as a valid value for this parameter.
ConnectionInfo
Presented below are the details for the parameters present in Fiorano->Repeater->FioranoRepeaterManager->Link->SourceServer->ConnectionInfo.
ProtocolType
The ProtocolType parameter describes the underlying protocol to be used to connect to the source of the FioranoMQ Server.
Valid values:
The default value of the ProtocolType Server is TCP.
JMXProtocol
The JMXProtocol parameter describes the underlying communication protocol that is used for to connect theJMX connection to the Source FioranoMQ Server.
Valid values:
The default value of the JMXProtocol is rmi.
JMXPort
The JMXPort parameter specifies the JMX port hosting the Source FioranoMQ Server, to which a JMX connection is made.
Valid values:
The default value of this parameter is 1858.
The range of integer values considered valid by the PingInterval are -2^31 to 2^31 -1.
All values less than zero retrieve the same result.
ServerURL
The ServerURL parameter specifies the URL of the FioranoMQ Server that will be a part of a link. The FioranoMQ Server identified ten serves as the source Server in the link.
Valid values:
The default value of the ServerURL is http://localhost:1856.
Format: http://hostname:port
UserName
The UserName parameter specifies the login name used by the repeater to connect to the source FioranoMQ Server.
Valid values:
The default value of the UserName parameter is anonymous.
Any String may be used as a valid value for this parameter.
Password
The Password parameter specifies the login name used by the repeater to connect to the source FioranoMQ Server.
Valid values:
The default value of the password parameter is anonymous.
Any String may be used as a valid value for this parameter.
TopicConnectionFactory
The TopicConnectionFactory parameter specifies the topic connection factory used by the repeater to connect to the source FioranoMQ Server.
Valid values:
The default value of the TopicConnectionFactory parameter is primaryTCF.
Any String may be used as a valid value for this parameter.
ServerSecurityManager
The ServerSecurityManager parameter specifies the Security Manager used by the source FioranoMQ Server.
Valid values:
The default value of the ServerSecurityManager parameter is null.
Any String may be used as a valid value for this parameter.
ProxyURLAttribute
The ProxyURLAttribute parameter specifies the URLs of the proxy Servers that are to be used. Multiple backup URLs may be specified as a semicolon-separated string of URLs.
Valid values:
The default value of the ProxyURLAttribute is null.
ServerSecurityManager parameter LinkTopicInfo
Presented below are the details for the parameters present in Fiorano->Repeater->FioranoRepeaterManager->Link->LinkTopicInfo.
IsDurable
The IsDurable parameter specifies whether the link between the source and the target Server is durable. A durable link ensures that no messages are lost across the repeater in case of network failure.
Valid values:
The default value of the IsDurable parameter is false.
- true - Link is durable
- false - Link is not durable
ConnectionMode
The ConnectionMode parameter specifies whether the same JMS connection will be used for replicating the data across JMS Servers or if a separate connection will be created to be used for each link.
Valid values:
The default value of the ConnectionMode parameter is Shared.
- Shared - In this mode the repeater will use the same JMS connection for replicating the data across JMS Servers.
- Exclusive - In this mode the repeater will use separate JMS connections for replicating data across servers. In the exclusive connection mode, a new Replication Link is added for each link.
Example:
The Shared connection mode can be used when the replication is directed towards multiple topics on a destination. A single connection is used for all the multiple topics.
Type
The Type parameter specifies if a link should be permanently connected to the target Server or if the link should when a subscriber exists.
Valid values:
The default value for the Type parameter is SUBSCRIBER EXISTS.
- SUBSCRIBEREXISTS - The link with the target server that is used for replication does not exist unless there is a subscriber present on that target server.
- ALWAYS - The link that the repeater has with the server will be a permanent link.
ReplyOn
The ReplyOn parameter specifies the destination on which the repeater listens for replies to requests it forwards.
Valid values:
The default value is null.
SourceTopicName
The SourceTopicName parameter specifies the name of the topic on which subscriptions are made on source Server of the link.
Valid values:
The default value of the SourceTopicName is primaryTopic.
TargetTopicName
The TargetTopicName parameter specifies the name of the topic on the target server where messages are replicated.
Valid values:
The default value of the TargetTopicNameParameter is secondaryTopic.
MessageSelector
The MessageSelector parameter specifies the selector that is set on a link between the Servers that ensures only the required messages are exchanged between Servers.
Valid values:
The default value of the MessageSelector parameter is null.
Only messages where header and property values match those of the selector will be readable. A message selector matches a message if the selector arrives as true when the message header values and property values are substituted by their corresponding identifiers by the selector. If the value of a message selector is an empty string, the value is treated as a null and indicates that there is no message selector for the message consumer.