Clarity Install fails with error: ExecTask) \CA\SharedComponents\ScanEngine was unexpected at this time. 8/13/09 12:08 PM (UnknownElement) Task "exec" finished with error.

Products

• Clarity PPM SaaS
• Clarity PPM On Premise

Issue/Introduction

Description:

On a Windows 2003 64 bit OS, installing Clarity 12 fails with following error in the install.log:

8/13/09 12:08 PM (ExecTask) \CA\SharedComponents\ScanEngine was unexpected at this time.8/13/09 12:08 PM (UnknownElement) Task "exec" finished with error.D:\x\install.xml:484: exec returned: 255 at org.apache.tools.ant.taskdefs.ExecTask.runExecute(ExecTask.java:591) at org.apache.tools.ant.taskdefs.ExecTask.runExec(ExecTask.java:617) at org.apache.tools.ant.taskdefs.ExecTask.execute(ExecTask.java:452) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at com.niku.tools.taskdefs.CompleteTask.execute(CompleteTask.java:125) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at com.niku.tools.taskdefs.IfTask.execute(IfTask.java:199) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at org.apache.tools.ant.Target.execute(Target.java:342) at org.apache.tools.ant.Target.performTasks(Target.java:370) at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1216) at org.apache.tools.ant.helper.SingleCheckExecutor.executeTargets(SingleCheckExecutor.java:37) at org.apache.tools.ant.Project.executeTargets(Project.java:1068) at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:382) at org.apache.tools.ant.taskdefs.CallTarget.execute(CallTarget.java:107) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at com.niku.tools.taskdefs.IfTask.execute(IfTask.java:199) at org.apache.tools.ant.Task.perform(Task.java:364) at com.niku.tools.taskdefs.ChooseTask.execute(ChooseTask.java:132) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at org.apache.tools.ant.taskdefs.Sequential.execute(Sequential.java:64) at org.apache.tools.ant.Task.perform(Task.java:364) at com.niku.tools.taskdefs.ChooseTask.execute(ChooseTask.java:146) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at org.apache.tools.ant.Target.execute(Target.java:342) at org.apache.tools.ant.Target.performTasks(Target.java:370) at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1216) at org.apache.tools.ant.helper.SingleCheckExecutor.executeTargets(SingleCheckExecutor.java:37) at org.apache.tools.ant.Project.executeTargets(Project.java:1068) at org.apache.tools.ant.taskdefs.Ant.execute(Ant.java:382) at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) at org.apache.tools.ant.Task.perform(Task.java:364) at org.apache.tools.ant.Target.execute(Target.java:342) at org.apache.tools.ant.Target.performTasks(Target.java:370) at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1216) at org.apache.tools.ant.Project.executeTarget(Project.java:1185) at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:40) at org.apache.tools.ant.Project.executeTargets(Project.java:1068) at org.apache.tools.ant.Main.runBuild(Main.java:675) at org.apache.tools.ant.Main.startAnt(Main.java:190) at org.apache.tools.ant.launch.Launcher.run(Launcher.java:246) at org.apache.tools.ant.launch.Launcher.main(Launcher.java:67)8/13/09 12:08 PM (UnknownElement) Task "complete" finished with error.

Solution:

Workaround:

Please make sure that the %PATH%, %NIKU_HOME% and %JAVA_HOME% do not contain path having blank spaces e.g. C:\Program Files. If there are space(s) in the folder name, then they can be defined under double quotes i.e. "C:\Program Files" -or- you may replace folder names using tilde character, i.e. replace C:\Program Files\ with C:\PROGRA~1\, C:\Program Files (x86)\ with C:\PROGRA~2\, etc.

Fix the PATH by escaping elements with spaces in them as follows:

Example:

***<CUT***;C:\Program Files (x86)\Microsoft SQL Server\90\DTS\Binn\;***<CUT>***

Change this to:

***<CUT***;"C:\Program Files (x86)\Microsoft SQL Server\90\DTS\Binn\";***<CUT>***

You have to do that for every element on the path that contains spaces. You must then continue to maintain that quoting, i.e. if you install new software on the server running Clarity, you have to immediately verify that it hasn't added spaces to the path, otherwise Clarity will stop working when next you try to start it from the command line (not sure if it will or won't work as a service in that scenario, though).

To change the value of the environment variables, go to start ->Settings -> Control Panel -> System ->Advanced ->Environment Variables. Choose the appropriate variable, edit them and save and exit.
Re launch the command shell and run install.bat.

Status:

Planned for a resolution in an upcoming Clarity 12 Service Pack.

Keywords: CLARITYKB, CLRT-13878, clarity12open.

Environment

Release:
Component: PPMENV