PK92983: WHEN USING A DERBY DATABASE AND PERFORMING MIGRATION, *.LCK FILES STILL EXIST, AND MIGRATION WILL MIGRATE THEM.

Fixes are available

APAR status

Closed as program error.

Error description

When using a Derby Database and performing migration, *.lck
files may still exist, and migration will migrate them.  This
causes the Derby Database to be locked for use in the newly
migrated environment.  Errors seen may be:

java.sql.SQLException: Another instance of Derby may have
already booted the database.

Local fix

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server                                      *
****************************************************************
* PROBLEM DESCRIPTION: WHEN MIGRATING EMBEDDED DERBY           *
*                      DATABASES, *.LCK FILES ARE MIGRATED,    *
*                      CAUSING AN EXCEPTION ON SERVER STARTUP. *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
When using embedded Derby databases, *.lck files may still
exist even if the database is not in use. The WASPreUpgrade
command was copying those *.lck files during migration. This
caused the Derby database to be locked for use in the newly
migrated environment.

Problem conclusion

Since the presence of *.lck files does not necessarily
indicate the Derby database is in use, the WASPreUpgrade
command has been changed to not migrate those files. To ensure
data integrity, the WASPreUpgrade command has also been
changed to obtain a lock on each embedded Derby database
before migrating it. Since obtaining a lock on the database
could fail, causing the WASPreUpgrade command to fail, the
-requireEmbeddedDBMigration parameter has been added to bypass
the database migration if necessary. If the value is specified
as true, which is the default, any exception that occurs when
you migrate the embedded databases will cause the
WASPreUpgrade command to fail. If the value is specified as
false, any exception that occurs when you migrate the embedded
databases will be logged in the trace file, and the
WASPreUpgrade command will continue.

The fix for this APAR is currently targeted for inclusion in
fix pack 7.0.0.7.  Please refer to the Recommended Updates
page for delivery information:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980

Temporary fix

Comments

APAR Information

APAR number
PK92983
Reported component name
WEBSPHERE APP S
Reported component ID
5724J0800
Reported release
700
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-08-03
Closed date
2009-08-31
Last modified date
2009-08-31

APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name
WEBSPHERE APP S
Fixed component ID
5724J0800

Applicable component levels

R700 PSY
UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
24 October 2021

Tips

PK92983: WHEN USING A DERBY DATABASE AND PERFORMING MIGRATION, *.LCK FILES STILL EXIST, AND MIGRATION WILL MIGRATE THEM.

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name

Fixed component ID

Applicable component levels

R700 PSY

Document Information

Share your feedback

Need support?