You are on page 1of 158

Tivoli Service Quality Manager /

Customer Experience Manager

E
T
T

Installation & Configuration SPVC

not for distribution

Workshop Objectives
Perform a complete installation of
Tivoli Netcool Service Quality Manager (TNSQM)
Tivoli Netcool Customer Experience Manager (TNCEM)

E
T
T

Install and configure two Service Solutions


TNSQM Module for IP VPN Services
TNCEM Module for UMTS Voice Services

Configure utilities to generate synthetic data for each


Service Solution
Learn how to demonstrate key features and functions of
TNSQM and TNCEM
Configure the integration with Tivoli Business Service
Manager (TBSM)
1-2

not for distribution

Workshop Logistics
Self Paced Virtual Classroom (SVPC) format

E
T
T

Recorded Presentations
Hands-on Exercises

Detailed lab workbooks for each exercise


Performed using a dedicated remote server

Total Time is Approximately 36-48 Hours

Each lab exercise is labeled with the approximate time


The exercises do not have to be completed in a single sitting

1-3

not for distribution

Workshop 1 System Prerequisites


Goal verify all system prerequisites

Operating System
Memory (real and virtual)
Disk
Filesystem
Host Name
Domain Name
Prepare system for installation

E
T
T

Create directories
Move installation software

Approximate time 45 minutes

1-4

not for distribution

Workshop 2 Platform Software Installation


Goal install platform software components
Oracle

E
T
T

SunOne Directory Server


Java Message Queue
WebSphere

Approximate time 1:15 minutes

1-5

not for distribution

Workshop 3 TNSQM / TNCEM Installation


Goal install TNSQM and TNCEM

E
T
T

Install TNSQM
Install TNCEM

Validate system

Configure system to forward SNMP traps

Approximate time 3 hours

1-6

not for distribution

Workshop 4 IP VPN Installation


Goal install TNSQM Module for IP VPN Services

E
T
T

Install GOM (Global Object Module)


Install IP VPN

Configure IP VPN demo data generation


Validate installation

Approximate time 60 minutes

1-7

not for distribution

Workshop 5 UMTS Voice Installation


Goal install TNCEM Module for UMTS Voice Services

E
T
T

Install UMTS Voice

Configure UMTS Voice demo data generation


Validate installation

Approximate time 60 minutes

1-8

not for distribution

Workshop 6 Client Installation


Goal Configure and validate client access

E
T
T

Configure Socks Proxy


Download & install TNSQM thick client
Configure student workstation thick client for proxy use
Configure student workstation browser for proxy use
Create new TNSQM user
Validate client access to TNSQM and CEM

Approximate time 45 minutes

1-9

not for distribution

Workshop 7 TNSQM Demo


Goal demonstrate key features and functions of
TNSQM

E
T
T

Create SLA (Service Level Agreement) Template


Create custom SLA
Monitor state changes of SLA
Using TNSQM thick client
Using SLA WebView

Create custom KQI (Key Quality Indicator)


Monitor the KQI using KQI Analyzer

Approximate time 1 hour

1-10

not for distribution

Workshop 8 TNCEM Demo


Goal demonstrate key features and functions of
TNCEM

E
T
T

Demonstrate TNCEM user interface


Investigate customer issues
Investigate group issues
Investigate device issues

Create custom SLO (Service Level Objective)


Monitor state changes of SLO

Approximate time 60 minutes

1-11

not for distribution

Workshop 9 TBSM / TNSQM Integration


Goal install and configure the TBSM / TNSQM
Integration

E
T
T

Add custom rules to NcKL (Netcool Knowledge Library)


Add custom fields to Object Server
Configure TBSM

Create service templates


Define auto-population rules
Configure Data Fetcher
Customize Service Tree
Add custom charts
Configure Single Sign On (SSO)
Configure Launch In Context (LC)

Approximate time 8 hours

1-12

not for distribution

Workshop 10 Custom Reporting Using BIRT


Goal install and configure BIRT and produce a custom
report

E
T
T

Install BIRT Designer on student workstation

Configure BIRT Designer for access to TNSQM server


Create custom report

Approximate time 45-60 minutes

1-13

not for distribution

Remote Server
Each student is assigned a dedicated server

E
T
T

Real server, not a virtual image

The server is reserved for student use (typically two


weeks)
The lab exercises may be completed any time during the
period that the server is assigned to the student

1-14

not for distribution

Workshop 1
To begin the workshop

E
T
T

Download and view System Pre-requisites

1-15

not for distribution

E
T
T

Workshop 1
TNSQM/TNCEM Installation
System Prerequisites

not for distribution

Objectives verify all system prerequisites

Operating System
Memory (real and virtual)
Disk
Filesystem
Host Name
Domain Name
Prepare system for installation

E
T
T

Create directories
Move installation software

Approximate time 45 minutes

1-17

not for distribution

E
T
T

Installation Prerequisites

1-18

not for distribution

General Requirements
Majority of the install performed as root

E
T
T

Install will create 2 additional UNIX users


oracle
saserver

Shared Memory changes may require reboot


Complete installation takes 6-8 hours, including
copying/expanding software

1-19

not for distribution

Minimum Hardware Requirements - Solaris


Sun SPARC Architecture

E
T
T

Four UltraSPARC IV, IV+ or UltraSPARC T1


processors
8GB core memory

NOTE: Release Notes for Service Solutions call for 32 GB

Four 72GB hard disks

IBM Tivoli Netcool Service Quality Manager Server Installation Guide

1-20

not for distribution

Operating System Requirements - Solaris


Solaris 10
6/06 or later
kernel patch 118833-36 or later
Including patch 122032-05 or later

E
T
T

Total of 16 GB Virtual Memory - MINIMUM


RAM + SWAP = 16 GB

1-21

not for distribution

Operating System Requirements - Solaris


Shared Memory settings for Oracle
Create a new project (101) for the dba group called Oracle

E
T
T

projadd p 101 c Oracle U oracle G dba user.oracle

Update this project with the necessary settings

projmod s K project.max-shm-memory=(privileged, 32GB, deny)


user.oracle
projmod s K project.max-shm-ids=(privileged, 1024, deny)
user.oracle
projmod s K project.max-sem-ids=(privileged, 4096, deny)
user.oracle
projmod s K project.max-sem-nsems=(privileged, 16010, deny)
user.oracle

Verify that the changes were applied correctly

/usr/bin/projects l

Does NOT require a reboot

1-22

not for distribution

3rd Party Software Platform Dependencies

Database

JMS
LDAP
Server JRE

1-23

E
T
T
AIX

Solaris

Oracle 10g,
Enterprise w/

Oracle 10g,
Enterprise w/

Partitioning

Partitioning

WebSphere

IMQ

Tivoli Directory
Server 6.1

SunOne DS

J2RE 1.5.0 IBM J9


2.3

Java HotSpot(TM)
Server VM

not for distribution

Filesystem Requirements (production grade)

1-24

Filesystem

Software

Size (Mbytes)

Disk Location

Operating system

8192

c1t0d0s0

[1]

Swap

Operating system

8192

c1t0d0s1

[1]

/var

Operating system

4096

c1t0d0s3

[1]

/appl

Oracle & TNSQM

30720

c1t0d0s4

[1]

/export/home

Users Home

2048

c1t0d0s5

[1]

/oradata01

Oracle storage 1

34816

c1t1d0s0

[2]

/oradata02

Oracle storage 2

34816

c1t1d0s1

[2]

/oradata03

Oracle storage 3

34816

c1t2d0s0

[3]

/oradata04

Oracle storage 4

34816

c1t2d0s1

[3]

/oralogs1

Oracle Redo log loc 1

10920

c1t3d0s0

[4]

/oralogs2

Oracle Redo log loc 2

10920

c1t3d0s1

[4]

/oratemp

Oracle temp space

10920

c1t1d0s3

[2]

/oradump

Oracle dump space

4096

c1t3d0s7

[4]

/data/cache

TNSQM cache

8192

c1t3d0s3

[4]

/data/download1

Downloaded data 1

8192

c1t3d0s3

[4]

/data/download2

Downloaded data 2

8192

c1t3d0s4

[4]

/data/trace_log1

Trace log

8192

c1t3d0s5

[4]

/data/trace_archive1

Trace Archive

8192

c1t3d0s6

[4]

E
T
T
not for distribution

E
T
T

Software Preparation

