Before installing

Verify that all necessary prerequisite conditions are complete before installing HCL Connections.

Prerequisites

Important: If Feature Foundation is included in your HCL Connections 7.0 installation then both Rollback and Uninstall will fail in the IBM Installation Manager. Make sure you have a full backup of the Connections server before upgrading. Refer to Backing up HCL Connections for details. You can use this backup to restore your existing deployment if the migration or update fails.
  1. Refer to the What's New in HCL Connections to review the latest new features in a release, gather download links, look over the latest fix list and update strategy information.
  2. Install all the required fixes for WebSphere® Application Server that are listed in the HCL Connections Software Requirements web page. If you are migrating from an earlier release or updating a release, verify that you have upgraded to the supported versions of all required software and all required fixes. Requirements have changed since the previous release.
  3. HCL Connections bundles the 64-bit, version 1.8.5.1 Installation Manager which is the supported version of Installation Manager.
    Note: Use the same user account to install IBM® Installation Manager and HCL Connections.
  4. Plan which of three deployment options makes the most sense for your HCL Connections implementation. For more information about these options, Refer to the Deployment options topic.
    Note: The HCL Connections installation process supports the creation of new server instances and clusters. Do not use existing clusters to deploy HCL Connections.
  5. Complete the Pre-installation tasks.
  6. Install IBM WebSphere Application Server Network Deployment (Application Server option) on each node. HCL Connections is installed on the system where WebSphere Application Server Deployment Manager is installed. For more information, see the Installing IBM WebSphere Application Server topic.
  7. Back up the profile_root/Dmgr01 directory.
  8. Configure WebSphere Application Server to communicate with the LDAP directory. For more information, see the Setting up federated repositories topic.
  9. Prepare directories to use as content stores. You need to provide shared content stores on network share devices and local content stores on each node. Both shared and local content stores must be accessible using the same path from all nodes and from the Deployment Manager.
  10. Set the system clocks on the Deployment Manager and the nodes to within 1 minute of each other. If these system clocks are further than 1 minute apart, you might experience synchronization errors.
  11. Copy the JDBC files for your database type to the Deployment Manager (DM) and then from the DM to each node. Place the copied files in the same location on each node as their locations on the DM. If, for example, you copied the db2jcc4.jar file from the C:\IBM\SQLLIB directory on the DM, place the copy in the C:\IBM\SQLLIB directory on each node.
  12. If HCL Docs clusters are running, shut them down.
  • If you are going to use a trusted SSL certificate, ensure it is available before you begin the installation.
  • You can still install the Metrics application along with the other HCL Connections applications. This enables Connections to begin collecting event data immediately and store it in the Metrics database for migration to Elasticsearch later, when it is available to provide reports..
  • (Microsoft Windows) You must use an administrator account to install HCL Connections on Windows. If you are installing on Windows Server 2008, you must use a local administrator account. If you use a domain administrator account, the installation might fail.
Tips:
  • Establish naming conventions for nodes, servers, clusters, and web servers.
  • Use a worksheet to record the user IDs, passwords, server names, and other information that you need during and after installation. For more information, see the Worksheet for installing HCL Connections topic.
  • Installing and configuring HCL Connections is a complex process; not only should you read the instructions but you must also pay attention to the Before you begin prerequisites in each topic.

Linux and AIX considerations

  • (Linux only) If you receive an error message after attempting to start IBM Installation Manager, you might need to install additional 32-bit libraries. For more information about required Linux libraries, see the Linux libraries topic. For more information about IBM Installation Manager errors, go to the Unable to install Installation Manager on RHEL 6.0/6.1 (64-bit) web page.
  • (AIX and Linux) Ensure that the directory paths that you enter contain no spaces.
  • (AIX, IBMi, and Linux) Ensure that the Open File Descriptor limit is 8192. For information about setting the file limit, go to the Installation error messages topic and search for error code CLFRP0042E.
  • (AIX only) IBM Installation Manager requires additional libraries for the AIX operating system. For more information, go to the Required filesets on AIX for Installation Manager web page.
  • (AIX only) IBM Installation Manager requires additional 64-bit AIX libraries to support the graphical user interface. For a complete list of libraries, refer to AIX libraries.
  • (AIX only) If IBM Installation Manager hangs while being installed on your system, you might need to update your version of the software. For more information, read the IBM Installation Manager hangs on 64-bit AIX systems technote.
  • (AIX only) If you are downloading IBM Installation Manager, the TAR program available by default with AIX does not handle path lengths longer than 100 characters. To overcome this restriction, use the GNU file archiving program instead. This program is an open source package that IBM distributes through the AIX Toolbox for Linux Applications at the IBM AIX Toolbox website. Download and install the GNU-compatible TAR package. You do not need to install the RPM Package Manager because it is provided with AIX.

    After installing the GNU-compatible compression program, change to the directory where you downloaded the HCL Connections tar file. Enter the following command to extract the files from the file:

    gtar -xvf HCL_Connections_6.5_wizards_lin_aix.tar

    This command creates a directory named after IBM Installation Manager.

  • You can install HCL Connections with either root or non-root accounts on AIX and Linux. For more information, see the Installing as a non-root user topic.