beautypg.com

Appendix a. common agent serviceability tool, Components, Running the serviceability tool – IBM 51 User Manual

Page 233: Contents of the casservice.zip file, Appendix, Common, Agent, Serviceability, Tool, Running

background image

Appendix

A.

Common

Agent

serviceability

tool

This

section

describes

the

serviceability

tool

that

captures

information

about

the

common

agent

and

the

machine

the

agent

is

running

on.

The

serviceability

tool

is

a

script

that

can

be

run

from

the

common

agent

installation

directory,

also

referred

to

as

the

base

directory.

The

tool

collects

diagnostic

information

about

the

agent

and

packs

the

information

into

an

archive

that

can

be

used

for

troubleshooting

or

can

be

sent

to

IBM

Customer

Support

for

analysis

in

the

event

of

problems

with

the

common

agent.

The

archive

includes

an

HTML

compilation

of

the

information

gathered.

Components

The

serviceability

tool

consists

of

three

key

components:

1.

A

script

that

runs

the

tool,

which

is

stored

in

the

base

directory

of

the

agent

(default:

C:\Program

Files\tivoli\ep

):

v

Windows:

service.bat

v

Unix:

service.sh

2.

A

jar

file

located

in

the

lib

directory

(default

C:\Program

Files\tivoli\ep\lib

):

casservice.jar

Note:

This

tool

also

depends

on

the

guid.jar

file

being

in

the

lib

directory,

so

it

can

get

the

GUID.

3.

An

output

file,

CASservice.zip

,

which

is

created

in

the

base

directory

of

the

agent.

Running

the

serviceability

tool

To

run

the

common

agent

serviceability

tool:

1.

Open

an

Command

prompt

window.

2.

Switch

to

the

base

directory

of

the

common

agent.

3)

3.

Invoke

the

following

script

to

create

a

CASservice.zip

file

in

the

base

directory

of

the

common

agent:

v

Windows:

service

v

UNIX/Linux:

./service.sh

Note:

If

you

have

multiple

common

agents

on

a

machine,

you

need

to

run

the

tool

in

the

base

directory

of

each

agent

that

you

want

to

gather

service

information

about.

If

you

intend

to

send

multiple

CASservice.zip

files

to

IBM

Customer

Support,

be

sure

to

rename

them

so

they

don’t

all

have

the

same

name.

Contents

of

the

CASservice.zip

file

The

CASservice.zip

file

contains

the

following

files:

1.

Key

system

information

stored

as

a

file

called

CASserviceInfo.html

that

can

be

viewed

by

an

HTML

browser

(Internet

Explorer

6

recommended).

The

file

is

located

in

the

\

directory:

©

Copyright

IBM

Corp.

2003,

2006

221