1-25

not for distribution

TNSQM Software Packages


TNSQM Packages on XL Download site

E
T
T

CZS0GEN IBM Tivoli Netcool Service Quality Manager V4.1.3


for Solaris (1300 MB)
CZS0EEN IBM Tivoli Netcool Service Quality Manager V4.1.3
for WAS Solaris (628 MB)
CZS0DEN IBM Tivoli Netcool Service Quality Manager V4.1.3
Documentation Multiplatform (34 MB)
NOTE: TNCEM is included in the TNSQM eAssembly
(CZS0GEN)
Total disk (compressed) = 2.0 GB

1-26

not for distribution

TNSQM Service Solutions


C1W3YEN - Tivoli Netcool Service Quality Manager Service Solution Blackberry V5.2.1 (48 MB)
CZ95NEN - Tivoli Netcool Service Quality Manager Module for Blackberry Logs Service V1.1 (99 MB)
CZC7GEN - Tivoli Netcool Service Quality Manager Service Solution DSL Broadband V1.2.2 (2 MB)

E
T
T

CZ3TIEN - Tivoli Netcool Service Quality Manager Service Solution GPRS V1.4 (4 MB)
CZ3TJEN - Tivoli Netcool Service Quality Manager Service Solution GSM V1.4.1 (2 MB)
CZF36EN - Tivoli Netcool Service Quality Manager Module for HSPA PM Service V1.1 (2 MB)
CZ0UPEN - Tivoli Netcool Service Quality Manager Service Solution IPTV V3.2 (1 MB)
C1L5DEN - Tivoli Netcool Service Quality Manager Service Solution IP-VPN V3.2 (1 MB)
CZQT6EN - Tivoli Netcool Service Quality Manager Module for Mobile User Plane Service V1.1 (2 MB)
CZ183EN - Tivoli Netcool Service Quality Manager Service Solution Roaming V1.2.1 (5 MB)
CZ0ULEN - Tivoli Netcool Service Quality Manager Service Solution Short Messaging System V2.3 (3 MB)
CZK64EN - Tivoli Netcool Service Quality Manager Module for UMTS HSPA Trans Service V1.1 (2 MB)
CZQ87EN - Tivoli Netcool Service Quality Manager Module for UMTS Voice PM Service V1.1 (2 MB)
CZQ86EN - Tivoli Netcool Service Quality Manager Module for UMTS Voice Trans Service V1.1 (2 MB)
CZ0UMEN - Tivoli Netcool Service Quality Manager Service Solution Voice Mail V2.2 (2 MB)
CZ0UNEN - Tivoli Netcool Service Quality Manager Service Solution VoIP V2.3 (2 MB)
New / Updated Service Solutions are distributed quarterly
The above list was current as of November, 2010
1-27

not for distribution

TNCEM Service Solutions


CZ95QEN - Tivoli Netcool Customer Experience Manager Module for Evdo Service V1.2 (.5 MB)
CZ95VEN - Tivoli Netcool Customer Experience Manager Module for GPRS Service V1.3 (1 MB)
CZ95UEN - Tivoli Netcool Customer Experience Manager Module for GSM Voice Service V1.2 (1 MB)

E
T
T

CZ95REN - Tivoli Netcool Customer Experience Module for MMS Service V1.2 (.5 MB)
CZIX7EN - Tivoli Netcool Customer Experience Manager Module for Mobile User Plane Service V1.1 (1
MB)
CZ95TEN - Tivoli Netcool Customer Experience Manager Module for Roaming Service V1.2 (2 MB)
CZ95SEN - Tivoli Netcool Customer Experience Manager Module for SMS Service V1.2 (1 MB)
CZC7IEN - Tivoli Netcool Customer Experience Manager Service Solutions iUMTS-HSDPA V1.3 (1 MB)
CZIX6EN - Tivoli Netcool Customer Experience Manager Module for UMTS HSPA Trans V1.1 (1 MB)
CZC7HEN - Tivoli Netcool Customer Experience Manager Service Solutions iUMTS Voice V1.2 (.5 MB)

New / Updated Service Solutions are distributed quarterly


The above list was current as of November, 2010

1-28

not for distribution

Global Object Module Service Solutions


CZ0FEEN - Tivoli Netcool Service Quality Manager Service Solution GOM
V1.4 for Solaris and AIX (.5 MB)

E
T
T

CZ0FEEN - Tivoli Netcool SQM/CEM Global Object Module (GOM) V1.5


Multiplatform (.5 MB)
CZF77EN - Tivoli Netcool SQM/CEM Global Object Module (GOM) V1.6
Multiplatform (.5 MB)
CZQ85EN - Tivoli Netcool SQM/CEM Global Object Module (GOM) V1.7
Multiplatform (.5 MB)

New / Updated Service Solutions are distributed quarterly


The above list was current as of November, 2010
1-29

not for distribution

Oracle Packages
Oracle 10g:
10gr2_db_sol.cpio.gz (873 MB)

E
T
T

Oracle Patch Set 4 for Oracle 10g:

p6810189_10204_Solaris-64.zip (1.2 GB)

Oracle one off patches:

p6396242_10204_Generic
p7306915_10204_SOLARIS64

Total disk (compressed) = 2.0 GB

1-30

not for distribution

LDAP & JMS


SunOne Directory Server (LDAP)

E
T
T

ds.5.2.P4.Solaris.SPARC.full.tar.gz (77 MB)

Sun Java Message Queue System (JMS)


mq3_7ur2-ent-solsparc.zip (38 MB)

1-31

not for distribution

Workshop 1
To begin the hands-on exercises

E
T
T

Download workbook number 1


Follow all the steps to complete the exercises
When complete, continue on to workshop 2

To begin Workshop 2

Download and view the presentation Platform Installation

1-32

not for distribution

E
T
T

Workshop 2
TNSQM/TNCEM
Platform Software Installation

not for distribution

Objectives
Goal install platform software components
Oracle

E
T
T

SunOne Directory Server


Java Message Queue
WebSphere

Approximate time 1:15 minutes

1-34

not for distribution

E
T
T

Installation Platform Package


Approximate Time 10 mins

1-35

not for distribution

Platform Package
Installs custom helper scripts in /var/install/sbin

E
T
T

These are used to install:


Oracle
SunOne
JMS
WebSphere

Platform package found in CZS0GEN IBM Tivoli Netcool


Service Quality Manager v4.1.3 for (1.3 GB)

1-36

not for distribution

Platform Package Installation

Do the following as root

Expand the installation files for the base TNSQM software

Expand the platform tar file:

cd core.solaris64-sparc.install
cp R * /appl
cd /cem.solaris64-sparc.install
cp R * /appl
cd /appl
gunzip ibm-tn-plat-install-PLAT1.0.0.49.tar.gz
tar xvf ibm-tn-plat-install-PLAT1.0.0.49.tar

Run the platform installation script

1-37

E
T
T

cd /appl/INSTALLFILES
tar xvf CZS0GEN.tar

./ibm-tn-plat-install.install now

not for distribution

Server Preparation
Create users, groups

E
T
T

cd /var/install/sbin
./setup_users product serviceassure

Set file permissions

chown oracle:dba /ora*


