IBM Support

Setting up IBM Content Collector for Outlook Web Application with Load Balancer

Troubleshooting


Problem

The IBM Content Collector Outlook Web Access (OWA) 4.0.1.3 and the older versions involve manual configuration while setting up the Microsoft Exchange server, where the server runs behind a Load Balancer.

Resolving The Problem

The IBM Content Collector 4.0.1.8 Interim Fix 010 offers to automates the process. This interim fix eliminates the need to configuring the files installed on Microsoft Exchange Server, manually.

The following information is applicable for setting up the IBM Content Collector for Outlook Web Access (OWA) where the Microsoft Exchange server is running behind a Load Balancer as well as a proxy server.

Manual configuration scenarios
  1. To map the entries between the Microsoft Exchange Server and the Load Balancer in the OWA service configuration, on the ICC server.
    For details on mappings, see  Configuring URL mappings to Exchange servers .
  2. To update the ICCApp.xml for OWA extension on the Microsoft Exchange Server with the Load Balancer host name, instead of the Microsoft Exchange Server host name.
  3. To update the ibm_config.js file for OWA extension on the Microsoft Exchange Server with the Load Balancer as host name.
    This file is not a part of the initial installation; it is generated later by the Apply Configuration utility.

Installing Content Collector Outlook Web App Support
The IBM Content Collector OWA support comprises the OWA Service and OWA Extension. These components can be installed on the same machine or on different machines. If you are upgrading from an earlier IBM Content Collector release, you do not have to uninstall the earlier OWA support installation; simply run the wizard. The component is automatically installed in the previous installation location.

To run the installation wizard in GUI mode:
  1. Navigate to where you extracted the IBM Content Collector installation package.
  2. Run the following command and follow the wizard:
    install.exe
  3. When on the Product Components screen, select the appropriate components to be installed. You can choose to install the OWA Extension and the OWA Service on the same or different machines. In case of an upgrade scenario, the IBM Content Collector Configuration Web Service Host name and Port values will be prepopulated from the existing configuration and the same can be updated, if required.
  4. On Load Balancer / Proxy Server screen, which is newly added in this Interim Fix, enter the Load Balancer / Proxy Server Host name if your Microsoft Exchange Server is running behind the Load Balancer / Proxy Server. If not, leave it blank.
    In case of an upgrade scenario, the Load Balancer / Proxy Server Host name value will be prepopulated from the existing configuration and the same can be updated, if required.
  5. Review the Preinstallation Summary and click Install to start the installation.
    In case of an upgrade scenario, you will be intimated to replace the existing configuration files. Proceed with replacing the same.

To run the installation wizard in Console mode:
  1. Open the command prompt as an administrator and change to the directory with extracted IBM Content Collector OWA installation package.
  2. Run the following command and follow the instructions:
    install.exe -i console
  3. For Product Components section, enter the comma separated options for the component/s to be installed.
  4. For Application Server section, enter IBM Content Collector Configuration Web Service Host name and Port.    In case of an upgrade scenario, the IBM Content Collector Configuration Web Service Host name and Port values will be prepopulated from the existing configuration as default and the same can be updated, if required.
  5. For Load Balancer / Proxy Server section, which is newly added in this Interim Fix, enter the Load Balancer / Proxy Server Host name if your Microsoft Exchange Server is running behind the Load Balancer / Proxy Server. If not, leave it blank.
    In case of an upgrade scenario, the Load Balancer / Proxy Server Host name value will be prepopulated from the existing configuration as default and the same can be updated, if required.
  6. Review the Preinstallation Summary and press Enter to start the installation.
    In case of an upgrade scenario, you will be intimated to replace the existing configuration files. Proceed with replacing the same.

To run the installation wizard in Silent mode:
  1. Open the command prompt as an administrator and navigate to where you extracted the IBM Content Collector OWA installation package.
  2. Run the following command and follow the instructions:
    install.exe -i silent -f <<input text file>>

The content for the input text file should be as the following. The sample input values are in Italic-Bold.

# Accept the license panel
LICENSE_ACCEPTED=TRUE

#Install IBM Content Collector OWA Support
# Set OWA components
USER_INPUT_OWA_EXT=1
USER_INPUT_OWA_SRV=1

# Set the installation folder.
USER_INSTALL_DIR=C:\\Program Files (x86)\\IBM\\ContentCollector_OWASupport

# Set ICC Configuration Host name
USER_INPUT_WEB_SERVER_1=vmWebServer.testdomain.ibm.com

# Set ICC Configuration port number
USER_INPUT_SERVER_PORT_1=11443

# Set Load Balancer/Proxy Server host name USER_INPUT_LOAD_BALANCER_URL_1=ExLoadBalancer.testdomain.ibm.com

For more details on installing and configuring Content Collector Outlook Web App Support, see:

Configuring Content Collector Outlook Web App Support with Microsoft Exchange Server running behind Load Balancer

Additional Configuration on IBM Content Collector Server
For setting up OWA with the Microsoft Exchange Server running behind Load Balancer, the OWA service configuration on IBM Content Collector Server needs mapping entries between the exchange server and the Load Balancer.
For more details on mappings see  Configuring URL mappings to Exchange servers .

Additional Configuration on Microsoft Exchange Server
Once the installation is finished and configuration changes are completed on the IBM Content Collector Server, apply the OWA Extension configuration:
  1. Log on to the server on which the OWA Extension is installed.
  2. Enable the IBM Content Collector OWA apps for Office 2013 (applicable only for Exchange 2013)
  3. Select All Programs > IBM Content Collector > Apply Configuration

The configuration data that you entered using the Configuration Manager is accessed from the IBM Content Collector web server and applied to the server on which the OWA Extension is installed.

The Apply Configuration also accesses the OWA service configuration to extract the mappings information and updates the Load Balancer URL in the ibm_config.js file. No manual intervention is required to update this file.

Note:
  • Any post-installation changes in the Load Balancer / Proxy server host name details can be applied to ICCApp.xml by running the installer again with the updated Load Balancer / Proxy server host name details, or by updating the Host name details in ICCApp.xml manually.
  • For the ibm_config.js file, the Load Balancer / Proxy server host name details can always be applied by running the Apply Configuration once the IBM Content Collector Server configuration is updated.
  • When you click on IBM Content Collector Add-in in the Outlook Web Access and encounter an error, or the IBM Content Collector Add-in buttons are not displayed, do the following:
    a. In Microsoft Exchange Center, remove the IBM Content Collector Add-in and add it again.
    b. In Outlook Web Access, disable the IBM Content Collector Add-in and enable it again.

Document Location

Worldwide


[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSAE9L","label":"Content Collector"},"Component":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"4.0.1.8","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

More support for:
Content Collector

Software version:
4.0.1.8

Operating system(s):
Windows

Document number:
870930

Modified date:
11 February 2019

UID

ibm10870930

Manage My Notification Subscriptions

Page Feedback