Gen DTU fails start (Could not resolve org.eclipse.ant.core)

Products

Gen - Workstation Toolset Gen

Issue/Introduction

A few of our Developers have a problem with the Gen 8.6 Diagram Trace Utility (DTU) failing to start with this dialog box error:

The above message refers user to file C:\Users\<user>\Appdata\Local\CA\Gen 8.6\cfg\DiagramTrace\workspace\.metadata\.log.
The .log file contains several errors of this format:
===

!ENTRY org.eclipse.ant.core 4 0 2022-02-07 11:42:34.877
!MESSAGE FrameworkEvent ERROR
!STACK 0
org.osgi.framework.BundleException: Could not resolve module: org.eclipse.ant.core [37]
Another singleton bundle selected: osgi.identity; type="osgi.bundle"; version:Version="3.5.200.v20180822-0553"; osgi.identity="org.eclipse.ant.core"; singleton:="true"

at org.eclipse.osgi.container.Module.start(Module.java:447)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1685)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.incStartLevel(ModuleContainer.java:1664)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.doContainerStartLevel(ModuleContainer.java:1627)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1558)
at org.eclipse.osgi.container.ModuleContainer$ContainerStartLevel.dispatchEvent(ModuleContainer.java:1)
at org.eclipse.osgi.framework.eventmgr.EventManager.dispatchEvent(EventManager.java:233)
at org.eclipse.osgi.framework.eventmgr.EventManager$EventThread.run(EventManager.java:343)
...
===

Environment

Release : 8.6

Component : Gen Diagram Trace

Resolution

1. The advice in KB article Gen Diagram Trace Utility (DTU) startup issues to delete the "C:\Users\<userid>\AppData\Local\CA\Gen 8.6\cfg\DiagramTrace" sub-directories or run DiagramTrace.exe with the clean option did not help.

2a. Directory "%Gen86%\Gen\dt\plugins" ("C:\Program Files (x86)\CA\Gen86\Gen\dt\plugins") contains 2 copies of org.eclipse.ant.core*.jar
===
30/05/2016 01:03 PM 95,076 org.eclipse.ant.core_3.1.200.v20070522.jar
14/10/2019 03:02 PM 108,319 org.eclipse.ant.core_3.5.200.v20180822-0553.jar
===
The DTU PTF RTN86203/SS10543 ("DIAGRAM TRACE UTILITY ECLIPSE UPGRADE") installs "org.eclipse.ant.core_3.5.200.v20180822-0553.jar" and "org.eclipse.ant.core_3.1.200.v20070522.jar" should have been deleted/copied to the PTF backup directory "%Gen86%\PTF_Backups\RTN86203.BAK\dt\plugins".
NOTE: That is only one of many files updated by that PTF.
b. The "%Gen86%\PTF_Backups\PTF_maintenance.log" seems to show the same set of PTFs has been installed twice, mostly first on "Mon 20/12/2021" and then on "Tue 08/02/2022".
NOTE: There is no reference to "has been backed out" between those 2 sets of installs.

3. Developers had tried several times to uninstall/reinstall Gen 8.6 and PTFs but DTU still failed to start. When uninstall was done the directory "%Gen86%" ("C:\Program Files (x86)\CA\Gen86") was not removed so that may explain both 2a and 2b i.e. "%Gen86%\Gen\" still contained previous files after uninstall and the existing "%Gen86%\PTF_Backups\PTF_maintenance.log" file had been appended to.

4. Developer performed these steps after which the DTU could be started:
a. Uninstall Gen 8.6 from "Control Panel"/"Programs and Features".
b. Rename these directories as a backup:
- "C:\Users\<userid>\AppData\Local\CA"
- "%Gen86%" ("C:\Program Files (x86)\CA\Gen86")
c. Restart machine.
d. Install Gen 8.6
e. Install Gen 8.6 Complete PTF WKS86200/SO09618
f. Install required additional patches including RTN86203/SS10543.

Additional Information

L1 Support discussed further with Gen Engineering.
It is probable that the current InstallShield Gen 8.6 uninstall program will only remove files (or files with the same name) that it originally installed. So if a PTF installs a new file with a different name, that new file will not be removed when InstallShield uninstalls Gen
When the next Gen ISO image is built, Engineering will investigate this further along with cleaning up the file "%Gen86%\PTF_Backups\PTF_maintenance.log" during the uninstall.