User Guide › Design › Data Acquisition › Adapters › Deploying Adapters › Adapter Manager › Configuring Adapters

Configuring Adapters

Before using the Adapter Manager for the first time on a server, it is necessary to configure its settings to the environment.

1. Run the AdaptersManager.exe utility. The Adapters Manager window is displayed.
2. From the toolbar, select Tools/Options. The Options window is displayed.
3. In General, check the Adapter root directory, which is where the Adapter Manager places all adapters. Each one of the adapters is created in its own folder underneath this. The Adapter root directory field controls the name and path of the folder where all adapters are located. It is within this folder that the Adapters Manager creates an individual folder for each new adapter and places the relevant files.
4. In Generic Adapters, enter the name and full path of the Adapter's executable files in the File Adapter and SQL Adapter fields (or use Browse to find it). The Adapters Manager requires this information in order to create a copy of these files when creating a new adapter. For each individual adapter created by the Adapters Manager utility, a copy of one of the executable files (according to the adapters type; SQL or File) is created.
5. In Log Server, enter the IP address of the Log Server in the Network Address field. This is the IP of the application server if remote, and localhost if the Adapters Manager is located on the same computer as the application server.

   Enter the Log Server's port number in the Port field (usually 4040).

   Note: The port number and IP address of the Log Server are defined in the Registry.xml file.

6. From the toolbar, select Tools/Templates. The Configuration Options window is displayed.
7. The configuration template file is an adapter's configuration file that contains the requested XML structure that the adapter's XML engine needs. There are a few templates available (e.g. File Adapter and SQL Adapter templates) each with the relevant structure. For each of these templates there is a Minimal and Maximal version.

   Note: Use the configuration templates as a basis for your configuration files. It makes the task easy and safe.

8. Select the Use Configuration Templates check box to have the Adapters Manager create a copy of the template for each adapter created.
9. Enter the name and location of the configuration template for each type of adapter in the File Adapter and SQL Adapter fields.
10. From the toolbar, select Tools/RegEdit. The Registry Editor window is displayed.

    Note: The Registry Editor opens directly on the adapter's entry.

    For each adapter created, a new entry with the related properties is created in the main adapters section. The Adapters Manager handles the registry for the adapters, so there is no need to perform it manually.

    Note: When changes to the Adapter's properties are made or mistakes are done while creating a new adapter, the values can be changed manually, directly in the registry at any time.