IBM

Tivoli

Monitoring

for

Business

Integration

Installation

and

Setup

Guide

Version

5.1.1

SC32-1402-00

���

IBM

Tivoli

Monitoring

for

Business

Integration

Installation

and

Setup

Guide

Version

5.1.1

SC32-1402-00

���

Note

Before

using

this

information

and

the

product

it

supports,

read

the

information

Appendix

D,

“Notices,”

on

page

205.

First

Edition

(October

2003)

This

edition

applies

to

version

5.1.1

of

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ,

version

5.1.0

of

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator,

and

version

5.1.1

of

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server

and

to

all

subsequent

releases

and

modifications

until

otherwise

indicated

in

new

editions.

©

Copyright

International

Business

Machines

Corporation

2002,

2003.

All

rights

reserved.

US

Government

Users

Restricted

Rights

–

Use,

duplication

or

disclosure

restricted

by

GSA

ADP

Schedule

Contract

with

IBM

Corp.

Contents

Figures

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. v

Tables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. vii

About

this

guide

.

.

.

.

.

.

.

.

.

.

. ix

Who

should

read

this

guide

.

.

.

.

.

.

.

.

. ix

What

this

guide

contains

.

.

.

.

.

.

.

.

.

. ix

Publications

.

.

.

.

.

.

.

.

.

.

.

.

.

. x

IBM

Tivoli

Monitoring

for

Business

Integration

library

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. x

Prerequisite

publications

.

.

.

.

.

.

.

.

. xii

Related

publications

.

.

.

.

.

.

.

.

.

. xii

Accessing

publications

online

.

.

.

.

.

.

. xiii

Ordering

publications

.

.

.

.

.

.

.

.

.

. xiii

Accessibility

.

.

.

.

.

.

.

.

.

.

.

.

.

. xiii

Contacting

software

support

.

.

.

.

.

.

.

. xiv

Conventions

used

in

this

guide

.

.

.

.

.

.

. xiv

Typeface

conventions

.

.

.

.

.

.

.

.

.

. xiv

Operating

system-dependent

variables

and

paths

xv

Tivoli

command

syntax

.

.

.

.

.

.

.

.

. xv

Chapter

1.

Overview

.

.

.

.

.

.

.

.

. 1

Choosing

an

installation

method

.

.

.

.

.

.

.

. 1

Tivoli

monitoring

environment

.

.

.

.

.

.

.

. 3

Tivoli

management

region

.

.

.

.

.

.

.

.

. 3

Components

of

a

Tivoli

monitoring

environment

. 6

Chapter

2.

Guidelines

for

installation

and

setup

.

.

.

.

.

.

.

.

.

.

.

.

. 17

Chapter

3.

Pre-installation

requirements

.

.

.

.

.

.

.

.

.

.

.

. 19

Supported

operating

systems

.

.

.

.

.

.

.

. 19

Requirements

for

OS/400

endpoints

.

.

.

.

.

. 21

Required

and

optional

software

.

.

.

.

.

.

. 22

System

requirements

.

.

.

.

.

.

.

.

.

.

. 27

Disk

space

requirements

for

installing

the

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

.

.

. 27

Disk

space

requirements

for

log

files

.

.

.

.

. 28

Additional

system

requirements

.

.

.

.

.

. 29

Permissions

and

privileges

.

.

.

.

.

.

.

.

. 29

About

upgrades

.

.

.

.

.

.

.

.

.

.

.

.

. 30

Language

requirements

.

.

.

.

.

.

.

.

.

. 30

Key

points

for

system

layout

.

.

.

.

.

.

.

. 30

Where

to

install

IBM

Tivoli

Monitoring

for

Business

Integration

component

software

.

.

. 30

Setting

up

endpoints

.

.

.

.

.

.

.

.

.

. 31

IBM

Tivoli

Monitoring

for

Business

Integration

and

interconnected

regions

.

.

.

.

.

.

.

. 32

Planning

for

event

handling

.

.

.

.

.

.

.

. 33

Configuration

requirements

for

IBM

Tivoli

Monitoring

for

Business

Integration

.

.

.

.

.

. 34

Naming

conventions

.

.

.

.

.

.

.

.

.

. 34

Setting

up

user

IDs

.

.

.

.

.

.

.

.

.

.

. 35

About

starting

and

stopping

WebSphere

MQ

listener

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

About

installing

and

using

the

TivoliMonitor

node

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 36

Enabling

monitoring

of

WebSphere

MQ

and

WebSphere

MQ

Integrator

on

z/OS

systems

.

. 37

Backing

up

and

restoring

Tivoli

databases

.

.

.

. 38

Verifying

that

the

required

software

is

running

.

. 40

Completing

installation

planning

sheets

.

.

.

.

. 43

Obtaining

the

installation

files

.

.

.

.

.

.

.

. 49

Using

installation

files

from

CDs

.

.

.

.

.

. 49

Using

installation

files

from

the

Web

.

.

.

.

. 50

Downloading

installation

files

from

the

Web

.

. 54

Chapter

4.

Performing

an

Evaluation

installation

.

.

.

.

.

.

.

.

.

.

.

.

. 59

Chapter

5.

Performing

a

Typical

installation

.

.

.

.

.

.

.

.

.

.

.

.

. 65

Installing

the

product

using

the

Typical

option

.

. 65

Creating

a

Windows

proxy

endpoint

.

.

.

.

.

. 75

Chapter

6.

Installing

or

upgrading

the

product

manually

in

an

existing

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

.

. 79

Road

map

for

manual

installations

and

upgrades

.

. 79

Accessing

the

Tivoli

Management

Framework

environment

.

.

.

.

.

.

.

.

.

.

.

.

.

. 81

Installing

new

Tivoli

software

.

.

.

.

.

.

.

. 83

Upgrading,

installing

Tivoli

patches,

and

installing

fix

packs

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 86

Chapter

7.

Completing

the

installation

of

the

product

.

.

.

.

.

.

.

.

.

.

. 93

Verifying

the

installation

of

the

product

.

.

.

.

. 94

Installing

the

Java

Runtime

Environment

.

.

.

. 95

Linking

to

an

existing

Java

Runtime

Environment

97

Loading

Managed

Object

Format

(MOF)

files

into

Resource

Model

Builder

.

.

.

.

.

.

.

.

.

. 99

Installing

files

to

enable

Tivoli

Enterprise

Data

Warehouse

.

.

.

.

.

.

.

.

.

.

.

.

.

. 100

Installing

IBM

Tivoli

Language

Support

for

this

product

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 103

Updating

Web

Health

Console

files

.

.

