Implementation Guide › Implementation › Data Gathering (Data Source Expert) › How to Configure Adapters and Translations › Execute and Test the Adapter

Execute and Test the Adapter

The setting of the Adapter configuration file cannot usually be completed in a single cycle. It may need a number of iterations during which the Adapter is executed, and the results are checked in order to ensure that the Adapter configuration is correct.

Following are some of the more common issues that need to be corrected:

• Connection problems (either between data source and Adapter or Adapter and Listener)
• Mistakes in the configuration file, such as:
  • Wrong structure
  • Wrong use of attributes
  • Wrong case used (Adapter are case sensitive - 'Yes' and 'yes' are different, and so on)
  • Wrong value assignment
• Data manipulation mistakes, such as, output Event structure, wrong event values, mistake in queries.

Follow these steps:

1. Set the Adapter to RunOnce = “yes” and LogDebugMode = “yes”, as well as setting the RejectedEventsUpperLimit to a reasonable number (see Adapter Running Modes).

   The following figure shows the configuration settings required for testing.

2. It is also possible to use the offline mode for the purposes of the configuration file settings.
3. Once the configuration file has loaded successfully, change the setting back to online (see Adapter's running modes).
4. Each iteration includes the following steps:
   1. Update/fix the Adapter configuration file.
   2. Delete all of the Adapter's output files.
   3. Run the Adapter by double-clicking the shortcut to the Adapter executable or the .bat file that was created.
   4. Open the Adapter's log file using the Log browser (Log Browser.exe utility placed in CA Business Service Insight Utilities) and check that there are no error messages.
5. The first step is to get a correct configuration file and to reach a state where the Adapter loads the configuration file successfully. Repeat this step until you successfully connect to CA Business Service Insight and to the data source and have rejected events and requests for translation.
6. To complete this stage check the following:
   • There are no error messages in the Adapter's log file.
   • Adapter connects to CA Business Service Insight and the data source successfully.
   • Adapter sent requests for translations and rejected events.

   You should expect to see the letter "R" appear on the console for every record the Adapter rejects. Remember that rejected events are expected until all of the necessary translations have been completed.

7. Check that the rejectedEvents file contains records and is not empty.

   

8. Login to CA Business Service Insight and go to the Translation entries page and search for pending Translation entries from your Adapter. You should expect to have several entries, one for each Translation request the Adapter has sent.

   WARNING: Deleting the Adapter's output files is very risky. It should be done only at this stage for testing purposes. For example, when deleting the control file, the Adapter loses track of the files it has already read and may therefore lose data or read files again. The only file that can be deleted during operational mode without functional consequences is the log file.

To use the log browser to view the error messages:

If there is an error message, double-click the message and read it. This is usually caused by an error in the configuration file.