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.
Installing Connections
To install HCL Connections™, you need to follow a detailed series of procedures.
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.
Populating the Profiles database
Populate the Profiles database with data from the LDAP directory.
Adding source data to the Profiles database
Populate the Profiles database with information from the source server by using the Profiles population wizard or by populating the database manually.
Manually populating the Profiles database
Instead of using the Profiles population wizard, you can manually populate the database.
Setting up the Security Directory Integrator Solutions directory (tdisol)
Setting up the Security Directory Integrator Solutions directory (tdisol).

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.
  - 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.
    - Verifying disk space and open file limits before installing HCL Connections
      On all operating systems, ensure that you have 6 GB of temporary disk space. On AIX® and Linux™, set the Open File Descriptor limit to at least 40000 before installing HCL Connections.
    - Preparing to configure the LDAP directory
      Determine which Lightweight Directory Access Protocol (LDAP) attributes you want to use as the identifiers for HCL Connections users.
    - Installing IBM® WebSphere® Application Server and IBM® HTTP Server
      HCL Connections requires an environment where the WebSphere® Application Server Deployment Manager and one node are installed and configured in advance. IBM® HTTP Server and the Web Server Plug-ins for IBM WebSphere Application Server are also prerequisites. This software is provided with the HCL Connections package.
    - Accessing Windows® network shares
      Configure a user account to access network shares in an HCL Connections deployment on the Microsoft® Windows® operating system
    - Setting up federated repositories
      Use federated repositories with IBM® WebSphere® Application Server to manage and secure user and group identities.
    - Creating databases
      Create databases for the applications that you plan to install. You can use the database wizard or run the SQL scripts that are provided with HCL Connections.
    - Populating the Profiles database
      Populate the Profiles database with data from the LDAP directory.
      - Configuring IBM Security Directory Integrator
        Configure IBM Security Directory Integrator to synchronize and exchange information between the Profiles database and your LDAP directory.
      - Adding source data to the Profiles database
        Populate the Profiles database with information from the source server by using the Profiles population wizard or by populating the database manually.
        Using the Profiles population wizard
        Use the Profiles population wizard to populate the HCL Connections Profiles database with data from the LDAP directory.
        Using the Profiles population wizard in silent mode
        You can run the Profiles population wizard in silent mode to populate the Profiles database.
        Manually populating the Profiles database
        Instead of using the Profiles population wizard, you can manually populate the database.
        Setting up the Security Directory Integrator Solutions directory (tdisol)
        Setting up the Security Directory Integrator Solutions directory (tdisol).
        Security Director Integrator solution properties for Profiles
        HCL Connections maps LDAP, database, and other properties with IBM Security Directory Integrator configuration parameters.
        Batch files for processing Profiles data
        HCL Connections provides several batch files that automate the collection and processing of LDAP data for the Profiles database.
        Considerations when populating a large user set
        Populate the Profiles database with many users from an LDAP directory.
        Mapping fields manually
        To populate the Profiles database with data from the enterprise LDAP directory, map the content of the fields in the database to the fields in the LDAP directory.
        Attribute mapping for Profiles
        When the Profiles directory service is enabled, IBM® Connections relies on the Profiles database to provide user data such as user name, ID, and email.
      - Populating Profiles with photos from LDAP
        You can use the IBM® Tivoli® Directory Integrator assembly-line command load_photos_from_ldap to load the Profiles database with photos of your users.
      - Configuring the Manager designation in user profiles
        When you map manager data in the Profiles database, you can mark manager profiles and also create report-to chains.
      - Supplemental user data for Profiles
        You can supplement user profiles data using a mapping table, the profiles_tdi.properties file, and CSV files.
      - Specifying the global ID attribute for users and groups
        Decide if you will accept the default identifiers used by your LDAP directory server or create a custom attribute to be used as the global unique identifier (GUID) for each user. This identifier is unique across the organization and is used for synchronizing names in the LDAP directory with names in the Profiles database.
      - Optional: Specifying a custom ID attribute for users or groups
        Add custom global unique ID attributes in the LDAP directory to make user record changes easier to manage and to minimize the possibility of accidentally introducing dual accounts for a user. This is an optional task.
    - Before installing
      Verify that all necessary prerequisite conditions are complete before installing HCL Connections.
  - Installing HCL Connections
    Select the HCL Connections applications that you plan to use and install them in a clustered deployment.
- 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™.

Setting up the Security Directory Integrator Solutions directory (tdisol)

Setting up the Security Directory Integrator Solutions directory (tdisol).

About this task

To deploy & set up SDI Solutions Directory ("tdisol"), complete the following steps:

Procedure

On the system hosting your IBM® Tivoli® Directory Integrator installation, create a subdirectory in which to store the Tivoli® Directory Integrator solution directory. Make sure that the file path does not contain spaces. Do not, for example, create the subdirectory in the Program Files directory in Microsoft® Windows®. For example, on a Linux server: you may want to create a subdirectory named tdisol under the SDI path /opt/IBM/TDI/V7.2/tdisol.
Go to the HCL Connections installation media and navigate to the HCL_Connections_Install\tools directory and copy the TDISOL compressed file tdisol.tar for Linux/AIX, or tdisol.zip for Windows) from the HCL_Connections_Install\tools directory and paste it into the TDISOL directory you created in Step 1.
Using appropriate tools, extract the TDISOL compressed file to the directory that you created in Step 1. This process creates a Security Directory Integrator Solution directory called TDI. For example, you will end up with: /opt/IBM/TDI/V7.2/tdisol/TDI.
Ensure that you have previously copied the necessary Database JDBC Driver file to the SDI Java Library Extension directory. For example, /opt/IBM/TDI/V7.2/jvm/jre/lib/ext/. Refer to Step 2 in the topic: Configuring IBM Security Directory Integrator for additional information.
From the SDI solution directory, open the tdienv.bat or tdienv.sh file in a text editor. Ensure that the path to the Tivoli® Directory Integrator installation directory is specified correctly in the TDIPATH variable. If the path is not correct, edit the TDIPATH environment variable.
- AIX® or Linux®:
  The default value for TDIPATH is:
```
export TDIPATH=/opt/IBM/TDI/V7.2
```
- Windows®:
  The default value for TDIPATH is:
```
SET TDIPATH=C:\Program Files\IBM\TDI\V7.2
```
Other scripts in the solution directory use this Tivoli® Directory Integrator path or tdienv.bat or tdienv.sh file to find Tivoli® Directory Integrator files.