How TIBCO ActiveMatrix® Adapter for Files (Unix/Win) can use the reconnect mechanism to attempt reconnecting to a TIBCO Enterprise Message Service (EMS) server in case of a connection loss?
book
Article ID: KB0091292
calendar_today
Updated On:
Products
Versions
TIBCO ActiveMatrix BusinessWorks Plug-in for Files for Unix and Windows
-
Not Applicable
-
Description
Description: TIBCO ActiveMatrix® Adapter for Files (Unix/Win) (FA) usually throws an error and stops
running in case a EMS server connection is lost. In order to enable a reconnect
mechanism to a single EMS server or switching to another EMS server
running in fault tolerance(FT) mode, FA needs configuration changes in
the project, adapter tra file and EMS servers.
Resolution
In order for FA to attempt reconnecting to an EMS server if the EMS server connection is lost, follow the steps below.
1). Use a comma separated list of the EMS servers in the FA project configuration.
FA can use SDK to reconnect to the TIBCO EMS server.
a). If a single EMS Server is running:
To enable the SDK reconnection feature with a single EMS server, set the JMS Provider URL property to %%JmsProviderUrl%%,%%JmsProviderUrl%% for DefaultJmsTopicSession and DefaultJMSQueueSession.
b). Multiple EMS Servers running in FT mode:
Provide the JMS provider URL property to %%JmsProvider1Url%%,%%JmsProvider2Url%%. For more information, refer to the TIBCO Enterprise Message Service User's Guide, Chapter 13, Fault Tolerance.
2). Modify the adapter tra file:
Set tibco.jmsReconnectCount to 100 (the default value is 4) and tibco.jmsReconnectDelay to 2000 (the default value is 500). You can include these properties in the adfilesagent.tra file which act as a template for generating a tra file. Avoid modifying the tra file for each file adapter instance.
3). Specify multiple EMS Servers in a comma separated list for factories used in the FA project.
Example: URL1,URL2 for TopicConnection and QueueConnection factory for factories.conf file of each EMS Server.
Issue/Introduction
How TIBCO ActiveMatrix® Adapter for Files (Unix/Win) can use the reconnect mechanism to attempt reconnecting to a TIBCO Enterprise Message Service (EMS) server in case of a connection loss?