Troubleshoot common exception when executing in console mode


  • Please use Ctrl+F to look for the exceptions and errors you have encountered quickly.
  • If the exception you are looking for is not documented, please go to the Katalon forum for further support.
Issue Solution

joptsimple.IllegalOptionSpecificationException: is not a legal option character 
Expand to see the full logjoptsimple.IllegalOptionSpecificationException: $ is not a legal option character at joptsimple.ParserRules.ensureLegalOptionCharacter( at joptsimple.ParserRules.ensureLegalOption( at joptsimple.ParserRules.ensureLegalOptions( at joptsimple.OptionParser.acceptsAll( at joptsimple.OptionParser.acceptsAll( at joptsimple.OptionParser.accepts( at com.kms.katalon.execution.console.ConsoleMain.acceptConsoleOptionList( at com.kms.katalon.execution.console.ConsoleMain.launch( at com.kms.katalon.console.application.Application.runConsole( at com.kms.katalon.core.application.Application.runConsole( at com.kms.katalon.core.application.Application.start( at at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication( at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start( at at at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke( at sun.reflect.DelegatingMethodAccessorImpl.invoke( at java.lang.reflect.Method.invoke( at org.eclipse.equinox.launcher.Main.invokeFramework( at org.eclipse.equinox.launcher.Main.basicRun( at

This is because the name of your global variables might contain special characters like $, or a space. For instance: 

  • -g_myVar="test" (supported)
  • -g_$myVar="test" (not supported)
We recommend giving global variables a name without $, and/or space.
When executing tests in KRE in Windows with Chrome version 93.x or 94.x, users may come across the following error:
SessionNotCreatedException: Message: session not created from timeout: Timed out receiving message from renderer: 600.000
This is an issue from Chrome version 93.x and 94.x that doesn’t allow the ChromeDriver to start as a Windows service. 
Here are two workarounds for this issue:
1. Set --disable-gpu for the desired capability in Project Settings > Desired Capabilities > Web UI > Chrome. Click Add, then input as follows:
Name Type Value
args List --disable-gpu


Set desired capabilities in chrome
2. Downgrade to Chrome version 92.x. To downgrade ChromeDriver versions, you can refer to this guide here: Update or Downgrade WebDrivers.
New and old proxy mechanisms are not allowed in one command. Please use either the new or the old one
If you encounter the above error when executing your test with Katalon Runtime Engine, please check if you are mixing options of the new mechanism with options for proxy configuration prior to 7.5.0 and correct the commands in use. Learn more at Proxy options.