Archive Integration Guide › External Agent API › Install the External Agent API

Install the External Agent API

You install the External Agent API with the CA DataMinder Integration Agents installation wizard.

To install the External Agent API

1. Find setup.exe in the root of your CA DataMinder distribution image. Run setup.exe to launch the CA DataMinder installation wizard.

   The Installation Type screen opens.

2. Click Advanced Installation.
3. In the Advanced Install Options screen, choose Server Agents and then click Install.

   This launches the Integration Agents installation wizard in a separate window.

4. In the Integration Agents installation wizard, navigate to the Customer Setup screen.
5. In the Custom Setup screen, choose External Agent API.
6. In the External Agent API Configuration screen, choose whether to install a Remote Policy Engine Connector (that is, a policy engine hub) and the Socket API. If you install the:
   • Remote Policy Engine Connector, you must programmatically configure the External Agent API output destination to be a local hub. Full details are in the External Agent COM API Specification.
   • Socket API, you can use socket connections to call the External Agent API from a remote location, including from a non‑Windows system. For example the CA DataMinder Network uses the Socket API to analyze traffic leaving or entering the corporate network from the internet. By default, the Socket API automatically listens on port numbers 8538 and 8359.
7. If you chose to install a Remote Policy Engine Connector in step 6, specify the PE domain user in the Policy Engine Hub Configuration screen.
8. In the final wizard screen, click Install to start the file transfer.
9. When the file transfer is complete, the wizard installs the necessary DLLs and registry values to the External Agent API machine.
   1. It creates a new CA DataMinder installation folder (unless this folder exists already, containing Event Import). It then installs Wgnrdi.dll to the \client subfolder of this CA DataMinder folder.
   2. It creates the following registry key. You may need to edit registry values in this key.

      HKEY_LOCAL_MACHINE\Software\ComputerAssociates\CA DataMinder
        \CurrentVersion \External Agent API
      

10. (Required for EAS integration only) If you are integrating with an EAS archive, follow these steps:
    1. Find EAS.ini in the Windows (‘systemroot’) folder of the EAS machine.
    2. Edit EAS.ini and add the following line to the [FULLTEXT] section:

       ComplianceDLL=<path>\wgnrdi.dll
       

       Where <path> is the full path to Wgnrdi.dll (that is, the External Agent API), installed in step 5.

    3. Run the EAS indexer process.

       The External Agent API to start converting messages from the email archive and saving them in the EVF file cache.

11. The External Agent API installation is now complete.

More information:

Specify a PE Domain User