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.
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.
Changing how often to check for new mail
Control how often the Connections Mail Plug-in checks the server for new mail. Changing these settings can reduce the load on your server infrastructure, or allow you to check for new mail more frequently.

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.
    - Changing how often to check for new mail
      Control how often the Connections Mail Plug-in checks the server for new mail. Changing these settings can reduce the load on your server infrastructure, or allow you to check for new mail more frequently.
    - Changing settings for files and attachments
      Set the maximum attachment size for Exchange users, the default option when users attach files, and if users can share files that they receive in email.
    - Changing other settings
      You can enable dynamic search, hide links to HCL iNotes® or Microsoft™ Outlook Web Access, or disable active content filtering for Microsoft Exchange information.
- Uninstalling the HCL Connections™ Mail Plug-in
  To uninstall the HCL Connections™ Mail Plug-in, use IBM® Installation Manager. For IBM i, uninstall manually.

Changing how often to check for new mail

Control how often the Connections Mail Plug-in checks the server for new mail. Changing these settings can reduce the load on your server infrastructure, or allow you to check for new mail more frequently.

About this task

If this is your first time installing the Connections Mail Plug-in, these settings are enabled automatically. After completing all installation and configuration steps, you can change the settings using the following steps.

If you installed a previous version of the Connections Mail Plug-in, you must change the MailPollInterval and MailCheckOnLoadInterval preferences and add the MailPollOnBadge preference to enable the new settings. After you uninstall previous versions and install the current version, complete the following steps.

Procedure

In the WAS-root/AppServer/profiles/Dmgr01/config/cells/cell-name/LotusConnections-config directory, open the socialmail-discovery-config.xml file.

Inside the GadgetConfig tag, add or change the following preferences:

Option	Description
Change how often, in milliseconds, to check for new mail.	Enter an integer inside the `<GadgetPreference id="MailPollInterval"></GadgetPreference>` tag. Do not use commas (,). The recommended value is 1800000, which is 30 minutes.
Check for new mail when users go to a new page in Connections	Enter an amount of time in milliseconds within the `<GadgetPreference id="MailCheckOnLoadInterval"></GadgetPreference>` tag. If this amount of time has passed since the last new mail check, the Connections Mail Plug-in checks for new mail when users reload the page or go to a new page. Do not use commas (,). The recommended value is 300000, which is 5 minutes.
Check for new mail when the new mail icon shows	`<GadgetPreference id="MailPollOnBadge"></GadgetPreference>`To stop checking for new mail when the new mail icon is showing, enter false, which is the recommended value. To check for new mail even when the new mail icon is showing, enter true.

Save and close the socialmail-discovery-config.xml file.
Synchronize the changes from the deployment manager to the nodes. Complete the steps in the following topic: Applying common configuration property changes.

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.