.

.

.

. 106

Integrating

the

product

with

Tivoli

Inventory

.

. 107

Installing

the

DB2

WebSphere

MQ

database

schema

.

.

.

.

.

.

.

.

.

.

.

.

.

. 109

Installing

the

Microsoft

SQL

WebSphere

MQ

database

schema

.

.

.

.

.

.

.

.

.

.

. 111

Installing

the

Oracle

WebSphere

MQ

database

schema

.

.

.

.

.

.

.

.

.

.

.

.

.

. 112

Installing

the

Sybase

WebSphere

MQ

database

schema

.

.

.

.

.

.

.

.

.

.

.

.

.

. 114

Creating

the

MQSeries

Inventory

policy

region

115

©

Copyright

IBM

Corp.

2002,

2003

iii

Chapter

8.

Expanding

your

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

.

. 119

Installing

managed

nodes

through

an

existing

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

. 119

Installing

endpoints

through

an

existing

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

.

.

.

. 123

Changing

the

gateway

assignment

of

an

endpoint

127

Installing

the

Web

Health

Console

manually

.

.

. 128

Chapter

9.

Installing

and

configuring

the

WebSphere

MQ

component

for

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 131

Tivoli

environment

for

monitoring

WebSphere

MQ

for

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 132

Installing

Monitoring

for

WebSphere

MQ

for

z/OS

133

Configuring

timeouts

for

Tivoli

gateways

.

.

.

. 134

Installing

the

task

server

.

.

.

.

.

.

.

.

. 135

Configuring

the

task

server

to

communicate

with

z/OS

systems

.

.

.

.

.

.

.

.

.

.

.

.

. 137

Configuring

the

IBM

Tivoli

NetView

for

z/OS

environment

.

.

.

.

.

.

.

.

.

.

.

.

.

. 141

Starting

communication

between

the

task

server

and

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

. 142

Using

IBM

Tivoli

NetView

for

z/OS

message

automation

.

.

.

.

.

.

.

.

.

.

.

.

.

. 144

Creating

the

event

adapter

configuration

file

.

.

. 144

Creating

the

event

adapter

JCL

.

.

.

.

.

.

. 147

Configuring

event

queues

for

the

queue

manager

148

Configuring

the

dead-letter

queue

handler

for

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 149

About

monitoring

SMF

records

with

the

Statistics

Event

Adapter

.

.

.

.

.

.

.

.

.

.

.

.

. 151

Setting

up

the

Statistics

Event

Adapter

.

.

.

.

. 151

Starting

the

Statistics

Event

Adapter

.

.

.

.

.

. 155

Controlling

statistics

events

.

.

.

.

.

.

.

.

. 155

Chapter

10.

Installing

and

configuring

the

WebSphere

MQ

Integrator

component

for

z/OS

.

.

.

.

.

.

.

. 157

Tivoli

environment

for

monitoring

WebSphere

MQ

Integrator

for

z/OS

.

.

.

.

.

.

.

.

.

.

. 158

Installing

and

setting

up

Monitoring

for

WebSphere

MQ

Integrator

for

z/OS

.

.

.

.

.

. 160

Configuring

timeouts

for

Tivoli

gateways

.

.

.

. 164

Configuring

the

IBM

Tivoli

NetView

for

z/OS

environment

.

.

.

.

.

.

.

.

.

.

.

.

.

. 165

Starting

communication

between

the

task

server

and

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

. 166

Chapter

11.

Monitoring

for

MQSeries

for

z/OS

and

RACF

.

.

.

.

.

.

.

.

. 169

NetView

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 169

NetView

operator

ID

.

.

.

.

.

.

.

.

.

. 169

NetView

operator

commands

.

.

.

.

.

.

. 170

MVS

operating

system

.

.

.

.

.

.

.

.

.

. 170

Programs

.

.

.

.

.

.

.

.

.

.

.

.

.

. 170

MVS

operator

commands

.

.

.

.

.

.

.

. 170

MVS

data

sets

.

.

.

.

.

.

.

.

.

.

.

. 171

WebSphere

MQ

.

.

.

.

.

.

.

.

.

.

.

.

. 171

Queue

manager

.

.

.

.

.

.

.

.

.

.

. 172

Queue

sharing

group

.

.

.

.

.

.

.

.

.

. 172

Queue

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 173

Process

.

.

.

.

.

.

.

.

.

.

.

.

.

. 174

Name

list

.

.

.

.

.

.

.

.

.

.

.

.

.

. 174

MQSC

operator

commands

.

.

.

.

.

.

.

. 174

Command

resource

.

.

.

.

.

.

.

.

.

. 175

Channel

.

.

.

.

.

.

.

.

.

.

.

.

.

. 176

Data

sets

.

.

.

.

.

.

.

.

.

.

.

.

.

. 176

Tivoli

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 176

Chapter

12.

Setting

up

OS/400

endpoints

for

the

WebSphere

MQ

component

.

.

.

.

.

.

.

.

.

.

.

. 177

Installing

the

endpoint

.

.

.

.

.

.

.

.

.

. 177

Starting

an

OS/400

endpoint

.

.

.

.

.

.

.

. 180

Stopping

an

OS/400

endpoint

.

.

.

.

.

.

.

. 183

Removing

an

endpoint

from

an

OS/400

system

184

Chapter

13.

Installing

Message

Manager

console

.

.

.

.

.

.

.

.

.

. 187

Appendix

A.

Patches

and

fix

packs

189

Appendix

B.

Icons

and

options

in

the

Step

List

window

.

.

.

.

.

.

.

.

.

. 193

Appendix

C.

Uninstalling

the

product

195

Uninstalling

Monitoring

for

WebSphere

MQ

.

.

. 195

Uninstalling

Monitoring

for

WebSphere

MQ

Integrator

from

the

Tivoli

server

.

.

.

.

.

.

. 197

Uninstalling

Monitoring

for

WebSphere

MQ

Integrator

from

a

single

gateway

.

.

.

.

.

.

. 198

Creating

the

Uninstall

Monitoring

for

WebSphere

InterChange

Server

task

.

.

.

.

.

.

.

.

.

. 199

Uninstalling

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server

from

the

Tivoli

server

.

.

.

.

.

.

.

.

.

.

.

. 200

Uninstalling

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server

managed

nodes

and

endpoints

.

.

.

.

.

.

. 202

Uninstalling

Message

Manager

.

.

.

.

.

.

. 203

Appendix

D.

Notices

.

.

.

.

.

.

.

. 205

Trademarks

.

.

.

.

.

.

.

.

.

.

.

.

.

. 207

Index

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 209

