Katalon Test Execution - Local tests fail after migrating to Katalon True Platform

Condition

After upgrading from Katalon True Platform Legacy to Katalon True Platform, your Katalon Test Execution - Local 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 Test Engine - Local commands contain the -orgId parameter, they look for an Organization-level license. When no licenses are assigned to that Organization, Katalon Test Engine - Local cannot validate the license and the execution fails.

Remedy

The Account Admin needs to assign the licenses to the Organization specified in the Katalon Test Engine - Local 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 Test Engine - Local 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 Test Engine - Local commands should work again without further setup.

note

• If your Katalon Test Engine - Local 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.