Katalon Runtime Engine tests fail after migrating to Katalon True Platform

Last updated: July 2026

Condition

After upgrading from Katalon True Platform Legacy to Katalon True Platform, your Katalon Runtime Engine tests fail to run.

Cause

In the new version of Katalon True Platform, licenses are managed at the Organization level instead of the Account level. During migration, all existing licenses remain at the Account level by default.

If your Katalon Runtime Engine commands contain the -orgId parameter, they look for an Organization-level license. When no licenses are assigned to that Organization, Katalon Runtime Engine cannot validate the license and the execution fails.

Remedy

The Account Admin needs to assign the licenses to the Organization specified in the Katalon Runtime Engine commands.

1. Sign in to your Katalon True Platform Admin account.
2. Go to Admin Settings > Organization Settings > License Management.
3. Switch to the Katalon Runtime Engine tab and select Assign Dedicated Licenses.
4. Select the Organization that is the same in the -orgId parameter and specify the number of license(s).
5. Click Assign.

After this change, your Katalon Runtime Engine commands should work again without further setup.

note

• If your Katalon Runtime Engine commands do not use -orgId, no action is needed.
• If you use a mix of commands (some with and some without -orgId), assign licenses to both your Account and your Organization.

If you need help identifying which commands use -orgId or how to check your license setup, contact Katalon Support Team. Make sure to include your Account ID and Org ID for faster assistance.