iv

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

Figures

1.

Installation

options

window:

Evaluation/Product

Demonstration

option

.

. 61

2.

Component

selection

window

.

.

.

.

.

. 62

3.

Sample

prompt

for

a

software

CD

.

.

.

.

. 62

4.

Installation

options

window:

Typical

option

69

5.

Basic

tab

for

managed

nodes

.

.

.

.

.

.

. 70

6.

Advanced

tab

for

managed

nodes

.

.

.

.

. 70

7.

Component

selection

window

.

.

.

.

.

. 71

8.

Basic

tab

for

endpoints

.

.

.

.

.

.

.

. 72

9.

Advanced

tab

for

endpoints

.

.

.

.

.

.

. 72

10.

Sample

prompt

for

a

software

CD

.

.

.

.

. 73

11.

Stop

deployment

message

.

.

.

.

.

.

.

. 76

12.

Detail

window

for

TMA

installation

step

76

13.

Tivoli

environment

for

monitoring

WebSphere

MQ

for

z/OS

.

.

.

.

.

.

.

.

.

.

. 132

14.

Architecture

of

Monitoring

for

WebSphere

MQ

Integrator

for

z/OS

.

.

.

.

.

.

.

. 158

©

Copyright

IBM

Corp.

2002,

2003

v

vi

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

Tables

1.

Guidelines

for

installation

and

setup

.

.

.

. 17

2.

Pre-installation

requirements

and

procedures

19

3.

Supported

operating

systems

for

the

Tivoli

management

region

server

and

managed

nodes

.

.

.

.

.

.

.

.

.

.

.

.

.

. 20

4.

Supported

operating

systems

for

endpoints

20

5.

Required

and

optional

software

for

IBM

Tivoli

Monitoring

for

Business

Integration

.

.

.

. 22

6.

Disk

space

requirements

for

installing

the

Tivoli

environment

.

.

.

.

.

.

.

.

.

. 28

7.

Subdirectories

for

log

files

on

managed

nodes

and

endpoints

.

.

.

.

.

.

.

.

.

.

.

. 28

8.

Additional

system

requirements

for

installation

of

the

IBM

Tivoli

Monitoring

for

Business

Integration

software

.

.

.

.

.

.

.

.

.

. 29

9.

Context

for

setting

up

endpoints

.

.

.

.

. 31

10.

Event

adapters

for

Monitoring

for

WebSphere

MQ

Integrator

.

.

.

.

.

.

.

.

.

.

. 34

11.

Valid

and

Invalid

characters

for

the

names

of

WebSphere

MQ

Integrator

resources

.

.

.

. 35

12.

Managed

resources

and

their

purpose

.

.

.

. 43

13.

Planning

sheet

for

creating

managed

nodes

45

14.

Planning

sheet

for

creating

endpoints

.

.

.

. 46

15.

Planning

sheet

for

creating

proxy

managed

objects

.

.

.

.

.

.

.

.

.

.

.

.

.

. 48

16.

CDs

for

Evaluation

or

Typical

installations

of

IBM

Tivoli

Monitoring

for

Business

Integration

49

17.

Web

download

links

for

Evaluation

or

Typical

installations

of

IBM

Tivoli

Monitoring

for

Business

Integration

.

.

.

.

.

.

.

.

.

. 51

18.

Download

directories

for

a

Typical

or

Evaluation

installation

.

.

.

.

.

.

.

.

. 54

19.

Guidelines

for

a

Typical

installation

.

.

.

. 65

20.

Procedures

for

creating

Windows

endpoints

66

21.

Startup

and

configuration

options

.

.

.

.

. 77

22.

Guidelines

for

installing

the

product

from

the

Tivoli

desktop

or

command

line

.

.

.

.

.

. 79

23.

Installation

and

upgrade

procedures

for

manual

installations

of

IBM

Tivoli

Monitoring

for

Business

Integration

.

.

.

.

.

.

.

. 80

24.

Information

required

to

install

the

software

83

25.

Information

required

for

installing

patches

for

Tivoli

Management

Framework,

Version

4.1

.

. 87

26.

Information

required

for

installing

patches

for

Tivoli

Management

Framework,

Version

3.7.1

. 87

27.

Information

required

for

installing

fix

packs

88

28.

Information

required

for

installing

upgrade

software

.

.

.

.

.

.

.

.

.

.

.

.

. 88

29.

Guidelines

for

completing

the

installation

of

the

product

.

.

.

.

.

.

.

.

.

.

.

. 93

30.

Locations

of

Tivoli

Enterprise

Data

Warehouse

configuration

files

.

.

.

.

.

. 101

31.

Language

support

and

names

of

corresponding

installation

index

(.IND)

files

. 104

32.

Guidelines

for

expanding

your

Tivoli

environment

.

.

.

.

.

.

.

.

.

.

.

. 119

33.

Guidelines

for

installing

the

product

through

an

existing

Tivoli

environment

.

.

.

.

.

. 123

34.

Goals

for

installation

and

configuration

of

Monitoring

for

WebSphere

MQ

for

z/OS

.

. 131

35.

Components

of

a

Monitoring

for

WebSphere

MQ

for

z/OS

installation

.

.

.

.

.

.

. 133

36.

Goals

for

installing

and

configuring

the

WebSphere

MQ

Integrator

component

for

z/OS

.

.

.

.

.

.

.

.

.

.

.

.

.

. 157

37.

Guidelines

for

setting

up

OS/400

endpoints

177

38.

User

profiles

that

Tivoli

creates

on

OS/400

177

39.

Parameters

for

the

STRTMEEPT

command

181

40.

Message

Manager

installation

file

types

187

41.

Specifications

of

required

patches

that

the

installer

installs

automatically

.

.

.

.

.

. 189

42.

Specifications

of

required

patches

for

other

required

and

optional

software

.

.

.

.

.

. 190

43.

Status

icons

and

options

for

the

Step

List

window

of

the

installer

.

.

.

.

.

.

.

. 193

44.

Guidelines

for

uninstalling

the

product

195

45.

Tivoli

server

uninstall

actions

.

.

.

.

.

. 201

©

Copyright

IBM

Corp.

2002,

2003

vii

viii

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

About

this

guide

This

guide

describes

how

to

install

and

set

up

IBM®

Tivoli®

Monitoring

for

Business

Integration

to

monitor

and

manage

server

resources

and

other

objects

in

a

Tivoli

environment.

Who

should

read

this

guide

This

guide

is

for

system

administrators

who

monitor

and

manage

WebSphere

MQ,

WebSphere

MQ

Integrator,

and

WebSphere

