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

Source: https://www.ibm.com/developerworks/community/forums/html/topic?id=77777777-0000-0000-0000-000014896067

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"