Troubleshooting
Problem
When applying a Fix Pack to IBM Netcool Impact, the upgrade process may fail if Derby is configured to use SSL (Secure Sockets Layer).
This issue can occur when SSL is enabled in the Derby configuration (derby.properties) and/or in one or more Derby-based data sources within Netcool Impact.
Symptom
- Fix Pack upgrade fails or does not complete successfully
- Errors related to database connectivity or Derby communication during upgrade
- Upgrade rollback or partial installation
Cause
Netcool Impact Fix Pack upgrades are not compatible with Derby SSL-enabled configurations.
If Derby SSL is enabled, the upgrade process cannot properly connect to the Derby database, which results in upgrade failure.
Resolving The Problem
To avoid upgrade failure, you must disable Derby SSL before performing the Fix Pack upgrade.
Procedure
Step 1: Disable SSL in derby.properties
- Locate the
derby.propertiesfile in your Netcool Impact installation. - Open the file in a text editor.
Identify SSL-related properties, such as:
derby.drda.sslMode={basic or peerAuthentication}Modify or remove the SSL setting. For example:
derby.drda.sslMode=offor remove the line entirely.
- Save the file.
Step 2: Disable SSL in Derby data sources
Review all Netcool Impact data sources that use Derby and ensure SSL is disabled.
This includes (but is not limited to):
- ImpactDB
- RelatedEventsDatasource
- seasonalEventsDatasource
- NOIReportDatasource
- Any custom Derby-based data sources
For each data source:
- Open the data source configuration in Netcool Impact.
- Locate the SSL/TLS Configuration properties.
- Select "Off".
- Save the changes.
Step 3: Restart Netcool Impact
Restart Netcool Impact services to apply the configuration changes.
Step 4: Apply the Fix Pack
Proceed with the Fix Pack upgrade after SSL has been fully disabled.
Step 5 (Optional): Re-enable SSL
If Derby SSL is required in your environment:
- Re-enable SSL in:
derby.propertiesfile- All relevant data sources
- Restart Netcool Impact services again.
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
16 June 2026
UID
ibm17276737