IBM Support

Netcool Impact Fix Pack upgrade may fail when Derby SSL is enabled

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

  1. Locate the derby.properties file in your Netcool Impact installation.
  2. Open the file in a text editor.
  3. Identify SSL-related properties, such as:

    derby.drda.sslMode={basic or peerAuthentication}
    
  4. Modify or remove the SSL setting. For example:

    derby.drda.sslMode=off
    

    or remove the line entirely.

  5. 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:

  1. Re-enable SSL in:
    • derby.properties file
    • All relevant data sources
  2. Restart Netcool Impact services again.

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSSHYH","label":"Tivoli Netcool\/Impact"},"ARM Category":[{"code":"a8m500000008YMnAAM","label":"Impact-\u003EImpact Server-\u003EDatabase-\u003EDerby"},{"code":"a8m500000008ZvjAAE","label":"Impact-\u003EInstallation-\u003EUpgrade"}],"ARM Case Number":"TS021924315","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.1.0"}]

Document Information

Modified date:
16 June 2026

UID

ibm17276737