Home
Administering Connections 6 CR6
Welcome to the HCL Connections 6 CR6 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.
Troubleshooting and support
To isolate and resolve problems with your IBM® 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™.
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.
Troubleshooting the "too many open files" error when updating the Search index
Attempts to update the IBM® 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 IBM Connections.

Administering Connections 6 CR6
Welcome to the HCL Connections 6 CR6 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 6
  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 IBM Connections social networking product.
- Planning
  Before installing HCL Connections™, study the system requirements, deployment options, and documentation conventions.
- Installing
  To install IBM® Connections, you need to follow a detailed series of procedures.
- Migrating and updating
  Migrate IBM® Connections and its supporting software to the latest release and then update the installation with the latest 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 IBM® Connections to fit your environment.
- Security
  IBM® Connections provides a flexible security infrastructure that supports an open, easily shareable data model.
- Mobile
  See the IBM Connections Mobile documentation for Connections Cloud and Connections on-premises.
- Developing
  Get information about how to use the APIs provided with IBM® 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 IBM® 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™.
  - 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.
  - Searching knowledge bases
    You can often find solutions to problems by searching IBM® knowledge bases. You can optimize your results by using available resources, support tools, and search methods.
  - Contacting IBM® Support
    IBM® Support assists with product defects, answers FAQs, and helps users resolve problems with the product.
  - Exchanging information with IBM®
    To diagnose or identify a problem, you might need to provide IBM® Support with data and information from your system. In other cases, IBM Support might provide you with tools or utilities to use for problem determination.
  - Subscribing to Support updates
    To stay informed of important information about the IBM® products that you use, you can subscribe to updates.
  - Troubleshooting tips
    - IBM® Connections log file
      IBM® Connections writes messages to the SystemOut.log file. Refer to this file if you encounter errors after installing an IBM Connections application or if you encounter unexpected behavior in an application.
    - Troubleshooting Cognos® Business Intelligence components
      The Metrics application in IBM® Connections works with Cognos® Business Intelligence; if you encounter problems while deploying or configuring Cognos Business Intelligence or while using the Metrics application, use this information to help resolve the problem.
    - 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 IBM® 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 IBM® 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 IBM Connections 6.0 causing some features to fail. Therefore, Edge Side Include (ESI) cache in IHS should be disabled for IBM Connections 6.0.
    - Troubleshooting display problems
      Microsoft™ Internet Explorer versions 7 and 8 browsers with security set to high do not display IBM® 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 IBM® 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 Cognos Metrics
      The Metrics application in IBM® Connections displays information in reports formatted as charts and tables. If you encounter problems while viewing the reports, use this information to help resolve the problem.
    - Troubleshooting Elasticsearch Metrics
      If you encounter issues when using the stand-alone Elasticsearch instance in your IBM Connections™ deployment, refer to these troubleshooting tips or consult the IBM® Support database for recent tech notes.
    - Troubleshooting Component Pack
      If you encounter issues when using the Component Pack, refer to these troubleshooting tips or consult the IBM® Support database for recent tech notes.
    - 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 IBM 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
        The IBM® Connections Search Engine provides the search serverStatus web page that you can use to troubleshoot search issues.
      - 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 IBM® 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 IBM 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 IBM® 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 Lotus® Domino®
      Troubleshoot problems when using single sign-on (SSO) with IBM® Lotus® Domino® Directory.
    - Troubleshooting Tivoli Directory Integrator
      If you experience problems when using IBM® Tivoli® 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 Connections Content Manager (CCM)
      If you experience problems when you are installing, configuring, or using IBM® Connections Content Manager, use this information to help resolve the problem.
    - 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 IBM® Connections to identify problems and find their solutions.

Troubleshooting the "too many open files" error when updating the Search index

Attempts to update the IBM® 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 IBM® Connections.

Temporary workaround

Restarting the Search service temporarily resolves this issue.

Diagnosing the problem

To see the current limits on the number of open files, log on to a shell as the user who updates the IBM® Connections Search index and run the following command: ulimit -n

The default is 1024 open files.

The recommended limit is 8192 open files.

Resolving the problem

As the user who updates the IBM® Connections Search index, enter the following commands:

vi .bashrc
Note: .bashrc is in the user's home directory.
Add the line: ulimit -n 8192.
Save and exit file.
Set ulimit for the working current session, for example: ulimit -n 8192.
Confirm that the new ulimit setting is in effect: ulimit -a.

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.