Home
Administering Connections 6.5
Welcome to the HCL Connections 6.5 documentation. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
Installing
To install HCL Connections™, you need to follow a detailed series of procedures.
Post-installation tasks
After installation, you need to perform further tasks to ensure an efficient deployment.
Configuring additional HCL Connections applications
You must perform additional tasks to enable HCL Connections for the Orient Me home page, the Touchpoint interactive user experience, Community Libraries, Community Surveys, Metrics applications, and more.
Configuring Connections Content Manager for Libraries
If you installed the Connections Content Manager add-on, you must configure FileNet® to work with Connections Content Manager. Choose the instructions that match your deployment: either an existing FileNet deployment, which you installed independently before you installed HCL Connections or a new, integrated FileNet deployment that is part of a new HCL Connections installation.
Configuring HCL Connections Content Manager with an existing FileNet® deployment
An existing FileNet® deployment is one that was installed independently of HCL Connections. Because it was installed separately, you must take additional steps to set up your implementation of IBM® Filenet to work with Connections Content Manager.

Administering Connections 6.5
Welcome to the HCL Connections 6.5 documentation. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
- What's new in HCL Connections
  Find out about features that are new or updated in this release of HCL Connections.
- Product overview
  Learn how to deploy, customize, and administer the HCL Connections social networking product.
- Planning
  Before installing HCL Connections™, study the system requirements, deployment options, and documentation conventions.
- Installing
  To install HCL Connections™, you need to follow a detailed series of procedures.
  - The installation process
    Review the steps that are required to install HCL Connections.
  - Pre-installation tasks
    Complete the following tasks before installing HCL Connections. If you are migrating from a prior release of HCL Connections, do not complete the tasks for creating databases or populating the Profiles database. The migration process handles those tasks automatically.
  - Installing HCL Connections
    Select the HCL Connections applications that you plan to use and install them in a clustered deployment.
  - Post-installation tasks
    After installation, you need to perform further tasks to ensure an efficient deployment.
    - Registering custom widgets
      Register all custom and third-party widgets starting with HCL Connections™ 6 CR1 \IFR1 to ensure they meet security requirements and can display in communities.
    - Reviewing the JVM heap size
      Review the size of the Java™ Virtual Machine heap and adjust it, if necessary, to avoid out-of-memory errors or to suit your hardware capabilities.
    - Configuring IBM® HTTP Server
      When you have successfully installed HCL Connections™ to run on WebSphere® Application Server, you can configure IBM® HTTP Server to handle web traffic.
    - Configuring the Home page administrator
      Create an administrator for Home page so that you can make changes to the application such as adding and removing widgets.
    - Configuring additional HCL Connections applications
      You must perform additional tasks to enable HCL Connections for the Orient Me home page, the Touchpoint interactive user experience, Community Libraries, Community Surveys, Metrics applications, and more.
      - Optional: Installing the Component Pack for Connections™
        The Component Pack for HCL Connections™ introduces new connectivity capabilities that enhance collaboration and boost productivity.
      - Setting up stand-alone Elasticsearch
        Deploy Elasticsearch as a stand-alone server for use with HCL Connections™, instead of deploying it as part of the Component Pack for Connections.
      - Setting up type-ahead search
        Enable type-ahead search in HCL Connections™ to suggest items in the search box based on content that is relevant to each user.
      - Installing Customizer Lite
        This topic describes how to install Customizer Lite. There are two deployment options, hereby referred to as Customizer Lite and Customizer Lite HA. Customizer Lite – the most basic deployment using a single Docker node running a single instance of each required service, and Customizer Lite HA – a more resilient deployment using a pair (or more) of Docker nodes all running instances of each required service with requests load balanced across available nodes.
      - Configuring Connections Content Manager for Libraries
        If you installed the Connections Content Manager add-on, you must configure FileNet® to work with Connections Content Manager. Choose the instructions that match your deployment: either an existing FileNet deployment, which you installed independently before you installed HCL Connections or a new, integrated FileNet deployment that is part of a new HCL Connections installation.
        Configuring a new FileNet® deployment for the first time
        A "new" FileNet® deployment refers to any HCL Connections installation where you chose to create a FileNet deployment when you installed Connections Content Manager. Follow this procedure only if you installed HCL Connections Manager for the first time and are ready to set up the required data storage. The procedure does not apply to a new FileNet deployment that was migrated from an earlier version of HCL Connections, which already has the required components nor does it apply to an existing FileNet deployment that was installed independently of HCL Connections.
        Configuring HCL Connections Content Manager with an existing FileNet® deployment
        An existing FileNet® deployment is one that was installed independently of HCL Connections. Because it was installed separately, you must take additional steps to set up your implementation of IBM® Filenet to work with Connections Content Manager.
        Giving the HCL Connections administrator access to an existing FileNet® deployment
        If you have an existing FileNet® deployment, in which you installed FileNet servers independently of HCL Connections, you must make the HCL Connections administrator a valid administrator on the FileNet system. The easiest way to do that is to make the Connections administrator a user in a shared LDAP. The user name must not have any spaces.
        Configuring Profile and Community membership lookups for FileNet®
        You must deploy both IBM® FileNet® and HCL Connections with the same WebSphere® federated repositories. In other words, the HCL Connections cell security configuration must be pointing to the same LDAP directory that your IBM FileNet is configured to use, with identical configuration options.
        Generating Security identifiers for an existing FileNet deployment
        You need to generate Security Identifiers (SID) values for installing HCL Connections Content Manager with an existing FileNet® deployment.
        Preparing an object store to be used by Connections
        You must prepare an object store so that it can be used by HCL Connections.
        Configuring WebSphere® encrypted connections for Activity Stream
        Configure WebSphere® encrypted connections for Activity Stream when you are installing FileNet® into an existing Connections deployment.
        Setting up anonymous access
        If anonymous access has not been enabled for IBM® FileNet® Collaboration Services, enable it now. HCL Connections requires anonymous access to be set in FileNet for public communities.
        Configuring collaborative features in FileNet®
        You can set up and maintain FileNet® collaborative features using the Administration Console for Content Platform Engine (ACCE) on the FileNet system to create and administer an Object Store.
        Updating Waltz and Sonata Jars
        After you upgrade Content Engine (CE) 5.2.0.3 to version 5.2.0.3 + IF003 by using the update-ce script, the old waltz.jar and sonata.jar files are used in the FileNetEngine application. Since these older files are used, some fixes are not included in the updated HCL Connections environment.
      - Optional: Configuring HCL Connections Docs with CCM
        You can enable community members to edit files in Community libraries online if you have already installed HCL Connections Docs.
      - Installing Community Surveys
        If you want to be able to conduct surveys within Communities to capture data and share it easily with your community in an activity stream, enable Community Surveys.
  - Optional: Installing and configuring the Tiny Editors for HCL Connections
    HCL Connections 6.5 can use the optional Tiny Editors: TinyMCE or Textbox.io, to replace the HCL Connections™ default rich text editor.
  - Copying Search conversion tools to local nodes for AIX and Linux
    To enable full indexing of data, copy the Search conversion tools to local nodes.
  - Copying Search conversion tools to local nodes for Windows
    To enable full indexing of data, copy the Search conversion tools to local nodes.
  - Optional post-installation tasks
    Complete the post-installation tasks that are relevant to your deployment.
