Home
Deploying the HCL Connections Mail Plug-in
The HCL Connections Mail Plug-in can be integrated into HCL Connections to let users use their inbox and view their calendar in Connections.
Configuring the HCL Connections™ Mail Plug-in
After installing the HCL Connections™ Mail Plug-in, you must configure additional options before it is ready to use.
Enabling requests to social mail server using CRE OpenSocial gadgets
Enable the CRE OpenSocial gadget to ensure that the Connections Mail Plug-in works properly.

Deploying the HCL Connections Mail Plug-in
The HCL Connections Mail Plug-in can be integrated into HCL Connections to let users use their inbox and view their calendar in Connections.
- Installation overview
  Before you install, review the steps that are required to install the HCL Connections™ Mail Plug-in.
- HCL Connections™ Mail Plug-in system requirements
  HCL Connections Mail Plug-In installs on all systems adhering to the general HCL Connections system requirements.
- Accessibility features for HCL Connections Mail
  Accessibility features help users who have a disability, such as restricted mobility or limited vision, to use information technology products successfully.
- Preparing to install the HCL Connections™ Mail Plug-in
  Before you install the HCL Connections™ Mail Plug-in, you must ensure that components are installed and that your environment is configured.
- Installing the HCL Connections™ Mail Plug-in
  To install the HCL Connections™ Mail Plug-in, use IBM® Installation Manager, the same program that is used to install HCL Connections. For IBM i, manual installation is required.
- Configuring the HCL Connections™ Mail Plug-in
  After installing the HCL Connections™ Mail Plug-in, you must configure additional options before it is ready to use.
  - Enabling or disabling access to the HCL Connections™ Mail Plug-in
    To let users see the mail and calendar icons in HCL Connections, add users to the mail-user role that is associated with the common application. You can enable this feature for all authenticated Connections users.
  - Enabling the discovery service for the HCL Connections™ Mail Plug-in
    The discovery service enables the HCL Connections™ Mail Plug-in to access HCL Domino® or Microsoft™ Exchange mail services. The discovery service must be configured before running the HCL Connections Mail Plug-in.
  - Enabling help for the HCL Connections™ Mail Plug-in
    To see help topics for the HCL Connections™ Mail Plug-in, you must add the new help plug-in to your environment, and then add a section to the HCL Connections help system.
  - Enabling the Connections Mail Plug-in for environments that use both HTTP and HTTPS
    If your environment uses both HTTP and HTTPS between your Domino servers and Connections servers, complete these steps, so you can use the Connections Mail Plug-in.
  - Enabling requests to social mail server using CRE OpenSocial gadgets
    Enable the CRE OpenSocial gadget to ensure that the Connections Mail Plug-in works properly.
  - Domino® only: Enabling embedded experiences
    If you enable embedded experiences, HCL Connections™ Mail Plug-in users can interact with applications, such as Connections Files, from within some emails. For example, when someone shares a file with you in Connections Files, you receive an email notification. With embedded experiences, you can like or comment on that file from within the notification.
  - Optional: Changing settings in the HCL Connections™ Mail Plug-in
    You can customize the HCL Connections™ Mail Plug-in by changing settings in the socialmail-discovery-config.xml file.
- Uninstalling the HCL Connections™ Mail Plug-in
  To uninstall the HCL Connections™ Mail Plug-in, use IBM® Installation Manager. For IBM i, uninstall manually.

Enabling requests to social mail server using CRE OpenSocial gadgets

Enable the CRE OpenSocial gadget to ensure that the Connections Mail Plug-in works properly.

After you set up the HCL Connections Mail plug-in, perform the following procedure to ensure that the plug-in works as intended.

Note: If you encounter the error message "Mail server cannot be reached" when you hover over the mail icon, it means that requests to the social mail server have not been allowed from the CRE OpenSocial gadgets. In this case, the following steps would resolve the issue.

Register the CRE gadget and check that the "Connections Mail" application is enabled: Log in as a Connections administrator and from the Homepage Administrator page, click Homepage > Administration > Enabled Apps.
Complete the steps outlined in Configuring per-host proxy access rules for OpenSocial gadgets, if not already.
Add an "allow mail hostname" rule, that is:
```
allow('.*', '.*', '.*\.domain\.com.*')
```
Where domain is your mail server domain.
For details on configuring access rules, refer to the previous step.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.