Skip to main content link. Accesskey S
  • HCL Logo
  • HCL Connections On-Premise Wiki
  • THIS WIKI IS READ-ONLY.
  • HCL Forums and Blogs
  • Home
  • API Documentation
Search
Learning Center > Education > Tutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 6 - Installing Tivoli Directory Integrator
  • Share Show Menu▼

Recent articles by this author

Using @mentions in Connections 4

New to @mentions? This short tutorial will demonstrate how they're used.

Tutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 9: Installing Connections 4.0

Lesson 9 of a 10 part tutorial that walks through a single node installation of Connections on a Red Hat Enterprise Linux 6.3 64 bit system. In this lesson, you will install Connections 4.0 . At the end of this lesson, you will be able to install and configure Connections in order to create a ...

start Tutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 8: Intermediate Steps

Lesson 8 of a 10 part tutorial that walks through a single node installation of Connections on a Red Hat Enterprise Linux 6.3 64 bit system. In this lesson, you will install Connections 4.0 . At the end of this lesson, you will be able to Configure WAS to work with Domino LDAP, create a dedicated ...

Tutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 7: Installing a Domino LDAP Directory

Lesson 7 of a 10 part tutorial that walks through a single node installation of Connections on a Red Hat Enterprise Linux 6.3 64 bit system. In this lesson, you will install a Domino LDAP Directory. At the end of this lesson, you will be able to install and configure a Domino LDAP server for use ...

Tutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 6 - Installing Tivoli Directory Integrator

Lesson 6 of a 10 part tutorial that walks through a single node installation of Connections on a Red Hat Enterprise Linux 6.3 64 bit system. In this lesson, you will install Tivoli Directory Integrator (TDI). At the end of this lesson, you will be able to install TDI which is necessary to ...
Learning Center articleTutorial - Installing Connections 4.0 on a Linux RHEL 6.3 64-bit System: LESSON 6 - Installing Tivoli Directory Integrator
Added by ~Kelly Rekromarobu | Edited by ~Kelly Rekromarobu on April 11, 2013 | Version 17
  • Actions Show Menu▼
expanded Abstract
collapsed Abstract
Lesson 6 of a 10 part tutorial that walks through a single node installation of Connections on a Red Hat Enterprise Linux 6.3 64 bit system. In this lesson, you will install Tivoli Directory Integrator (TDI). At the end of this lesson, you will be able to install TDI which is necessary to configure a single node Connections 4.0 environment running on a Red Hat Enterprise Linux 6.3 64 bit system.
Tags: connections4 installation rhel63
ShowTable of Contents
HideTable of Contents
  • 1 Overview
    • 1.1 Lesson objectives
    • 1.2 System requirements
    • 1.3 Resources
  • 2 Task 1: Install TDI
  • 3 Task 2: Install TDI Fix Pack 5
  • 4 Appendix A: Troubleshooting

Overview


This tutorial walks through a single-node installation of IBM Connections on a Red Hat Enterprise Linux 6.3 64-bit system . The first eight lessons are required to configure a working environment.

Introduction
Lesson 1: Preparing your system
Lesson 2: Installing WebSphere Application Server (WAS)
Lesson 3: Installing IBM HTTP Server and Plugin
Lesson 4: Installing WAS Fix Packs
Lesson 5: Installing DB2
Lesson 6: Installing Tivoli Directory Integrator
Lesson 7: Installing a Domino LDAP Directory
Lesson 8: Intermediate Steps
Lesson 9: Installing IBM Connections 4.0
Lesson 10: Installing Cognos (optional - requires another VM with 4G RAM and 100G disk space)


Lesson objectives


Tivoli Directory Integrator (TDI) is a software tool that synchronizes data across multiple repositories. Within the Lotus Connections framework, you can use TDI to populate and/or synchronize data from your LDAP directory, and possibly other sources, into the Profiles database. This is done by running the Profiles population wizard or you can manually populate the Profiles database by running TDI AssemblyLines.

In this lesson, you will install and configure TDI for use with Connections 4.0.

At the end of this lesson, you will be able to install and configure TDI for use with Connections 4.0. At the end of this tutorial, you will be ready to install and configure a single-node IBM Connections 4.0 environment running on a Red Hat Enterprise Linux 6.3 64-bit system.

After completing this lesson, you will be able to do the following:
  • Identify the Tivoli Directory Integrator (TDI) Installation and Fix Pack Files
  • Install TDI
  • Install TDI Fix Pack 5

At the end of this lesson, you will be able to install and configure TDI and fix pack.

System requirements


A RHEL 6.3 64-bit machine with a minimum of 8G memory and 100G of disk space is required.

Resources


IBM Connections 4.0 Documentation

IBM Connections 4.0 on Linux

List of related software for IBM Connections 4.0



