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?

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?

Additional Information

References
========
TIBCO Enterprise Message Service User's Guide, Chapter 13 Fault Tolerance