Home
Administering Connections 7.0
Welcome to the HCL Connections documentation site. 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.
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 HCL products, including HCL Connections™.
Troubleshooting tips
Troubleshooting Search
If you experience indexing issues, consider validating Search seedlists to help you identify the source of the problem. You can also configure settings to avoid out-of-memory issues or other problems caused by long response times from the Search application.
Analyzing results from the search serverStatus page
TheHCL Connections™ Search Engine provides the search serverStatus web page that you can use to troubleshoot search issues.
Reviewing the Initial Indexing Exceptions tab
The Initial Indexing Exceptions tab returns any exceptions encountered when crawling the services during an initial index building task.

Administering Connections 7.0
Welcome to the HCL Connections documentation site. 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 Connections
  To install HCL Connections™, you need to follow a detailed series of procedures.
- Installing or upgrading Component Pack for Connections
  HCL Connections 7.0 now supports the latest Component Pack based in Harbor, an open-source container and Helm registry hosted by HCL for the Component Pack build. Deployments that are new or carrying Component Pack 7 will use this approach for a simplified installation/upgrade process, while releases prior to 7.0 will first need to upgrade to Component Pack 7 using a zip file and a local Docker registry.
- Post-installation tasks
  After installation, you need to perform further tasks to ensure an efficient deployment.
- Optional: Installing and configuring Tiny Editors for HCL Connections
  The Tiny editors are alternative rich-text editors which can be installed for HCL Connections™. They provide additional features and extensive customization options not available with the default editor.
- Optional post-installation tasks
  Complete the post-installation tasks that are relevant to your deployment.
- Uninstalling
  Uninstall HCL Connections.
- Upgrading and updating
  Upgrade HCL Connections and its supporting software to the latest release and then update the installation with the latest interim fixes or cumulative fixes. Refer to the What's New in HCL Connections to review the features in the latest release and gather download links or links to the latest fix list and update strategy information.
