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.
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.
Managing access
Manage roles, credentials, users, and directories, and allow third-party access to HCL Connections data.
Managing personal information in accordance with PI laws
As an administrator, you might experience users asking that their personal information (PI) be erased or corrected in accordance with local and international PI laws, for example the EU General Data Protection Regulation (GDPR). This section describes the most common scenarios that you might encounter and the actions that you need to take to satisfy the user requests.
Pseudonymising user PI contained in Surveys
If Community Surveys are part of your HCL Connections deployment, you can download and run a database script to pseudonymise a user's name in the Surveys application. You must use the script specific to the database and the operating system that it runs on in your environment.

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.
  - Administering common areas
    Administer the common areas of HCL Connections.
    - Administrator checklist
      Consider tasks that you might want to complete after you install HCL Connections and before users start using it.
    - Administration tools
      Use the wsadmin utility to edit configuration properties or run administrative commands.
    - System maintenance
      Make sure HCL Connections works properly in your particular environment.
    - Managing content
      Use superusers, moderation, and other methods to manage HCL Connections content.
    - Administering the Widget container
      The Widget Container is the HCL Connections-specific integration of the Common Rendering Engine, also known as the CRE.
    - Managing access
      Manage roles, credentials, users, and directories, and allow third-party access to HCL Connections data.
      - Roles
        Roles that you can define for users and groups on IBM® WebSphere® Application Server.
      - Managing stored credentials
        HCL Connections does not create nor store user names and passwords. Instead, it uses the user credentials that already exist in your LDAP directory for authentication. HCL Connections does not store administrative user IDs and passwords either. It does, however, create and store references to existing administrative user credentials. You can make changes to those references.
      - Managing users
        As employees come and go from your organization, the corporate directory changes, and there are some steps that you, as the administrator, must take to make sure that those changes are reflected in the product by keeping the HCL Connections membership tables up-to-date with the changes that occur in your corporate directory.
      - Managing personal information in accordance with PI laws
        As an administrator, you might experience users asking that their personal information (PI) be erased or corrected in accordance with local and international PI laws, for example the EU General Data Protection Regulation (GDPR). This section describes the most common scenarios that you might encounter and the actions that you need to take to satisfy the user requests.
        Managing user requests to erase PI
        Here are four scenarios that you might encounter if a user requests that their personal information (PI) be erased from Connections content. In all, the user's "right to erasure" is accomplished by changing the user's name and email address to ones that can no longer identify them, a process known as "pseudonymisation."
        Deleting or correcting user PI
        If a user who has left the organization wants to make sure that their personal information (PI), for example, their social security number, is removed or corrected in all content sources, they can ask the organization to find the occurrences in blogs, wikis, and so on, and to remove or change the text.
        Pseudonymising user PI contained in Surveys
        If Community Surveys are part of your HCL Connections deployment, you can download and run a database script to pseudonymise a user's name in the Surveys application. You must use the script specific to the database and the operating system that it runs on in your environment.
      - Using the LDAP directory as the user directory
        Edit configuration property settings to disable HCL Connections directory service extensions.
      - Groups
        Content owners can use LDAP groups to control access to resources in the Communities, Activities, Files, and Wikis applications. For this reason, it is important to consider the effect that updating LDAP groups has on the existing membership of these resources.
    - Managing external user access
      Manage the access that people from outside your organization (external users) have to your HCL Connections implementation.
    - Customizing the deployment
      Perform optional tasks to customize your HCL Connections deployment.
    - URL Preview
      URL preview allows users decide quickly whether to follow a link by displaying a thumbnail preview for URLs.
- 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™.

Pseudonymising user PI contained in Surveys

If Community Surveys are part of your HCL Connections deployment, you can download and run a database script to pseudonymise a user's name in the Surveys application. You must use the script specific to the database and the operating system that it runs on in your environment.

Before you begin

Download the script “HCL Connections 6.0.0.0 CR1 Community Surveys fix for APAR LO93917” (6.0.0.0_CR1_Surveys_IFLO93917.zip) from the download package “HCL Connections v6.0 APAR Fixes” on the HCL Software License and Download Portal.

In all of the following commands, directory_uuid is the user's LDAP UUID, a string that looks like 46c25940-be70-1033-93a5-95472f45d54f . The scripts change the name of the user associated with the UUID to pseudonym, a name like "User124," throughout the Surveys application.

For surveys on a DB2 database

Linux: Log in as the DB2 administrator, and issue the following command:
```
 sh changeNames_Survey_OnPrem_DB2.sh directory_uuid "pseudonym"
```
Windows: Log in as the DB2 administrator, and issue the following command:
```
 changeNames_Survey_OnPrem_DB2.bat directory_uuid "pseudonym"
```

For surveys on an Oracle database

Linux: Issue the following command:

 sh changeNames_Survey_OnPrem_Oracle.sh db_admin db_password directory_uuid "pseudonym"

Windows: Issue the following command:
```
 changeNames_Survey_OnPrem_Oracle.bat db_admin db_password directory_uuid "pseudonym"
```
Note: Make sure to detach both changeNames_Survey_OnPrem_Oracle.bat and changename.sql and save them in the same folder on the Windows system.