In order to ensure that the IBM Connections Mail component is functioning across multiple mail servers, and to have mail discovery configured correctly, the following configuration file (socialmail-discovery-config.xml) needs to be created/modified:
<ServerConfig name="domino-config"> <ConfigType>DOMINO</ConfigType> <DirectoryServer>domino.example.com</DirectoryServer> <DirectoryUser>username</DirectoryUser> <DirectoryPW>adminpw</DirectoryPW> <MailPattern type="example.com" /> <MailPattern type="example2.com" /> </ServerConfig> |
Where:
Property |
Value |
<ConfigType></ConfigType> |
Enter DOMINO |
<DirectoryServer></DirectoryServer> |
Enter the IP address or the fully qualified host name of the Domino LDAP server that is used to determine the validity of email addresses and to return users’ mail setup data. Example: 192.168.1.90 or nts-r90.d-pit.local |
Optional: <port></port> |
To specify a port for the URL specified in the DirectoryServer tag, enter the port number. The protocol for this port must match the protocol used to access Connections. |
<DirectoryUser></DirectoryUser> |
Enter the name of a Lotus Domino user that has full read access to the LDAP service. Note: Enter only the username. For example, do not include "cn=" or "domain/". |
<DirectoryPW></DirectoryPW> |
Enter the password for the Lotus Domino user specified in the DirectoryUser tag. |
Optional: <FixedServer></FixedServer> |
To specify a mail server that might not be the user’s primary server, enter the IP address or fully qualified host name. Example: 192.168.1.90 or https://nts-r90.d-pit.local If this server includes a non-default port, the protocol must match the protocol used to access Connections. |
<MailPattern type=" "/> |
For each domain of email addresses that use this server configuration, enter <MailPattern Example: <MailPattern type="d-pit.com"/> |
So a live, and working, version of the socialmail-discovery-config.xml file is as follows:
<?xml version="1.0" encoding="UTF-8"?> <!-- ***************************************************************** --> <config id="socialmail-discovery-config" version="1.0" xmlns:xsi="http://www.w3.org/2001/ XMLSchema-instance" xsi:noNamespaceSchemaLocation="socialmail-discovery-config.xsd"> <discovery> <!--Example of Domino server, no encryption--> <ServerConfig name="dominoconfig" enabled="true"> <ConfigType>DOMINO</ConfigType> <DirectoryServer>nts-r90.d-pit.local</DirectoryServer> <DirectoryUser>ldapconnections</DirectoryUser> <DirectoryPW>ldapconnections</DirectoryPW> <MailPattern type="d-pit.com"/> </ServerConfig> </discovery> <GadgetConfig> <GadgetPreference id="MailSearchInterval">5000</GadgetPreference> </GadgetConfig> </config> |
Once this is done, restart your IBM Connections servers (for some reason just restarting the applications did not appear to work!)
Allow plenty of time for the IBM Connections, DB2 and Web services to start correctly, and then in Internet Explorer (or FireFox), enter the following URL:
https://connections.d-pit.local/connections/resources/discovery/DiscoveryServlet?email=This email address is being protected from spambots. You need JavaScript enabled to view it.
And you should be presented with:
The section to note is <fullapp>, as this indicates the full URL that will be used to access the users' mail file.