InterChange

Server

resources.

Readers

should

be

familiar

with

the

following

topics:

v

Tivoli

management

software

v

UNIX®operating

systems

v

Windows®

operating

systems

v

z/OS™

operating

systems

v

databases

v

IBM

WebSphere

MQ

v

IBM

WebSphere

MQ

Integrator

v

IBM

WebSphere

MQ

Workflow

v

IBM

WebSphere

InterChange

Server

v

Tivoli

Enterprise

Data

Warehouse

v

IBM

Tivoli

Enterprise

Console

v

IBM

Tivoli

Business

Systems

Manager

(optional)

What

this

guide

contains

This

guide

contains

the

following

sections:

v

Chapter

1,

“Overview,”

on

page

1

Provides

an

overview

of

the

installation

and

setup

of

IBM

Tivoli

Monitoring

for

Business

Integration.

v

Chapter

2,

“Guidelines

for

installation

and

setup,”

on

page

17

Provides

guidelines

for

installing

and

setting

up

IBM

Tivoli

Monitoring

for

Business

Integration.

v

Chapter

3,

“Pre-installation

requirements,”

on

page

19

Describes

how

to

plan

and

prepare

for

installing

the

product.

v

Chapter

4,

“Performing

an

Evaluation

installation,”

on

page

59

Describes

the

Evaluation

installation

method.

v

Chapter

5,

“Performing

a

Typical

installation,”

on

page

65

Describes

the

Typical

installation

method.

v

Chapter

6,

“Installing

or

upgrading

the

product

manually

in

an

existing

Tivoli

environment,”

on

page

79

Describes

how

to

install

or

upgrade

the

product

in

an

existing

Tivoli

environment

from

the

Tivoli

command

line

or

desktop.

v

Chapter

7,

“Completing

the

installation

of

the

product,”

on

page

93

Describes

how

to

verify

and

complete

the

installation

of

the

product.

©

Copyright

IBM

Corp.

2002,

2003

ix

v

Chapter

8,

“Expanding

your

Tivoli

environment,”

on

page

119

Describes

how

to

add

managed

nodes,

endpoints,

or

installations

of

the

IBM

Tivoli

Monitoring

Web

Health

Console

to

an

existing

Tivoli

environment.

v

Chapter

9,

“Installing

and

configuring

the

WebSphere

MQ

component

for

z/OS,”

on

page

131

Describes

how

to

install

and

set

up

Monitoring

for

WebSphere

MQ

for

z/OS.

v

Chapter

10,

“Installing

and

configuring

the

WebSphere

MQ

Integrator

component

for

z/OS,”

on

page

157

Describes

how

to

install

and

set

up

Monitoring

for

WebSphere

MQ

Integrator

for

z/OS.

v

Chapter

11,

“Monitoring

for

MQSeries

for

z/OS

and

RACF,”

on

page

169

Provides

information

about

using

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

in

a

Resource

Access

Control

Facility

(RACF)

environment.

v

Chapter

12,

“Setting

up

OS/400

endpoints

for

the

WebSphere

MQ

component,”

on

page

177

Describes

the

OS/400

commands

that

enable

you

to

set

up

and

manage

Monitoring

for

WebSphere

MQ

endpoints.

v

Chapter

13,

“Installing

Message

Manager

console,”

on

page

187

Describes

how

to

install

the

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Message

Manager

Console.

v

Appendix

A,

“Patches

and

fix

packs,”

on

page

189

Lists

required

patches

and

fix

packs.

v

Appendix

B,

“Icons

and

options

in

the

Step

List

window,”

on

page

193

Describes

the

icons

and

options

that

are

displayed

in

the

Step

List

window

of

the

installer.

v

Appendix

C,

“Uninstalling

the

product,”

on

page

195

Describes

how

to

uninstall

the

product.

v

Appendix

D,

“Notices,”

on

page

205

Provides

information

about

copyrights

and

trademarks.

Publications

This

section

lists

publications

in

the

IBM

Tivoli

Monitoring

for

Business

Integration

library

and

related

documents.

It

also

describes

how

to

access

Tivoli

publications

online

and

how

to

order

Tivoli

publications.

IBM

Tivoli

Monitoring

for

Business

Integration

library

The

following

documents

are

available

in

the

IBM

Tivoli

Monitoring

for

Business

Integration

library:

IBM

Tivoli

Monitoring

for

Business

Integration

v

IBM

Tivoli

Monitoring

for

Business

Integration:

Readme

First,

SC32–1401–00

Provides

information

on

where

to

find

all

of

the

IBM

Tivoli

Monitoring

for

Business

Integration

documentation,

including

the

titles

and

locations

of

all

documentation.

v

IBM

Tivoli

Monitoring

for

Business

Integration

Installation

and

Setup

Guide,

SC32–1402–00

Provides

information

about

installing

each

of

the

IBM

Tivoli

Monitoring

for

Business

Integration

components.

x

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

v

IBM

Tivoli

Monitoring

for

Business

Integration

User’s

Guide,

SC32–1403–00

Provides

information

about

how

to

use

each

IBM

Tivoli

Monitoring

for

Business

Integration

component

to

manage

resources.

v

IBM

Tivoli

Monitoring

for

Business

Integration

Problem

Determination

Guide,

SC32–1404–00

Provides

information

and

messages

to

assist

users

with

troubleshooting

problems

with

the

software.

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Reference

Guide,

SC32–1405–00

Provides

information

about

the

tasks

and

resource

models

that

Monitoring

for

WebSphere

MQ

provides.

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Warehouse

Enablement

Pack

Implementation

Guide,

SC32–1406–00

Provides

information

that

helps

users

deploy

and

use

Tivoli

Enterprise

Data

Warehouse

with

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ.

v

IBM

Tivoli

Monitoring

for

Business

Integration:

MQ

Workflow

Warehouse

Enablement

Pack

Implementation

Guide,

SC32–1409–00

Provides

information

that

helps

users

deploy

and

use

Tivoli

Enterprise

Data

Warehouse

with

the

Workflow

function

in

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ.

v

Program

Directory

for

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

for

z/OS,

GI11-4234-01

Provides

information

about

installing

Monitoring

for

WebSphere

MQ

for

z/OS

in

proxy

mode

or

native

mode.

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

Reference

Guide,

SC23–4708–00

Provides

information

about

the

resource

models,

tasks,

and

commands

that

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

provides.

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

Warehouse

Enablement

Pack

Implementation

Guide,

SC09–7784–00

Provides

information

that

helps

users

deploy

and

use

Tivoli

Enterprise

Data

Warehouse

with

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator.

