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.
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.
Administering the News repository
You administer the News repository using scripts accessed using the wsadmin client. Changes to News configuration settings require node synchronization and a restart of the Home page server before they take effect.
Activity stream search
The activity stream search service provides an indexing and search infrastructure that is bundled with the News application. This service provides search capabilities over the activity stream.
Restoring the activity stream search index
If the activity stream search index becomes corrupt or is not being refreshed properly, you can delete the existing index data to rebuild the index.

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.
- 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.
  - Administering common areas
    Administer the common areas of HCL Connections.
  - Administering Activities
    Configure Activities to best meet the needs of your environment.
  - Administering Blogs
    Administer site-wide settings for Blogs from either the Blogs user interface or via the wsadmin client.
  - Administering Bookmarks
    You configure and administer Bookmarks using scripts accessed using the wsadmin client. Changes to Bookmarks configuration settings require a restart of the Bookmarks server before they take effect. Changes made using administrative commands take effect immediately.
  - Administering Communities
    Configure and administer Communities using scripts accessed using the IBM® WebSphere® Application Server wsadmin client.
  - Administering Files
    You administer Files using the wsadmin client to specify properties in a configuration file, or run administrative commands.
  - Administering Forums
    Administer Forums by specifying properties in a configuration file or running administrative commands.
  - Administering the Home page
    You can administer site-wide settings for the Home page from the Home page administration user interface or using the wsadmin client.
  - Administering Libraries
    A Library provides the services of an Enterprise Content Management (ECM) system to Communities. To enable the use of Libraries, you must make some configuration changes to Connections and to each ECM system that you plan to use.
  - Administering Metrics
    Administer metrics in HCL Connections by modifying configuration settings, backing up data, and running commands to perform maintenance tasks.
  - Administering the News repository
    You administer the News repository using scripts accessed using the wsadmin client. Changes to News configuration settings require node synchronization and a restart of the Home page server before they take effect.
    - Accessing the News configuration file
      To make configuration changes to the News component in HCL Connections, you must first access the News configuration file.
    - News administrative commands
      Use the commands listed to administer the News repository.
    - Synchronizing News data with other applications
      Edit settings in the news-config.xml file to define the interval at which data from the HCL Connections applications is synchronized with the News repository.
    - Managing scheduled tasks for the News repository
      Use administrative commands to manage scheduled tasks for the News repository.
    - Configuring database clean-up for the News repository
      Edit settings in the news-config.xml file to define the interval at which the different database clean-up tasks run and specify when the IBM® WebSphere® Application Server scheduler starts the tasks.
    - Reallocating and load balancing users according to mail domain
      Use the NewsEmailDigestService.loadBalanceEmailDigest() command to manually reallocate and load balance users in the different email tranches (or groups of email addresses) used by the email digest.
    - Purging compromised reply-to IDs
      Use the NewsMailinService commands to delete compromised reply-to IDs from the system and ensure that replies are received from secure IDs only. If a particular reply to ID is being misused, you can delete that ID from the system while keeping the user’s other valid IDs active.
    - Registering third-party applications
      Use the NewsActivityStreamService commands to register third-party applications. An application in this context is an OpenSocial gadget that is compatible with HCL Connections.
    - Administering microblogs
      You can perform a number of administrative tasks to manage the microblogging feature in HCL Connections.
    - Activity stream search
      The activity stream search service provides an indexing and search infrastructure that is bundled with the News application. This service provides search capabilities over the activity stream.
      - Administering activity stream search
        Update information related to the activity stream search service and manage the collection of activity stream data.
      - Copying the activity stream search index to new nodes
        When you add a node to the News cluster to ensure high availability for activity stream search requests, you must copy the activity stream search index to the new node. Before copying the index, ensure that you disable scheduled metadata collections.
      - Configuring activity stream search index settings
        You can update the default settings for the index folder and the shared replication folder for the activity stream search service.
      - Restoring the activity stream search index
        If the activity stream search index becomes corrupt or is not being refreshed properly, you can delete the existing index data to rebuild the index.
  - Administering Profiles
    Profiles provides two types of administrative capabilities: configuration settings and administrative commands. You change configuration settings and execute administrative commands by running scripts from the wsadmin command line.
  - Administering Search
    The Search service provides a point for performing full text and tag searches across all the deployed HCL Connections applications. Search is a required application for all HCL Connections applications, and it must be running to prevent unexpected behaviors in the other applications.
  - Administering Wikis
    Configure and administer Wikis by using the wsadmin client to run administrative commands or by editing the configuration file directly.
  - Administering Component Pack for Connections
    Monitor the services for Component Pack for HCL Connections™ and troubleshoot issues.
- 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™.

Restoring the activity stream search index

If the activity stream search index becomes corrupt or is not being refreshed properly, you can delete the existing index data to rebuild the index.

About this task

The IBM® WebSphere® Application Server variables ACTIVITY_STREAM_SEARCH_INDEX_DIR and ACTIVITY_STREAM_SEARCH_REPLICATION_DIR define the location of the activity stream search index directory and replication directory respectively. If there are issues with the existing activity stream index, you can restore it by deleting the contents of these directories. The index is rebuilt when the next scheduled crawl takes place.

Note: In a clustered environment, ACTIVITY_STREAM_SEARCH_REPLICATION_DIR is a shared folder whereas ACTIVITY_STREAM_SEARCH_INDEX_DIR exists on each one of the servers.

Procedure

To access the Activity Stream Search Administration page, enter the following URL in your browser and log in using your admin user credentials:
```
http://server_name/news/web/activityStreamSearchAdmin/
   activityStreamSearchAdmin.action
```
There is no link provided from the HCL Connections user interface, you must access the page using the direct URL.
Disable all the crawlers listed on the page by selecting More actions > Disable Schedule for each crawler.
Find the value of the ACTIVITY_STREAM_SEARCH_REPLICATION_DIR and ACTIVITY_STREAM_SEARCH_INDEX_DIR WebSphere® Application Server variables.
1. Log in to the WebSphere® Integrated Solutions Console.
2. Expand Environment and select Websphere Variables.
3. Look for the ACTIVITY_STREAM_SEARCH_REPLICATION_DIR and ACTIVITY_STREAM_SEARCH_INDEX_DIR variables and make a note of their respective locations.
Navigate to the location specified by the ACTIVITY_STREAM_SEARCH_REPLICATION_DIR variable and delete the contents of the directory.
Navigate to the location specified by the ACTIVITY_STREAM_SEARCH_INDEX_DIR variable and delete the contents of the directory.
Return to the Activity Stream Search Administration page and enable all the crawlers.

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.