Before installing
Verify that all necessary prerequisite conditions are complete before installing HCL Connections.
Prerequisites
- Check the HCL Knowledge Base - Articles for late-breaking issues.
- 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.
- If you previously installed IBM® Installation Manager
(IIM), update it to the prerequisite version listed in the software requirements. For more
information, go to the IBM® Installation Manager updates web
page.Note: Use the same user account to install IBM® Installation Manager and HCL Connections.
- 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.
- Complete the Pre-installation tasks.
- 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.
- Back up the profile_root/Dmgr01 directory.
- Configure WebSphere® Application Server to communicate with the LDAP directory. For more information, see the Setting up federated repositories topic.
- 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.
- 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.
- 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.
- 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®, IBM®i, 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.