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 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.
Adding Linked Libraries
Enable and configure linked libraries so that Community owners can add them.
Configuring single sign-on with ECM servers
Configure single sign-on between HCL Connections and Enterprise content manager (ECM) servers. With single sign-on enabled, users do not need to log in to HCL Connections and the ECM server separately; logging in to HCL Connections also give them access to the ECM server.
Configure SSO between IBM® Content Manager and HCL Connections
Configure single sign-on (SSO) between IBM® FileNet® Collaboration Services and HCL Connections.
Configuring HCL Connections for SSO
Configure HCL Connections for single sign-on.

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.
    - Library concepts and terminology
      Knowledge of FileNet® concepts can help with extension and customization of your deployment. Connections Content Manager uses the FileNet P8 Platform to store and retrieve documents in libraries.
    - Running Library administrative queries and commands
      Run administrative commands from the Administration Console for Content Platform Engine (ACCE) to query for and modify objects in the FileNet Content Platform Engine
    - Configuring CCM for newly added nodes
      You must perform several steps to get IBM® FileNet® working properly on a newly added node.
    - Creating and managing document types
      Define the document types that users can select when they add a file to a library.
    - Permissions and access management
      Files and folders can be shared within a Library. However, the Library itself cannot be shared, but you can set access on the Library in the edit mode of the Library widget. The Library owner can decide the permissions to be given to members of a community. Initially, files and folders inherit access settings from their parent.
    - Libraries and the Activity Stream
      A library sends events from documents in the library to the Activity Stream.
    - Finding identifiers for CCM libraries, folders, and documents
      Find identifiers of HCL Connections Content Manager libraries, folders, and documents from the HCL Connections web interface. You can then use the identifier in an administrative task or query.
    - Configuring the FileNet® deployment used by Libraries
      FileNet® Content Platform Engine and FileNet Collaboration Services are initially deployed and configured as part of the Connections Content Manager installation.
    - Recreating the FileNet® domain and object store
      If you have a problem with running the ccmDomainTool automation tool to create the FileNet® P8 domain and Object Store, perform the following refresh steps and then rerun the tool.
    - Configuring Library widget options and defaults
      Configure the behavior of community Library widgets by checking out library-config.xml and editing it directly.
    - Configuring web resources and virus scan properties
      Web resources properties include for example, the Connections server and port for URLs. Virus scan properties include for example, the virus scanning server that is used to scan uploaded files for viruses. Create these configuration properties in the connections.xml file.
    - Administering thumbnails for library files
      HCL Connections™ configuration properties control how and when thumbnails are generated for Library files.
    - Enabling grid view for library files
      Use ccmMediaView flag to enable grid view in Connections Content Manager libraries and linked libraries.
    - Adding Linked Libraries
      Enable and configure linked libraries so that Community owners can add them.
      - Enabling linked libraries
        Enable the Linked Library widget in HCL Connections so that community owners can add linked libraries to their communities.
      - Configuring IBM DB2 Content Manager
        For the Linked Library widget to function in an IBM® Content Manager deployment, you must update the value of the sortByNameIdealAttribute property in the cmpathservice.properties file.
      - Setting allowed ECM servers
        Set a list of specific Enterprise Content Management (ECM) servers that Linked Library widgets can connect with.
      - Configuring single sign-on with ECM servers
        Configure single sign-on between HCL Connections and Enterprise content manager (ECM) servers. With single sign-on enabled, users do not need to log in to HCL Connections and the ECM server separately; logging in to HCL Connections also give them access to the ECM server.
        Prerequisites for Single Sign-On (SSO)
        There are several prerequisites for configuring single sign-on (SSO) between the WebSphere® Application Servers that underlie the HCL Connections and ECM servers.
        Configure SSO between IBM® FileNet® and HCL Connections
        Configure single sign-on (SSO) between IBM® FileNet® Collaboration Services and HCL Connections.
        Configure SSO between IBM® Content Manager and HCL Connections
        Configure single sign-on (SSO) between IBM® FileNet® Collaboration Services and HCL Connections.
        Configuring the IBM® Content Manager server for SSO
        Configure the IBM® Content Manager Enterprise Edition server for single sign-on.
        Configuring HCL Connections for SSO
        Configure HCL Connections for single sign-on.
      - Enabling search in linked libraries
        You can enable content-based text search in linked libraries that are hosted on FileNet® P8. Search is disabled by default.
    - Managing ECM and CCM connectivity in a library
      Manage Enterprise Content Management (ECM) and Connections Content Manager connectivity.
  - 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.
  - 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™.

Configuring HCL Connections for SSO

Configure HCL Connections for single sign-on.

Before you begin

To configure HCL Connections for SSO, see the topic Configuring single sign-on in this documentation. For example, if the IBM® Content Manager server is using a standalone LDAP, follow steps in Enabling single sign-on for standalone LDAP before performing the steps in this topic.

To complete the SSO configuration between HCL Connections and IBM® FileNet® Collaboration Services, you must synchronize the LTPA tokens between the two servers.

Procedure

To synchronize the LTPA tokens between the HCL Connections and IBM® Content Manager servers, perform the following steps:

On the HCL Connections server, open the WebSphere® Application Server Integrated Console.
Navigate to Security > Global security >LTPA.
Type and confirm a password and make a note of it.
Type the full path to a file on the application server where you want to store the keys, such as /home/wasadmin/ltpa.keys.
Click Export keys. WebSphere® exports the LTPA keys into the location you specified.
Click Apply and save the changes.
Copy the LTPA key file you just generated to the IBM® FileNet® Collaboration Services server and note the location.
Open the WebSphere® Application Server Integrated Console on the IBM® FileNet® Collaboration Services, and follow Step 2.
Navigate to the Single sign-on section and enter the password you entered in Step 3.
Type the full path to the LTPA key file from Step 7 on the IBM® FileNet® Collaboration Services server.
Click Import Keys and Save.
Restart the HCL Connections and IBM® FileNet® Collaboration Services WebSphere® Application Servers for the changes to take effect.

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.