ShowTable of Contents
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
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.
|