Deployment Guide › Third-Party Integration › External Agent API › Install the External Agent API

Install the External Agent API

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

To install the External Agent API

1. Launch the CA DLP installation wizard. To do this, run setup.exe in your CA DLP distribution image.
2. In the Installation Type screen, choose 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 DLP 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, you must specify the PE domain user in the Policy Engine Hub Configuration screen; for details about this domain account.
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 DLP installation folder (unless this folder exists already, containing Event Import). It then installs Wgnrdi.dll to the \client subfolder of this CA DLP folder.
   2. It creates the following registry key. You may need to edit registry values in this key.

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

10. EAS integration: If you are integrating with an EAS archive, you must now:
    1. Edit the EAS.INI file. Find this in the Windows (‘systemroot’) folder of the EAS machine 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.

    2. Run the EAS indexer process. This causes the External Agent API to start converting messages from the email archive and saving them in the EVF file cache.
11. EmailXtender integration: If you are integrating with EMC EmailXtender, you must now enable integration with CA DLP by adding a registry value to the following registry key:

    HKEY_LOCAL_MACHINE\Software\OTG\EmailXtender
    

    Add the EnableOrchestriaIntegration registry value to this key and set it to 1.

12. This completes the External Agent API installation.

More information:

Socket API

Specify a PE Domain User

Configure the External Agent API