Troubleshooting
Problem
After installing an iFix on the Engineering Workflow Management (EWM) client, the application fails to start and report a NullPointerException.
Cause
The client fails to properly re-provision after installing the iFix, resulting in a NullPointerException.
Diagnosing The Problem
Steps to Reproduce:
- Download the appropriate ELM iFix.
- Extract the update site folder as required.
- In the EWM client, open the "Help" menu and select "Install New Software".
- Choose the extracted update site folder from the local file system and proceed with installation.
- When prompted to restart the client, select "Restart Now".
- Upon restart, the client displays a NullPointerException.
- Close the error dialog windows and restart the EWM client again. The client may start successfully on the second attempt.
Resolving The Problem
Steps to Resolve the Problem:
- Open the eclipse.ini file located in the EWM or Eclipse installation directory.
- Add the following argument on a new line:
-clean
- Save the file and restart the EWM or Eclipse client.
Additional Information:
The -clean argument forces the application to re-provision its configuration, which may result in slower startup times during the next launch. After the client successfully starts with the applied iFix, the -clean entry can be removed from the eclipse.ini file.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"ARM Category":[{"code":"a8m50000000CjkgAAC","label":"ELM Workflow Management-\u003EClient-\u003EEclipse"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"and future releases;7.0.3"}]
Product Synonym
EWM; Eclipse
Was this topic helpful?
Document Information
Modified date:
30 March 2026
UID
ibm17260615