Unable to Open Project: Invalid Project Description, but it works on Jenkins windows but no Ubuntu

Bit of an odd one.
My test suite runs fine on windows 11 (my local Jenkins), but gives error on my cloud Ubuntu 24.

[2024-09-15T09:40:48.403841014] Cleaning up workspace
[2024-09-15T09:40:48.404442216] Opening project file: /var/lib/jenkins/workspace/KatalonPipelineTestSuite/KatalonCode.prj
[2024-09-15T09:40:49.376514875] org.eclipse.core.internal.resources.ResourceException: Invalid project description.
[2024-09-15T09:40:49.376557775] 	at org.eclipse.core.internal.resources.Project.checkDescription(Project.java:178)
[2024-09-15T09:40:49.376562975] 	at org.eclipse.core.internal.resources.Project.assertCreateRequirements(Project.java:62)
[2024-09-15T09:40:49.376566575] 	at org.eclipse.core.internal.resources.Project.create(Project.java:272)
[2024-09-15T09:40:49.376569975] 	at org.eclipse.core.internal.resources.Project.create(Project.java:258)
[2024-09-15T09:40:49.376573075] 	at com.kms.katalon.groovy.util.GroovyUtil.initGroovyProjectDescription(GroovyUtil.java:653)
[2024-09-15T09:40:49.376576575] 	at com.kms.katalon.groovy.util.GroovyUtil.initFullGroovyProject(GroovyUtil.java:197)
[2024-09-15T09:40:49.376579875] 	at com.kms.katalon.controller.ProjectController.openProject(ProjectController.java:232)
[2024-09-15T09:40:49.376583275] 	at com.kms.katalon.console.handlers.ProjectHandler.getProject(ProjectHandler.java:71)
[2024-09-15T09:40:49.376586475] 	at com.kms.katalon.console.handlers.ProjectHandler.findProject(ProjectHandler.java:44)
[2024-09-15T09:40:49.376589575] 	at com.kms.katalon.console.application.ConsoleMain.launch(ConsoleMain.java:136)
[2024-09-15T09:40:49.376592875] 	at com.kms.katalon.console.application.ConsoleApplicationStarter.start(ConsoleApplicationStarter.java:34)
[2024-09-15T09:40:49.376605675] 	at com.kms.katalon.application.Application.runConsole(Application.java:140)
[2024-09-15T09:40:49.376608875] 	at com.kms.katalon.application.Application.start(Application.java:100)
[2024-09-15T09:40:49.376612075] 	at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:203)
[2024-09-15T09:40:49.376615275] 	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:136)
[2024-09-15T09:40:49.376618475] 	at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
[2024-09-15T09:40:49.376621675] 	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:402)
[2024-09-15T09:40:49.376632776] 	at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:255)
[2024-09-15T09:40:49.377129577] 	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
[2024-09-15T09:40:49.377140278] 	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77)
[2024-09-15T09:40:49.377156978] 	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
[2024-09-15T09:40:49.377160478] 	at java.base/java.lang.reflect.Method.invoke(Method.java:569)
[2024-09-15T09:40:49.377164078] 	at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:659)
[2024-09-15T09:40:49.377167578] 	at org.eclipse.equinox.launcher.Main.basicRun(Main.java:596)
[2024-09-15T09:40:49.377181178] 	at org.eclipse.equinox.launcher.Main.run(Main.java:1467)
[2024-09-15T09:40:49.377184678] 	at org.eclipse.equinox.launcher.Main.main(Main.java:1440)
[2024-09-15T09:40:49.377188078] Contains: OK
[2024-09-15T09:40:49.377191678] Contains: /var/lib/jenkins/workspace/KatalonPipelineTestSuite overlaps the workspace location: /var/lib/jenkins/workspace/KatalonPipelineTestSuite/katData
[2024-09-15T09:40:49.377195378] 
[2024-09-15T09:40:49.377211678] Start clean up session
[2024-09-15T09:40:49.377215878] End clean up session
[2024-09-15T09:40:49.378005781] Start release license task
[2024-09-15T09:40:49.634763374] License released
[2024-09-15T09:40:49.634919874] End release license task
[2024-09-15T09:40:49.637112783] All launchers terminated
[2024-09-15T09:40:50.347717531] Finished executing sh -c /home/katalon_installation/Katalon_Studio_Engine_Linux_64-9.6.0/katalonc ./katalonc -noSplash -runMode=console -projectPath="/var/lib/jenkins/workspace/KatalonPipelineTestSuite/KatalonCode.prj" -browserType="Chrome (headless)" -retry=0 -statusDelay=2 -testSuitePath="Test Suites/PipelineTestSuite" -apiKey="xxx" -data "/var/lib/jenkins/workspace/KatalonPipelineTestSuite/katData" . Exit code: 2.
Build step 'Execute Katalon Studio Tests' marked build as failure
Recording test results
No test report files were found. Configuration error?
Finished: FAILURE
[KatalonCode.prj|attachment](upload://yofTYUOCb4wvRhyfAK01mv5TUf7.prj) (1.2 KB)
[.project|attachment](upload://aHV3p43DKsB3R5PUZTLP3umEoRT) (971 Bytes)
2 Likes

Hi there, :wave:

Thank you very much for your topic! It may take a little while before Katalon team member or others forum members respond to you.

In the meantime, you can double-check your post to see if you can add any extra information i.e. error logs, HTML codes, screenshots, etc. Check out this posting guide to help us help you better!

Thanks! :sunglasses:
Katalon Community team

Hi @tekautomation3,

Welcome to our community. After doing some research, I would like to suggest:

  1. The error log contains this message:
    Contains: /var/lib/jenkins/workspace/KatalonPipelineTestSuite overlaps the workspace location: /var/lib/jenkins/workspace/KatalonPipelineTestSuite/katData
    

This indicates that the workspace location for the project (/katData) overlaps with the Jenkins workspace directory. Katalon requires a separate one. Please check and change the working directory of the Jenkins job to another, try to set a different -data argument for Katalon, or create a separate workspace for the project.

Example:

katalonc -noSplash -runMode=console -projectPath="/var/lib/jenkins/workspace/KatalonPipelineTestSuite/KatalonCode.prj" \
-browserType="Chrome (headless)" -retry=0 -statusDelay=2 -testSuitePath="Test Suites/PipelineTestSuite" \
-apiKey="xxx" -data "/var/lib/jenkins/workspace/SeparateDataDirectory"
  1. The Invalid project description error could also indicate that some project files (like .prj or .project) are corrupted or missing in the cloud environment.

=> Ensure that all necessary project files, including KatalonCode.prj, .project, and .classpath, are correctly synced or uploaded to the cloud environment. Verify the integrity of these files and check that they’re not empty or corrupted.

  1. Check the permissions of Jenkins user on Ubuntu server to read/write on the project files/dir

In case none helps, try to clear the cached data in the Jenkins workspace (You can configure this in the Jenkins job settings under β€œBuild Environment” β†’ β€œDelete workspace before build starts”.)

Let me know if it works/not work

Thanks! The issue was indeed the overlap with the Jenkins workspace directory.
I changed to another location for Katalon data and the error is now gone.

1 Like