v

Program

Directory

for

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

for

z/OS,

GI11-4235-01

Provides

information

about

installing

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

MQ

Integrator

for

z/OS.

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

Interchange

Server

Reference

Guide

,

SC32–1408–00

Provides

information

about

the

tasks

and

resource

models

that

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server

provides.

v

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

Interchange

Server

Warehouse

Enablement

Pack

Implementation

Guide,

SC32–1410–00

About

this

guide

xi

Provides

information

that

helps

users

deploy

and

use

Tivoli

Enterprise

Data

Warehouse

with

IBM

Tivoli

Monitoring

for

Business

Integration:

WebSphere

InterChange

Server.

Prerequisite

publications

To

use

the

information

in

this

guide

effectively,

you

must

have

some

prerequisite

knowledge,

which

you

can

get

from

the

following

guides:

v

IBM

Tivoli

Monitoring

User’s

Guide,

SC23-4567

Provides

an

overview

of

IBM

Tivoli

Monitoring,

especially

of

resource

models.

It

also

describes

how

to

use

the

user

interface.

v

IBM

Tivoli

Monitoring

Resource

Model

Builder

User’s

Guide,

Version

1.1.0,

SC32-1391-01.

Describes

using

the

IBM

Tivoli

Monitoring

Resource

Model

Builder

to

create

and

customize

resource

models.

Related

publications

The

following

documents

also

provide

useful

information:

v

Tivoli

Software

Installation

Service

User’s

Guide,

SG24–6028

v

Tivoli

Management

Framework

User’s

Guide,

GC31–8433

v

Tivoli

Enterprise

Installation

Guide,

GC32–0395

v

Tivoli

Management

Framework

Reference

Manual,

SC31–8434

v

Tivoli

Software

Distribution

User’s

Guide,

GC32–0651

v

Tivoli

Software

Distribution

Reference

Manual,

GC32–0652

v

IBM

Tivoli

Configuration

Manager

User’s

Guide

for

Inventory,

SC23–4713

v

IBM

Tivoli

Enterprise

Console

Event

Integration

Facility

User’s

Guide,

GC32–0691

v

IBM

Tivoli

Enterprise

Console

Reference

Manual,

GC32–0666

v

IBM

Tivoli

Enterprise

Console

Rule

Builder’s

Guide,

GC32–0669

v

IBM

WebSphere

MQ

product

documentation

v

IBM

WebSphere

MQ

Integrator

product

documentation

v

IBM

WebSphere

MQ

Workflow

product

documentation

v

IBM

WebSphere

InterChange

Server

product

documentation

v

IBM

Tivoli

NetView®

for

z/OS

product

documentation

v

IBM

Tivoli

Business

Systems

Manager

product

documentation

v

MQSeries

Link

for

R/3

User’s

Guide,

GC33–1934

v

TSO/E

REXX

Reference,

SA22–7790

v

Tivoli

Enterprise

Data

Warehouse

product

documentation

v

IBM

Tivoli

Monitoring

product

documentation

v

Road

Map

for

the

Typical

Installation

Option

of

IBM

Tivoli

Monitoring

Products,

GI11-0959-00

v

Road

Map

for

Enabling

Tivoli

Enterprise

Data

Warehouse

for

IBM

Tivoli

Monitoring

Products

The

Tivoli

Software

Glossary

includes

definitions

for

many

of

the

technical

terms

related

to

Tivoli

software.

The

Tivoli

Software

Glossary

is

available,

in

English

only,

at

the

following

Web

site:

http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

xii

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm

Accessing

publications

online

The

documentation

CD

contains

the

publications

that

are

in

the

product

library.

The

format

of

the

publications

is

PDF,

HTML,

or

both.

Refer

to

the

readme

file

on

the

CD

for

instructions

on

how

to

access

the

documentation.

IBM

posts

publications

for

this

and

all

other

Tivoli

products,

as

they

become

available

and

whenever

they

are

updated,

to

the

Tivoli

software

information

center

Web

site.

Access

the

Tivoli

software

information

center

by

first

going

to

the

Tivoli

software

library

at

the

following

Web

address:

http://www.ibm.com/software/tivoli/library/

Scroll

down

and

click

the

Product

manuals

link.

In

the

Tivoli

Technical

Product

Documents

Alphabetical

Listing

window,

click

M

to

access

all

of

the

IBM

Tivoli

Monitoring

product

manuals.

Note:

If

you

print

PDF

documents

on

other

than

letter-sized

paper,

set

the

option

in

the

File

→

Print

window

that

allows

Adobe

Reader

to

print

letter-sized

pages

on

your

local

paper.

The

IBM

Tivoli

Software

Support

Web

site

provides

the

latest

information

about

known

product

limitations

and

workarounds

for

your

product.

You

can

view

this

information

at

the

following

Web

site:

http://www-3.ibm.com/software/support

Ordering

publications

You

can

order

many

Tivoli

publications

online

at

the

following

Web

site:

http://www.elink.ibmlink.ibm.com/public/applications/

publications/cgibin/pbi.cgi

You

can

also

order

by

telephone

by

calling

one

of

these

numbers:

v

In

the

United

States:

800-879-2755

v

In

Canada:

800-426-4968

In

other

countries,

see

the

following

Web

site

for

a

list

of

telephone

numbers:

http://www.ibm.com/software/tivoli/order-lit/

Accessibility

Accessibility

features

help

users

with

a

physical

disability,

such

as

restricted

mobility

or

limited

vision,

to

use

software

products

successfully.

With

this

product,

you

can

use

assistive

technologies

to

hear

and

navigate

the

interface.

You

can

also

use

the

keyboard

instead

of

the

mouse

to

operate

most

features

of

the

graphical

user

interface.

For

additional

information,

see

the

Accessibility

Appendix

in

the

user’s

guide

for

this

product.

About

this

guide

xiii

http://www.ibm.com/software/tivoli/library/http://www-3.ibm.com/software/supporthttp://www.elink.ibmlink.ibm.com/public/applications/ publications/cgibin/pbi.cgihttp://www.elink.ibmlink.ibm.com/public/applications/ publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/

Contacting

software

support

Before

contacting

IBM

software

support

with

a

problem,

refer

to

the

IBM

software

support

Web

site:

http://www.ibm.com/software/support

To

access

Tivoli

support,

click

the

Tivoli

support

link

at

the

bottom

right

of

the

support

page.

If

you

want

to

contact

software

support,

see

the

IBM

Software

Support

Guide

at

the

following

Web

site:

http://techsupport.services.ibm.com/guides/handbook.html

The

guide

provides

information

about

