Connection Manager


Connection Manager icon

IMPORTANT:  For the Connection Manager to have a comprehensive record of all authenticated users, you can have only one Connection Manager per messaging system.

Connection Manager's primary function is to keep track of authenticated users. When a user logs in via POP3 or IMAP, the POP or IMAP Agent grabs the client's IP address and sends it to the Connection Manager. Connection Manager then keeps track of the IP address for a designated amount of time (the default is 15 minutes).

In NetMail 3.5, Connection Manager is utilized by the SMTP agent for SMTP-after-POP. For more information, see SMTP-after-POP.

WARNING:  If you are using a Proxy Server, we recommend that you use ESMTP authentication rather than SMTP-after-POP because the same IP address might be assigned to multiple users. For more information on SMTP authentication, see the Allow Remote Sending for Authenticated Users Only feature in the SMTP Agent.


Creating the Connection Manager

To create the Connection Manager, select the messaging server where you want to create the Connection Manager and choose Connection Manager from the Create menu.

After you create the Connection Manager, you must restart the messaging server. For information on restarting the messaging server, see Starting and Stopping NetMail.


Configuring the Connection Manager

From the Connection Manager's configuration menu, you can configure the following options:

Option Function
Configuration

 

Expiration Timeout

The amount of time (in minutes) that an IP address is stored by the Connection Manager Agent. You can designate any value between 5 and 1440 minutes.

IMPORTANT:  You must restart the gkeeper executable to effect any changes in this property. See Loading and Unloading NetMail Agents for more information.

Status

 

 

By default, the Connection Manager Agent is enabled. To disable the Connection Manager Agent:

  1. Select Disabled.
  2. Click Save.

Disabling the agent prevents the messaging server from launching the Connection Manager Agent at startup. However, to immediately disable the agent, you must manually unload the gkeeper executable or restart the messaging server. For more information on manually unloading NetMail agents or restarting the messaging server, see Starting and Stopping NetMail.

After the Connection Manager Agent is disabled, the messaging server does not launch the gkeeper executable again until you select Enabled and restart the messaging server.


Configuring the Connection Manager Settings in the Messaging Server Object

For the SMTP Agent to find the Connection Manager for SMTP-after-POP, you must enable the Connection Manager and specify the IP address or fully distinguished name of the server running the Connection Manager in the Messaging Server object's Identification page.

IMPORTANT:  For Connection Manager to have a comprehensive record of all authenticated users, you can only have one Connection Manager per messaging system.