- Uninstalling HCL Connections
  Uninstall HCL Connections.
- Migrating and updating
  Migrate HCL Connections™ and its supporting software to the latest release and then update the installation with the latest deployment, interim fixes, or Cumulative Refresh (CR).
- Administering
  Run administration and maintenance tasks to keep your environment up-to-date. For example, learn how to customize your deployment or how to use the wsadmin utility to edit configuration files. You can also schedule tasks, maintain application databases, moderate content, or manage users and their roles.
- Customizing
  Customize HCL Connections™ to fit your environment.
- Security
  HCL Connections™ provides a flexible security infrastructure that supports an open, easily shareable data model.
- Mobile
  See the HCL Connections™ Mobile documentation for Connections Cloud and Connections on-premises.
- Developing
  Get information about how to use the APIs provided with HCL Connections™ and how to use Connections Customizer to modify the Connections pages that are returned to users.
- Troubleshooting and support
  To isolate and resolve problems with your HCL products, you can use the troubleshooting and support information. This information contains instructions for using the problem-determination resources that are provided with your IBM® products, including HCL Connections™.

Configuring HCL Connections Content Manager with an existing FileNet® deployment

An existing FileNet® deployment is one that was installed independently of HCL Connections. Because it was installed separately, you must take additional steps to set up your implementation of IBM® Filenet to work with Connections Content Manager.

Before you begin

To use an existing FileNet® deployment with Connections Content Manager, the existing deployment must be configured to use HCL Connections as a directory provider. Changing configuration of the directory or changing JVM arguments used in FileNet® directory configuration may only be done during FileNet® domain creation or afterward with services for directory migration. Contact IBM® services to migrate the directory service provider to use HCL Connections.

Note: OAuth is supported by the Connections WebSphere® cell. OAuth is enabled only when FileNet® is installed through the Connections installer. OAuth is used for single sign-on with other applications including IBM® Notes®. Download events are not available in the Connections event SPI and metrics might not include download information when Connections Content Manager uses an existing FileNet® deployment.

For an existing FileNet® system, ensure that single sign-on (SSO) has been configured between your FileNet® and Connections servers. WebSphere® LTPA SSO is recommended. Refer to Configure SSO between IBM® FileNet® and HCL Connections for more information.

To understand which add-ons need to be installed in the object store, refer to Preparing an object store to be used by Connections.

What to do next

To complete the configuration, make sure to configure collaborative features in FileNet® using the Administration Console for Content Platform Engine (ACCE) on the FileNet® system.

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.