how

to

contact

IBM

Software

Support,

depending

on

the

severity

of

your

problem,

and

the

following

information:

v

Registration

and

eligibility

v

Telephone

numbers,

depending

on

the

country

in

which

you

are

located

v

Information

you

must

have

before

contacting

IBM

Software

Support

Conventions

used

in

this

guide

This

guide

uses

several

conventions

for

special

terms

and

actions,

and

operating

system-dependent

commands

and

paths.

Typeface

conventions

This

guide

uses

the

following

typeface

conventions:

Bold

v

Lowercase

commands

and

mixed

case

commands

that

are

otherwise

difficult

to

distinguish

from

surrounding

text

v

Interface

controls

(check

boxes,

push

buttons,

radio

buttons,

spin

buttons,

fields,

folders,

icons,

list

boxes,

items

inside

list

boxes,

multicolumn

lists,

containers,

menu

choices,

menu

names,

tabs,

property

sheets),

labels

(such

as

Tip:,

and

Operating

system

considerations:)

v

Keywords

and

parameters

in

text

Italic

v

Words

defined

in

text

v

Emphasis

of

words

(words

as

words)

v

New

terms

in

text

(except

in

a

definition

list)

v

Variables

and

values

you

must

provide

Monospace

v

Examples

and

code

examples

v

File

names,

programming

keywords,

and

other

elements

that

are

difficult

to

distinguish

from

surrounding

text

v

Message

text

and

prompts

addressed

to

the

user

v

Text

that

the

user

must

type

v

Values

for

arguments

or

command

options

xiv

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

http://www.ibm.com/software/supporthttp://techsupport.services.ibm.com/guides/handbook.html

Operating

system-dependent

variables

and

paths

The

publications

in

this

library

use

the

UNIX

convention

for

specifying

environment

variables

and

for

directory

notation.

When

using

the

Windows

command

line,

replace

$variable

with

%variable%

for

environment

variables

and

replace

each

forward

slash

(/)

with

a

backslash

(\)

in

directory

paths.

The

names

of

environment

variables

are

not

always

the

same

in

Windows

and

UNIX.

For

example,

%TEMP%

in

Windows

is

equivalent

to

$tmp

in

UNIX.

Note:

If

you

are

using

the

bash

shell

on

a

Windows

system,

you

can

use

the

UNIX

conventions.

Tivoli

command

syntax

The

following

special

characters

define

Tivoli

command

syntax:

[

]

Identifies

elements

that

are

optional.

Required

elements

do

not

have

brackets

around

them.

...

Indicates

that

you

can

specify

multiple

values

for

the

previous

element.

Separate

multiple

values

by

a

space,

unless

otherwise

directed

by

command

information.

If

the

ellipsis

for

an

element

follows

a

closing

bracket,

use

the

syntax

within

the

brackets

to

specify

multiple

values.

For

example,

to

specify

two

administrators

for

the

option

[–a

admin]...,

use

–a

admin1

–a

admin2.

If

the

ellipsis

for

an

element

is

within

the

brackets,

use

the

syntax

of

the

last

element

to

specify

multiple

values.

For

example,

to

specify

two

hosts

for

the

option

[–h

host...],

use

–h

host1

host2.

|

Indicates

mutually

exclusive

information.

You

can

use

the

element

on

either

the

left

or

right

of

the

vertical

bar.

{

}

Delimits

a

set

of

mutually

exclusive

elements

when

a

command

requires

one

of

them.

Brackets

([

])

are

around

elements

that

are

optional.

In

addition

to

the

special

characters,

Tivoli

command

syntax

uses

the

typeface

conventions

described

in

“Typeface

conventions”

on

page

xiv.

The

following

examples

illustrate

the

typeface

conventions

used

in

Tivoli

command

syntax:

v

wcrtpr

[–a

admin]...

[–s

region]

[–m

resource]...

name

The

name

argument

is

the

only

required

element

for

the

wcrtpr

command.

The

brackets

around

the

options

indicate

they

are

optional.

The

ellipsis

after

the

–a

admin

resource

option

means

that

you

can

specify

multiple

administrators

multiple

times.

The

ellipsis

after

the

–m

resource

option

means

that

you

can

specify

multiple

resources

multiple

times.v

wchkdb

[–o

outfile]

[–u]

[–x]

{–f

infile

|

–i

|

object...}

The

–f,

–i,

and

object

elements

are

mutually

exclusive.

Braces

that

surround

elements

indicate

that

you

are

including

a

required

element.

If

you

specify

the

object

argument,

you

can

specify

more

than

one

object.

About

this

guide

xv

xvi

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

Chapter

1.

Overview

This

guide

describes

installation

and

setup

of

IBM

Tivoli

Monitoring

for

Business

Integration,

monitoring

and

management

software

for

business-critical

hardware

and

software.

This

document

includes

information

on

the

following

topics:

v

Determining

the

proper

installation

for

your

environment

v

Overview

of

a

Tivoli

environment

v

Guidelines

and

worksheets

for

planning

your

installation

and

setup

v

Using

the

installation

wizard

(also

referred

to

in

this

document

as

the

installer)

to

evaluate

the

product

v

Using

the

installation

wizard

to

install

or

upgrade

the

product

in

a

production

environment

v

Using

the

Tivoli

desktop

or

command

line

to

install

or

upgrade

the

product

v

Using

the

Tivoli

desktop

or

command

line

to

expand

an

existing

Tivoli

environment

Choosing

an

installation

method

The

IBM

Tivoli

Monitoring

products

offer

several

options

for

installing

the

software,

depending

on

the

complexity

of

your

environment

and

your

knowledge

of

Tivoli

management

systems.

Your

choices

include

the

following:

Installation

wizard

The

installation

wizard

(also

referred

to

in

this

guide

as

the

installer)

installs

the

product

and

creates

a

Tivoli

environment

if

none

exists.

The

installer

also

installs

supplemental

software,

such

as

the

Java

runtime

environment

and

language

packs.

If

you

use

the

installer,

you

must

choose

between

a

Typical

or

Evaluation

installation

path.

Use

the

following

criteria

to

determine

which

path

you

want

to

take:

v

Use

the

Typical

installation

path

if

you

want

to

install

the

product

on

a

target

computer

that

matches

one

of

the

following

profiles:

–

Has

no

software

installed

for

the

Tivoli

Management

Framework

—OR—

–

Has

Tivoli

Management

Framework

Version

3.7.1

or

a

later

version

installed.

You

cannot

install

this

product

on

systems

that

run

previous

versions

of

the

Tivoli

Management

Framework.

The

Typical

installation

