Installing IBM Connections 3.0.1

This article guides you through the installation and configuration of IBM Connections 3.0.1, covering important details that will make your implementation smooth and headache-free. After completing this article, you should be able to understand all components involved in an IBM Connections deployment and be able to make better decisions regarding your organization's needs.


Luis A. Guirigay (, Senior IT Architect, PSC Group, LLC

Luis Guirigay photoLuis Guirigay is a senior IT architect focused on administration, high availability/disaster recovery, performance tuning, and support. He has been working with IBM products for more than 14 years and is an IBM Certified Administrator for virtually all versions of IBM Connections, WebSphere Portal, Domino, Sametime, and Quickr as well as an IBM Certified Developer in Domino and IBM Lotus Workflow. He has deep experience with WebSphere Application Server, DB2, Tivoli, and ILWWCM. Luis has published multiple IBM Redbooks related to Domino, Workplace, DB2, and System i, and his speaking engagements include IamLug and Midwest Lotus User Group conferences, Lotusphere, Chicago Lotus User Group, and multiple IBM PoT and IBM workshops in the United States. You can follow Luis on Twitter @Lguiriga.

28 August 2012

Also available in Russian

Installing the prerequisites

The key to a successful IBM Connections installation is having the underlying and prerequisite components in place ahead of time. Installation of some of these components can lead to confusion or frustration. The Resources section contains required reading to ensure a smooth setup.

IBM Connections introduces social to the enterprise, allowing companies to be more proactive and efficient by providing a solid foundation on which to exchange ideas, build communities, promote the participation of employees, know the latest company updates, and more. The installation process for IBM Connections 3.0.1 can be quite complex because of the different scenarios available. Therefore, this article covers not only basic installation but also the architecture of the product and the final solution so as to provide the bigger picture of all the possible deployment options.

Preinstallation overview

Installing IBM Connections requires a solid understanding of all of its underlying components and the way they work and communicate with each other.

Glossary of IBM Connections terms

  • Deployment Manager: The administration application for a cell
  • Application Server: A Java™ Virtual Machine (JVM) process
  • Application: A Java server application.
  • Profile: An IBM WebSphere® entity similar to a node.
  • Cell: An administrative domain of one or more servers.
  • Node: An individual system, which can be physical or virtual.
  • Node agent: An administrative agent that manages all application servers on a node and represents the node in the management cell.
  • Cluster: A group of servers, all running the same applications.

WebSphere architecture

As you can see in Figure 1, all the connections services and nodes are within one cell, which the Deployment Manager manages. Different server instances are deployed to different nodes that are configured to work together in clusters for features. This diagram shows three nodes. Typically, each node represents one machine. Node A and Node B each have two instances, and each server instance has two features. Node A and Node B are identical to each other in terms of applications and server instance separation. Cluster A logically groups server A from Node A and server C from Node B to act together. You can provide any name you like to your cluster.

Figure 1. The WebSphere architecture
Image showing the WebSphere architecture

Deployment options

You can use any of three deployment options when installing IBM Connections 3.0.1: small, medium, and large.

Small deployment

This option installs all applications in a single cluster on a single node and so is the simplest deployment (see Figure 2). However, it has limited flexibility and does not allow you to scale up individual applications. For each node within the cluster, all applications run within a single JVM.

Figure 2. Small deployment architecture: one node
Image showing the architecture for a small deployment with one node

Figure 3 shows one of the simplest deployments of IBM Connections, where each component is running on its own machine. This option does not provide any workload or disaster recovery, but it does provide simplicity to small organizations looking to run IBM Connections.

Figure 3. A simple small deployment of IBM Connections
Image showing a simple small deployment of IBM Connections

Medium deployment

This option installs a subset of applications in separate clusters (see Figure 4). IBM Connections 3.0.1 provides three predefined cluster names shared among all applications. This option is used to distribute applications according to usage expectations and allows you to maximize the use of available hardware and system resources to suit specific needs.

Figure 4. Medium deployment architecture
Image showing the architecture for a medium deployment

In Figure 5, a two-node cluster is used for IBM Connections, with two HTTP servers in front handling all requests coming from the edge server. This approach also shows you how you can use IBM Tivoli® Directory Integrator (TDI) to merge data coming from multiple sources into the Lightweight Directory Access Protocol (LDAP) server and IBM DB2® database.

Figure 5. A typical medium deployment of IBM Connections
Image showing a typical medium deployment of IBM Connections

Large deployment

This option installs each application in its own cluster, and IBM Connections 3.0.1 provides a predefined cluster name for each application (see Figure 6). This option provides the best performance in terms of scalability and availability options, but it also requires more system resources.

Figure 6. Large architecture, with multiple nodes and clusters
Image showing the architecture for a large deployment, with multiple nodes and clusters

With a basic understanding of all the deployment options, you reach a decision point regarding all the additional servers and components that IBM Connections uses. Figure 7 shows a complex environment with multiple nodes, HTTP and proxy servers, and database clusters for each feature of IBM Connections (blogs, home pages, and more). Large organizations with strict service level agreements should consider deployments that include high availability and disaster recovery as well as sufficient resources to support the workload.

Figure 7. A large deployment of IBM Connections
Image showing a large deployment of IBM Connections

Planning and installation

Installing IBM Connections requires the prior installation and configuration of several components. Before starting, make sure that all required software is available: The Resources section provides a detailed list of all components (and their product number) that you should download via either IBM Passport Advantage or IBM PartnerWorld.


Installation assumptions

This article assumes the following conditions:

  • You are installing all components on computers using Windows® operating system.
  • IBM HTTP Server and WebSphere Application Server have been installed on the same machine.
  • You are installing a small deployment of IBM Connections 3.0.1.

When installing IBM WebSphere Application Server, you have several options, as shown in Figure 8. IBM Connections 3.0.1 requires a deployment manager, so you must choose Cell (deployment manager and managed node). This option installs the Deployment Manager (dmgr) and a managed node, with a default application server profile called server1. IBM Connections does not use the newly created server1, however; instead, the managed node will be used as the destination for the new server.

Figure 8. WebSphere Application Server environments
Images showing WebSphere Application Server environments

If you are installing DB2, you must register the proper DB2 license to use the product. When you buy IBM Connections, IBM provides a restricted license that allows you to use DB2 for IBM Connections. You can download this license (db2ese_o.lic) from IBM PartnerWorld or IBM Passport Advantage by looking for Product Number CZ381ML. See Resource for links to additional information on DB2 license management.

After installing DB2, you must create a dedicated user named LCUSER and add it to the DB2users group. IBM Connections and WebSphere Application Server use this user to handle all connectivity with the DB2 databases.

In addition to the WebSphere Application Server environment, the following products must be installed:

  • IBM Lotus Domino® 8.5.3 as the LDAP server
  • WebSphere Application Server Network Deployment
  • WebSphere Application Server 7.0 Fix Pack 19
  • WebSphere Application Server 7.0 Plug-in Fix Pack 19
  • IBM HTTP Server
  • IBM HTTP Server 7.0 Fix Pack 19
  • IBM DB2 Enterprise Server Edition V9.7 for Windows
  • IBM Tivoli Directory Integrator V7.0 for Windows
  • IBM Tivoli Directory Integrator V7.0 Fix Pack 5 for Windows

For more information on how to install and configure these products and other supported database and LDAP servers, see Resources.

Creating the IBM Connections databases

Before installing IBM Connections, you need to create the required databases and populate the Profiles database (PEOPLEDB). To do so, complete the following steps:

  1. Copy the IBM Connections Wizards (CZVQ9ML) to the DB2 server, and run dbWizard30.bat.
  2. On the Welcome page, click Next.
  3. Choose Create, and click Next.
  4. Select the database type (see Figure 9), the location of the DB2 server installation, and the name of the DB2 instance to be used, and click Next.
    Figure 9. Select the database type
    Select the database type
  5. Select all the databases, and click Create.
  6. Review the task summary, and click Next.
  7. After all databases have been created, click Finish.

Populating the Profiles database

Now that all the databases have been created, you must populate PEOPLEDB with user information from the LDAP server. To do so, complete the following steps:

  1. From the IBM Connections Wizard folder, run populationWizard.bat.
  2. On the Welcome screen, click Next.
  3. Enter the location of TDI (see Figure 10), and click Next.
    Figure 10. Enter the location of TDI
    Enter the location of TDI
  4. Select DB2 as the Profiles database type.
  5. Enter all the required information to establish a session with the Profiles database, as shown in Figure 11.
    Figure 11. Connect to the Profiles database
    Connect to the Profiles database
  6. Enter the hostname and port for the LDAP server, and click Next.
  7. Enter the bind credentials to access the LDAP server, and click Next.
  8. Enter the LDAP search filters based on your own LDAP server configuration, and click Next.

    Note: Using a tool like Softerra LDAP Browser might help in understanding your LDAP environment in case your organization does not have an LDAP administrator.

  9. Click Next.
  10. Review the configuration summary, and click Configure.
  11. Review the results, and click Finish to complete this wizard.

Configure the LDAP server with WebSphere

IBM Connections relies on WebSphere Application Server's security to handle the LDAP configuration and connectivity. This section show you how to configure WebSphere Application Server to connect to an existing LDAP server for search and authentication within IBM Connections.

To configure the LDAP server, complete the following steps:

  1. Access the Integrated Solutions Console (ISC), and click Security > Global Security.
  2. Select Federated Repositories, and click Configure.
  3. Click Add Repository.
  4. Enter the required information to connect to your LDAP server (see Figure 12), and click OK.
    Figure 12. Set up a new repository
    Set up a new repository
  5. Save the changes to the master configuration.
  6. Enter the distinguished name of the base entry that will identify this set of entries (see Figure 13), and click OK.
    Figure 13. Provide the distinguished name for the base entry
    Provide the distinguished name for the base entry
  7. Click OK to save the changes.
  8. Enable application security (see Figure 14), and click Apply to save the changes.
    Figure 14. Enable application security
    Enable application security
  9. Restart the Deployment Manager for the changes to take effect.

If you have never worked with the Deployment Manager before, the following are the commands to stop the Deployment Manager:

C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01\bin>stopServer 
dmgr -username wasadmin -password password

The following are the commnads to start the Deployment Manager:

C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01\bin>startServer dmgr

Installing IBM Connections

To install IBM Connections, complete the following steps:

  1. Access the IBM Connections installer (CZVP9ML) folder, and run launchpad.exe.

    The IBM Connections installation process is controlled by the IBM Installation Manager, which must be installed first.

  2. Select both the IBM Installation Manager and IBM Connections, and click Next.
  3. Accept the terms in the license agreement, and click Next.
  4. Enter the location for the Shared Resources Directory and the Installation Manager Directory, and click Next.
  5. Enter the installation directory for IBM Connections, and click Next.
  6. Select all the features to install, and click Next.
  7. Select the location of WebSphere Application Server, and select the Deployment Manager profile.
  8. Enter the hostname of the machine on which you are performing the installation and the credential information to connect to the Deployment Manager (see Figure 15).

    Doing so adds the new node to the Deployment Manager.

    Figure 15. Deployment Manager settings
    Deployment Manager settings

    Click to see larger image

    Figure 15. Deployment Manager settings

    Deployment Manager settings
  9. Click Next.
  10. Select Small Deployment, and enter the cluster name (see Figure 16). Click Next.
    Figure 16. Choosing deploying options
    Choosing deployment options

    Click to see larger image

    Figure 16. Choosing deploying options

    Choosing deployment options
  11. Copy the db2jcc.jar and db2jcc_license_cu.jar files from the DB2 server to the machine on which you are installing IBM Connections.
  12. Enter the required information for the connection to the DB2 databases (see Figure 17).

    Under JDBC driver location, select the location to which you copied the two .jar files.

    Figure 17. DB2 settings
    DB2 settings

    Click to see larger image

    Figure 17. DB2 settings

    DB2 settings
  13. Enter the location for the shared and local content stores (see Figure 18).
    Figure 18. Location of the shared and local content stores
    Location of the shared and local content stores

    Click to see larger image

    Figure 18. Location of the shared and local content stores

    Location of the shared and local content stores
  14. Enter the appropriate settings for your messaging environment.

    You can choose not to enable notifications during the installation process and get back to it later.

  15. Click Next.
  16. Review the packages to be installed, and then click Install.
  17. After IBM Connections has been installed, click Finish to close the wizard.

Configure IBM HTTP Server

To configure IBM HTTP Server, complete the following steps:

  1. Log in to the WebSphere Application Server ISC on the Deployment Manager, and click System administration > Nodes > Add Node.
  2. Select Unmanaged node, and click Next.
  3. Enter the name and hostname for the new instance, and click OK to save the changes to the master configuration.
  4. Click Servers > Server Types > Web servers, and click New.
  5. Select the unmanaged node you created earlier, enter the server name, and select IBM HTTP Server as the type. Click Next.
  6. Select the default web server template, and click Next.
  7. Enter the information requested based on the IBM HTTP Server installation (see Figure 19). Click Next.
    Figure 19. IBM HTTP Server settings
    IBM HTTP Server settings
  8. Click Finish to save the changes to the master configuration.
  9. Click System Administration > Nodes, and synchronize the IBM Connections node.
  10. Click Servers > Server Types > Web servers, and generate and propagate the plug-in for the web server you just created.
  11. Click Servers > Server Types > webserver1 > Plug-in properties, and click Copy to Web Server key store directory (see Figure 20).

    Note: If the plugin-key.kdb file is on a different system from the IBM HTTP Server system, copy it manually from the WebSphere Application Server system.

    Figure 20. Copying the Web Server plug-in
    Copying the Web Server plug-in
  12. Restart IBM HTTP Server.

At this point, IBM Connections should be accessible. Note that IBM Connections uses HTTP Secure Sockets Layer (SSL) by default. For a pilot, you should be able to install the self-signed SSL certificate provided with the installation and avoid the security warnings. For additional information on the IBM HTTP Server and SSL configuration along with WebSphere Application Server and SSL certificates, see Resources.

Now that you have installed IBM Connections, you must configure your landing page for the Blogs feature and perform additional tasks, like assign an administrator for each feature for further administration. In addition, you must update web addresses. See Resources for links to information on these and other tasks.

Important considerations when deploying IBM Connections

Every software implementation must perform well enough and be as fast as possible for users to be able to enjoy the full experience. The following sections provide important topics that you must consider when deploying IBM Connections.

Java Virtual Machine

Although multiple components can run in a single JVM, doing so is not recommended for non-pilot deployments. It is easier to run each component in a separate JVM than to decide which component is to run on which JVM.

Running multiple nodes is required for failover but is not necessary for capacity, except in deployments with more than 100,000 users. If your system is 32 bit, remember that 32-bit JVMs can support a heap size of 1.5GB. Single-component benchmarks show that 1GB is usually sufficient to use all CPU resources and drive enough database load to saturate disks.

Also, for small and medium deployments, review the maximum heap size. IBM Installation Manager sets the values shown in Table 1 for such deployments.

Table 1. Default maximum heap size
SystemMaximum heap size

Adjust the current values of the heap size up or down to suit the needs of your deployment and your hardware capabilities.

Multiple servers per node

The limit for running multiple WebSphere Application Server instances per node is based on system memory. Always make sure you have enough physical memory to run all JVMs at their maximum size, and avoid paging; 8GB of system memory will be usable, but 12GB or more is better.

Database instances

It is optimal to run an instance per component rather than allocate all components into two or three instances. You cannot scale with all components in a single instance.

Running multiple database servers is not necessary, except in particularly large deployments. Database high availability and failover are supported if the process is transparent to Java Database Connectivity (JDBC), but you must beware of data replication lag time. If you use a 32-bit system, remember that the same rules for WebSphere Application Server instances are valid: You are limited to 2GB of memory per instance.

Shared file system

In IBM Connections 3.0.x, there is a requirement to have a shared file system that needs to be accessible to all WebSphere nodes. For a shared file system, make sure of the following:

  • Linux®/UNIX®: You must have Network File System v4.
  • Windows: Make sure that the bandwidth to the share is sufficient, and possibly consider a dedicated file server for deployments larger than 100,000 users.

IBM Connections 3.0.1 can run without a file repository, but searches, downloads, and updates with file content will fail. Consider a General Parallel File System, instead. Also, in medium or large deployments, configure the Windows services for IBM Connections to start as a valid network account, not as LocalSystemAccount. Doing so allows the multiple nodes involved in the IBM Connection deployment to access the shared file systems on the network.


An array provides fault tolerance from disk errors or failures and continues to operate as long as at least one drive in the mirrored set is functioning. With appropriate operating system support, there can be increased read performance and only a minimal write performance reduction.

In redundant array of independent disks (RAID) 2 (bit-level striping with dedicated Hamming-code parity), all disk spindle rotation is synchronized, and data is striped such that each sequential bit is on a different disk. Hamming-code parity is calculated across corresponding bits on disks and stored on one or more parity disks. Extremely high data transfer rates are possible. In RAID 3 (byte-level striping with dedicated parity), all disk spindle rotation is synchronized, and data is striped such that each sequential byte is on a different disk. Parity is calculated across corresponding bytes on disks and stored on a dedicated parity disk. Very high data transfer rates are possible.

IBM Connections 3.0.1 is database driven, and there can be significant disk activity on the database. IBM Connections 3.0.1 is also file driven: Activities, Wikis, Files, and Bookmarks all store data on the file system, and all components use disk-based full-text indexing. Consider a storage area network for deployments larger than 10,000 users or 100GB, with separate arrays and logical unit numbers for database and file store.


This article covered a significant portion of the installation process, plus additional considerations you need to be aware of when installing IBM Connections. After installing IBM Connections for the first time, you should have a considerable understanding of all components required and how they interact. As you continue working with IBM Connections, you will get to fully understand all the deployment options and how the tool can be installed and configured to achieve more complex requirements. Other articles in this series also cover the customization process of IBM Connections, including adding new fields to Profiles and applying the corporate look and feel.



Get products and technologies



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into IBM collaboration and social software on developerWorks

ArticleTitle=Installing IBM Connections 3.0.1