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. There are nine lessons in this tutorial. This is Lesson 1 - Preparing your system.
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
Several applications are required to install and configure an IBM Connections environment. In this lesson, you will identify, locate, and download all the required files for each application. You will:
• Procure all required files
• Create the directory structure
• Set the file permissions
At the end of the lesson, 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.
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: Configure your system
For additional information on this topic, refer to Preparing Linux systems for installation.
Step
|
Action
|
1
|
Verify the version of Linux. Type the following command prompt:
[root@connections4 ~]# cat /etc/redhat-release
This should return:
Red Hat Enterprise Linux Server release 6.3 (Santiago)
|
2
|
As the root user, run the following command to create a symbolic link that is needed by the IBM HTTP Server:
ln -s /bin/ksh /usr/bin/ksh
|
3
|
Disable SELinux by setting SELINUX=disabled in /etc/selinux/config |
4
|
Add multilib_policy=all to /etc/yum.conf |
5
|
Enter the following commands:
[root@connections4 ~]# cd ~
[root@connections4 ~]# umask 022
[root@connections4 ~]# vi .bashrc
|
6
|
Add the line: ulimit -n 8192
Save and exit file. |
7
|
Set the ulimit for the working current session :
[root@connections4 ~]# ulimit -n 8192
|
8
|
Confirm ulimit setting is in effect:
[root@connections4 ~]# ulimit -a
|
9
|
Create the following directories under /opt to store the install packages:
[root@connections4 ~]# mkdir -p /opt/install/WAS
[root@connections4 ~]# mkdir /opt/install/WASSupp1
[root@connections4 ~]# mkdir /opt/install/WASSupp2
[root@connections4 ~]# mkdir /opt/install/WASFixes
[root@connections4 ~]# chmod 777 /opt/install/
|
Task 2: Install RHEL 6.3 packages
For additional information on this topic, see Preparing Red Hat Enterprise Linux 6 for Installation.
Several packages are required to be installed before installing Connections. These packages are part of the Red Hat Enterprise Linux 6 operating system, but they might not installed by default.
To determine which package (a.k.a. library) is installed, run the rpm -qa | grep package_name command to verify that you have both versions of each package. Because some packages may have been updated, it’s a good practice to search for the package using a prefix. For example, when searching for pam-1.1.1-4, issue the search rpm –qa | grep pam-1 which will return a result for either the minimum required pam-1.1.1-4 or the updated pam-1.1.1-10.
The packages shown in the table below are required to install Connections. If patches or service packs have been applied to your system, it's possible that packages newer than those shown below may be installed. This is OK. You can install a later release of any of these packages if available. All of the required packages will be on your installation DVD and can be installed using the GUI Installer or use the yum command as shown below.
Note: RPM stands for RPM Package Manager (formerly Redhat Package Management). The files with suffix _64 indicate 64-bit versions.
Required package
|
Latest Version for RHEL 6.3
(as of Nov. 2012)
|
Is it installed?
|
Install It!
|
compat-db-4.6.21-15*
|
compat-db-4.6.21-15.el6.i686
compat-db-4.6.21-15.el6.x86_64
|
rpm -qa | grep compat-db-4.6.21
|
yum install compat-db-4.6.21*
|
compat-libstdc++-33-3.2.3-69*
|
compat-libstdc++-33-3.2.3-69.el6.x86_64
compat-libstdc++-33-3.2.3-69.el6.i686
|
rpm -qa | grep compat-libstdc++-33
|
yum install compat-libstdc++-33*
|
elfutils-0.148-1
|
elfutils-0.152-1.el6.x86_64
|
rpm -qa | grep elfutils-0
|
yum install elfutils-0*
|
elfutils-libs-0.148-1
|
elfutils-libs-0.152-1.el6.i686
elfutils-libs-0.152-1.el6.x86__64
|
rpm -qa | grep elfutils-libs-0
|
yum install elfutils-libs-0*
|
gtk2-2.18.9-4*
|
gtk2-2.18.9-10.x86_64
gtk2-2.18.9-10.el6.i686
|
rpm -qa | grep gtk2*
|
yum install gtk2*
|
gtk2-engines-2.18.4-5*
|
gtk2-engines-2.18.4-5.el6.x86_64
gtk2-engines-2.18.4-5.el6.i686
|
rpm -qa | grep gtk2-engines-2
|
yum install gtk2-engines-2*
|
ksh-20100621-2
|
ksh-20100621-16.el6.x86_64
|
rpm -qa | grep ksh-201
|
yum install ksh-20100621*
|
libXft-2.1.13-4.1*
|
libXft-2.1.13-4.1.el6.i686
libXft-2.1.13-4.1.x86_64
|
rpm -qa | grep libXft-2.1.13
|
yum install libXft-2.1.13*
|
libXmu-1.0.5-1*
|
libXmu-1.0.5-1.el6.x86_64
libXmu-1.0.5-1.el6.i686
|
rpm -qa | grep libXmu-1.0.5
|
yum install libXmu-1.0.5*
|
libXp-1.0.0-15.1*
|
libXp-1.0.0-15.1.el6.i686
libXp-1.0.0-15.1.el6.x86_64
|
rpm -qa | grep libXp-1.0.0
|
yum install libXp-1.0.0*
|
openmotif22-2.2.3-19*
(Required for Cognos)
|
openmotif22-2.2.3-19.el6.x86_64
openmotif22-2.2.3-19.el6.i686
|
rpm -qa | grep openmotif22
|
yum install openmotif22*
|
openmotif-2.3.3-4
|
openmotif-2.3.3-4.el6.i686
|
rpm -qa | grep openmotif-2.3.3
|
yum install openmotif-2.3.3*
|
libXtst-1.0.99.2-3*
|
libXtst-1.0.99.2-3.el6.i686
libXtst-1.0.99.2-3.x86_64
|
rpm -qa | grep libXtst-1.0.99
|
yum install libXtst-1.0.99*
|
pam-1.1.1-4*
|
pam-1.1.1-10. x86_64
pam-1.1.1-10. el6.i686
|
rpm -qa | grep pam-1.1.1
|
yum install pam-1.1.1*
|
rpm-build-4.8.0-12
|
rpm-build-4.8.0-27.el6.x86_64
|
rpm -qa | grep rpm-build-4.8.0
|
yum install rpm-build-4.8.0*
|
xulrunner-10.0.5-1
(Required for Cognos)
|
xulrunner-10.0.5-1.el6_2.i686
xulrunner-10.0.5-1.el6_2.x86_64
|
rpm -qa | grep xulrunner
|
yum install xulrunner*
|
*Those packages marked with an asterisk require both the 32-bit and 64-bit versions. This is to support 64-bit applications as well as 32-bit applications such as the IBM HTTP Server.
Step
|
Action
|
1
|
Verify each of the required packages is installed by entering the command rpm -qa | grep package_name
For example:
[root@connections4 ~]# rpm -qa | grep compat-db-4.6.21-15
Should return:
compat-db-4.6.21-15.el6.i686
compat-db-4.6.21-15.el6.x86_64
|
2
|
Use the yum command to install packages as needed.
For example:
yum install compat-db-4.6.21-15.el6.i686
|
Task 3: Prepare to install WAS
See Appendix A for a list of suggested directory paths.
Step
|
Action
|
1
|
Download the packages below using XL Software Downloads or from IBM Passport Advantage On-line Web site.
C1G35ML.tar.gz
Part Number: C1G35ML
Description: WebSphere Application Server Network Deployment V7.0 for Linux on x86-64 bit
C1G36ML.tar.gz
Part Number: C1G36ML
Description: WebSphere Application Server Network Deployment Supplements V7.0 for Linux on x86-64 bit (1 of 2)
C1G37ML.tar.gz
Part Number: C1G37ML
Description: WebSphere Application Server Network Deployment Supplements V7.0 for Linux on x86-64 bit (2 of 2)
For additional details, got to the URL below and refer to section Linux on x86 64-bit architecture
http://www-01.ibm.com/support/docview.wss?uid=swg27013044
|
2
|
Extract the WAS installation package and run the installer.
[root@connections4 ~]# cd /opt/install/WAS
[root@connections4 WAS]# tar xvfz ../C1G35ML.tar.gz
[root@connections4 WAS]# ./launchpad.sh
|
3
|
Verify the installation wizard launched.
Exit the install dialog. |
Task 4 (optional): Configure Firefox v. 10 or later
If you are using Firefox v.10 or later (very likely), you will need to modify two files: browser.sh and fbrowsher.sh
Modify each file so that it contains the following string in the supportedFirefoxVersion case statement:
*Firefox\ [1-9][0-9].*) return 0;;
The function should then look like this:
supportedFirefoxVersion()
{
case "$*" in
*Firefox\ [1-9].*) return 0;;
*Firefox/[1-9].*) return 0;;
*Firefox\ [1-9][0-9].*) return 0;;
...
The browser.sh file is located at
/launchpad/browser.sh
The fbrowser.sh file is located at ./IBM/WebSphere/AppServer2/firststeps/fbrowser.sh
Failure to modify these files can result in the following error:
Unable to find supported browser
The launchpad cannot start. This error typically occurs when a supported browser cannot be found.
For more details, see Technote 159598.
Task 5: Prepare to install IBM HTTP Server and Plugin
Step
|
Action
|
1
|
Extract the contents of C1G36ML.tar.gz and run the installer
[root@connections4 WAS]# cd /opt/install/WASSupp1
[root@connections4 WASSupp1]# tar xvfz ../C1G36ML.tar.gz
[root@connections4 WASSupp1]# cd IHS
[root@connections4 IHS]# ./install
|
2
|
Verify the installation wizard launched.
Exit the install dialog. |
Task 6: Prepare to install the WAS Fix Pack 7.0.0.21
Task 7: Prepare to install DB2
Step
|
Action
|
1
|
Download the following packages from XL Software Downloads or IBM Passport Advantage On-line Web site.
DB2_ESE_97_Linux_x86-64.tar.gz
Part Number: CZ19NEN
Description: IBM DB2 Enterprise Server Edition 9.7 for Linux® on AMD64 and Intel® EM64T systems (x64) English
DB2_ESE_Restricted_QS_Activation_97.zip
Part Number: CZ381ML
Description: IBM DB2 9.7, Enterprise Server Edition - Restricted Use - QuickStart Guide and Activation Multiplatform Multilingual |
2
|
Download the following package from Fix Central
v9.7fp5_linuxx64_universal_fixpack.tar.gz
Description: DB2 9.7.0.5 fix pack |
3
|
Create installation directories and set file permissions:
[root@connections4 ]# mkdir -p /opt/install/DB2
[root@connections4 ]# chmod 777 -R /opt/install/
|
4
|
Transfer the installation packages into /opt/install/DB2 and extract the files:
[root@connections4 ]# cd /opt/install/DB2
[root@connections4 ]# tar xvfz DB2_ESE_97_Linux_x86-64.tar.gz
|
5
|
Switch to the /opt/install/DB2/ese directory and verify the DB2 installation wizard starts.
[root@connections4 ]# cd /opt/install/DB2/ese
[root@connections4 ]# ./db2setup
Exit the install dialog. |
Task 8: Prepare to install Tivoli Directory Integrator
Step
|
Action
|
1
|
Download the following TDI 7.1 package from XL Software Downloads or IBM Passport Advantage On-line Web site:
CZ9MNML.tar
Part Number: CZ9MNML
Description: IBM Tivoli Directory Integrator Identity Edition v7.1 for Linux 64-bit IA x86 |
2
|
Download the following TDI 7.1 package from Fix Central
7.1.0-TIV-TDI-FP0005.zip*
Description: IBM Tivoli Directory Integrator 7.1 Fix Pack 5
*It's OK to choose Fix Packs later than FP5. Always choose the latest if you plan to develop custom TDI assembly lines.
To locate this file in Fix Central, choose the Select Product tab. Enter the values Tivoli – Tivoli Directory Integrator – 7.1.0 – Linux (see image below). Click Continue.
|
3
|
Select Recommended and click Continue.
|
4
|
Locate the file 7.1.0-TIV-TDI-FP0005.zip* in the results and select it. Click Continue.
*It's OK to choose Fix Packs later than FP5. Always choose the latest if you plan to develop custom TDI assembly lines.
|
5
|
Choose a download option and select Continue.
|
6
|
Log in as root and create a TDI folder for the installation and set file permissions:
[root@connections4 ]# mkdir /opt/install/TDI
[root@connections4 ]# chmod 777 /opt/install/TDI
|
7
|
Copy the downloaded files into /opt/install/TDI and extract the contents of CZ9MNML.tar.
[root@connections4 ]# cd /opt/install/TDI/
[root@connections4 ]# tar xvf ../CZ9MNML.tar
|
8
|
Switch to the /opt/install/TDI directory and verify the TDI installation wizard starts.
[root@connections4 ]# cd /opt/install/TDI
[root@connections4 ]# ./launchpad.sh
Exit the install dialog. |
Task 9: Prepare the LDAP Directory
We will use IBM Domino as the LDAP directory. See the Domino 8.5 Administrator Client Help for more information.
Step
|
Action
|
1
|
Download the following Domino installation kit from XL Software Downloads or IBM Passport Advantage On-line Web site:
lotus_domino853_xlinux_en.tar
Part Number: CI1LBEN
Description: IBM Lotus Domino V8.5.3 32 bit Linux for xSeries English
lotus_domino853FP2_linux_x86.tar
Part Number: CI8JCEN
Description: IBM Lotus Domino Server V8.5.3 Fix Pack 2 for Linux on Intel English
notes_designer_admin853_w32en.exe
Part Number: CI1LQEN
Description: IBM Lotus Notes, Domino Designer and Admin V8.5.3 for Windows XP,Vista and Windows 7 32 Bit English
Note: The Notes administration client will be setup on a Windows client as there is no Linux admin client. |
2
|
Create the following directory structure and set file permissions:
[root@connections4 ]# mkdir -p /opt/install/Domino
[root@connections4 ]# chmod 777 -R /opt/install/
|
3
|
Switch to the directory /opt/install/Domino and extract the contents of lotus_domino853_xlinux_en.tar.
[root@connections4 Domino]# pwd
/opt/install/Domino
[root@connections4 Domino]# tar xvf lotus_domino853_xlinux_en.tar
|
4
|
The extraction from the previous step will create a new directory structure under /opt/install/Domino. Switch to the linux/domino directory and run ./install. When prompted to continue in graphic mode, type Yes and click Enter.
[root@connections4 Domino]# pwd
/opt/install/Domino/linux/domino
[root@connections4 domino]# ./install
Lotus Domino for Unix Install Program
Your DISPLAY is currently set to :1.0
Answer Yes to continue in graphic mode
Answer No to continue in console mode
Answer Exit to exit application.
Do you wish to continue in graphic mode?[Yes]
Yes
Continuing in graphic mode
InstallShield Wizard
Click Cancel to exit the install dialog. |
Task 10: Prepare to install IBM Connections 4.0
Step
|
Action
|
1
|
Download the following packages from XL Software Downloads or IBM Passport Advantage On-line Web site:
IBM_Connection40_LinAIX_CIA3EML.tar
Part Number: CIA3EML
Description: IBM Connections V4.0 for Linux, AIX Multilingual
IBM_Connection40_Wzd_LNXAIX_CIA3HML.tar
Part Number: CIA3HML
Description: IBM Connections V4.0 Wizard for Linux, AIX Multilingual
In the Find by part number section, enter CIA3EML, CIA3HML. Click Search.
Results:
|
2
|
Create the installation directory and set file permissions:
[root@connections4 ]# mkdir -p /opt/install/Connections
[root@connections4 ]# chmod 777 -R /opt/install/Connections
|
3
|
Transfer both files to into /opt/install/Connections and extract.
Example:
[root@connections4 ~]# cd /opt/install/Connections
[root@connections4 Connections]# tar xvf IBM_Connection40_LinAIX_CIA3EML.tar
[root@connections4 IBM_Connections]# ./launchpad.sh
|
4
|
Switch to the /opt/install/Connections directory and verify the IBM Connections 4.0 wizard can start.
[root@connections4 ]# cd /opt/install/Connections
[root@connections4 ]# ./launchpad.sh
Exit the install dialog. |
5
|
Download a copy of the Worksheet for installing IBM Connections.
This worksheet will be useful as you progress through the installation. |
You are now ready to begin the installation of all the applications that make up Connections 4! Let's move on to Lesson 2: Installing WebSphere Application Server.
Appendix A
Suggested directory paths for the applications you will be installing:
Directory
|
Directory variable
|
Default installation root
|
IBM WebSphere® Application Server installation directory
|
app_server_root
|
/opt/IBM/WebSphere/AppServer
|
IBM WebSphere® Application Server profile directory
|
profile_root
|
/opt/IBM/WebSphere/AppServer/profiles/profile_name
|
IBM HTTP Server installation directory
|
ibm_http_server_root
|
/opt/IBM/HTTPServer
|
IBM Connections installation directory
|
connections_root
|
/opt/IBM/Connections
|
Local content stores
|
local_data_directory_root
|
/opt/IBM/Connections/data/local
|
Shared content stores
|
shared_data_directory_root
|
/opt/IBM/Connections/data/shared
|
IBM Installation Manager installation directory
|
IM_root
|
/opt/IBM/InstallationManager
|
Shared resources directory
|
shared_resources_root
|
/opt/IBM/SSPShared
|
DB2® database installation directory*
|
db2_root
|
/opt/ibm/db2/version
|
Oracle database installation directory*
|
oracle_root
|
/home/oracle/oracle/product/version/db_1
|
IBM Cognos® BI Server installation directory (optional)
|
Cognos_BI_install_path
|
/opt/IBM/Cognos64
|
Cognos Transformer installation directory (optional)
|
Cognos_Transformer_install_path
|
/opt/IBM/Cognos
|
*A database is required