is

suitable

for

a

production

environment.

v

Use

the

Evaluation

installation

path

if

you

want

to

install

a

limited

Tivoli

environment

and

IBM

Tivoli

Monitoring

for

Business

Integration

on

one

computer

so

that

you

can

test

and

evaluate

the

product.

Use

the

Evaluation

installation

path

only

if

you

have

no

Tivoli

software

installed

on

the

computer.

The

Evaluation

installation

is

not

intended

for

use

in

a

production

environment.

Tivoli

desktop

or

command

line

interface

installation

Use

one

of

these

options

(both

referred

to

in

this

guide

as

a

manual

installation)

if

either

of

the

following

conditions

is

true:

©

Copyright

IBM

Corp.

2002,

2003

1

v

You

are

an

existing

Tivoli

user

with

a

version

of

the

Tivoli

Management

Framework

earlier

than

Version

3.7.1

—OR—

v

You

have

expert

knowledge

of

the

Tivoli

environment

and

plan

to

extensively

customize

your

installation.

The

manual

installation

method

enables

you

to

create

interconnected

Tivoli

management

regions

and

to

create

environments

with

more

than

50

endpoints.

Chapter

6,

“Installing

or

upgrading

the

product

manually

in

an

existing

Tivoli

environment,”

on

page

79

provides

manual

installation

instructions.

For

further

information,

see

the

documentation

for

Tivoli

Management

Framework,

available

with

IBM

Tivoli

Monitoring

for

Business

Integration.

Tivoli

Software

Installation

Service

Tivoli

Software

Installation

Service

(SIS)

can

install

multiple

Tivoli

products

on

multiple

systems

in

parallel.

This

Java™-based

product

can

install

more

products

on

more

systems

in

less

time

than

the

install

facility

of

Tivoli

Management

Framework.

SIS

performs

product

prerequisite

checks

and,

if

defined,

user-specified

prerequisite

checks,

ensuring

as

few

installation

failures

as

possible.

In

most

cases,

failures

occur

only

when

machines

are

turned

off

or

removed

from

the

network.

Tivoli

Software

Installation

Service

also

creates

an

installation

repository

into

which

you

can

import

the

installation

image

of

one

or

more

Tivoli

products.

You

can

import

only

those

interpreter

types

needed

in

your

environment,

which

saves

disk

space

and

import

time.

The

installation

repository

is

then

the

source

of

all

your

Tivoli

installations.

You

can

share

a

single

installation

repository

across

multiple

Tivoli

Management

Regions.

This

guide

does

not

cover

Tivoli

Software

Installation

Service.

For

instructions

on

how

to

install

Tivoli

Software

Installation

Service

in

your

Tivoli

environment

and

how

to

use

it

to

install

products,

refer

to

the

Tivoli

Software

Installation

Service

User’s

Guide.

Setting

up

Monitoring

for

WebSphere

MQ

and

WebSphere

MQ

Integrator

on

z/OS

The

Tivoli

Business

Systems

Manager

task

server

enables

communication

between

Tivoli

distributed

environments

and

z/OS

environments.

For

more

information

about

working

with

z/OS

systems,

see

Chapter

9,

“Installing

and

configuring

the

WebSphere

MQ

component

for

z/OS,”

on

page

131

and

Chapter

10,

“Installing

and

configuring

the

WebSphere

MQ

Integrator

component

for

z/OS,”

on

page

157.

The

task

server

is

a

component

of

Tivoli

Business

Systems

Manager

event

enablement.

Both

terms

(″task

server″

and

″Tivoli

Business

Systems

Manager

event

enablement″)

are

used

in

this

document

to

refer

to

the

software

that

enables

communication

between

Tivoli

distributed

environments

and

z/OS

environments.

Setting

up

Monitoring

for

WebSphere

MQ

on

OS/400

For

more

information

about

working

with

OS/400

systems,

see

Chapter

12,

“Setting

up

OS/400

endpoints

for

the

WebSphere

MQ

component,”

on

page

177.

2

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

Tivoli

monitoring

environment

A

basic

monitoring

solution

begins

with

a

set

of

core

monitoring

products.

You

can

extend

the

basic

monitoring

solution

with

additional

products

to

take

full

advantage

of

the

collected

performance

and

availability

data.

The

following

products

constitute

a

full

monitoring

solution:

Core

monitoring

products

v

Tivoli

Management

Framework

v

IBM

Tivoli

Monitoring

Additional

products

to

extend

monitoring

capabilities

and

collected

data

v

Tivoli

Enterprise

Console

v

IBM

Tivoli

Monitoring

Web

Health

Console

v

Tivoli

Enterprise

Data

Warehouse

v

IBM

Tivoli

Monitoring

Resource

Model

Builder

v

Tivoli

Business

Systems

Manager

The

additional

products

use

components

that

are

installed

on

the

Tivoli®

server

and

gateways

to

link

with

IBM

Tivoli

Monitoring

on

the

endpoint.

The

IBM

Tivoli

Monitoring

and

Web

Health

Console

components

are

automatically

enabled

on

the

endpoints

at

the

first

profile

distribution.

Tivoli

management

region

A

Tivoli

region

contains

three

tiers

of

resources:

the

Tivoli

server,

managed

nodes

and

gateways,

and

endpoints.

Chapter

1.

Overview

3

In

a

Tivoli

environment,

a

managed

resource

is

a

database

object

that

represents

a

system

or

network

resource

and

is

governed

by

policies.

A

resource

is

a

hardware,

software,

or

data

entity

that

is

managed

by

Tivoli

software.

Anything

that

affects

the

operation

of

a

computer

system

is

a

resource,

for

example,

physical

and

logical

disks,

CPUs,

memory,

printers,

processes

that

are

running,

and

service

such

as

LanMan,

Windows®

event

log,

UNIX®

syslogd

(logging

system

daemon),

and

TCP/IP.

Tivoli

management

region

server

Tivoli

Management

Framework

software

provides

the

base

component

for

Tivoli

products.

The

computer

in

which

this

software

is

installed

becomes

the

Tivoli

management

region

server.

The

Tivoli

server

includes

the

libraries,

binaries,

data

files,

and

the

graphical

user

interface

(GUI)

(the

Tivoli

desktop)

that

are

required

to

install

and

manage

your

Tivoli

environment.

See

“1-

Tivoli

Management

Framework”

on

page

6

for

more

information.

Managed

nodes

A

managed

node

runs

the

same

software

that

runs

on

a

Tivoli

server.

Managed

nodes

maintain

their

own

object

databases

that

can

be

accessed

by

the

Tivoli

server.