- 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 HCL products, including HCL Connections™.
  - Techniques for troubleshooting problems
    Troubleshooting is a systematic approach to solving a problem. The goal of troubleshooting is to determine why something does not work as expected and how to resolve the problem. Certain common techniques can help with the task of troubleshooting.
  - Getting product fixes
    A product fix might be available to resolve your problem.
  - Troubleshooting tips
    - HCL Connections log file
      HCL Connections™ writes messages to the SystemOut.log file. Refer to this file if you encounter errors after installing an Connections application or if you encounter unexpected behavior in an application.
    - Troubleshooting connection timeouts when running a wsadmin script
      Running a wsadmin administrative script that calls an MBean in a network deployment environment results in several connections between sever processes, such as the deployment manager, the node agent, and the cluster member using Java™ Management Extensions (JMX) connectors. Some HCL Connections™ administrative scripts can run for longer than the default connection timeout that is specified for the connector that is used.
    - Troubleshooting a database connection
      A faulty JDBC driver or data source can prevent you from accessing an HCL Connections™ application. To troubleshoot and correct these problems, test the database connections.
    - Troubleshooting file download and page display issues
      Enabling ESI cache in IHS will have an adverse affect on HCL Connections™ 6.0 causing some features to fail. Therefore, Edge Side Include (ESI) cache in IHS should be disabled for Connections 6.0.
    - Troubleshooting display problems
      Microsoft™ Internet Explorer versions 7 and 8 browsers with security set to high do not display HCL Connections™ properly. You must either reduce the browser security level or change browser settings.
    - Troubleshooting email digests
      You can verify that email digests are working as expected by accessing specific HCL Connections™ URLs to trigger the email digests to be sent to the current user. You can also trigger email digests to be sent to the next available tranche of users.
    - Troubleshooting Help
      Find out how to resolve problems accessing the product help.
    - Troubleshooting inter-server communication
      If you are having problems establishing communication between servers in your deployment, this might be because a server's URL is not configured correctly in the LotusConnections-config.xml file.
    - Troubleshooting Component Pack
      If you encounter issues when using the Component Pack, refer to these troubleshooting tips or consult the HCL Support database for recent tech notes or HCL Support for recent articles.®
    - Troubleshooting network shares on Windows® 2003
      Windows® 2003 returns network errors when accessing shared content.
    - Collecting communities catalog troubleshooting data
      Collect communities catalog data to help HCL Support diagnose catalog problems.
    - Troubleshooting Search
      If you experience indexing issues, consider validating Search seedlists to help you identify the source of the problem. You can also configure settings to avoid out-of-memory issues or other problems caused by long response times from the Search application.
      - Troubleshooting Search FAQs
        A list of the common troubleshooting issues and answers.
      - Validating Search seedlists
        If you experience problems when indexing, you can validate Search seedlists to help you identify the source of the problem. You can validate Search seedlists using the browser or the wsadmin client.
      - Troubleshooting Search-related memory issues
        You can configure settings in the LotusConnections-config.xml file to avoid out-of-memory issues or other problems caused by long response times from the Search application.
      - Analyzing results from the search serverStatus page
        TheHCL Connections™ Search Engine provides the search serverStatus web page that you can use to troubleshoot search issues.
        Reviewing the Server Status tab
        The Server Status tab checks the Search log file, the crawling version file, and the index ready file from the node that the request is sent to.
        Reviewing the Initial Indexing Exceptions tab
        The Initial Indexing Exceptions tab returns any exceptions encountered when crawling the services during an initial index building task.
        Reviewing the SystemOut Log Exceptions tab
        Any exceptions in the current SystemOut.log on this node are highlighted in a red text box.
        Reviewing the Seedlists Validation tab
        The Seedlists Validation tab validates that the application seedlists can be accessed for search engine crawling.
        Reviewing the SAND Validation tab
        The SAND validation tabs checks the files needed for the SAND index are in place..
      - Troubleshooting when files content is not found after searching
        Connections uses the Apache Tika file conversion libraries for converting business documents from various types to plain text. The plain text is required before the content can be indexed. If search cannot find the content from a file, it could be due to an issue with this conversion from the business document format to plain text. This article describes some steps that can be used to troubleshoot this process.
      - Troubleshooting the "too many open files" error when updating the Search index
        Attempts to update the HCL Connections™ Search index on Linux™ can result in the following error: CLFRW0034E: Error reading or writing to the index directory. Please check permissions and capacity. java.io.FileNotFoundException: /opt/IBM/Connections/data/local/search/index/index_forums/_iu.fdt (Too many open files). This error means that users cannot search for content that is added to Connections.
      - Troubleshooting searches in multiple restricted communities
        Users who are members of many restricted communities may get incorrect search results.
    - Troubleshooting OAuth errors
      OAuth is used to manage the list of client applications that are allowed to prompt users for access to their HCL Connections™ data.
    - Troubleshooting SAML 2.0
      Review the topics in this section to see if your issue is addressed.
    - Troubleshooting single sign-on problems with Domino®
      Troubleshoot problems when using single sign-on (SSO) with Domino® Directory.
    - Troubleshooting Security Directory Integrator
      If you experience problems when using IBM Security Directory Integrator to work with Profiles data, explore the different trace areas available for Profiles to find information that might help to identify and resolve the problem.
    - Troubleshooting user data propagation
      If you experience problems related to user data propagation, enable traces in the IBM® WebSphere® Application Server so that you can access detailed information about the processes involved in propagating updates. You can use this information to help you verify if the processes are working as expected.
    - Troubleshooting virus scanning
      Find out some of the common causes for scanning-related error messages.
    - Troubleshooting media views and thumbnail generation
      The Files application provides a grid view to show thumbnails for files of various formats. When a user uploads, updates, or views a file, a thumbnail is generated (provided a thumbnail is available for the file). However, this solution does not work with existing files. You can use the global feature flag <genericProperty name="filesMediaView">enabled</genericProperty> to control whether the grid view is displayed when users upload, update, or open a file. Use the Files MBean FilesThumbnailService.generateForAllFiles()command to modify createThumbnail event so that the thumbnail also displays existing files.
  - Error message reference
    Use the codes included in the error messages generated by HCL Connections™ to identify problems and find their solutions.

Reviewing the Initial Indexing Exceptions tab

The Initial Indexing Exceptions tab returns any exceptions encountered when crawling the services during an initial index building task.

Checking exceptions encountered when crawling services

Review any exceptions displayed and determine why the URL that is displayed is not returning data to be indexed. Use these steps to investigate exceptions returned in this tab:

Check that the service has started without any exceptions being encountered.
Determine if the URL displayed is returning data by opening it in a browser.
Review the logs from the problem service and address any exceptions found.