Implementation Guide › Implementation › Data Gathering (Data Source Expert) › How to Configure Adapters and Translations › Deploy a New Adapter (Manually)

Deploy a New Adapter (Manually)

Prerequisites for Creating a New Adapter

All of the following need to be in place before starting to create a new Adapter:

• Adapter's root folder: If CA Business Service Insight is installed on the server, this folder exists under the Program Files\CA\Cloud Insight root folder, if not, it should then be created.
• Individual Adapter folder: Create a folder under the Adapter's root folder for the specific Adapter.

  Note: If you are using the AdapterManager utility, the utility automatically creates the folder when adding the new Adapter.

• Adapter's executables: TextFileAdapter.exe, the text file adapter's executable for text file Adapter; SQLAdapter.exe, SQL file adapter's executable for the SQL Adapter. These can be found on the application server under the Program Files\CA\Cloud Insight\Adapters folder.

  Note: During the Adapter creation process via the Adapter Manager utility, whenever possible, you should choose the option to create a shortcut to the executables, rather than create a copy. This ensures that when an upgrade or service release (SR) is applied to CA Business Service Insight all of the binary components are updated correctly.

• Configuration Templates: Templates of the Adapter configuration file. Place the files in the Adapter's root folder. These can be found on the application server under the Program Files\CA\Cloud Insight\Adapters folder. The configuration templates are used to create the configuration file to avoid having to create them from scratch. It is also common to use an existing Adapter configuration file for this purpose.
• Adapter Manager utility: A standalone executable. It is sufficient to make a copy of the AdaptersManager.exe from the Utilities folder under the Program Files\CA\Cloud Insight\Utilities folder on the application server. It is not necessary to create the Adapter using this utility, and this utility can be used only on a Windows server.
• Two open TCP\IP ports: One port for the AdapterListener on the Application server and another for the LogServer. The LogServer port is usually 4040.
• Check which CA Business Service Insight application service components are running. For the purposes of running the Adapter, the following service components need to be running:
  • AdapterListener
  • TaskHost
  • LogServer

Follow these steps:

1. Run the AdapterManager Utility (see AdapterManager Utility section above).
2. Prepare all the above prerequisites and create a batch file with the executable command line (see Adapter Running Modes).