Task 1: Install TDI


In this task, we will locate and install the Tivoli Directory Integrator.
Step
Action
1
Locate the TDI files below that were downloaded and extracted in Lesson 1, Task 8, Steps 1 & 2. They should be in the directory /opt/install/TDI.

CZ9MNML.tar
Part Number: CZ9MNML
Description: IBM Tivoli Directory Integrator Identity Edition v7.1 for Linux 64-bit IA x86

7.1.0-TIV-TDI-FP0005.zip
Description: IBM Tivoli Directory Integrator 7.1 Fix Pack 5

Note: If you do not have these files and need to download them, go to XL Software Downloads or IBM Passport Advantage On-line Web site or Fix Central.

2
Login as user root. Switch to the directory /opt/install/TDI. Extract the contents of file CZ9MNML.tar.

[root@connections4 ~]# cd /opt/install/TDI/

[root@connections4 TDI]# tar xvf CZ9MNML.tar

3
Switch to directory /opt/install/TDI/linux_x86_64 and run ./install_tdiv71_linux_x86_64.bin.

[root@connections4 TDI]# cd linux_x86_64
[root@connections4 linux_x86_64]# ./install_tdiv71_linux_x86_64.bin

4
At the initial dialogue, select your language. Click OK.
5
At the introduction dialogue, click OK.
6
The install will search to determine if TDI has already been installed. This may take quite awhile. You can allow this to complete or click Next to expedite the process.
7
At the dialogue Software License Agreement, select I accept the terms in the license agreement. Click Next.
8
At the dialogue Choose Install Folder, change the path to where TDI will be installed -> /opt/IBM/TDI/V7.1 . Click Next.
9
At the dialogue Choose Install Set, select Typical. Click Next.
10
At the dialogue Solutions Directory, select Do not specify - use current working directory at startup time. Click Next.
11
At the dialogue Server Port Values, leave the default ports. Click Next.

Server: 1099
System Store : 1527
REST API Port 1098
System Queue Port: 41001


12
At the dialogue Register Server as a Service, leave box unchecked. Click Next.

13
At the dialogue Integrated Solutions Console Port Values, leave the default ports. Click Next.

HTTP: 13100
HTTPS : 13101
Action : 13104

14
At the dialogue AMC Service, leave box unchecked. Click Next.
15
You will receive a dialogue stating "Please wait, IBM Tivoli Directory Integrator v7.1 is being configured for your system. This may take a moment...".
16
At the dialogue Pre-Installation Summary, click Install.
17
At the dialogue Install Complete, de-select the Start Configuration Editor. Click Done.
Note: Any warnings are usually benign. If you would like to determine the cause, see Appendix A: Troubleshooting.
18
Result: You have successfully installed Tivoli Directory Integrator v7.1.


Task 2: Install TDI Fix Pack 5

In this task, we will install the required TDI fix pack 5.

Step
Action
1
Log in as user root.
2
Located the fix pack file 7.1.0-TIV-TDI-FP0005.zip previously downloaded in Lesson 1, Task 7, Step 4. It should be in the directory /opt/install/TDI. Switch directory to /opt/install. Make a new directory called TDIFix. Move the 7.1.0-TIV-TDI-FP0005.zip file to this directory and unzip the contents.

[root@connections4]# mkdir /opt/install/TDIFix

[root@connections4]# cd /opt/install/TDIFix
[root@connections4 TDIFix]# mv ../TDI/7.1.0-TIV-TDI-FP0005.zip .      (NOTE: TRAILING SPACE DOT)
[root@connections4 TDIFix]# unzip 7.1.0-TIV-TDI-FP0005.zip
Archive:  7.1.0-TIV-TDI-FP0005.zip
   creating: 7.1.0-TIV-TDI-FP0005/
  inflating: 7.1.0-TIV-TDI-FP0005/7.1.0-TIV-TDI-FP0005.README.html  
  inflating: 7.1.0-TIV-TDI-FP0005/applyUpdates.sh  
  inflating: 7.1.0-TIV-TDI-FP0005/LWI8.1.0SecurityFixUpdateSite.zip  
 extracting: 7.1.0-TIV-TDI-FP0005/TDI-7.1-FP0005.zip  
[root@connections4 TDIFix]#

3
Switch to the 7.1.0-TIV-TDI-FP0005 directory and change the permissions on the applyUpdates.sh file to read/write. Once changed, copy the file to the /opt/IBM/TDI/V7.1/bin/ directory (overwriting the existing file).

