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.