TPC install and setup
A detailed description about the installation of TPC (VSC) on Linux
Product
IBM Tivoli Storage Productivity Center - Virtual Storage Center Edition
Platform
- RedHat Enterprise Linux 6.3 x86_64 (kernel 2.6.32-279.22.1.el6.x86_64)
- VMWare ESXi 4x Intel(R) Xeon(R) CPU E5-2660 0 @ 2.20GHz
- 11GB of RAM, 2GB of swap
Install kits
from IBM Passport Advantage
- DB2_ESE_10.1_FIX_PACK_3_LINUX_AMD.tar.gz (734 MB)
- ITCR_3.1.0.1_FOR_LINUX.tar.gz (1751 MB) - Tivoli Common Reporting (Cognos) (base)
- ITCR_3.1.0.2_FOR_LINUX.tar.gz (1185 MB) Tivoli Common Reporting (Cognos) (update)
- JAZZ_FOR_SM_1.1.0.3_FOR_LNX.zip (1163 MB)
- WAS_V8.5.0.1_FOR_JAZZSM_LINUX_ML.zip (1426 MB)
- TPC_ADVANCED_V5.2.3_LNX_1_OF_2.tar (963 MB) - TPC server JARs, libs, scripts, database scripts
- TSPC_V5.2.3_LNX_2_OF_2.tar (938 MB) - TPC Web eWAS, device server, replication server, IBMIM
Prerequisites
Full root access
Filesystems (Minimum)
Installation
/ 3.0GB including /home/db2inst1
/tmp 2.0GB
/var 1.0GB
/opt/IBM 40GB
Running system
/ 1.8GB +additional space for database logs
--> /home/db2inst1 1.4GB
/tmp 200MB
--> /tmp/javasharedresources 150MB
/var 500MB+
--> /var/ibm/InstallationManager 30MB+
/opt/IBM 40GB
--> installation material 22GB
--> installed product 18GB
Enlarge number of files ulimit parameter
# cat /etc/security/limits.d/91-nofile.conf
* soft nofile unlimited
Install DB2
Install RPMs for TPC: libstdc++-4.4.7-4.el6.i686 pam-1.1.1-17.el6.i686
Install RPMs for JazzSM: openmotif-2.3.3-7.1.el6_5.i686 openmotif22-2.2.3-19.el6.x86_64 openmotif22-2.2.3-19.el6.i686 firefox-24.7.0-1.el6_5.x86_64 (and perhaps some libX* stuff)
Installation procedure
Normally, the TPC installer would invoke the JazzSM install launchpad, but we could not get the TPC installer working in GUI mode.
So we installed JazzSM WAS and Cognos reporting first, then we specified the installed JazzSM in the TPC response file. The actual installation of TPC was done in silent mode.
Setup remote X11 for root
The login user's ssh X11 forwarding will set DISPLAY and the Xauth cookie; use DISPLAY if there are multiple xauth cookies
$ echo $DISPLAY
localhost:12.0
$ xauth list
myhost/unix:12 MIT-MAGIC-COOKIE-1 b82b26a04949071b280301c587e68112
Add it for root (cleanup first if you feel like housekeeping)
# xauth list | while read foo junk; do xauth remove $foo; done
# xauth add myhost/unix:12 MIT-MAGIC-COOKIE-1 b82b26a04949071b280301c587e68112
Test it
Modify CPU speed in the installer files to pass PRS (prerequisite scanner) checks
See also at Install logs
# vmware-toolbox-cmd stat speed
2200 MHz
Change these (defaults below) to a lower value according to the above:
/tmp/install/JazzSM/templates/prs/unix/FAS.cfg
intel.cpu=2.93GHz
/tmp/install/JazzSM/templates/prs/unix/DSH.cfg
intel.cpu=2.4GHz
Run the JazzSM launchpad
It will open a remote X11 browser session.
# /tmp/install/JazzSM/launchpad.sh
It can take several hours (!).
The installer should fail at the step "Install Reporting Services" because it cannot create database. You can create it before running the installer.
Optionally, you can prepare the database as described in Step 5.
The GUI might be slow (drop-down lists etc) and the browser menus did not work.
- Custom
- Home location: as desired (I used the default, /opt/IBM/JazzSM)
- Source locations: path to individual files in directories where products were extracted. A mouseover will display the help. Path selection is only possible by file selector window.
- Operations will be Install for every component
- Credentials: the JazzSM WAS admin password will be given here. For the database, an existing user is required.
The install is very slow. If any of the steps fail, the installer will detect that the previous components are already installed.
Create database manually for TPC
Shell script parameters: database name, database user
NB: 100MB is not enough, new database uses 248MB
# (path to extracted TCR base install)/TCRInstaller/ContentStoreDatabase/TCR_generate_content_store_db2_definition.sh TCRDB db2inst1
# su - db2inst1
$ db2 -vtf /tmp/install/TCR/TCRInstaller/ContentStoreDatabase/tcr_create_db2_cs.sql
Re-run the launchpad and finish installation, this time only with TCR
It should find the DB and install fine.
Install TPC in silent mode
Run the TPC install.bin in silent mode because both GUI and console will fail.
# cd /tmp/install/TPC
# export IATEMPDIR=/tmp/install/temp
# . /home/db2inst1/sqllib/db2profile
# ./setup.bin -f install.properties -i silent
The response file:
## Based on the sample response file "silent_SingleServerCustom.properties"
## Installer
LICENSE_ACCEPTED=true
CHOSEN_INSTALL_TYPE="Single Server Install"
USER_INSTALL_DIR=/opt/IBM/TPC
varFullRollback=0
## Server
varSrvName=myhost.mycompany
varTPCPortRangeSP=9549
## License
varUseLicenseKeyOnImage=0
varLicenseKeyFile=
## DB2
varCommonUsrID=db2inst1
varCommonUsrPW=password
varDBAdmUsr=db2inst1
varDBAdmPW=password
varDBName=TPCDB
# varDBPath=/home/db2inst1/db2inst1/NODE0000/TPCDB
varDBPath=/opt/IBM/TPCDB
varDBLogPath=
## Jazz(tm) for Service Management
varInstallReportingLater=false
JAZZSM_INSTALL_DIR=/opt/IBM/JazzSM/
varJazzSMUsrID=smadmin
varJazzSMUsrPW=password
Installer messages
GUI mode is not supported : ../temp/install.dir.10718/Linux/resource/jre/lib/i386/xawt/libmawt.so (libXext.so.6: cannot open shared object file: No such file or directory)
-- Missing 32bit library (libXext-1.3.1-2.el6.i686)
INFO com.ibm.tpc.install.db2.DB2Util initialize Error: java.lang.UnsatisfiedLinkError: /tmp/install/TPC/util/linux-ix86/libdb2util.so (libpam.so.0: cannot open shared object file: No such file or directory)
-- Missing 32bit libpam package
INFO TPCUtility handleException BPCIN0006E The location "/opt/IBM/TPC/" that was specified for the installation is not empty.
-- Installer assumes an empty directory
INFO com.ibm.tpc.install.frontend.ia.actions.SilentInstallValidation validateCommonUsersPWDs BPCIN0025E The password ******** cannot contain spaces or any of the following special characters: @ # $ % ^ & * = + { } \ | ; : ' " , < > / .
-- Database user password must not use include special characters
INFO com.ibm.tpc.install.frontend.ia.actions.SilentInstallValidation validateJazzSMLocation BPCIN0233E Jazz for Service Management is not installed in the specified location. Reenter the correct installation location for Jazz for Service Management.
-- When attempting to run the TPC installer without JazzSM installed
Installation failed. Return code 1. See Tivoli Common Reporting install log for details
See logs under /root/TCR*
INFO DBSchemaValidator displayErrorMsg DB2 prevalidation failed - BPCIN0091E The file path /opt/IBM/TPCDB specified is not an absolute path or is not a directory or the partition does not exists.
-- Directory must be created before install
INFO DBSchemaValidator displayErrorMsg DB2 prevalidation failed - BPCIN0094E The user name db2inst1 does not have write permission on the specified database path: /opt/IBM/TPCDB.
-- Database user needs write access to the directory
INFO com.ibm.tpc.install.frontend.ia.actions.SilentInstallValidation validateJazzSMLocation BPCIN0231E Tivoli Common Reporting is not installed on your system. You must install it to continue with the Tivoli Storage Productivity Center installation.
-- TCR is required before TPC
An attempt was made to access a database, TPCDB, which was either not found or does not support transactions. ERRORCODE=-4499, SQLSTATE=08004
-- Missing TPCDB.
INFO com.ibm.tpc.install.frontend.ia.actions.AddRequiredDiskSpaceAction calculateSpace Required space: /tmp 1,600 MB;/ 1,200 MB;/opt/IBM 5,382 MB
INFO com.ibm.tpc.install.frontend.ia.actions.AddRequiredDiskSpaceAction calculateSpace Available space: /tmp 518 MB;/ 163 MB;/opt/IBM 5,775 MB
INFO com.ibm.tpc.install.frontend.ia.actions.AddRequiredDiskSpaceAction calculateSpace BPCIN0026E The installation location selected does not have enough space.
-- Not enough space.
"When you remove the spaces, and rename the directory, for example: ... Tivoli Storage Productivity Center installs correctly."
Install logs
/root/jazzsm_launchpad/prs/result.txt
# grep FAIL jazzsm_launchpad/prs/result.txt
intel.cpu FAIL 2.20GHz 2.4GHz
intel.cpu FAIL 2.20GHz 2.93GHz
os.space.tmp_root FAIL 801MB [dir:root=/tmp,unit:MB]810
os.package.openmotif22 FAIL Unavailable openmotif22-2.2.3-18+
os.ulimit FAIL 1024 [type:filedescriptorlimit]2048+,unlimited
/tmp FAIL 801MB 810MB
Overall result: FAIL (DSH DSH: FAIL, ESS ESS: PASS, FAS FAS: FAIL, FRS FRS: PASS, ODP ODP: PASS, TCR TCR: FAIL)
/root/jazzsm_launchpad/logs/deployment.log
/root/TCR3101InstallMessage00.log
/root/TCR3101InstallTrace00.log
/root/TCRInstaller-00.log
/root/Tivoli_Common_Reporting_Install_(mm)_(dd)_(yyyy)_(HH)_(MM)_(ss).log
/tmp/lax-*.out
/tmp/lax-*.err
Management
JazzSM WAS admin port
https://localhost:16316/ibm/console
Change default port for TPC Web GUI
Edit the file /opt/IBM/TPC/ewas/profiles/WebServerProfile/config/cells/WebServerCell/nodes/WebServerNode/serverindex.xml
Change the port "WC_defaulthost_secure" from "9569" to a different value
Source: http://www-01.ibm.com/support/docview.wss?uid=swg21500769
List active (currently accessed) DB2 databases
db2 => list active databases
Active Databases
Database name = TPCDB
Applications connected currently = 29
Database path = /opt/IBM/db2_home/db2inst1/db2inst1/NODE0000/SQL00003/MEMBER0000/
Database name = FRSDB
Applications connected currently = 1
Database path = /opt/IBM/db2_home/db2inst1/db2inst1/NODE0000/SQL00001/MEMBER0000/
Database name = TCRDB
Applications connected currently = 29
Database path = /opt/IBM/db2_home/db2inst1/db2inst1/NODE0000/SQL00002/MEMBER0000/
Set DB2 diag logsize from unlimited to a limited value
db2 => update dbm cfg using diagsize 256
DB20000I The UPDATE DATABASE MANAGER CONFIGURATION command completed
Starting and stopping
See also at individual components below
Start
su - db2inst1 -c db2start
/opt/IBM/TPC/agent/bin/agent.sh start
/opt/IBM/TPC/scripts/startTPCWeb.sh
/opt/IBM/TPC/scripts/startTPCData.sh
/opt/IBM/TPC/scripts/startTPCDevice.sh
/opt/IBM/TPC/scripts/startTPCReplication.sh
/opt/IBM/JazzSM/profile/bin/startServer.sh server1
Stop
/opt/IBM/TPC/agent/bin/agent.sh stop
/opt/IBM/TPC/scripts/stopTPCWeb.sh
/opt/IBM/TPC/scripts/stopTPCData.sh
/opt/IBM/TPC/scripts/stopTPCDevice.sh
/opt/IBM/TPC/scripts/stopTPCReplication.sh
/opt/IBM/JazzSM/profile/bin/stopServer.sh server1
su - db2inst1 -c db2stop
Managed by init during boot/shutdown/switching runlevels in runlevel 3:
/etc/rc3.d/S75itna1
/etc/rc3.d/S90tpcdsrv1
/etc/rc3.d/S91device
/etc/rc3.d/S92replication
/etc/rc3.d/S98webguiEWAS
/etc/rc3.d/K90device
/etc/rc3.d/K91replication
/etc/rc3.d/K92webguiEWAS
Running components
[*] Change port:
# vi /opt/IBM/TPC/ewas/profiles/WebServerProfile/config/cells/WebServerCell/nodes/WebServerNode/serverindex.xml
endPointName="WC_defaulthost_secure" port="443"