beautypg.com

IBM 51 User Manual

Page 211

background image

v

Using

a

Web

browser,

access

the

URL,

url.

4.

Start

the

upgrade

again.

5.

If

the

common

agent

upgraded

continues

to

fail,

collect

the

common

agent

logs

and

contact

customer

support.

BTC5049E

The

upgrade

bundle

cannot

retrieve

the

value

for

the

key

key

from

CAUpgrade.properties

file.

Explanation:

The

CAUpgrade.properties

file

contains

key/value

pairs

that

provide

platform-specific

information

that

is

needed

to

upgrade

the

common

agent.

The

value

for

the

required

key

was

not

found

in

the

file.

This

typically

indicates

a

programming

error

or

that

the

file

was

changed

after

it

was

created.

System

action:

The

upgrade

of

the

common

agent

stopped

and

the

version

of

the

common

agent

is

unchanged.

Administrator

Response:

If

the

agent

manager

is

version

1.1

or

version

1.2

with

fix

pack

1

or

earlier,

completed

the

following

steps:

1.

Repeat

the

steps

in

the

common

agent

upgrade

instructions

on

the

support

web

site

to

reconfigure

the

agent

manager

to

upgrade

common

agents.

2.

Start

the

upgrade

again.

If

the

upgrade

still

fails,

or

if

the

agent

manager

is

already

at

version

1.2

with

fix

pack

2

or

greater,

collect

the

common

agent

log

files

and

contact

customer

support.

BTC5050E

The

upgrade

bundle

cannot

create

a

response

file

to

use

with

the

installation

program.

Look

in

the

logs/upgradeAgentTrace.log

and

logs/upgradeAgentMessage.log

files

for

information

about

the

exception:

exception.

Explanation:

An

error

occurred

while

creating

the

response

file

that

is

needed

to

drive

the

upgrade

path

of

the

common

agent

installation.

Possible

exceptions

include:

v

IOException

-

The

response

file

cannot

be

created

or

opened

for

writing,

or

an

error

occurred

when

writing

to

the

file.

System

action:

The

upgrade

of

the

common

agent

stopped

and

the

version

of

the

common

agent

is

unchanged.

Administrator

Response:

Look

in

the

logs/upgradeAgentTrace.log

file

for

information

about

the

exception.

The

trace

log

contains

information

about

the

error.

Correct

the

problem,

and

then

start

the

upgrade

again.

BTC5051E

The

upgrade

bundle

cannot

unpack

the

image

at

location

into

the

data_directory

directory.

Look

in

the

logs/upgradeAgentTrace.log

and

logs/upgradeAgentMessage.log

files

for

information

about

the

exception:

exception

Explanation:

An

error

occurred

while

unpacking

the

installation

image

image

into

the

data_directory

directory.

Possible

exceptions

include:

v

MalformedURLException

-

The

URL,

location,

specifies

an

unknown

protocol.

v

ZipException

-

There

was

a

problem

with

the

zipped

image

file.

v

IOException

-

An

error

occurred

while

reading

from

the

zipped

image

file

or

while

creating

the

unpacked

version

of

a

file

on

the

local

file

system.

System

action:

The

upgrade

of

the

common

agent

stopped

and

the

version

of

the

common

agent

has

not

been

changed.

Administrator

Response:

Look

in

the

logs/upgradeAgentTrace.log

and

logs/

upgradeAgentMessage.log

files

to

find

details

about

the

error,

and

then,

take

corrective

action.

Possible

actions

include:

v

Making

sure

there

is

enough

disk

space

on

the

common

agent

machine

to

hold

the

uncompressed

files.

v

Make

sure

the

target

directory,

data_directory,

is

writable.

After

you

correct

the

problem,

start

the

upgrade

again.

BTC5052E

The

upgrade

bundle

cannot

copy

the

image

from

location

to

relative_path/file_name.

Explanation:

Before

the

upgrade

can

occur,

the

deployer

service

must

copy

the

compressed

image

file

from

location

to

the

file_name

file

in

the

relative_path

directory

on

the

common

agent

machine.

This

error

indicates

that

the

copy

was

not

successful.

System

action:

The

upgrade

of

the

common

agent

stopped

and

the

version

of

the

common

agent

has

not

been

changed.

Administrator

Response:

Perform

these

actions

to

correct

the

problem:

1.

Make

sure

that

the

agent

manager

is

running.

2.

If

the

agent

manager

is

version

1.1

or

version

1.2

with

fix

pack

1

or

earlier,

make

sure

the

common

agent

upgrade

instructions

on

the

support

Web

site

have

been

followed.

The

instructions

help

you

configure

the

agent

manager

to

upgrade

common

agents.

3.

Make

sure

that

common

agent

has

enough

disk

space

for

the

file.

Chapter

11.

Tivoli

Common

Agent

Services

messages

199