Message Server Integration Guide › Sendmail and Postfix Integration › Deploy the Socket API and a Remote PE Connector

Deploy the Socket API and a Remote PE Connector

The Milter MTA agent uses the CA DataMinder Socket API to pass Sendmail or Postfix emails to:

• A local policy engine, or
• A Remote PE Connector. This a policy engine hub running on the same machine as the External Agent; this hub then distributes emails to remote policy engines for processing.

You install the Socket API and a Remote PE Connector when you install the External Agent API. In particular, when you install the Socket API you must specify which port number to use for the socket connection between the Milter MTA agent and the External Agent. You will reference this port number when you install the Milter MTA agent.

You install the Socket API and hub with the CA DataMinder Integration Agents installation wizard.

To install the Socket API and a policy engine hub

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
      

For full details about the External Agent API, see the Archive Integration Guide.

More information:

Wgnmilter.conf Parameters

Install the Milter MTA agent