Resolve "Fatal Error iu_les: Restore server failure: Cannot rename server directory" when upgrading Spectrum

Issue

When upgrading to a newer vintage of the Spectrum Technology Platform, we see the following error:

User-added image

iu_les: Restore server failure: Cannot rename server directory. 
Installer cannot continue.
Refer to the following logs (if available) in the target directory for details:

We ran the Spectrum Technology Platform upgrade installation using debug mode, and see the following snippet from the platform_upgrade.log file: 

BUILD FAILED 

C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\es-upgrade.xml:81: Error occurred upgrading database:C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\upgrade\version9.2.zip-contents\build.xml:58: The following error occurred while executing this line: 
C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\upgrade\version9.2.zip-contents\build.xml:64: Java returned: 1 
at com.g1.dcg.server.upgrade.upgrader.AbstractUpgradeTask.execute(AbstractUpgradeTask.java:69) 
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291) 
at sun.reflect.GeneratedMethodAccessor4.invoke(Unknown Source) 
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) 
at java.lang.reflect.Method.invoke(Method.java:606) 
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106) 
at org.apache.tools.ant.Task.perform(Task.java:348) 
at org.apache.tools.ant.Target.execute(Target.java:435) 
at org.apache.tools.ant.Target.performTasks(Target.java:456) 
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1393) 
at org.apache.tools.ant.Project.executeTarget(Project.java:1364) 
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41) 
at org.apache.tools.ant.Project.executeTargets(Project.java:1248) 
at org.apache.tools.ant.Main.runBuild(Main.java:851) 
at org.apache.tools.ant.Main.startAnt(Main.java:235) 
at org.apache.tools.ant.Main.start(Main.java:198) 
at org.apache.tools.ant.Main.main(Main.java:286) 
Caused by: C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\upgrade\version9.2.zip-contents\build.xml:58: The following error occurred while executing this line: 
C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\upgrade\version9.2.zip-contents\build.xml:64: Java returned: 1 
at org.apache.tools.ant.ProjectHelper.addLocationToBuildException(ProjectHelper.java:547) 
at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:442) 
at org.apache.tools.ant.taskdefs.CallTarget.execute(CallTarget.java:105) 
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291) 
at sun.reflect.GeneratedMethodAccessor4.invoke(Unknown Source) 
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) 
at java.lang.reflect.Method.invoke(Method.java:606) 
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106) 
at org.apache.tools.ant.Task.perform(Task.java:348) 
at org.apache.tools.ant.Target.execute(Target.java:435) 
at org.apache.tools.ant.Target.performTasks(Target.java:456) 
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1393) 
at org.apache.tools.ant.Project.executeTarget(Project.java:1364) 
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41) 
at org.apache.tools.ant.Project.executeTargets(Project.java:1248) 
at com.g1.dcg.server.upgrade.AntUtil.runTargets(AntUtil.java:53) 
at com.g1.dcg.server.upgrade.VersionUpgrader.runTargets(VersionUpgrader.java:155) 
at com.g1.dcg.server.upgrade.VersionUpgrader.runTarget(VersionUpgrader.java:165) 
at com.g1.dcg.server.upgrade.upgrader.Upgrader.execute(Upgrader.java:135) 
at com.g1.dcg.server.upgrade.upgrader.AbstractUpgradeTask.execute(AbstractUpgradeTask.java:61) 
... 16 more 
Caused by: C:\Users\Administrator\AppData\Local\Temp\2\907748.tmp\server\upgrade\version9.2.zip-contents\build.xml:64: Java returned: 1 
at org.apache.tools.ant.taskdefs.Java.execute(Java.java:111) 
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:291) 
at sun.reflect.GeneratedMethodAccessor4.invoke(Unknown Source) 
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) 
at java.lang.reflect.Method.invoke(Method.java:606) 
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106) 
at org.apache.tools.ant.Task.perform(Task.java:348) 
at org.apache.tools.ant.Target.execute(Target.java:435) 
at org.apache.tools.ant.Target.performTasks(Target.java:456) 
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1393) 
at org.apache.tools.ant.helper.SingleCheckExecutor.executeTargets(SingleCheckExecutor.java:38) 
at org.apache.tools.ant.Project.executeTargets(Project.java:1248) 
at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:440) 
... 34 more

Cause

The Spectrum upgrade tries to rename an entry in the repository, which fails due to the target name already existing.

Resolution

UPDATED: October 23, 2017
Client should provide PB Software Support with the platform_upgrade.log file, which would be created as a result of upgrading Spectrum in debug mode.

Client should also provide PB Software Support with a zipped up directory of their Derby DB or Orient DB repository directory.

Once PB Software Support has both the platform_upgrade.log file and the zipped up repository, Engineering can work on remedying the issue with the database entry that cannot be renamed.

Once changes are made to the repository by PB Engineering, the client can then run the upgrade installation.