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.

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?

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.

Additional Information

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