[root@connections4 TDIFix]# cd /opt/install/TDIFix/7.1.0-TIV-TDI-FP0005
[root@connections4 7.1.0-TIV-TDI-FP0005]# ls -l
...
-rw------- 1 root root     3568 Jul 17  2010 applyUpdates.sh (before permissions are changed)
...
[root@connections4 7.1.0-TIV-TDI-FP0005]# chmod 777 applyUpdates.sh
[root@connections4 7.1.0-TIV-TDI-FP0005]# ls -l
...
-rwxrwxrwx 1 root root     3568 Jul 17  2010 applyUpdates.sh (after permissions are changed)
...
root@connections4 7.1.0-TIV-TDI-FP0005]# cp ./applyUpdates.sh /opt/IBM/TDI/V7.1/bin/
cp: overwrite `/opt/IBM/TDI/V7.1/bin/applyUpdates.sh'? y
4
Run the applyUpdates.sh shell script as shown below to install the fix pack.

[root@connections4 7.1.0-TIV-TDI-FP0005]# /opt/IBM/TDI/V7.1/bin/applyUpdates.sh -update TDI-7.1-FP0005.zip
CTGDKO023I Applying fix 'TDI-7.1-FP0005' using backup directory '/opt/IBM/TDI/V7.1/maintenance/BACKUP/TDI-7.1-FP0005'.
CTGDKO027I Updating SERVER.
CTGDKO027I Updating CE.
CTGDKO027I Updating EXAMPLES.
5
Change directory to /opt/IBM/TDI/V7.1/bin. Run the command shown below to confirm the successful installation of the fix pack. Output should be similar.

[root@connections4 7.1.0-TIV-TDI-FP0005]# cd /opt/IBM/TDI/V7.1/bin
[root@connections4 bin]# ./applyUpdates.sh -queryreg

Information from .registry file in: /opt/IBM/TDI/V7.1
Edition: Identity
Level: 7.1.0.5
License: None

Fixes Applied
=-=-=-=-=-=-=
TDI-7.1-FP0005(7.1.0.0) 

Components Installed
=-=-=-=-=-=-=-=-=-=
BASE
SERVER
   -TDI-7.1-FP0005
CE
   -TDI-7.1-FP0005
JAVADOCS
EXAMPLES
   -TDI-7.1-FP0005
EMBEDDED WEB PLATFORM
AMC
   Deferred: false
6
Result: You have successfully installed TDI fix pack 5.


Appendix A: Troubleshooting



Problem
You receive a warning similar to the following:

"The installation of IBM Tivoli Directory Integrator v7.1 is finished, but some warnings occurred during the install. Please see the installation log for details."


This would most likely occur on Task 1, step 17 at the completion of the TDI installation.
Resolution
1. To determine the cause of the warning message, go to the /tmp directory and search for files by date. One of the most recent files will have an extension of .details.

[root@connections4 tmp]# ls -lrt
...
drwx------  5 root     root        4096 Jan 30 10:32 install.dir.4515
-rw-rw-r--  1 root     root     1213560 Jan 30 10:32 f60eea0813c8c12e916.details
-rw-rw-r--  1 root     root      621044 Jan 30 10:32 tdiv71debug.log
...


2. Once found, open this file and search for 'warning' to determine the cause. See examples below. These warnings are informational only and do NOT impact successful completion of the install.

...
Install Uninstaller: IBM Tivoli Directory Integrator v7.1 (Install All Uninstaller Components)
Status: SUCCESSFUL


Status: WARNING
Additional Notes: WARNING - Could not determine the version of Gnome that is installed. Shortcuts may not work properly.


Status: WARNING
Additional Notes: WARNING - Could not determine the version of KDE that is installed. Shortcuts may not work properly.

Custom Action: com.ibm.eec.pit.ia.customcode.action.CreateLinuxShortcutAction
Status: SUCCESSFUL


Status: WARNING
Additional Notes: WARNING - Could not determine the version of Gnome that is installed. Shortcuts may not work properly.


Status: WARNING
Additional Notes: WARNING - Could not determine the version of KDE that is installed. Shortcuts may not work properly.

Custom Action: com.ibm.eec.pit.ia.customcode.action.CreateLinuxShortcutAction
Status: SUCCESSFUL


Status: WARNING
Additional Notes: WARNING - Could not determine the version of Gnome that is installed. Shortcuts may not work properly.

  • Actions Show Menu▼


expanded Attachments (0)
collapsed Attachments (0)
Edit the article to add or modify attachments.
expanded Versions (1)
collapsed Versions (1)
Version Comparison     
VersionDateChanged by              Summary of changes
This version (17)Apr 11, 2013, 7:03:42 PM~Kelly Rekromarobu  
expanded Comments (0)
collapsed Comments (0)
Copy and paste this wiki markup to link to this article from another article in this wiki.
Go ElsewhereStay ConnectedAbout
  • HCL Software
  • HCL Digital Solutions community
  • HCL Software support
  • BlogsDigital Solutions blog
  • Community LinkHCL Software forums and blogs
  • About HCL Software
  • Privacy
  • Accessibility