When

managed

nodes

communicate

directly

with

other

managed

nodes,

they

perform

the

same

communication

or

security

operations

that

the

Tivoli

server

performs.

The

difference

between

a

Tivoli

server

and

a

managed

node

is

that

the

Tivoli

server

object

database

is

global

to

the

entire

region

including

all

managed

nodes.

In

contrast,

the

managed

node

database

is

local

to

the

particular

managed

node.

IBM

Tivoli

Monitoring

for

Web

Infrastructure:

WebSphere

Application

Server

uses

two

types

of

endpoints:

local

endpoints

and

proxy

endpoints.

A

local

endpoint

represents

an

IBM®

WebSphere®

server

resources

running

on

a

non-z/OS

platform,

such

as

Windows

or

AIX®.

A

proxy

endpoint

is

a

non-z/OS

system

that

communicates

with

an

IBM

WebSphere

server

resource

running

on

a

z/OS®

system.

To

manage

IBM

WebSphere

Application

Server

resources

on

local

endpoints,

the

Tivoli

endpoint

must

be

installed

on

each

IBM

WebSphere

Application

Server

node.

For

z/OS

systems,

the

proxy

endpoint

must

be

installed

on

a

separate

system

from

z/OS.

Note:

In

the

Tivoli

environment,

the

term

node

is

used

to

refer

to

any

managed

resource

with

Tivoli

Management

Framework

installed.

In

the

WebSphere

environment,

the

term

node

is

used

to

refer

to

the

IBM

WebSphere

server

resources.

In

this

document,

unless

specifically

indicated,

the

Tivoli

environment

definition

of

node

is

used.

Gateways

A

gateway

controls

communication

and

operations

with

endpoints.

Each

gateway

can

support

thousands

of

endpoints.

A

gateway

can

launch

methods

on

an

endpoint

or

run

methods

on

behalf

of

the

endpoint.

A

gateway

is

generally

created

on

an

existing

managed

node.

This

managed

node

provides

access

to

the

endpoint

methods

and

provides

the

communication

with

the

Tivoli

server

that

the

endpoints

occasionally

require.

Endpoints

4

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

Endpoints

communicate

with

the

Tivoli

management

region

through

assigned

gateways.

An

endpoint

can

be

created

on

UNIX

or

PC

operating

systems,

including

Windows

NetWare

and

OS/2®.

An

endpoint

runs

the

IBM

Tivoli

Monitoring

engine.

See

“7-

Endpoints”

on

page

13

for

more

information

about

endpoints.

Chapter

1.

Overview

5

Components

of

a

Tivoli

monitoring

environment

A

Tivoli

monitoring

environment

consists

of

the

following

components:

1.

Tivoli

Management

Framework

2.

Tivoli

Enterprise

Console

3.

RIM

database

4.

IBM

Tivoli

Monitoring

5.

IBM

Tivoli

Monitoring

Web

Health

Console

6.

Profile

(resource

models)

7.

Endpoints

8.

Tivoli

Enterprise

Data

Warehouse

9.

IBM

Tivoli

Monitoring

Resource

Model

Builder

10.

Tivoli

Business

Systems

Manager

The

following

sections

provide

descriptions

of

the

components

in

the

Tivoli

monitoring

environment.

1-

Tivoli

Management

Framework

(Requires

separate

installation)

Tivoli

Management

Framework

is

the

base

component

for

Tivoli

products.

Using

Tivoli

Management

Framework

and

a

combination

of

Tivoli

software,

you

can

manage

large

distributed

networks

with

multiple

operating

systems,

various

network

services,

diverse

system

operations,

and

constantly

changing

nodes

and

users.

6

IBM

Tivoli

Monitoring

for

Business

Integration:

Installation

and

Setup

Guide

The

Tivoli

Management

Framework

function

in

your

IBM

Tivoli

Monitoring

software

is

installed

in

your

Tivoli

management

region

or

on

your

Tivoli

management

region

server.

When

installed,

you

have

the

following

tools

for

managing

your

resources:

Policy

regions

The

policy

region

is

the

entry

point

into

the

management

functions

for

your

software

installations.

It

is

installed

on

your

administrator

desktop.

Task

libraries

Each

IBM

Tivoli

Monitoring

software

contains

two

or

more

task

libraries.

The

name

of

each

task

library

indicates

the

type

of

tasks

that

the

task

library

contains.

For

example,

configuration

task

libraries

contain

tasks

that

support

the

discovery

and

Tivoli

configuration

functions.

Operations

task

libraries

contains

tasks

that

support

the

daily

operations

for

managing

resources.

Profile

managers

A

profile

manager

contains

resource

model

profiles

for

monitoring

your

resources.

Profiles

A

profile

contains

the

resource

models

for

monitoring

your

resources.

See

also

10

and

“6-

Profile

(resource

models)”

on

page

12.

Resource

models

The

resource

models

provide

best

practices

monitoring

functions

for

your

resources.

Tivoli

Enterprise

Console

event

classes

and

rules

The

event

classes

and

rules

provide

a

set

of

event

definitions

for

viewing

changes

on

your

Tivoli

Enterprise

Console

console,

and

provide

a

set

of

rules

that

aggregate

and

consolidate

events

to

minimize

Tivoli

Enterprise

Console

event

traffic.

Icons

for

resources

Icons

represent

various

resources

in

your

software.

The

icons

graphically

show

the

current

state

of

a

resource.

Context

menus

from

which

you

can

easily

access

the

functions

required

to

manage

a

resource

are

available

using

the

following

icons:

v

Software

icon

on

your

administrator

desktop

v

Resource

icons,

one

icon

for

each

resource

or

object

being

managed

2-

Tivoli

Enterprise

Console

(Requires

separate

installation)

Chapter

1.

Overview

7

Tivoli

Enterprise

Console

is

a

rules-based

event

management

application

that

collects,

processes,

and

automatically

responds

to

events.

You

can

install

Tivoli

Enterprise

Console

on

the

server

or

any

managed

node

or

gateway

within

the

Tivoli

management

region.

When

you

install

an

endpoint,

you

can

enable

the

sending

of

events

generated

by

IBM

Tivoli

Monitoring

applications

to

the

Tivoli

Enterprise

Console.

You

can

the

enable

sending

of

events

either

through

a

Tivoli

environment,

which

enables

you

to

take

advantage

of

multiple

Tivoli

Enterprise

Console

servers,

or

directly

to

a

specific

Tivoli

Enterprise

Console

server.

Tivoli

Enterprise

Console

event

classes

and

rules

provide

a

set

of

event

definitions

for

viewing

changes