Katalon agent don't download the latest version of KRE

Product Forums Katalon Studio
, ,
1

Hi guys,

We are using Katalon Runtime Engine (on a VM) with TestOps & GIT.
Recently, i added a new functionnality (send mail after TestSuite Collection and TestSuite, it’s working fine on my Laptop with KSE 10.2.0). In the debug log on TestOps i can see some error about sending the email.

[2025-05-16T07:52:16.285Z] [DEBUG]: 	System is unable to email report. Reason: groovy.lang.MissingPropertyException: No such property: totalIncomplete for class: Script1
	at org.codehaus.groovy.runtime.ScriptBytecodeAdapter.unwrap(ScriptBytecodeAdapter.java:65)
	at org.codehaus.groovy.runtime.callsite.PogoGetPropertySite.getProperty(PogoGetPropertySite.java:51)
	at org.codehaus.groovy.runtime.callsite.AbstractCallSite.callGroovyObjectGetProperty(AbstractCallSite.java:341)
	at Script1.run(Script1.groovy:1)
	at groovy.lang.GroovyShell.evaluate(GroovyShell.java:427)
	at groovy.lang.GroovyShell.evaluate(GroovyShell.java:461)
	at groovy.lang.GroovyShell.evaluate(GroovyShell.java:436)
	at com.kms.katalon.groovy.util.GroovyStringUtil.evaluate(GroovyStringUtil.java:24)
	at com.kms.katalon.execution.util.MailUtil.sendSummaryMailForTestSuite(MailUtil.java:178)
	at com.kms.katalon.execution.launcher.ReportableLauncher.sendReportEmail(ReportableLauncher.java:364)
	at com.kms.katalon.execution.launcher.ReportableLauncher.sendReport(ReportableLauncher.java:307)
	at com.kms.katalon.execution.launcher.ReportableLauncher.preExecutionComplete(ReportableLauncher.java:164)
	at com.kms.katalon.execution.launcher.ProcessLauncher.onWatchdogComplete(ProcessLauncher.java:200)
	at com.kms.katalon.execution.launcher.LaunchWatchdog.notifyProcessTerminated(LaunchWatchdog.java:136)
	at com.kms.katalon.execution.launcher.LaunchWatchdog.run(LaunchWatchdog.java:66)
	at java.base/java.lang.Thread.run(Thread.java:833)

After investiguation, i found that the KRE version used by the agent is outdated (9.7.5).
In testOps, it is configure to use the latest version.

image
image1126×784 40.4 KB

I tried to delete the 9.7.5 folder, but the agent always download the version 9.7.5 instead of 10.2.0

I put the agent log in DEBUG, i can see, he get the versions on the url https://download.katalon.com/katalon-studio/releases.json but he still download the version 9.7.5

Anyone know why or what i can do to always use the latest version of KRE ?

Thanks in advance

1 Like
2

Hi there, and thanks for posting in the Katalon community! :hugs:

To help you faster, please review our guide on Git here:

Double-checking the steps and configurations might resolve the issue.

If the doc doesn’t help, feel free to provide more details, and a community member will assist you soon. Thanks for being a part of our community!

Best,
Elly Tran

3

To resolve the KRE agent persistently downloading version 9.7.5 instead of the latest (e.g., 10.2.0), follow these steps:

1. Force KRE Version in Agent Configuration

Explicitly specify the desired KRE version in the agent’s agent.properties file:

# File: /opt/katalon/agent/agent.properties
kre.version=10.2.0

Note: If the file doesn’t exist, create it in the agent’s installation directory.

2. Update TestOps Agent to Latest

Ensure the TestOps agent itself is up-to-date:

  1. Stop the agent service.
  2. Backup existing configuration:
cp -r /opt/katalon/agent /opt/katalon/agent_backup
  1. Download the latest agent:
wget https://download.katalon.com/testops/agent/latest/linux/katalon-agent-linux.zip
unzip katalon-agent-linux.zip -d /opt/katalon/agent
  1. Restore your agent.properties and restart the agent.

3. Clear Agent Cache

Delete cached KRE versions and temporary files:

# Remove cached KRE versions
rm -rf /opt/katalon/agent/kre/*

# Clear agent temp files
rm -rf /opt/katalon/agent/work/*

4. Verify TestOps Project Settings

Confirm the project uses “Latest” KRE in TestOps:

  1. Go to TestOps > Project > Configurations.
  2. Under Runtime Engine, select Use latest version.
  3. Save and re-run the job.

5. Manually Install KRE 10.2.0

Bypass automatic downloads by manually installing KRE:

  1. Download KRE 10.2.0:
wget https://download.katalon.com/katalon-studio/10.2.0/Katalon_Runtime_Engine_Linux_64-10.2.0.tar.gz
  1. Extract it to the agent’s KRE directory:
tar -xzf Katalon_Runtime_Engine_Linux_64-10.2.0.tar.gz -C /opt/katalon/agent/kre/
  1. Update agent.properties to point to the manual install:
kre.version=10.2.0
kre.auto.update=false

6. Check Agent Logs for Errors

Monitor the agent’s debug logs during job execution:

tail -f /opt/katalon/agent/logs/engine.log | grep "Downloading KRE"

Look for errors like network timeouts or permission issues.

7. Disable Version Pinning (If Applicable)

If your TestOps project uses a Git integration with a katalon-analytics.json file, ensure it doesn’t pin the KRE version:

// katalon-analytics.json
{
  "kreVersion": "latest" // Not "9.7.5"
}

8. Network Configuration

Ensure the VM has unrestricted access to:

  • https://download.katalon.com
  • https://testops.katalon.io

Firewall/Proxy: Whitelist these domains if behind a corporate network.

Post-Upgrade Validation

After upgrading, verify:

  1. The email script error (MissingPropertyException) resolves, as newer KRE versions include updated APIs.
  2. The agent log shows KRE 10.2.0 being used:
[INFO ] 2025-05-16 07:52:16.285 [main] - Using KRE version: 10.2.0

By forcing the KRE version, updating the agent, and ensuring network access, the agent should download and use the correct KRE version.

4

Thank you

If i’m forcing the KRE version, it’s working fine and no error with email script.
It’s just the “Latest” option seems to be broken

1 Like
5

Hi @braynaud, are you a Katalon customer? Then, you can raise a support ticket here: https://katalon-inc.my.site.com/support/