ibm tivoli service level...

250
IBM Tivoli Service Level Advisor Getting Started Version 2.1 SC32-0834-03

Upload: phamtu

Post on 18-Jun-2018

226 views

Category:

Documents


0 download

TRANSCRIPT

  • IBM

    Tivoli

    Service

    Level

    Advisor

    Getting

    Started

    Version

    2.1

    SC32-0834-03

  • IBM

    Tivoli

    Service

    Level

    Advisor

    Getting

    Started

    Version

    2.1

    SC32-0834-03

  • Fourth

    Edition

    (September

    2004)

    This

    edition

    applies

    to

    Version

    2.1

    of

    IBM

    Tivoli

    Service

    Level

    Advisor

    (program

    number

    5724C40)

    and

    to

    all

    subsequent

    releases

    and

    modifications

    until

    otherwise

    indicated

    in

    new

    editions.

    Copyright

    International

    Business

    Machines

    Corporation

    2002,

    2004.

    All

    rights

    reserved.

    US

    Government

    Users

    Restricted

    Rights

    Use,

    duplication

    or

    disclosure

    restricted

    by

    GSA

    ADP

    Schedule

    Contract

    with

    IBM

    Corp.

  • Contents

    Preface

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . vii

    Who

    should

    read

    this

    guide

    .

    .

    .

    .

    .

    .

    .

    .

    . vii

    Publications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . vii

    IBM

    Tivoli

    Service

    Level

    Advisor

    library

    .

    .

    . vii

    IBM

    DB2

    Universal

    Database

    Enterprise

    Edition

    library

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . ix

    Tivoli

    Data

    Warehouse

    library

    .

    .

    .

    .

    .

    .

    . ix

    Warehouse

    Enablement

    Packs

    .

    .

    .

    .

    .

    .

    . ix

    IBM

    WebSphere

    Application

    Server

    library

    .

    .

    . ix

    SLM

    Administrative

    Console

    Information

    .

    .

    .

    . x

    Related

    publications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . x

    Accessing

    Publications

    Online

    .

    .

    .

    .

    .

    .

    .

    . x

    Ordering

    publications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . x

    Accessibility

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xi

    Tivoli

    technical

    training

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xi

    Contacting

    IBM

    Software

    Support

    .

    .

    .

    .

    .

    .

    . xi

    Determine

    the

    business

    impact

    of

    your

    problem

    xii

    Describe

    your

    problem

    and

    gather

    background

    information

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xii

    Submit

    your

    problem

    to

    IBM

    Software

    Support

    xii

    Searching

    knowledge

    bases

    .

    .

    .

    .

    .

    .

    .

    . xiii

    Obtaining

    fixes

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xiii

    Updating

    support

    information

    .

    .

    .

    .

    .

    .

    . xiv

    Participating

    in

    newsgroups

    .

    .

    .

    .

    .

    .

    .

    . xiv

    Conventions

    used

    in

    this

    guide

    .

    .

    .

    .

    .

    .

    .

    . xv

    Typeface

    conventions

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xv

    Operating

    system-dependent

    variables

    and

    paths

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xvi

    Chapter

    1.

    Introduction

    .

    .

    .

    .

    .

    .

    .

    . 1

    What

    is

    IBM

    Tivoli

    Service

    Level

    Advisor?

    .

    .

    .

    . 1

    How

    IBM

    Tivoli

    Service

    Level

    Advisor

    Works

    .

    .

    . 2

    IBM

    Tivoli

    Service

    Level

    Advisor

    in

    the

    Enterprise

    . 3

    Inside

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    . 4

    The

    SLM

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 5

    SLM

    Reports

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 5

    SLM

    Administration

    Server

    .

    .

    .

    .

    .

    .

    .

    . 6

    IBM

    Tivoli

    Service

    Level

    Advisor

    Databases

    .

    .

    .

    . 6

    The

    Central

    Data

    Warehouse

    Database

    .

    .

    .

    .

    . 6

    The

    SLM

    Database

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 6

    The

    SLM

    Measurement

    Data

    Mart

    .

    .

    .

    .

    .

    . 7

    Chapter

    2.

    Planning

    Decisions

    .

    .

    .

    .

    . 9

    Components

    of

    an

    SLM

    Deployment

    .

    .

    .

    .

    .

    . 9

    Tivoli

    Data

    Warehouse

    Components

    .

    .

    .

    .

    . 9

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 11

    IBM

    Tivoli

    Service

    Level

    Advisor

    Components

    . 12

    Deploying

    the

    SLM

    Solution

    in

    Your

    Enterprise

    12

    Deployment

    Options

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 17

    Selecting

    Port

    Numbers

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 21

    Coexistence

    with

    Other

    DB2

    Database

    Applications

    24

    Information

    to

    Gather

    Before

    Installing

    .

    .

    .

    .

    . 25

    Information

    for

    All

    Installations

    .

    .

    .

    .

    .

    . 25

    Additional

    Information

    for

    Single

    System

    Installations

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 30

    Additional

    Information

    for

    Distributed

    Installations

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 30

    Planning

    for

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    . 32

    Chapter

    3.

    Prerequisite

    Software

    .

    .

    . 35

    Upgrading

    From

    Previous

    Versions

    .

    .

    .

    .

    .

    . 38

    Considerations

    for

    Installing

    DB2

    Universal

    Database

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 38

    Reading

    the

    Documentation

    .

    .

    .

    .

    .

    .

    .

    . 39

    Installing

    DB2

    Server

    or

    Client

    .

    .

    .

    .

    .

    .

    . 39

    Considerations

    for

    Databases

    .

    .

    .

    .

    .

    .

    . 40

    Installing

    DB2

    Universal

    Database

    on

    UNIX

    Systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 41

    Installing

    DB2

    Universal

    Database

    on

    Red

    Hat

    3.0

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 41

    Connecting

    a

    Database

    on

    DB2

    7.2

    Server

    to

    a

    DB2

    8.1

    Client

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 42

    Updating

    the

    JDBC

    Level

    for

    DB2

    Universal

    Database

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 42

    Configuring

    the

    Database

    Manager

    to

    use

    Extended

    Shared

    Memory

    .

    .

    .

    .

    .

    .

    .

    . 42

    Considerations

    for

    Installing

    Tivoli

    Data

    Warehouse

    43

    Considerations

    for

    Configuring

    an

    Environment

    with

    Multiple

    Central

    Data

    Warehouse

    Databases

    43

    Upgrading

    Tivoli

    Enterprise

    Data

    Warehouse

    1.1

    to

    Fix

    Pack

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 44

    Installing

    Source

    Application

    Warehouse

    Packs

    .

    . 44

    Installing

    IBM

    WebSphere

    Application

    Server

    .

    .

    . 45

    Considerations

    for

    Installing

    IBM

    WebSphere

    Application

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 45

    Chapter

    4.

    Installing

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 49

    Before

    Installing

    IBM

    Tivoli

    Service

    Level

    Advisor

    49

    Starting

    the

    LaunchPad

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 51

    Creating

    Databases

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 52

    Step

    1.

    Select

    the

    Databases

    to

    be

    Created

    .

    .

    . 53

    Step

    2.

    Specify

    Whether

    Databases

    are

    Local

    or

    Remote

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 53

    Step

    3.

    Creating

    the

    Databases

    .

    .

    .

    .

    .

    .

    . 59

    Step

    4.

    Checking

    Database

    Creation

    Logs

    and

    Tables

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 60

    Step

    5.

    Creating

    a

    Temporary

    Database

    and

    Tablespace

    for

    Databases

    on

    z/OS

    Systems

    .

    .

    . 60

    Installing

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Product

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 61

    Step

    1.

    Select

    the

    Language

    for

    the

    Installation

    . 62

    Step

    2.

    Accept

    the

    Software

    License

    Agreement

    62

    Step

    3.

    Specify

    the

    Tivoli

    Common

    Directory

    .

    . 63

    Step

    4.

    Select

    Installation

    Options

    .

    .

    .

    .

    .

    . 64

    Step

    5.

    Specify

    the

    Destination

    Directory

    .

    .

    . 65

    Step

    6.

    Select

    SLM

    Installation

    Options

    .

    .

    .

    . 66

    Step

    7.

    Verify

    Prerequisite

    Software

    .

    .

    .

    .

    . 67

    Step

    8.

    Configure

    for

    SLM

    Database

    Access

    .

    .

    . 68

    Step

    9.

    Specify

    Additional

    Server

    Configuration

    69

    Copyright

    IBM

    Corp.

    2002,

    2004

    iii

  • Step

    10.

    Specify

    Event

    Notification

    Methods

    .

    . 71

    Step

    11.

    Define

    SLM

    Administrator

    Authority

    and

    SLM

    Reports

    Access

    .

    .

    .

    .

    .

    .

    .

    .

    . 77

    Step

    12.

    Decide

    Whether

    or

    not

    to

    Compile

    JavaServer

    Page

    Files

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 77

    Step

    13.

    Optionally

    Configure

    Language

    Support

    Installation

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 79

    Step

    14.

    Confirm

    Your

    Installation

    Options

    .

    .

    . 80

    Step

    15.

    Complete

    the

    Installation

    .

    .

    .

    .

    .

    . 81

    Additional

    Installation

    Tasks

    .

    .

    .

    .

    .

    .

    .

    .

    . 84

    Chapter

    5.

    Additional

    Installation

    Tasks

    87

    Regenerating

    Web

    Server

    Plug-in

    Configurations

    .

    . 87

    Configuring

    ODBC

    Data

    Sources

    .

    .

    .

    .

    .

    .

    . 88

    Configuring

    ODBC

    Data

    Sources

    for

    Distributed

    Environments

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 88

    Additional

    ODBC

    Data

    Source

    Configuration

    Methods

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 89

    Verifying

    ODBC

    Configuration

    .

    .

    .

    .

    .

    .

    . 89

    Installing

    the

    Target

    Warehouse

    Enablement

    Pack

    . 89

    Installing

    the

    Target

    Warehouse

    Pack

    for

    the

    Tivoli

    Data

    Warehouse

    1.2

    Environment

    .

    .

    .

    . 90

    Installing

    the

    Target

    Warehouse

    Pack

    for

    the

    Tivoli

    Enterprise

    Data

    Warehouse

    1.1

    Environment

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 92

    Configuring

    the

    User

    ID

    and

    Password

    .

    .

    .

    . 93

    Enabling

    Data

    Collection

    for

    Source

    Applications

    95

    Configuring

    for

    Multiple

    Central

    Data

    Warehouses

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 99

    Configuring

    Target

    ETL

    Table

    Translation

    Information

    for

    SLM

    Databases

    on

    z/OS

    .

    .

    . 100

    Configuring

    ETLs

    for

    Production

    Mode

    .

    .

    . 101

    Running

    the

    Registration

    ETL

    and

    Process

    ETL

    103

    Registering

    Warehouse

    Data

    .

    .

    .

    .

    .

    .

    . 104

    Installing

    the

    Source

    Warehouse

    Pack

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    . 105

    Configuring

    Source

    ETL

    Table

    Translation

    Information

    for

    the

    SLM

    Database

    on

    z/OS

    Operating

    Systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 106

    Configuring

    for

    Event

    Notification

    .

    .

    .

    .

    .

    . 107

    Configuring

    for

    Notification

    by

    SNMP

    .

    .

    .

    . 107

    Configuring

    for

    Notification

    by

    Tivoli

    Enterprise

    Console

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 108

    Verifying

    Notification

    Methods

    .

    .

    .

    .

    .

    . 108

    Installing

    Language

    Support

    .

    .

    .

    .

    .

    .

    .

    . 109

    Viewing

    Reports

    in

    Double

    Byte

    Character

    Languages

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 111

    Associating

    System

    Users

    with

    IBM

    Tivoli

    Service

    Level

    Advisor

    Roles

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 112

    Restarting

    the

    WebSphere

    Application

    Server

    .

    .

    . 112

    Chapter

    6.

    Startup

    and

    Shutdown

    Procedures

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 115

    Starting

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Solution

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 115

    Starting

    IBM

    WebSphere

    Application

    Server

    .

    . 115

    Starting

    the

    IBM

    HTTP

    Services

    .

    .

    .

    .

    .

    . 116

    Starting

    the

    WebSphere

    Administrative

    Console

    116

    Starting

    the

    SLM

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    . 117

    Starting

    the

    SLM

    Administrative

    Console

    .

    .

    . 117

    Starting

    the

    SLM

    Reports

    Console

    .

    .

    .

    .

    . 118

    Shutting

    Down

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Solution

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 119

    Shutting

    Down

    the

    SLM

    Administrative

    Console

    119

    Shutting

    Down

    the

    SLM

    Reports

    Console

    .

    .

    . 119

    Shutting

    Down

    the

    SLM

    Server

    .

    .

    .

    .

    .

    . 119

    Stopping

    IBM

    HTTP

    Services

    .

    .

    .

    .

    .

    .

    . 119

    Stopping

    IBM

    WebSphere

    Application

    Server

    120

    Chapter

    7.

    Uninstalling

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    . 121

    Considerations

    Before

    Uninstalling

    .

    .

    .

    .

    .

    . 121

    Running

    the

    Uninstallation

    Program

    .

    .

    .

    .

    .

    . 122

    Uninstalling

    the

    Target

    and

    Source

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 123

    Uninstalling

    SLM

    Databases

    .

    .

    .

    .

    .

    .

    .

    . 124

    Uninstalling

    the

    Databases

    .

    .

    .

    .

    .

    .

    .

    . 125

    Removing

    ODBC

    Datasources

    .

    .

    .

    .

    .

    .

    . 125

    Appendix

    A.

    A

    Quick

    Start

    Installation

    Example

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 127

    Installation

    Assumptions

    .

    .

    .

    .

    .

    .

    .

    .

    . 128

    Planning

    Worksheets

    for

    this

    Installation

    .

    .

    .

    . 130

    Step

    1.

    Installing

    DB2

    Universal

    Database

    Server

    130

    Step

    2.

    Installing

    IBM

    WebSphere

    Application

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 131

    Upgrading

    WebSphere

    to

    Version

    5.1.0.5

    .

    .

    . 132

    Enabling

    WebSphere

    Security

    .

    .

    .

    .

    .

    .

    . 132

    Step

    3.

    Installing

    Crystal

    Enterprise

    .

    .

    .

    .

    .

    . 133

    Step

    4.

    Installing

    Tivoli

    Data

    Warehouse

    .

    .

    .

    . 134

    Step

    5.

    Installing

    Source

    Application

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 134

    Step

    6.

    Creating

    Databases

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 134

    Step

    7.

    Installing

    IBM

    Tivoli

    Service

    Level

    Advisor

    135

    Step

    8.

    Configuring

    ODBC

    Data

    Sources

    .

    .

    .

    . 137

    Step

    9.

    Installing

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Target

    Warehouse

    Pack

    .

    .

    .

    .

    .

    .

    . 137

    Step

    10.

    Configuring

    the

    User

    ID

    and

    Password

    137

    Step

    11.

    Enabling

    Data

    Collection

    for

    Source

    Applications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 138

    Step

    12.

    Configuring

    ETLs

    for

    Production

    Mode

    138

    Step

    13.

    Running

    the

    Registration

    and

    Process

    ETLs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 138

    Step

    14.

    Registering

    Warehouse

    Data

    .

    .

    .

    .

    . 138

    Step

    15.

    Additional

    Optional

    Configuration

    .

    .

    . 138

    Step

    16.

    Restarting

    WebSphere

    Application

    Server

    139

    Accessing

    the

    SLM

    Administrative

    Console

    .

    .

    . 139

    Accessing

    SLM

    Reports

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 139

    Appendix

    B.

    A

    Two-Machine

    Distributed

    Installation

    Example

    .

    .

    . 141

    The

    Warehouse

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 141

    The

    SLM

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 142

    Installation

    Assumptions

    .

    .

    .

    .

    .

    .

    .

    .

    . 142

    Planning

    Worksheets

    for

    this

    Installation

    .

    .

    .

    . 144

    Step

    1.

    Installing

    DB2

    Universal

    Database

    Server

    145

    Step

    2.

    Installing

    Crystal

    Enterprise

    .

    .

    .

    .

    .

    . 146

    Step

    3.

    Installing

    Tivoli

    Data

    Warehouse

    .

    .

    .

    . 146

    iv

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

  • Step

    4.

    Installing

    Source

    Application

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 147

    Step

    5.

    Installing

    IBM

    WebSphere

    Application

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 147

    Upgrading

    WebSphere

    to

    Version

    5.1.0.5

    .

    .

    . 148

    Enabling

    WebSphere

    Security

    .

    .

    .

    .

    .

    .

    . 148

    Step

    6.

    Creating

    Databases

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 148

    Step

    7.

    Installing

    IBM

    Tivoli

    Service

    Level

    Advisor

    149

    Step

    8.

    Configuring

    ODBC

    Data

    Sources

    .

    .

    .

    . 151

    Step

    9.

    Installing

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Target

    Warehouse

    Pack

    .

    .

    .

    .

    .

    .

    . 151

    Step

    10.

    Configuring

    the

    User

    ID

    and

    Password

    151

    Step

    11.

    Enabling

    Data

    Collection

    for

    Source

    Applications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 152

    Step

    12.

    Configuring

    ETLs

    for

    Production

    Mode

    152

    Step

    13.

    Running

    the

    Registration

    and

    Process

    ETLs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 152

    Step

    14.

    Registering

    Warehouse

    Data

    .

    .

    .

    .

    . 152

    Step

    15.

    Additional

    Optional

    Configuration

    .

    .

    . 152

    Step

    16.

    Restarting

    WebSphere

    Application

    Server

    153

    Accessing

    the

    SLM

    Administrative

    Console

    .

    .

    . 153

    Accessing

    SLM

    Reports

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 153

    Appendix

    C.

    A

    Three-Machine

    Distributed

    Installation

    Example

    .

    .

    . 155

    Installation

    Assumptions

    .

    .

    .

    .

    .

    .

    .

    .

    . 156

    Appendix

    D.

    A

    Four-Machine

    Distributed

    Installation

    Example

    .

    .

    . 157

    The

    Warehouse

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 158

    The

    Crystal

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 158

    The

    Database

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 158

    The

    SLM

    Machine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 159

    Installation

    Assumptions

    .

    .

    .

    .

    .

    .

    .

    .

    . 160

    Planning

    Worksheets

    for

    this

    Installation

    .

    .

    .

    . 162

    Step

    1.

    Installing

    DB2

    Universal

    Database

    Server

    and

    Client

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 162

    Step

    2.

    Installing

    Crystal

    Enterprise

    .

    .

    .

    .

    .

    . 163

    Step

    3.

    Installing

    Tivoli

    Data

    Warehouse

    .

    .

    .

    . 164

    Step

    4.

    Installing

    Source

    Application

    Warehouse

    Packs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 165

    Step

    5.

    Installing

    IBM

    WebSphere

    Application

    Server

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 165

    Upgrading

    WebSphere

    to

    Version

    5.1.0.5

    .

    .

    . 166

    Enabling

    WebSphere

    Security

    .

    .

    .

    .

    .

    .

    . 166

    Step

    6.

    Creating

    Databases

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 166

    Step

    7.

    Installing

    IBM

    Tivoli

    Service

    Level

    Advisor

    167

    Step

    8.

    Configuring

    ODBC

    Data

    Sources

    .

    .

    .

    . 169

    Step

    9.

    Installing

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Target

    Warehouse

    Pack

    .

    .

    .

    .

    .

    .

    . 170

    Step

    10.

    Configuring

    the

    User

    ID

    and

    Password

    170

    Step

    11.

    Enabling

    Data

    Collection

    for

    Source

    Applications

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 170

    Step

    12.

    Configuring

    ETLs

    for

    Production

    Mode

    170

    Step

    13.

    Running

    the

    Registration

    and

    Process

    ETLs

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 170

    Step

    14.

    Registering

    Warehouse

    Data

    .

    .

    .

    .

    . 171

    Step

    15.

    Additional

    Optional

    Configuration

    .

    .

    . 171

    Step

    16.

    Restarting

    WebSphere

    Application

    Server

    171

    Accessing

    the

    SLM

    Administrative

    Console

    .

    .

    . 171

    Accessing

    SLM

    Reports

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 172

    Appendix

    E.

    Database

    Creation

    Tables

    173

    Tables

    Created

    in

    dyk_cat

    .

    .

    .

    .

    .

    .

    .

    .

    . 173

    Tables

    Created

    in

    dyk_dm

    .

    .

    .

    .

    .

    .

    .

    .

    . 175

    Appendix

    F.

    Manually

    Creating

    ODBC

    Data

    Sources

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 177

    Editing

    the

    Script

    Files

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 177

    Using

    the

    Windows

    Control

    Panel

    Administrative

    Tool

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 177

    Using

    DB2

    Commands

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 178

    Creating

    ODBC

    Data

    Sources

    for

    Remote

    SLM

    Databases

    on

    z/OS

    Operating

    Systems

    .

    .

    .

    .

    . 180

    Verifying

    ODBC

    Configuration

    .

    .

    .

    .

    .

    .

    . 181

    Appendix

    G.

    Installation

    Hints

    and

    Tips

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 183

    Starting

    a

    DB2

    Command

    Prompt

    .

    .

    .

    .

    .

    . 183

    Starting

    a

    DB2

    Command

    Prompt

    on

    Windows

    Systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 183

    Sourcing

    the

    db2profile

    on

    UNIX

    .

    .

    .

    .

    .

    . 183

    Verifying

    the

    Root

    User

    Authority

    in

    a

    DB2

    environment

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 184

    Ensuring

    User

    Rights

    Authority

    for

    Database

    Creation

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 184

    Ensuring

    fully

    qualified

    hostnames

    .

    .

    .

    .

    .

    . 186

    On

    AIX

    systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 186

    On

    Linux

    systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 186

    On

    Solaris

    systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 187

    On

    HP

    systems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 187

    On

    Microsoft

    Windows

    NT

    systems

    .

    .

    .

    .

    . 187

    On

    Windows

    2000

    systems

    .

    .

    .

    .

    .

    .

    .

    . 187

    Mounting

    the

    CD-ROM

    on

    UNIX

    Systems

    .

    .

    .

    . 188

    Checking

    the

    version

    of

    an

    existing

    DB2

    installation

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 188

    Verifying

    your

    DB2

    Universal

    Database

    Installation

    189

    Updating

    the

    JDBC

    Level

    for

    DB2

    .

    .

    .

    .

    .

    . 189

    Verifying

    the

    JDBC

    Level

    .

    .

    .

    .

    .

    .

    .

    . 189

    Updating

    the

    JDBC

    Level

    Manually

    .

    .

    .

    .

    . 190

    Configuring

    the

    Database

    Manager

    to

    use

    Extended

    Shared

    Memory

    .

    .

    .

    .

    .

    .

    .

    .

    . 190

    Installing

    Tivoli

    Enterprise

    Data

    Warehouse

    1.1

    Fix

    Pack

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 191

    Resolving

    port

    conflicts

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 192

    Creating

    Distributed

    SLM

    Databases

    Manually

    .

    . 192

    Creating

    SLM

    Databases

    on

    Windows

    Systems

    192

    Creating

    SLM

    Databases

    on

    UNIX

    Systems

    .

    . 193

    Checking

    Database

    Creation

    Log

    Files

    .

    .

    .

    . 194

    Modifying

    Configuration

    Parameters

    After

    Creating

    Databases

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 195

    Connecting

    a

    DB2

    7.2

    Database

    with

    a

    DB2

    8.1

    Client

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 196

    Performing

    a

    Silent

    Installation

    of

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 197

    Contents

    v

  • Appendix

    H.

    Upgrading

    From

    Previous

    Versions

    of

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    . 199

    Tasks

    to

    Complete

    Before

    Upgrading

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 202

    Running

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Upgrade

    Program

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 204

    Tasks

    to

    Complete

    After

    Upgrading

    IBM

    Tivoli

    Service

    Level

    Advisor

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 205

    Step

    1.

    Verify

    database

    upgrade

    and

    complete

    manually

    if

    needed

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 205

    Step

    2.

    Install

    the

    new

    SLM

    Administration

    Server

    Option

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 207

    Step

    3.

    Migrate

    users

    from

    the

    previous

    version

    208

    Step

    4.

    Ensure

    the

    correct

    version

    of

    the

    db2java.zip

    file

    is

    being

    used

    .

    .

    .

    .

    .

    .

    . 209

    Step

    5.

    Install

    the

    Target

    Warehouse

    Pack

    .

    .

    . 210

    Step

    6.

    Configure

    warehouse

    pack

    user

    ID

    and

    password

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 211

    Step

    7.

    Manually

    run

    special

    ETL

    upgrade

    steps

    211

    Step

    8.

    Schedule

    target

    ETLs

    and

    promote

    to

    production

    mode

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 211

    Step

    9.

    Restore

    customization

    of

    JSP

    Files

    .

    .

    . 211

    Step

    10.

    Update

    notification

    configuration,

    if

    needed

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 212

    Step

    11.

    Recreate

    filtering

    and

    sorting

    preferences

    for

    Manage

    pages

    .

    .

    .

    .

    .

    .

    . 212

    Step

    12.

    Optionally

    install

    language

    support

    .

    . 212

    Step

    13.

    Search

    the

    log

    file

    for

    a

    single

    date

    message

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 212

    Step

    14.

    Search

    the

    log

    file

    for

    unsupported

    time

    zone

    message

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 213

    Step

    15.

    Check

    Quarterly

    Dates

    .

    .

    .

    .

    .

    . 214

    Step

    16.

    Restart

    the

    servers

    .

    .

    .

    .

    .

    .

    .

    . 214

    Appendix

    I.

    IBM

    Tivoli

    Business

    Systems

    Management

    solution

    .

    .

    .

    . 215

    Integration

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 215

    Designing

    Your

    Solution

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 216

    Understanding

    the

    Product

    Set

    .

    .

    .

    .

    .

    .

    . 217

    Products

    in

    the

    Business

    Impact

    Management

    Layer

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 217

    Products

    in

    the

    Event

    Correlation

    and

    Automation

    Layer

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 219

    Products

    in

    the

    Monitoring

    Systems

    and

    Applications

    Layer

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 220

    Appendix

    J.

    Notices

    .

    .

    .

    .

    .

    .

    .

    . 223

    Trademarks

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 225

    Index

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 227

    vi

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

  • Preface

    IBM

    Tivoli

    Service

    Level

    Advisor

    :

    Getting

    Started

    provides

    information

    about

    the

    IBM

    Tivoli

    service

    level

    management

    (SLM)

    software

    solution,

    and

    provides

    step-by-step

    instructions

    for

    installing

    and

    configuring

    IBM

    Tivoli

    Service

    Level

    Advisor,

    including

    references

    to

    the

    installation

    procedures

    for

    supporting

    applications.

    Who

    should

    read

    this

    guide

    This

    document

    is

    written

    for

    systems

    administrators

    and

    IBM

    support

    personnel

    who

    plan

    to

    install,

    configure,

    and

    integrate

    IBM

    Tivoli

    Service

    Level

    Advisor

    and

    its

    supporting

    applications

    in

    the

    enterprise

    environment.

    You

    should

    be

    familiar

    with

    planning,

    installing,

    and

    configuring

    distributed

    systems

    management

    software,

    and

    be

    somewhat

    familiar

    with

    the

    business

    objectives

    associated

    with

    Tivolis

    service

    level

    management

    solution.

    You

    should

    also

    be

    familiar

    with

    the

    following

    topics:

    v

    Knowledge

    of

    IBM

    DB2

    Universal

    Database

    Enterprise

    Edition

    software

    ,

    in

    the

    areas

    of

    installing

    and

    configuring

    servers

    and

    clients,

    creating

    multiple

    instances,

    cataloging

    databases,

    and

    performing

    backup

    and

    restore

    operations

    to

    protect

    your

    database

    resources.

    v

    The

    IBM

    data

    warehouse

    strategy,

    including

    installation

    and

    configuration

    of

    Tivoli

    Data

    Warehouse.

    v

    Supported

    IBM

    Tivoli

    software

    applications

    that

    are

    enabled

    for

    putting

    data

    into

    the

    Tivoli

    Data

    Warehouse

    (see

    the

    Release

    Notes

    for

    information

    on

    supported

    IBM

    Tivoli

    software

    applications)

    v

    Familiarity

    with

    installing

    and

    configuring

    the

    extract,

    transform,

    and

    load

    (ETL)

    processes,

    provided

    in

    warehouse

    enablement

    packs

    that

    are

    associated

    with

    the

    applications

    that

    put

    data

    into

    Tivoli

    Data

    Warehouse.

    v

    IBM

    WebSphere

    Application

    Server,

    in

    the

    areas

    of

    installing,

    configuring,

    and

    starting

    and

    stopping

    the

    WebSphere

    Application

    Server

    and

    the

    WebSphere

    Administrative

    Console

    v

    The

    z/OS

    environment,

    if

    you

    plan

    to

    create

    and

    maintain

    SLM

    databases

    on

    a

    z/OS

    operating

    system

    v

    HTML

    concepts

    for

    customizing

    Java

    Server

    Pages

    (JSP

    files)

    to

    generate

    Web-based

    reports

    Publications

    This

    section

    lists

    publications

    in

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    library

    and

    other

    related

    documents.

    It

    also

    describes

    how

    to

    access

    Tivoli

    publications

    online,

    and

    how

    to

    order

    Tivoli

    publications.

    IBM

    Tivoli

    Service

    Level

    Advisor

    library

    Product

    information

    for

    using

    IBM

    Tivoli

    Service

    Level

    Advisor

    is

    found

    in

    the

    /tsladocs

    directory

    on

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    Publications

    CD

    (or

    electronic

    media),

    in

    PDF

    and

    HTML

    formats.

    Inserting

    the

    Publications

    CD

    into

    a

    Copyright

    IBM

    Corp.

    2002,

    2004

    vii

  • machine

    using

    the

    Windows

    operating

    system

    automatically

    launches

    the

    Tivoli

    Software

    Information

    Center,

    from

    which

    you

    can

    access

    any

    of

    the

    available

    documentation

    in

    softcopy

    form.

    The

    following

    documents

    are

    available

    in

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    library:

    v

    A

    Read

    Me

    First

    document

    that

    provides

    a

    starting

    point

    to

    help

    you

    become

    oriented

    with

    the

    set

    of

    IBM

    products

    that

    support

    the

    overall

    SLM

    solution,

    and

    some

    quick

    instructions

    on

    what

    documentation

    to

    refer

    to

    as

    you

    begin

    your

    installation

    of

    IBM

    Tivoli

    Service

    Level

    Advisor

    and

    its

    supporting

    applications.

    v

    Release

    Notes,

    SC09-7777

    This

    document

    provides

    late-breaking

    information,

    such

    as

    problems

    and

    workarounds,

    and

    patch

    availability.

    v

    Getting

    Started,

    SC32-0834

    This

    document

    introduces

    you

    to

    IBM

    Tivoli

    Service

    Level

    Advisor

    and

    provides

    information

    about

    planning,

    installing,

    and

    configuring

    IBM

    Tivoli

    Service

    Level

    Advisor

    to

    run

    in

    your

    Tivoli

    enterprise

    environment.

    v

    Managing

    Service

    Level

    Agreements,

    SC32-1247

    This

    document

    provides

    information

    about

    creating

    and

    managing

    schedules,

    offerings,

    customers,

    and

    realms,

    and

    associating

    these

    elements

    with

    selected

    resources

    in

    your

    enterprise

    environment

    to

    develop

    service

    level

    agreements

    (SLAs)

    between

    your

    organization

    and

    customers

    who

    depend

    on

    your

    enterprise

    for

    agreed

    upon

    levels

    of

    service.

    This

    document

    is

    designed

    to

    be

    used

    by

    administrators,

    service

    offering

    specialists,

    and

    service

    level

    agreement

    specialists

    who

    are

    responsible

    for

    creating

    and

    managing

    SLAs.

    v

    SLM

    Reports,

    SC32-1248

    This

    document

    provides

    information

    about

    generating

    and

    viewing

    Web-based

    SLM

    reports

    for

    IBM

    Tivoli

    Service

    Level

    Advisor,

    based

    on

    the

    evaluation

    and

    trend

    analysis

    results

    of

    the

    data

    that

    is

    extracted

    from

    the

    Tivoli

    Data

    Warehouse

    database.

    Additional

    information

    is

    provided

    so

    that

    you

    or

    your

    customer

    can

    integrate

    SLM

    reports

    into

    the

    customer

    Web

    site,

    including

    examples

    of

    how

    you

    can

    customize

    various

    display

    features.

    v

    Administrators

    Guide,

    SC32-0835

    This

    document

    provides

    information

    about

    the

    administrative

    tasks

    you

    can

    perform

    using

    IBM

    Tivoli

    Service

    Level

    Advisor

    to

    configure

    your

    SLM

    environment,

    and

    perform

    various

    administrative

    functions

    that

    support

    IBM

    Tivoli

    Service

    Level

    Advisor,

    such

    as

    backup

    and

    restore

    operations,

    and

    user

    definition

    and

    authorization.

    v

    Command

    Reference,

    SC32-0833

    This

    document

    provides

    information

    on

    command

    line

    interface

    (CLI)

    commands

    available

    for

    displaying

    certain

    conditions

    and

    states

    inside

    IBM

    Tivoli

    Service

    Level

    Advisor,

    and

    for

    performing

    various

    configuration

    tasks

    using

    the

    scmd

    command.

    Additional

    utilities

    that

    provide

    other

    specific

    functions

    are

    also

    described.

    v

    Messages,

    SC32-1250

    This

    document

    provides

    information

    on

    messages

    that

    might

    be

    displayed

    while

    using

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    product.

    It

    provides

    additional

    explanations

    for

    messages

    and

    instructions

    on

    what

    to

    do

    to

    recover

    from

    errors.

    v

    Troubleshooting,

    SC32-1249

    This

    document

    provides

    information

    on

    resolving

    problems

    that

    you

    might

    encounter

    during

    installation

    and

    configuration,

    as

    well

    as

    resolving

    viii

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

  • administrative

    problems

    that

    might

    arise

    during

    typical

    operation

    of

    the

    product.

    Information

    about

    message

    and

    trace

    logging

    is

    also

    provided.

    v

    Online

    user

    assistance

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    The

    online

    user

    assistance

    provides

    integrated

    online

    help

    topics

    for

    all

    IBM

    Tivoli

    Service

    Level

    Advisor

    administrative

    tasks

    that

    are

    performed

    using

    the

    SLM

    Administrative

    Console.

    Online

    user

    assistance

    is

    displayed

    in

    the

    Task

    Assistant

    portion

    of

    the

    SLM

    Administrative

    Console.

    Specific

    information

    about

    performing

    IBM

    Tivoli

    Service

    Level

    Advisor

    tasks

    is

    documented

    only

    in

    this

    online

    user

    assistance.

    When

    new

    products

    are

    installed

    that

    run

    in

    the

    SLM

    Administrative

    Console,

    corresponding

    online

    help

    topics

    are

    also

    installed

    and

    integrated

    into

    the

    existing

    information

    base.

    In

    addition,

    refer

    to

    the

    following

    IBM

    Tivoli

    Service

    Level

    Advisor

    Web

    site

    for

    support

    information

    and

    software

    updates

    on

    IBM

    Tivoli

    Service

    Level

    Advisor

    and

    supported

    warehouse

    packs

    and

    downloadable

    interim

    fix

    software:

    www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.html

    IBM

    DB2

    Universal

    Database

    Enterprise

    Edition

    library

    The

    publications

    required

    to

    support

    IBM

    DB2

    are

    available

    on

    the

    IBM

    DB2

    Universal

    Database

    Enterprise

    Edition

    CD,

    or

    from

    this

    IBM

    Web

    site:

    http://www.ibm.com/software/data/db2/udb

    Tivoli

    Data

    Warehouse

    library

    IBM

    Tivoli

    Service

    Level

    Advisor

    requires

    Tivoli

    Data

    Warehouse

    to

    be

    installed

    in

    your

    enterprise,

    to

    serve

    as

    the

    data

    repository

    for

    Tivoli

    performance

    and

    availability

    monitoring

    applications

    that

    provide

    data

    for

    service

    level

    management.

    See

    the

    following

    documentation

    on

    the

    Tivoli

    Data

    Warehouse

    documentation

    CD

    included

    with

    IBM

    Tivoli

    Service

    Level

    Advisor:

    v

    Installing

    and

    Configuring

    Tivoli

    Data

    Warehouse

    v

    Enabling

    an

    Application

    for

    Tivoli

    Data

    Warehouse

    v

    Tivoli

    Data

    Warehouse

    Release

    Notes

    Warehouse

    Enablement

    Packs

    Warehouse

    enablement

    packs

    (also

    referred

    to

    as

    warehouse

    packs)

    are

    the

    interfaces

    that

    load

    and

    transform

    data

    collected

    by

    source

    applications

    into

    Tivoli

    Data

    Warehouse,

    and

    from

    Tivoli

    Data

    Warehouse

    to

    other

    target

    applications

    that

    use

    the

    data

    to

    generate

    reports

    and

    perform

    analyses.

    Refer

    to

    the

    Release

    Notes

    for

    IBM

    Tivoli

    Service

    Level

    Advisor

    for

    the

    online

    location

    of

    the

    latest

    warehouse

    pack

    information.

    IBM

    WebSphere

    Application

    Server

    library

    IBM

    Tivoli

    Service

    Level

    Advisor

    uses

    IBM

    WebSphere

    Application

    Server

    as

    the

    basis

    for

    the

    SLM

    Administration

    Server

    and

    SLM

    Reports

    functions.

    Getting

    Started

    provides

    introductory

    information

    on

    installing

    IBM

    WebSphere

    Application

    Server

    and

    integrating

    it

    with

    IBM

    Tivoli

    Service

    Level

    Advisor.

    See

    the

    official

    documentation

    provided

    on

    the

    IBM

    WebSphere

    Application

    Server

    product

    media

    included

    with

    IBM

    Tivoli

    Service

    Level

    Advisor

    for

    additional

    information,

    and

    also

    refer

    to

    the

    latest

    IBM

    WebSphere

    Application

    Server

    product

    information

    online

    at

    the

    following

    Web

    site:

    http://www.ibm.com/software/webservers/appserv/was/library

    Preface

    ix

    http://www.ibm.com/software/sysmgmt/products/support/IBMTivoliServiceLevelAdvisor.htmlhttp://www.ibm.com/software/data/db2/udbhttp://www.ibm.com/software/webservers/appserv/was/library

  • SLM

    Administrative

    Console

    Information

    IBM

    Tivoli

    Service

    Level

    Advisor

    provides

    the

    SLM

    Administrative

    Console,

    a

    Web-based

    Administration

    Server

    graphical

    user

    interface

    (GUI)

    that

    runs

    in

    the

    IBM

    WebSphere

    environment,

    from

    which

    you

    can

    create

    and

    manage

    schedules,

    offerings,

    customers,

    realms,

    and

    SLAs.

    Information

    on

    the

    use

    of

    the

    SLM

    Administrative

    Console

    and

    tasks

    related

    to

    creating

    and

    managing

    SLAs

    are

    described

    in

    detail

    in

    Managing

    Service

    Level

    Agreements.

    User

    assistance

    for

    the

    SLM

    Administrative

    Console

    is

    available

    in

    the

    Task

    Assistant

    online

    help

    function.

    Related

    publications

    The

    following

    documents

    also

    provide

    useful

    information:

    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

    Access

    the

    glossary

    by

    clicking

    the

    Glossary

    link

    on

    the

    left

    pane

    of

    the

    Tivoli

    software

    library

    window.

    Accessing

    Publications

    Online

    In

    addition

    to

    the

    Publications

    CD

    that

    is

    shipped

    with

    IBM

    Tivoli

    Service

    Level

    Advisor,

    you

    can

    also

    access

    these

    publications

    online.

    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

    the

    IBM

    Tivoli

    Service

    Level

    Advisor

    link

    to

    access

    the

    product

    library

    at

    the

    Tivoli

    software

    information

    center.

    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.

    Ordering

    publications

    You

    can

    order

    many

    Tivoli

    publications

    online

    at

    the

    following

    Web

    site:

    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/

    x

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

    http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htmhttp://www.ibm.com/software/tivoli/library/www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://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

    all

    features

    of

    the

    graphical

    user

    interface.

    Tivoli

    technical

    training

    For

    Tivoli

    technical

    training

    information,

    refer

    to

    the

    following

    IBM

    Tivoli

    Education

    Web

    site:

    www.ibm.com/software/tivoli/education

    Contacting

    IBM

    Software

    Support

    IBM

    Software

    Support

    provides

    assistance

    with

    product

    defects.

    Before

    contacting

    IBM

    Software

    Support,

    your

    company

    must

    have

    an

    active

    IBM

    software

    maintenance

    contract,

    and

    you

    must

    be

    authorized

    to

    submit

    problems

    to

    IBM.

    The

    type

    of

    software

    maintenance

    contract

    that

    you

    need

    depends

    on

    the

    type

    of

    product

    you

    have:

    v

    For

    IBM

    distributed

    software

    products

    (including,

    but

    not

    limited

    to,

    Tivoli,

    Lotus,

    and

    Rational

    products,

    as

    well

    as

    DB2

    and

    WebSphere

    products

    that

    run

    on

    Windows

    or

    UNIX

    operating

    systems),

    enroll

    in

    Passport

    Advantage

    in

    one

    of

    the

    following

    ways:

    Online:

    Go

    to

    the

    following

    Passport

    Advantage

    Web

    page

    and

    click

    How

    to

    Enroll:

    www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Home

    By

    phone:

    For

    the

    phone

    number

    to

    call

    in

    your

    country,

    go

    to

    the

    following

    IBM

    Software

    Support

    Web

    site

    and

    click

    the

    name

    of

    your

    geographic

    region:

    techsupport.services.ibm.com/guides/contacts.html

    v

    For

    IBM

    eServer

    software

    products

    (including,

    but

    not

    limited

    to,

    DB2

    and

    WebSphere

    products

    that

    run

    in

    zSeries,

    pSeries,

    and

    iSeries

    environments),

    you

    can

    purchase

    a

    software

    maintenance

    agreement

    by

    working

    directly

    with

    an

    IBM

    sales

    representative

    or

    an

    IBM

    Business

    Partner.

    For

    more

    information

    about

    support

    for

    eServer

    software

    products,

    go

    to

    the

    IBM

    Technical

    Support

    Advantage

    Web

    page:

    www.ibm.com/servers/eserver/techsupport.html

    If

    you

    are

    not

    sure

    what

    type

    of

    software

    maintenance

    contract

    you

    need,

    call

    1-800-IBMSERV

    (1-800-426-7378)

    in

    the

    United

    States

    or,

    from

    other

    countries,

    go

    to

    the

    contacts

    page

    of

    the

    following

    IBM

    Software

    Support

    Handbook

    on

    the

    Web

    and

    click

    the

    name

    of

    your

    geographic

    region

    for

    phone

    numbers

    of

    people

    who

    provide

    support

    for

    your

    location:

    techsupport.services.ibm.com/guides/contacts.html

    Follow

    the

    steps

    in

    this

    topic

    to

    contact

    IBM

    Software

    Support:

    1.

    Determine

    the

    business

    impact

    of

    your

    problem.

    2.

    Describe

    your

    problem

    and

    gather

    background

    information.

    3.

    Submit

    your

    problem

    to

    IBM

    Software

    Support.

    Preface

    xi

    http://www.ibm.com/software/tivoli/educationhttp://www.lotus.com/services/passport.nsf/WebDocs/Passport_Advantage_Homehttp://techsupport.services.ibm.com/guides/contacts.htmlhttp://www.ibm.com/servers/eserver/techsupport.htmlhttp://techsupport.services.ibm.com/guides/contacts.html

  • Determine

    the

    business

    impact

    of

    your

    problem

    When

    you

    report

    a

    problem

    to

    IBM,

    you

    are

    asked

    to

    supply

    a

    severity

    level.

    Therefore,

    you

    need

    to

    understand

    and

    assess

    the

    business

    impact

    of

    the

    problem

    you

    are

    reporting.

    Use

    the

    following

    criteria

    to

    decide

    on

    an

    appropriate

    severity

    level

    for

    your

    problem:

    Severity

    1

    Critical

    business

    impact:

    You

    are

    unable

    to

    use

    the

    program,

    resulting

    in

    a

    critical

    impact

    on

    operations.

    This

    condition

    requires

    an

    immediate

    solution.

    Severity

    2

    Significant

    business

    impact:

    The

    program

    is

    usable

    but

    is

    severely

    limited.

    Severity

    3

    Some

    business

    impact:

    The

    program

    is

    usable

    with

    less

    significant

    features

    (not

    critical

    to

    operations)

    unavailable.

    Severity

    4

    Minimal

    business

    impact:

    The

    problem

    causes

    little

    impact

    on

    operations,

    or

    a

    reasonable

    circumvention

    to

    the

    problem

    has

    been

    implemented.

    Describe

    your

    problem

    and

    gather

    background

    information

    When

    explaining

    a

    problem

    to

    IBM,

    be

    as

    specific

    as

    possible.

    Include

    all

    relevant

    background

    information

    so

    that

    IBM

    Software

    Support

    specialists

    can

    help

    you

    solve

    the

    problem

    efficiently.

    To

    save

    time,

    know

    the

    answers

    to

    these

    questions:

    v

    What

    software

    versions

    were

    you

    running

    when

    the

    problem

    occurred?

    v

    Do

    you

    have

    logs,

    traces,

    and

    messages

    that

    are

    related

    to

    the

    problem

    symptoms?

    IBM

    Software

    Support

    is

    likely

    to

    ask

    for

    this

    information.

    v

    Can

    the

    problem

    be

    recreated?

    If

    so,

    what

    steps

    led

    to

    the

    failure?

    v

    Have

    any

    changes

    been

    made

    to

    the

    system?

    (For

    example,

    hardware,

    operating

    system,

    networking

    software,

    and

    so

    on.)

    v

    Are

    you

    currently

    using

    a

    workaround

    for

    this

    problem?

    If

    so,

    please

    be

    prepared

    to

    explain

    it

    when

    you

    report

    the

    problem.

    Submit

    your

    problem

    to

    IBM

    Software

    Support

    You

    can

    submit

    your

    problem

    in

    one

    of

    two

    ways:

    v

    Online:

    Go

    to

    the

    Submit

    and

    track

    problems

    page

    on

    the

    IBM

    Software

    Support

    site

    (http://www.ibm.com/software/support/probsub.html).

    Enter

    your

    information

    into

    the

    appropriate

    problem

    submission

    tool.

    v

    Do

    you

    have

    logs,

    traces,

    and

    messages

    that

    are

    related

    to

    the

    problem

    symptoms?

    IBM

    Software

    Support

    is

    likely

    to

    ask

    for

    this

    information.

    v

    Can

    the

    problem

    be

    recreated?

    If

    so,

    what

    steps

    led

    to

    the

    failure?

    v

    Have

    any

    changes

    been

    made

    to

    the

    system?

    (For

    example,

    hardware,

    operating

    system,

    networking

    software,

    and

    so

    on.)

    v

    Are

    you

    currently

    using

    a

    workaround

    for

    this

    problem?

    If

    so,

    please

    be

    prepared

    to

    explain

    it

    when

    you

    report

    the

    problem.

    If

    the

    problem

    you

    submit

    is

    for

    a

    software

    defect

    or

    for

    missing

    or

    inaccurate

    documentation,

    IBM

    Software

    Support

    creates

    an

    Authorized

    Program

    Analysis

    Report

    (APAR).

    The

    APAR

    describes

    the

    problem

    in

    detail.

    Whenever

    possible,

    IBM

    Software

    Support

    provides

    a

    workaround

    for

    you

    to

    implement

    until

    the

    APAR

    is

    resolved

    and

    a

    fix

    is

    delivered.

    IBM

    publishes

    resolved

    APARs

    on

    the

    IBM

    product

    support

    Web

    pages

    daily,

    so

    that

    other

    users

    who

    experience

    the

    same

    problem

    can

    benefit

    from

    the

    same

    resolutions.

    xii

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

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

  • For

    more

    information

    about

    problem

    resolution,

    see

    Searching

    knowledge

    bases

    and

    Obtaining

    fixes.

    Searching

    knowledge

    bases

    If

    you

    have

    a

    problem

    with

    your

    IBM

    software,

    you

    want

    it

    resolved

    quickly.

    Begin

    by

    searching

    the

    available

    knowledge

    bases

    to

    determine

    whether

    the

    resolution

    to

    your

    problem

    is

    already

    documented.

    Search

    the

    information

    center

    on

    your

    local

    system

    or

    network

    IBM

    provides

    extensive

    documentation

    that

    can

    be

    installed

    on

    your

    local

    machine

    or

    on

    an

    intranet

    server.

    You

    can

    use

    the

    search

    function

    of

    this

    information

    center

    to

    query

    conceptual

    information,

    instructions

    for

    completing

    tasks,

    reference

    information,

    and

    support

    documents.

    Tip:

    Update

    your

    information

    center

    with

    the

    latest

    support

    information.

    Search

    the

    Internet

    If

    you

    cannot

    find

    an

    answer

    to

    your

    question

    in

    the

    information

    center,

    search

    the

    Internet

    for

    the

    latest,

    most

    complete

    information

    that

    might

    help

    you

    resolve

    your

    problem.

    To

    search

    multiple

    Internet

    resources

    for

    your

    product,

    expand

    the

    product

    folder

    in

    the

    navigation

    frame

    to

    the

    left

    and

    select

    Support

    on

    the

    Web.

    From

    this

    topic,

    you

    can

    search

    a

    variety

    of

    resources

    including:

    v

    IBM

    technotes

    v

    IBM

    downloads

    v

    IBM

    Redbooks

    v

    IBM

    DeveloperWorks

    v

    Forums

    and

    newsgroups

    v

    Google

    Obtaining

    fixes

    A

    product

    fix

    might

    be

    available

    to

    resolve

    your

    problem.

    You

    can

    determine

    what

    fixes

    are

    available

    for

    your

    IBM

    software

    product

    by

    checking

    the

    product

    support

    Web

    site:

    1.

    Go

    to

    the

    IBM

    Software

    Support

    Web

    site

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

    2.

    Under

    Products

    A

    -

    Z,

    select

    your

    product

    name.

    This

    opens

    a

    product-specific

    support

    site.

    3.

    Under

    Self

    help,

    follow

    the

    link

    to

    All

    Updates,

    where

    you

    will

    find

    a

    list

    of

    fixes,

    fix

    packs,

    and

    other

    service

    updates

    for

    your

    product.

    For

    tips

    on

    refining

    your

    search,

    click

    Search

    tips.

    4.

    Click

    the

    name

    of

    a

    fix

    to

    read

    the

    description

    and

    optionally

    download

    the

    fix.

    To

    receive

    weekly

    e-mail

    notifications

    about

    fixes

    and

    other

    news

    about

    IBM

    products,

    follow

    these

    steps:

    1.

    From

    the

    support

    page

    for

    any

    IBM

    product,

    click

    My

    support

    in

    the

    upper-right

    corner

    of

    the

    page.

    2.

    If

    you

    have

    already

    registered,

    skip

    to

    the

    next

    step.

    If

    you

    have

    not

    registered,

    click

    register

    in

    the

    upper-right

    corner

    of

    the

    support

    page

    to

    establish

    your

    user

    ID

    and

    password.

    3.

    Sign

    in

    to

    My

    support.

    Preface

    xiii

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

  • 4.

    On

    the

    My

    support

    page,

    click

    Edit

    profiles

    in

    the

    left

    navigation

    pane,

    and

    scroll

    to

    Select

    Mail

    Preferences.

    Select

    a

    product

    family

    and

    select

    the

    appropriate

    boxes

    for

    the

    type

    of

    information

    you

    want.

    5.

    Click

    Submit.

    6.

    For

    e-mail

    notification

    for

    other

    products,

    repeat

    Steps

    4

    and

    5.

    For

    more

    information

    about

    types

    of

    fixes,

    see

    the

    Software

    Support

    Handbook

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

    Updating

    support

    information

    Information

    centers

    typically

    include

    one

    or

    more

    support

    information

    plug-ins.

    These

    plug-ins

    add

    IBM

    technotes

    and

    other

    support

    documents

    to

    the

    information

    center.

    The

    following

    steps

    describe

    how

    to

    update

    your

    support

    information

    plug-ins:

    1.

    Go

    to

    the

    IBM

    Software

    Support

    Web

    site

    (www.ibm.com/software/support).

    2.

    Under

    Products

    A

    -

    Z,

    select

    your

    product

    name.

    This

    opens

    a

    product-specific

    support

    site.

    3.

    Under

    Search

    support

    for

    this

    product,

    type

    the

    keyword

    phrase:

    com.ibm.support.

    Select

    the

    Download

    check

    box,

    and

    click

    Submit.

    4.

    Check

    the

    search

    results

    for

    updates

    to

    support

    information

    plug-ins.

    All

    support

    information

    plug-ins

    follow

    the

    naming

    convention,

    com.ibm.support.product.doc.

    If

    an

    update

    is

    available,

    select

    it

    from

    the

    list

    and

    view

    the

    download

    instructions.

    5.

    Save

    the

    attached

    zip

    file

    to

    a

    temporary

    location

    on

    your

    hard

    drive.

    6.

    Unzip

    the

    downloaded

    file,

    making

    sure

    that

    you

    retain

    the

    subfolders.

    7.

    From

    the

    location

    where

    you

    unzipped

    the

    file,

    copy

    the

    support

    information

    plug-in

    folder

    to

    your

    Eclipse

    plug-ins

    folder.

    For

    example,

    if

    your

    IBM

    software

    product

    is

    installed

    at

    c:\IBM\WebSphere\,

    copy

    the

    updated

    plug-in

    folder

    (com.ibm.support.product.doc)

    to

    c:\IBM\WebSphere\eclipse\plugins.

    8.

    To

    see

    the

    updated

    support

    information,

    start

    the

    information

    center

    (or

    shut

    it

    down

    and

    restart

    it),

    and

    expand

    the

    Support

    information

    node

    in

    the

    navigation

    tree.

    Participating

    in

    newsgroups

    User

    groups

    provide

    software

    professionals

    with

    a

    forum

    for

    communicating

    ideas,

    technical

    expertise,

    and

    experiences

    related

    to

    the

    product.

    They

    are

    located

    on

    the

    Internet,

    and

    are

    available

    using

    standard

    news

    reader

    programs.

    These

    groups

    are

    primarily

    intended

    for

    user-to-user

    communication,

    and

    are

    not

    a

    replacement

    for

    formal

    support.

    If

    you

    use

    Mozilla

    as

    your

    browser,

    complete

    the

    following

    instructions

    to

    access

    a

    newsgroup:

    1.

    Open

    a

    Mozilla

    browser

    window.

    2.

    From

    the

    Edit

    menu,

    click

    Preferences.

    The

    Preferences

    window

    is

    displayed.

    3.

    In

    the

    Category

    view,

    click

    Mail

    &

    Newsgroups

    to

    display

    the

    Mail

    &

    Newsgroups

    settings.

    4.

    Select

    the

    Use

    Mozilla

    mail

    as

    the

    default

    mail

    application

    check

    box.

    5.

    Click

    OK.

    6.

    Close

    your

    Mozilla

    browser

    and

    then

    open

    it

    again.

    xiv

    IBM

    Tivoli

    Service

    Level

    Advisor:

    Getting

    Started

    http://techsupport.services.ibm.com/guides/handbook.htmlhttp://www.ibm.com/software/support

  • 7.

    Cut

    and

    paste

    the

    newsgroup

    address

    of

    a

    product

    into

    the

    browser

    Address

    field,

    and

    press

    Enter

    to

    open

    the

    newsgroup.

    If

    you

    use

    Microsoft

    Internet

    Explorer

    as

    your

    browser,

    complete

    the

    following

    instructions

    to

    access

    a

    newsgroup:

    1.

    Open

    an

    Internet

    Explorer

    browser.

    2.

    From

    the

    Tools

    menu,

    click

    Internet

    Options.

    3.

    On

    the

    Internet

    Options

    window,

    click

    the

    Programs

    tab.

    4.

    In

    the

    Newsgroups

    list,

    click

    the

    Down

    Arrow

    and

    then

    click

    Outlook

    Express.

    5.

    Click

    OK.

    6.

    Close

    your

    Internet

    Explorer

    browser

    and

    then

    open

    it

    again.

    7.

    Cut

    and

    paste

    the

    newsgroup

    address

    of

    a

    product

    into

    the

    browser

    Address

    field,

    and

    press

    Enter

    to

    open

    the

    newsgroup.

    You

    can

    find

    information

    on

    Tivoli

    Data

    Warehouse

    by

    accessing

    the

    following

    newsgroup:

    news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehouse

    You

    can

    find

    information

    on

    IBM

    Tivoli

    Service

    Level

    Advisor

    by

    accessing

    the

    following

    newsgroup:

    news://news.software.ibm.com/ibm.software.tivoli.service-level-advisor

    You

    can

    find

    information

    on

    IBM

    DB2

    by

    accessing

    the

    following

    newsgroup:

    news://news.software.ibm.com/ibm.software.db2

    You

    can

    find

    information

    on

    IBM

    WebSphere

    Application

    Server

    by

    accessing

    the

    following

    newsgroup:

    news://news.software.ibm.com/ibm.software.websphere.application-server

    Conventions

    used

    in

    this

    guide

    This

    guide

    uses

    several

    conventions

    for

    special

    terms

    and

    actions,

    operating

    system-dependent

    commands

    and

    paths,

    and

    margin

    graphics.

    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

    Citations

    (titles

    of

    books,

    diskettes,

    and

    CDs)

    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

    Preface

    xv

    news://news.software.ibm.com/ibm.software.tivoli.enterprise-data-warehousenews://news.software.ibm.com/ibm.software.tivoli.service-level-advisornews://news.software.ibm.com/ibm.software.db2news://news.software.ibm.com/ibm.software.websphere.application-server

  • 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

    Operating

    system-dependent

    variables

    and

    paths

    This

    guide

    uses

    the

    UNIX

    operating

    system

    convention

    for

    specifying

    environment

    variables

    and

    for

    directory

    notation.

    When

    using

    the

    Windows

    operating

    system

    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

    operating

    systems.

    For

    example,

    %TEMP%

    in

    Windows

    systems

    is

    equivalent

    to

    $tmp

    in

    UNIX

    systems.

    Note:

    If