chown saserver:sa /data/*

1-38

not for distribution

E
T
T

Installation Oracle Product


Approximate Time 30 mins

1-39

not for distribution

Oracle Installation
Use custom helper script in /var/install/sbin

E
T
T

Installs the Oracle software and patches

Oracle base installation package and patch4 package must


be expanded before use

Oracle one-off patches must be expanded before use


Oracle is installed (by default) into /appl/oracle

1-40

not for distribution

Oracle Installation Software Preparation

Perform the following as root

Expand Oracle base software

E
T
T

cd /appl/oracle/base
gzip d 10gr2_db_sol.cpio.gz
cpio idm < 10gr2_db_sol.cpio

Expand Patch Set 4 software

cd /appl/INSTALLFILES/oracle/patch4
unzip p6810189_10204_Solaris-64.zip

Expand the one-off patches

cd /appl/INSTALLFILES/oracle/one-off
unzip p6396242_10204_Generic.zip
unzip p7306915_10204_SOLARIS64.zip

1-41

not for distribution

Oracle Installation

Perform the following as root

Run the Oracle Installation script

cd /var/install/sbin
./oracle10gR2_install
Select the type of install you wish to execute
Enter:
1

E
T
T

Please enter the location of the Oracle 10.0.2.0.1 software


Enter:
/appl/INSTALLFILES/oracle/base
Please enter the install location of the Oracle base [/appl/oracle]
Accept the default
Please enter the value of ORACLE_HOME

[/appl/oracle/product/10.2.0/db_1]
Accept the default
Please enter the value of ORACLE_HOME_NAME [OraDBHome1]
Accept the default

Installation runs

1-42

Enter the full pathname of the local bin directory [/usr/local/bin]


Accept the default

not for distribution

Oracle Installation - cont


Would you like to install the Oracle companion software?
Enter:

Please enter the location of the Oracle 10.0.2.0.4 patch set


Enter:

Installation runs

E
T
T

/appl/INSTALLFILES/oracle/patch4/Disk1

Enter the full pathname of the local bin directory [/usr/local/bin]


Accept the default

The file dbhome already exists in /usr/local/bin. Overwrite it? (y/n)


Enter:

The file oraenv already exists in /usr/local/bin. Overwrite it? (y/n)


Enter:

The file coraenv already exists in /usr/local/bin. Overwrite it? (y/n)


Enter:

Please enter the location of the Oracle 10.0.2.0.4 one-off patches


Enter:

/appl/INSTALLFILES/oracle/one-off

Oracle Installation complete

1-43

not for distribution

E
T
T

Installation Directory Server


Approximate Time 10 mins

1-44

not for distribution

Directory Server Installation


Use custom helper script in /var/install/sbin

E
T
T

Installs the SunOne Directory Server software


Installation package can be left compressed

Package is installed (by default) into /appl/ds

NOTE: the lab server uses a logical link for /appl. The
installation requires the real path to /appl

1-45

not for distribution

Directory Server Installation

Perform the following as root

Run the installation note the directory path on the install command

Enter the full path of the DS package

Accept the default

Please, Enter the LDAP Admin Port: [16762]

Accept the default

Please, Enter the LDAP Root: [dc=comnitel, dc=com]

Accept the default

Please, enter the password for cn=Directory Manager: [Dirmgr01]

Accept the default

Please, enter the password for ldapadm: [Ldapadm01]

1-46

Enter:
/appl/INSTALLFILES/sun/ldap/ds[1].5.2.P4.Solaris.SPARC.full.tar.gz

Please, Enter the LDAP Port: [1389]

E
T
T

cd /var/install/sbin
./ds_install base /storage/appl product serviceassure

Accept the default

Installation runs

not for distribution

E
T
T

Installation Java Message


Queue
Approximate Time 5 mins

1-47

not for distribution

JMS Installation
Use custom helper script in /var/install/sbin

E
T
T

Installs the Java Message Queue software

Installation package can be left compressed


Package is installed (by default) into /appl/

1-48

not for distribution

JMS Installation
Perform the following as root

E
T
T

Run the installation

cd /var/install/sbin
./imq_install product serviceassure
Enter the full path of the IMQ package
Enter:
/appl/INSTALLFILES/sun/jms/mq3_7ur2-entsolsparc.zip

Installation runs

1-49

not for distribution

E
T
T

Installation WebSphere
Approximate Time 10 mins

1-50

not for distribution

WebSphere Installation
Use custom helper script in /var/install/sbin

E
T
T

Installs the WebSphere software

Installation package can be left compressed

Package is installed (by default) into /appl/IBM

Requires CZS0EEN IBM Tivoli Netcool Service Quality Manager


v4.1.3 WAS for Solaris (608 MB)

1-51

not for distribution

WebSphere Installation

Perform the following as root

Unpack the WebSphere installation file

E
T
T

cd /appl/INSTALLFILES
tar xvf INSTALLFILES/CZS0EEN.tar

Move the new WebSphere installation file to /appl

cd /appl
mv INSTALLFILES/WAS_61027_CIP.tar.gz .

Run the installation

cd /var/install/sbin
./was_install base /appl
Enter the full pathname of the WAS package
Enter:
/appl/WAS_61027_CIP.tar.gz
Installation runs

1-52

not for distribution

E
T
T

Summary

1-53

not for distribution

Installation Summary
Platform package installed

E
T
T

Oracle software installed

SunOne Directory Server software installed

Sun Java Message Queue software installed

WebSphere Application Server software installed

1-54

not for distribution

Workshop 2 Exercises
To begin the hands-on exercises

E
T
T

Download workbook number 2


Follow all the steps to complete the workshop exercises
When complete, continue on to workshop 3

To begin Workshop 3

Download and view the presentation TNSQM Installation

1-55

not for distribution

E
T
T

Workshop 3
TNSQM / TNCEM Installation

not for distribution

Objectives
Install TNSQM
Install TNCEM

E
T
T

Validate system

Configure system to forward SNMP traps

Approximate time 3 hours

1-57

not for distribution

E
T
T

Installation TNSQM / TNCEM


Approximate Time 2-3 Hours

1-58

not for distribution

TNSQM Installation
Use custom helper script in /appl
Installs the TNSQM software

E
T
T

Starts Oracle
Creates core Oracle database and tables
Provisions LDAP
Starts WebSphere
Configures WebSphere

Installation runs as a sequential script

Make sure that the process cannot be interrupted


Restarts may not be successful

Package is installed (by default) into /appl/sa

1-59

not for distribution

TNSQM Installation

The installation is performed as the saserver user

Use root to change file ownership of /appl to the saserver user

E
T
T

The installation files were already unpacked previously

Run the installation as saserver

1-60

cd /appl
ksh sqm_install wmcr /appl/sa
This installation script will install the IBM Tivoli Netcool Service Quality
Management software version SQM4.1.3.57.10 on your system.
Do you wish to continue?
Enter:
Y
The license agreement is displayed. Press <space> to get to the end.
Do you agree with the terms of this license?
Enter:
Y
What Type of Service Quality Manager System are you installing?
Enter:
1
(All Inclusive)

not for distribution

TNSQM Installation cont.


Business Objects Version
Business Objects is not being used, reply with none
Please enter the installed Business Objects version
(6.5/XI/none): []
---->
Enter :
none

E
T
T

Service Quality Manager Core

The following is a list of the default Service Quality Manager


Variables:

1-61

NOTE: review the list and adjust any that are required.
If changes are required, enter: N
The list of parameters appear in a vi window
Adjust as necessary
Enter:
:w!
(save changes)
Enter:
:q!
(exit vi)
Is the configuration OK (y[es]/n[no]/s[ee the configuration])?
Enter:
y
not for distribution

TNSQM Installation cont.

Configure Directory Server


Do you want to install Directory Server Configuration ? [Yes]

E
T
T

Accept the default

The following is a list of the default Service Quality Manager Variables :


1. LDAPROOT=dc=comnitel,dc=com

To accept these values enter 'Y' else enter 'N' to modify the values (Y/N)
Enter:
Y
Please enter the password for 'cn=Directory Manager', the
Directory Server User [Dirmgr01]:
Accept the default
Please enter the password for 'system', the Directory Server User
[Saserver01]:
Accept the default
Please enter the password for 'useradm', the Directory Server User
[Useradm01]:
Accept the default
Please enter the password for 'swvadm', the Directory Server User
[Swvadm01]:
Accept the default

1-62

not for distribution

TNSQM Installation cont.


Configure Message Queue
Do you want to install Sun Java System Message Queue

E
T
T

Configuration ? [Yes]
Accept the default
The following is a list of the default Service Quality Manager
Variables :
1. BROKER1HOST=tsedev20
2. BROKER1PORT=7681
3. BROKER2HOST=tsedev20
4. BROKER2PORT=7680
5. OMPORT=9008

To accept these values enter 'Y' else enter 'N' to modify the values
(Y/N)
Enter:
Y

1-63

not for distribution

TNSQM Installation cont.


Configure Socks Proxy
The following is a list of the default Service Quality Manager
Variables :

E
T
T

1. SERVER_IP_ADDRESS=192.168.1.225
2. SHORT_IP_ADDRESS=192.168.1

To accept these values enter 'Y' else enter 'N' to modify the values
(Y/N)
Enter:
Y

The following is a list of the default Service Quality


Manager Variables :
1. SHORT_IP_ADDRESS=192.168.1

To accept these values enter 'Y' else enter 'N' to modify the values
(Y/N)
Enter:
Y
1-64

not for distribution

TNSQM Installation cont.


Configure Web Server
The following is a list of the default Service Quality Manager
Variables :

E
T
T

1. TOMCAT_SERVER_PORT=8093
2. HTTPS_PORT=8094
3. WSPORT=9060
4. WSHOST=tsedev20.tivlab.austin.ibm.com

To accept these values enter 'Y' else enter 'N' to modify the values
(Y/N)
Enter:
Y

Configure WebSphere

Please enter the LDAP swvadm password: [Swvadm01]


Accept the default

NOTE: this step will run for several minutes (could be 15-20 minutes or longer
depending upon server speed), and the WebSphere application components
will be stopped and started multiple times.
1-65

not for distribution

TNSQM Installation cont.


Build SQM Database - sadb
Would you like to perform task SA_DB_INSTALL ? [yes/no] >
Enter:

yes

E
T
T

Please, Enter the required Database Type (sadb/repos):


---->sadb
Accept the default

Please, Enter your Database SID (8 character maximum):


---->sadb
Accept the default

Please, Enter your Database Size


(sml(10G)/med(20G)/lge(50G)/xlg(100G)/xxl(200G)/custom):
---->lge
Change the default value to sml

Please, Enter the sys user password:


---->Sysdb01
Accept the default

Please, Enter the system user password:


---->Sysdb01
Accept the default

NOTE: this step may take 1 hour to complete.


1-66

not for distribution

TNSQM Installation cont.


Build SQM Database - repos
Would you like to perform task REP_DB_INSTALL ? [yes/no] >
Enter:
no
NOTE: Only required if using Business Objects. The workshop
does NOT use Business Objects

E
T
T

Build Core Database Schema

Would you like to perform task CORE_SCHEMA_INSTALL ? [yes/no]


>
Enter:
yes

1-67

not for distribution

TNSQM Installation cont.

Create CRON tasks for log file maintenance


Would you like to perform task CORE_CRON_INSTALL ? [yes/no] >
Enter:
yes
What Type of Service Quality Manager System Are you Installing ?
Enter:
1
(All Inclusive)
Please enter the location of the ORACLE_HOME Directory
[/appl/oracle/product/10.2.0/db_1]:
Accept the default
Please enter the location of the sadb Database Archive Directory [/oradump]:
Accept the default
Please enter the location of the repos Database Archive Directory [/oradump]:
Accept the default
Please enter the location of the IMQ Software Directory [/]:

E
T
T

Accept the default

Please enter the location of the Directory Server Software Directory [/appl/ds]:
Accept the default
Please enter the location of the ServerAssure Log Directory [/appl/sa/logs]:
Accept the default
Please enter the location of the ServerAssure Archive Logs Directory
[/data/trace_archive1]:
Accept the default

1-68

not for distribution

TNSQM Installation cont.

TNCEM Installation
Would you like to perform task CEM_INSTALL? [yes/no] >
Enter:

E
T
T
yes

What Type of Service Quality Manager System Are you Installing ?


Enter:

(All Inclusive)

Please enter the location of the Service Quality Manager Software


packages [/appl]:
Accept the default
The following is a list of the default Service Quality Manager Variables :
1. MAIL_USERNAME=saserver
2. MAIL_PASSWORD=Saserver01
3. SADB_USERNAME=saserver
4. SADB_PASSWORD=Saserver01

To accept these values enter 'Y' else enter 'N' to modify the values (Y/N)
Enter:
Y

1-69

not for distribution

TNSQM Installation cont.

CEM Installation (cont.)


The following is a list of the default Service Quality Manager Variables :

E
T
T

1. OMPORT=9008

To accept these values enter 'Y' else enter 'N' to modify the values (Y/N)
Enter:
Y
Please enter the LDAP swvadm password: [Swvadm01]
Accept the default
Please enter the LDAP Directory Manager password: [Dirmgr01]
Accept the default
NOTE: this step could take 15-20 minutes to complete. The WebSphere application will
stopped and started multiple times.

Encode Passwords
Would you like to perform task ENCODE_PASSWORDS ? [yes/no] >
Enter:

1-70

yes

Installation is complete!!

not for distribution

TNSQM Installation cont.


Verify that all core services are online
svcs | grep serviceassure
online
19:34:22 svc:/application/serviceassure/ldap-sa:sa
online
19:49:26 svc:/application/serviceassure/imq2-sa:sa
online
19:49:26 svc:/application/serviceassure/imq1-sa:sa
online
12:16:47 svc:/application/serviceassure/traprouter-sa:sa
online
15:14:10 svc:/application/serviceassure/database-sa:global
online
15:56:24 svc:/application/serviceassure/socks-sa:sa
online
15:56:33 svc:/application/serviceassure/sapmon-sa:sa
online
15:56:39 svc:/application/serviceassure/sapmgr-sa:sa
online
15:56:39 svc:/application/serviceassure/wp-sa:sa

E
T
T

1-71

not for distribution

Post Installation
Enable Time Zone support

E
T
T

Become the saserver user


su saserver
Edit the time zone property file
cd /appl/sa/conf/adapter/
vi timezone.properties
Set timezone.enabled to true:
# enable/disable global timezone support
com.comnitel.timezone.enabled=true

1-72

not for distribution

Post Installation Platform Stop


Stop platform processes (as root) if necessary
svcadm disable sapmgr-sa
svcadm disable sapmon-sa
svcadm disable traprouter-sa
svcadm disable imq2-sa
svcadm disable imq1-sa
svcadm disable wp-sa
svcadm disable ldap-sa
svcadm disable database-sa

E
T
T

1-74

not for distribution

Post Installation Platform Start


Start platform processes (as root) if necessary
svcadm enable database-sa
svcadm enable ldap-sa
svcadm enable wp-sa
svcadm enable imq1-sa
svcadm enable imq2-sa
svcadm enable traprouter-sa
svcadm enable sapmon-sa
svcadm enable sapmgr-sa

E
T
T

1-75

not for distribution

Post Installation System Verification


Start the TNSQM components (as saserver)
sap start domain
sap start client
sap start cem

E
T
T

NOTE: Leave the monitoring components disabled until


after the installation of the Service Solutions. Once one or
more Service Solutions are installed, there will be additional
adapter components to start

1-76

not for distribution

Summary
TNSQM is installed
TNCEM is installed

E
T
T

Oracle is configured for TNSQM, TNCEM and is running


database-sa

SunOne Directory Server is configured for TNSQM, TNCEM and is


running
ldap-sa

Java Message Queue is configured for TNSQM, TNCEM and is


running
imq1-sa
imq2-sa

WebSpshere is configured for TNSQM, TNCEM and is running


wp-sa

1-78

not for distribution

Workshop 3
To begin the hands-on exercises

E
T
T

Download workbook number 3


Follow all the steps to complete the workshop exercises
When complete, continue on to workshop 4

To begin Workshop 4

Download and view the presentation Service Solution Overview

1-79

not for distribution

E
T
T

Workshops 4 & 5
Service Solutions

not for distribution

Objectives
Workshop 4
Install TNSQM Module for IP VPN Services
Install and configure synthetic data generator

Workshop 5

E
T
T

Install TNCEM Module for UMTS Voice Services


Install and configure synthetic data generator

Service Solution Overview

1-81

Describe components of a Service Solution


Describe the Global Object Model
Describe differences in Service Solution packaging
Describe options for data generation

not for distribution

TNSQM/CEM Service Solution Overview


What is a Service Solution?
It is an installable component designed to enable service providers to monitor
and report on the service quality delivered to their end customers for a specific
service offering (e.g. VOIP, Blackberry email, IP-VPN).

VOIP
IP-VPN

E
T
T

Tivoli Netcool Service Quality Manager (TNSQM)

SLA/Service Reporting

BlackBerry

IBM Service Solution


Library

SMS
Voice Mail
GPRS

1-82

IPTV

IP-VPN

Blackberry

VOIP

SLA/Service Monitoring

IPTV

Historical Trending

Root Cause Analysis


Data Persistence

Service Solutions can easily be added over time to deliver


immediate value across the service provider organization

not for distribution

Service Solutions
Strategy
Put in place a framework to allow the development of service models (and
associated components) which have been designed in a generic manner to
enable high volume sales as pre-packaged solutions, delivering immediate
business value.

Objectives

E
T
T

Easy to install
Immediate Value to end customer
Standalone and independent Service Solution Components

Bundle Service Solutions into manageable, modular entities

Models (SLA, KQI, Adapter)


Reports
Mediation*
Documentation

Vendor-Neutral Models Vendor-Specific Mediation

1-83

not for distribution

Service Solution Components


User
Documentation

Reports

E
T
T
SLA (s)

Scope of
Service Solution

Data Sheet

SLAT (s)

Combiner

Unchanged for
each deployment

KPI & KQI


DB Tables

Adapter (s)

CSV input format,


to feed adapter layer

Vendor specific
mapping done
Via project deployment
Mediation done on
A project basis
1-84

Vendor neutral data records


presented to adapter layer

Vendor-Specific
Agent (1)

Vendor 1
Raw Data

Vendor-Specific
Agent (2)

Vendor 2
Raw Data

not for distribution

Vendor-Specific
Agent (m)

Vendor m
Raw Data

Vendor Specific Mediation


transforms raw data into
a predefined format.

Service Solution Evolution


Service Solutions have been evolving over time

E
T
T

Elements of evolution

Global Object Model (GOM) Support


Packaging
Documentation
Features and functions

This results in significant differences between various Service


Solutions
Older ones may or may not support the GOM
Older ones may or may not have complete documentation

Service Solutions will eventually evolve to the same format and


content

1-85

not for distribution

Global Object Model


The Global Object Model (GOM) defines Resource Types that are generic to
one or more Service Solution

E
T
T
1-86

not for distribution

Global Object Model - cont


There is one Global GOM that contains Resource Types for all
Service Solutions

E
T
T

There are typically Service Solution specific GOMs, that provide


Resource Types unique to each Service Solution
The contents of the GOM have been evolving over time
Version 1.5 was recently released

Not all Service Solutions are currently compatible with the latest
GOM
Overlapping Resource Types

Release Notes for each Service Solution indicate if the GOM


is required and which version is supported

1-87

not for distribution

Packaging (pre-GOM v1.3)


Service Solutions are distributed as a single tar file, e.g., IP
VPN v3.1
C1F5SEN.tar

E
T
T

When expanded, it produces the following:


Generic Installation Guide
Overview Guide
Release Notes
ibm-tn-sqm-vpn-gom-3.1.0.2.tar.gz
ibm-tn-sqm-vpn-ipvpn-pm-3.1.0.2.tar.gz
ibm-tn-sqm-vpn-ipvpn-pm-demo-3.1.0.2.tar.gz

Expanding the pm file produces the following:


ibm-tn-sqm-vpn-ipvpn-pm.install
ibm-tn-sqm-vpn-ipvpn-pm.license
ibm-tn-sqm-vpn-ipvpn-pm.remove
ibm-tn-sqm-vpn-ipvpn-pm.sw

1-88

- a script
- text license file
- a script

- tar file

not for distribution

Packaging cont.
Expanding the sw file produces the following:
sa/admin
oracle/schema/vpn_ipvpn_pm_3.1
o nc
Tables
o pm

E
T
T

- sql definitions for Network Configuration


- sql definitions for KPI table, views, etc

provision/install
o service
TNSQM
o technology

- Business Objects report definitions for


- KQI and Resource Type definitions

report/bo/reports/vpn/ipvpn/pm
o logos
o reports
o universes

- These directories contain


- various files that must be copied
- to the BO server

smp/vpn/ipvpn/pm
o loader
o report.zip

- property file and csv definition


- more BO stuff

vpn_ipvpn_pm/install/environment
o vpn_ipvpn_pm_env
1-89

- properties for adapter


not for distribution

Packaging cont.
The initial install step performs three basic functions

Copies files to various directories


Configures adapter property file
Adds an entry to /etc/software
Basically places files in various directories to be used in the remainder
of the install process

E
T
T

The rest of the installation is completed manually


Provisioning
Database table creation
Adapter installation

1-90

not for distribution

New Packaging (GOM v1.3 +)


Service Solutions are distributed as a single tar file, e.g., IP
VPN v3.2
C1L5DEN.tar

E
T
T

When expanded, it produces the following:


Generic Installation Guide
Overview Guide
Release Notes
ibm-tn-sqm-ip_vpn-gom-3.2.0.4.tar.gz
ibm-tn-sqm-ip_vpn-pm-3.2.0.4.tar.gz
ip_vpn-pm-test-3.2.zip

Expanding the pm file produces the following:


ibm-tn-sqm-ip_vpn-pm.install
ibm-tn-sqm-ip_vpn-pm.license
ibm-tn-sqm-ip_vpn-pm.remove
ibm-tn-sqm-ip_vpn-pm.sw

1-91

- a script
- text license file
- a script
- tar file

not for distribution

New Packaging cont.


Expanding the sw file produces the following:
sa/packages/ip_vpn_pm_3.2
admin
o deploy

E
T
T

adapter.properties
o oracle/schema/ip_vpn_pm

sql definitions for KPI table, views, etc


o provision

Various xml files for reports, resources,


KQIs, etc
bin
o adapter.env
conf
o processes

processes.properties
o adapter
1-92

data
not for distribution
collector properties

New Packaging cont.


The initial install step performs three basic functions

Copies files to various directories


Configures adapter property file
Adds an entry to /etc/software
Basically places files in various directories to be used in the remainder of
the install process

E
T
T

The installation process is different than it was under GOM v1.2


Provisioning
package_mgmt I <solution package>
Database table creation
/appl/sa/packages/adp_deploy.xml do-schema
Adapter installation
cd /appl/sa/packages
wmc_ant -Dsa.package=<service solution>_<datasource>_<model
version> -f adp_deploy.xml do-deploy

1-93

not for distribution

Documentation
Service Solutions contain documentation
Generic Installation Guide
Installation instructions that are generic to all Service Solutions
Overview Guide
Description of the functional aspects of the Service Solution
Release Notes

E
T
T

New Service Solutions also contain the Interface Control Guide


Detailed description of input requirements

Eventually, all Service Solutions will have the ICG

1-94

not for distribution

Features and Functions


TNSQM v4.1 introduced the Visual Service Model feature

E
T
T

The newer Service Solutions come with a pre-configured


Visual Service Model

Blackberry v5.2
DSL Broadband v1.1
GPRS v1.3
GSM v1.2
IP VPN v3.1, v3.2
Roaming v1.1, v1.2

others

Eventually, all Service Solutions will come that way

1-95

not for distribution

Options for Data Generation


Bundled demo capability
Comes with each Service Solution
Requires additional installation step(s)
Data generated every 15 minutes DOESNT vary

E
T
T

IP VPN Demo Package

Not bundled with the Service Solution


Generates data at 5 minutes granularity
Data varies by time good for showing SLA transitions

CEM Simulator

Generates user and group definitions


Generates data every 15 minutes
Data contains variations

Create custom csv file

Content has to match requirements of Service Solution


Possible, but not likely

1-96

not for distribution

IP VPN Demo
Package contained in one tar file
Expand in home directory for saserver

E
T
T

Requires custom provision step to create required Resources


Script MakeCSIPVPNfiles.sh

Generates individual csv files for every 5 minutes of the current day
Can be run via crontab for continuous data generation

Script loadIPVPNdata.sh

Copies one csv file every 5 minutes to adapter input directory


Processed normally by the standard adapter
Requires crontab entry to guarantee success

1-97

not for distribution

CEM Simulator
Requires a separate installation file that is not included with the system
Requires a separate installation step and provision step

E
T
T

Run the install


Run topology_gen to create custom provisioning file
Run provision step

Run the data_gen step

New data is generated every 15 minutes


This data is moved to the adapter input directories (Gb and Gn)
Processed normally by the standard adapters

Produces a complete CEM configuration

1-99

Users
Groups
Services
Devices

not for distribution

Workshop Lab Exercise 4 & 5


To begin the hands-on exercises

E
T
T

There are two lab exercises for Service Solution installs


Lab 4 IP VPN Service Solution (for TNSQM)
Lab 5 UMTS Voice Service Solution (for TNCEM)

Download lab workbooks numbers 4 and 5


Follow all the steps to complete both lab exercises
When complete, continue on to workshop 6

To begin Workshop 6

Download and view the presentation Client Overview

1100

not for distribution

E
T
T
Workshop 6
Client Overview

not for distribution

Objectives

Configure Socks Proxy


Download & install TNSQM thick client
Configure student workstation thick client for proxy use
Configure student workstation browser for proxy use
Create new TNSQM user
Validate client access to TNSQM and CEM

E
T
T

Approximate time 45 minutes

1102

not for distribution

Client Types
TNSQM thick Client
Software installed on user workstations
TNSQM administrative interface

E
T
T

User Administration Browser-based


Web Portal Browser-based

TNSQM SLA WebView


Read-Only access to TNSQM SLA Monitoring

Cellular CEM
Primary CEM interface for investigating user issues
SLO Management
Interface for creating CEM Service Level Objectives (SLOs)
SLO Monitoring
Interface for monitoring state of SLOs
Access to all user functions is controlled by individual LDAP roles

1103

not for distribution

TNSQM thick Client Installation


Typical Production Install

E
T
T

Open a browser and connect to URL


http://<tnsqm-server>:8092/webstart
Select the link to download and install client

Lab Install

Lab servers are situated behind a firewall


Network Address Translation (NAT) is used
Restricted port forwarding
Necessitates modified installation process
Download the client software manually
Run the install manually

1104

not for distribution

Socks Proxy Configuration


Socks Proxy required for client access to Lab servers
Compensates for Network Address Translation (NAT)
Compensates for restricted port forwarding
Proxies all access thru one user-defined port

E
T
T

Configuration Steps

TNSQM Server
Change default port from 1080 to 3389
o Lab firewall is configured to allow this port number
Change client pass

from: 192.168.35.0/24 port 1-65535 to: 192.168.35.0/24


To
from: 9.0.0.0/8 port 1-65535 to: 192.168.35.0/24

Restart Socks Proxy

1105

not for distribution

Student Workstation Configuration


The default browser on the student workstation must be
configured to use a proxy server
Details listed in Workshop 6

E
T
T

TNSQM thick Client on the student workstation must be


configured to use the socks proxy
Details listed in Workshop 6

1106

not for distribution

Workshop Lab Exercise 6


To begin the hands-on exercises

E
T
T

Download lab workbook number 6


Follow all the steps to complete the lab exercise
When complete, continue on to workshop 7

To begin Workshop 7

Download and view the presentation How to Demo TNSQM

1107

not for distribution

E
T
T

Workshops 7 & 8
How to demo TNSQM / TNCEM

not for distribution

Demo Resources
Tivoli Integrated Demo Environment-TIDE-AG
http://w3103.ibm.com/software/xl/portal/viewcontent?type=doc&srcID=T9&docID=S405499Y99
141E74

E
T
T

TNCEM v4.1.2
CEM w/ GPRS & UMTS
3 scenarios covering: Congestion, Roaming, and Tracking Handsets
Storyboard documents available
TNSQM v4.1
Blackberry & VoIP demos
Storyboard documents available
TBSM Integration
Integration w/ Business Objects

VMWare Images

Work-in-Progress
Check Tivoli demo library for current status
http://depot.tivlab.raleigh.ibm.com/

1109

not for distribution

Demo Startup / Verification - Troubleshooting


The vast majority of issues with components not starting are
due to TIME not waiting long enough for components to
activate

E
T
T

It takes a fair amount of time for the components to start


completely
Even though TIDE says the demo is ready, it may take
additional time for the TNSQM / TNCEM components to
activate completely
Make sure to schedule the demo to start well before its needed
Note: for the TNCEM demo it is recommended to schedule the demo at
least one hour prior to when its needed

1110

not for distribution

Types of Demos
Two basic categories of demos
Static Demo

E
T
T

Show feature and function based upon static (old) data


Very good for demonstrating diagnostic capabilities
TIDE-AG demos are both static

Active Demo

1111

Synthetic data being processed periodically


Good for showing workflow in a semi-realistic manner
Able to demonstrate customization and results
This SPVC provides active demos

not for distribution

Lab 7 TNSQM Demo Exercises


Create SLA Template

E
T
T

Create Custom SLA

Monitor SLA State


TNSQM thick Client
SLA WebView
Create Custom KQI

Monitor custom KQI using KQI Analyzer

NOTE: make sure the VPN simulated data is being generated


and processed before starting this workshop

1112

not for distribution

Lab 8 CEM Demo Exercises


Basic CEM User Interface Functions

E
T
T

Simulated Troubleshooting of a specific Customer


Evaluating a Group of Customers

Configuration of a custom Service Level Objective


(SLO)
Monitoring the State of that SLO

NOTE: make sure the CEM simulated data is being


generated and processed before starting this workshop

1113

not for distribution

Workshop Lab Exercise 7 & 8


To begin the hands-on exercises

E
T
T

There are two lab exercises for the How to Demo workshop
Lab 7 TNSQM Demo Exercises
Lab 8 TNCEM Demo Exercises

Download lab workbooks numbers 7 and 8


Follow all the steps to complete both lab exercises

To begin the next video

Download and view the presentation Troubleshooting

1114

not for distribution

E
T
T

Troubleshooting Techniques

not for distribution

Platform Products
Platform products - Oracle, LDAP, JMS, WebSphere
Installation Issues

E
T
T

Messages displayed on console


Individual log files for each product install

Startup Issues

svcs | grep assure shows current status


If offline or maintenance

svcs x | grep assure


Check displayed log file for issues
If maintenance
svcadm clear xxxx-sa

1116

not for distribution

TNSQM Components
Installation Issues

E
T
T

Messages displayed on console


Individual log files for each component
/appl/sa/logs/<component directory>/

Startup Issues

sap start <component>


sap disp
Failed or Restarting
Check component log for issues

1117

not for distribution

Service Solutions
Use KQI Analyzer feature to check for KQI data in TNSQM

E
T
T

NO Data in TNSQM
Is the loader running?
sap disp adapters

Any issues with the running loader?


cd /appl/sa/logs/<adapter name>
more <adapter name>-server.log

Is the source data getting to the loader?


cd /appl/sa/var/adapater/<adapter name>
C20080917.1325-20080917.1330_demo.csv

Is the data being processed by the loader?

C20080917.1325-20080917.1330_demo.csv.20080917133500.processed

1118

not for distribution

TNSQM thick Client Issues Unable to discover server


Verify server name

E
T
T

Verify server name resolves


to correct IP address on the
local workstation

Is the TNSQM server located


behind a firewall?
Ports could be blocked by
firewall
May need to use Socks Proxy

1119

not for distribution

TNSQM thick Client Issues Additional Debug data


Unexplained client errors may
require additional debug

E
T
T

Open Webstart property settings


Start => Programs => IBM Tivoli
Netcool => Service Quality
Manager => Utilities => Service
Quality Manager
Enable Trace Management
Set Trace Level to DEBUG4

Review output in trace log

C:\Program Files\IBM Tivoli


Netcool\Service Quality
Manager\trace\sadesktop
sadesktop-server.log

1120

not for distribution

TNSQM thick Client Issues Clear Client Cache


Unexplained client errors
may be caused by cache
issues

E
T
T

Open Cache Browser

Start => Programs => IBM


Tivoli Netcool => Service
Quality Manager => Utilities
=> Cache Browser
Highlight the entry for the
server
Select Purge

1121

not for distribution

part_admin Utility
CLI utility to report on various aspects of Oracle Partition usage
List all Tablespaces and their current used/free space

E
T
T

part_admin listspace

TABLESPACE NAME
TOTAL SIZE(MB)
<10% FREE % FREE MB USED MB
===========================================================================
SA_ADMIN_DATA
SA_ADMIN_INDX
SA_APP_MED_DATA
SA_APP_MED_INDX
SA_APP_SML_DATA
SA_APP_SML_INDX
SA_CEM_TML_DATA
SA_CEM_TML_INDX
SA_COMMON_MED_DATA
SA_COMMON_MED_INDX

1122

128

82.8

106

22

128

93.8

120

512

84

430

82

512

75

384

128

128

89.1

114

14

128

92.2

118

10

50

99.9

49.9

.1

10

99.4

9.9

.1

256

94.9

243

13

256

94.9

243

13

not for distribution

Oracle Startup Issues


Oracle fails to start
svcadm enable database-sa
svcs | grep assure
offline
. svc:/application/serviceassure/database-sa:global

Places to look:

E
T
T

/appl/oracle/product/10.2.0/db_1/startup.log
/appl/oracle/admin/sadb/bdump/alert_sadb.log

Attempt to start manually

1123

su oracle
sqlplus / as sysdba
startup
Error messages will be displayed on screen

not for distribution

Oracle Enterprise Manager


Start OEM run as oracle user

E
T
T

$ORACLE_HOME/bin/emctl start dbconsole

Stop OEM run as oracle user

$ORACLE_HOME/bin/emctl stop dbconsole

Status OEM run as oracle user

$ORACLE_HOME/bin/emctl status dbconsole

Access OEM

http://<hostname>:1158/em
Login as saserver

1124

not for distribution

OEM Performance TAB

E
T
T
1125

not for distribution

OEM Administration TAB

E
T
T
1126

not for distribution

OEM Maintenance TAB

E
T
T
1127

not for distribution

E
T
T

Workshop 9
TBSM / TNSQM Integration

not for distribution

Workshop 9 TBSM / TNSQM Integration


Goal install and configure the TBSM / TNSQM Integration
Configure OMNIbus Event Integration

E
T
T

Configure TBSM Service Auto-Population

Configure TNSQM Metrics in TBSM Service Trees


Configure Single Sign On (SSO)

Configure TNSQM KQI Charting in TBSM Dashboards


Configure Launch-in-Context

Approximate time 8 hours

1129

not for distribution

TBSM TNSQM / TNCEM Integration Overview


Event Based Integration

SNMP traps produced by TNSQM and TNCEM


MTTrapd Probe produces OMNIbus events
OMNIbus events feed TBSM auto-population rules
TBSM Service Instances produced dynamically

Data Integration

E
T
T

TBSM Data Fetcher retrieves metrics from TNSQM / TNCEM database


Metrics published in TBSM Service Trees
KQI Charting tools embed TNSQM /TNCEM graphs in TBSM dashboards

Tool Integration

Single Sign On (SSO) between Tivoli Integrated Portal (TIP) and TNSQM Web
Portal
Common LDAP repository
Launch-in-Context between TIP and TNSQM Web Portal

Documentation
Tivoli Netcool Service Quality Managemet Center Integration Guide

1130

not for distribution

Event Based Integration


SNMP traps produced by TNSQM and TNCEM

E
T
T

TNSQM Service Level Agreement (SLA) conditions


TNSQM Service Level Objective (SLO) conditions
TNCEM SLO conditions

MTTrapd Probe produces OMNIbus events

Custom rules files bundled with TNSQM and TNCEM


Sql files provided to create custom OMNIbus event columns

TBSM Service Instances produced dynamically


TBSM Service Templates
TBSM auto-population rules

1131

not for distribution

TBSM Integration Details:


Event Based Integration
Manage SQM
(IP-VPN SLA,
SLA conformance reports etc)

Visualize SQM violations

Visualise SQM service hierarchy


and violation status

E
T
T

TBSM GUI

Active Event List

OMNIbus

IBM Service Solution


Library

TNSQM

SLA
Violation
Alarms

VOIP
IP-VPN

Alarms will contain:

IPTV

VOIP

SMS

IP-VPN

Customer

Blackberry

Service

Service Element
KQI

Voice Mail

Resource

GPRS

1132

not for distribution

AutoPopulation
rule

TBSM

Data Integration
TBSM Data Fetcher retrieves metrics from TNSQM /
TNCEM database

E
T
T

Metrics come directly from the database (Oracle)


Specific metrics are configurable
Frequency of retrieval configurable

Metrics published in TBSM Service Trees

Service trees generated by event-based integration (service


auto-population)
Extend the contents by adding metrics retrieved by data fetchers
Enhances the value of the service tree

KQI Charting tools embed TNSQM /TNCEM graphs in


TBSM dashboards
Charting tools bundled with TNSQM / TNCEM
Copy them to TBSM
Configure parameters to determine content of graphs
1133

not for distribution

TBSM Customized Service Tree

E
T
T

Service Tree generated by event-based integration


Technical Enablement
VoiceVPN
o Enterprise
ibm

Additional metrics produced by data fetchers


Jitter
Latency
Packet Loss
1134

not for distribution

Displaying KQI History Charts in TBSM SQM SLA


Multiple
charts

Clause
Thresholds

KQI Value

E
T
T

KQI Weight

Click anywhere on chart


to launch associated URL
(e.g. default Business
Objects report)

Clause / Resource details

1135

not for distribution

Tool Integration
Single Sign On (SSO) between Tivoli Integrated Portal (TIP) and
TNSQM Web Portal

E
T
T

TIP is based on WebSphere


TNSQM Web Portal is based on WebSphere
Enable SSO in each copy of WebSphere

Common LDAP Repository

TNSQM / TNCEM use LDAP for user authentication


Solaris SunOne Directory Server
AIX Tivoli Directory Server

TNSQM Web Portal already configured to use LDAP


Configure TIP to use TNSQM LDAP

SSO enables launch-in-context between TIP and TNSQM Web


Portal
Multiple launch points available
TBSM Service Instance
TBSM Service Tree
WebGUI event list

SSO & common LDAP eliminates need for secondary authentication


TNSQM/TNCEM Web Portal opens in context
1136

not for distribution

TBSM / TNSQM Launch-In-Context

SLA Violation Event

E
T
T

Tool launch from WebGUI event list


TNSQM Web Portal opens

SSO & common LDAP eliminate


secondary authentication
Web Portal opens to SLA Monitor
view based upon context passed
1137

not for distribution

TBSM Lab Configuration


Required products already installed
TBSM v4.2.1 with FixPack 2

E
T
T

OMNIbus v7.3
WebGUI v7.3

MTTrapd Probe

Netcool Knowledge Library (NCKL) v3.0

1138

not for distribution

Worshop Overview
MTTrapd Probe Configuration

E
T
T

Auto-populating TBSM Service Instances based upon TNSQM


SLA Events
Integrating TNSQM metrics into TBSM Service Trees
Single Sign-On (SSO) Configuration
Launching KQI History Charts

Launch-in-Context Configuration

1139

not for distribution

Workshop Lab Exercise 9


To begin the hands-on exercises

E
T
T

Download lab workbook number 9


Follow all the steps to complete the lab exercise

To begin Workshop 10

Download and view the presentation TNSQM Custom Reporting


Using BIRT

1140

not for distribution

E
T
T

Workshop 10
TNSQM Custom Reporting using BIRT

not for distribution

Workshop 10 Custom Reporting Using BIRT


Goal install and configure BIRT and produce a custom report
Install BIRT Designer on student workstation

E
T
T

Configure BIRT Designer for access to TNSQM server


Create custom report

Approximate time 45-60 minutes

1142

not for distribution

Agenda
Data Aggregation Overview

E
T
T

Data Retention Overview


TNSQM Oracle Tables
BIRT Installation

BIRT Report Generation

1143

not for distribution

Why Data Aggregation?


Performance management data is collected continuously 24x7
Data is collected at fairly low granularity typically every 5-15
minutes

E
T
T

Data is typically collected from many devices

Data is typically collected from many elements within these


devices
Device-specific memory, CPU, buffers
Interfaces
Virtual Interfaces ATM PVCs, Frame Relay DLCIs

The volume of data collected every day can be considerable

1144

not for distribution

Collection Example
Assume 50 routers with 20 interfaces each
50 x 20 = 1000 interfaces

E
T
T

Assume data is collected for each interface once every 10 minutes


1000 data samples every 10 minutes
6000 data samples every hour (6 x 1000)
144,000 data samples every day (24 x 6000)
1,008,000 data samples every week (7 x 144,000)
4,320,000 data samples every month (30 x 144,000)
51,840,000 data samples every year (12 x 4,320,000)

Service Providers will typically have many hundred thousand interfaces


Assume 30 times the above example
1,555,200,000 data samples per year

Over 1 BILLION data samples per year !!

1145

not for distribution

Why care? Storage is cheap!!


More data means more administration
Longer to backup
Longer to restore

E
T
T

More data means more database overhead


More time required for inserts / deletes

More data means that reports run longer!

Something must be done to manage the volume of data


effectively
Data Aggregation
Data Retention

1146

not for distribution

What is Data Aggregation?


Technique for managing large volumes of data
Utilizes statistics to summarize data

E
T
T

MIN, MAX, AVG, SUM, COUNT

Statistical summaries reduce the volume of data


TNSQM maintains 5 levels of data granularity

1147

RAW data as initially collected


HOUR summarized data for each hour of each day
DAY summarized data for 1 calendar day
WEEK summarized data for 1 calendar week
MONTH summarized data for 1 calendar month

not for distribution

How does it work?


Assume 50 routers with 20 interfaces each
50 x 20 = 1000 interfaces

Assume data is collected for each interface once every 10 minutes


1000 data samples every 10 minutes
6000 data samples every hour (6 x 1000)
144,000 data samples every day (24 x 6000) SAME !!

E
T
T

Compute summaries by HOUR

144,000 RAW data samples => 24000 summary records per day (24 x 1000)
One record for each interface per hour with MIN, MAX, AVG, SUM, COUNT

Compute summaries by calendar DAY

144,000 RAW data samples => 1000 summary records


One record for each interface per day with MIN, MAX, AVG, SUM, COUNT

Compute summaries by calendar WEEK

1,008,000 data samples => 1000 summary records


One record for each interface per week with MIN, MAX, AVG, SUM, COUNT

Compute summaries by calendar MONTH

4,320,000 data samples => 1000 summary records


One record for each interface per month with MIN, MAX, AVG, SUM, COUNT

1148

not for distribution

With and Without Aggregation


Data Granularity

With Aggregation

RAW (every 10 mins) 1,000

1,000

Hour

6,000 / hour

1,000 / hour

144,000 / day

1,000 / day

1,008,000 /week

1,000 / week

4,320,000 / month

1,000 / month

51,840,000 / year

12,000 (12 x 1000) /


year

Day
Week
Month
Year

1149

E
T
T
Without Aggregation

not for distribution

Data Retention
Dont need to keep data forever !

E
T
T

Save data at each aggregation level

62 calendar days of RAW level *


62 calendar days of HOUR level *
104 calendar weeks of DAY level *
104 calendar weeks of WEEK level *
36 calendar months of MONTH level *

Data that exceeds the calendar retention AGES out


deleted !
The volume of data is automatically managed to a
predictable limit
* TNSQM default retention levels
1150

not for distribution

Physical Implementation - Partitions


Individual database partitions for each level of granularity and each
calendar interval

E
T
T

RAW - day 1, day 2, day 3,


HOUR day 1, day 2, day 3,
DAY - day 1, day 2, day 3,
WEEK week 1, week 2, week 3,
MONTH month 1, month 2, month 3,

Number of partitions at each level = retention level


62 days of RAW = 62 partitions

AGE out of data

Drop oldest partition


Create new one to replace the one dropped

VERY Efficient

Not necessary to walk all the data and issue individual deletes

1151

not for distribution

TNSQM v4.x Default Retentions


KPI Data (individual tables per data source)
RAW 62 days retained

KQI Data (common tables for all KQIs)

E
T
T

RAW 62 days retained


HOUR 62 days retained
DAY 104 weeks retained
WEEK 104 weeks retained
MONTH 36 months retained

Aggregation Schedule *

HOUR updated every hour


DAY once per day at midnight
WEEK every Monday at midnight
MONTH the 1st of each month

Aging Schedule *

Old partitions dropped daily at 2:00 AM

* Implemented as Oracle Jobs

1152

not for distribution

Oracle Jobs Hourly Aggregation


KQI_ADMIN_PKG.HST_KQIV_HOURLYSUMMARY

Runs every hour


Reads data from SA_HST_KQIVALUE (raw KQI data)
Selects records that are 24 hours old, based upon the current hour
Summarizes raw KQI values into hourly summaries
COUNT
SUM
MIN
MAX
AVG
STDDEV
Inserts new records into SA_HST_KQIVHOURAGG
Newest data in this table is 24 HOURS OLD (by default)
If it runs Sunday at 9:00 AM, it summarizes Saturday 9:00 AM
/appl/sa/admin/oracle/schema/core/sqm/packages
kqi_admin_pkg_pks.sql (v_day and v_hr)

1153

E
T
T
not for distribution

Oracle Jobs Daily Aggregation


KQI_ADMIN_PKG.HST_KQIV_DAILYSUMMARY

Runs every day at 00:00


Reads data from SA_HST_KQIVHOURAGG Hourly Summaries
Selects records that are 3 days old, based upon the current day
Summarizes hourly KQI summaries into daily summaries
COUNT
SUM
MIN (minimum raw value)
MAX (maximum raw value)
AVG (average of the hourly average NOT weighted)
STDDEV - NONE
Inserts new records into SA_HST_KQIVDAYAGG
Newest data in this table is 3 DAYS OLD (by default)
If it runs on 2/7, it summarizes data for 2/4
/appl/sa/admin/oracle/schema/core/sqm/packages
kqi_admin_pkg_pkb.sql

1154

E
T
T
not for distribution

Oracle Jobs Weekly Aggregation


KQI_ADMIN_PKG.HST_KQIV_WEEKLYSUMMARY
Runs every Monday at 00:00
Reads data from SA_HST_KQIVHOURAGG Hourly Summaries
Selects records that are more than 7 days old, based upon the
current day
Summarizes daily KQI summaries into weekly summaries
COUNT
SUM
MIN (minimum raw value)
MAX (maximum raw value)
AVG (average of the hourly average NOT weighted)
STDDEV - NONE
Inserts new records into SA_HST_KQIVWEEKAGG
Newest data in this table is more than 7 DAYS OLD (by default)
If it runs on 2/23, it summarizes data for 2/7-2/13
/appl/sa/admin/oracle/schema/core/sqm/packages
kqi_admin_pkg_pkb.sql

E
T
T

1155

not for distribution

Oracle Jobs Monthly Aggregation


KQI_ADMIN_PKG.HST_KQIV_MONTHLYSUMMARY

Runs the 1st of each month at 00:00


Reads data from SA_HST_KQIVHOURAGG Hourly Summaries
Selects records for the month before the previous month
Summarizes hourly KQI summaries into monthly summaries
COUNT
SUM
MIN (minimum raw value)
MAX (maximum raw value)
AVG (average of the hourly average NOT weighted)
STDDEV - NONE
Inserts new records into SA_HST_KQIVMONTHAGG
Newest data in this table is 2 months OLD (by default)
If it runs on March 1st it summarizes data for January
/appl/sa/admin/oracle/schema/core/sqm/packages
kqi_admin_pkg_pkb.sql

1156

E
T
T
not for distribution

Oracle Tables KQI Data


SA_HST_KQIVALUE
Raw KQI values, at the same interval as processed by the adapter
Data is current as of the last adapter processing

E
T
T

SA_HST_KQIVHOURAGG

Hourly KQI summaries


Newest data is 24 hours old Yesterday

SA_HST_KQIVDAYAGG
Daily KQI summaries
Newest data is 3 days old

SA_HST_KQIVWEEKAGG

Weekly KQI summaries


Newest data is 7 days old not the past week, but the week before that

SA_HST_KQIVMONTHAGG

Monthly KQI summaries


Newest data is 30 days old not the past month, but the month before that

1157

not for distribution

Oracle Tables KPI Data


Individual tables based upon Service Solution Data Source(s)
IP VPN v3.2, e.g.
KPI_VPN_IPVPN_PM
VoIP v1.3, e.g.
KPI_VOIP_CDR_PSTN_GW
KPI_VOIP_CDR_BAD_DATA
KPI_VOIP_CDR_SBC
KPI_VOIP_CDR_SIPPROXY
KPI_VOIP_PM_MEDIASERVER
KPI_VOIP_PM_SBC
KPI_VOIP_PM_APPSERVER
KPI_VOIP_PM_BAD_DATA
KPI_VOIP_PM_PSTN_GW
KPI_VOIP_PRB_PROBE

E
T
T

Data retained at raw level default 62 days


NO aggregation performed

1158

not for distribution

BIRT Overview
Business Intelligence Reporting Tool BIRT

E
T
T

Available for free from Eclipse

http://www.eclipse.org/birt/phoenix/

General-purpose Reporting Tool

1159

not for distribution

Report Creation Overview


Install BIRT on laptop / workstation

E
T
T

Install Oracle JDBC drivers


Report Creation

Define project
Create a datasource

Connection to specific Oracle database (host, port, user, password)

Create a dataset

Connection to Oracle table and/or view


Select statement to define filter criteria and desired columns

Report format

Column contents, headings, output formats

Generate report

1160

not for distribution

Workshop Lab Exercise 10


To begin the hands-on exercises

E
T
T

Download lab workbook number 10


Follow all the steps to complete the lab exercise

1161

not for distribution