How to run katalon studio test case/test suite on remote/virtual machine

Hi Team,

Can you help sharing detailed steps to execute katalon studio test case/suite on remote machine(i.e. like selenium grid).
I have already tried with available option “Access the Remote Web setting from Main Menu > Project > Settings > Execution > Default > Web UI > Remote Web” but no luck.

Below are the details:
Remote web server url : http://myremotemachine ip address:8088/wd/hub
Remote web server type : Selenium
os : windows
browser : chrome

Issue:
Unable to open browser with url: ‘’ (Root cause: org.openqa.selenium.WebDriverException: Unable to parse remote response: 404 Not Found

Queries:
1. Am i giving the right port number?
2. Is my remote web server url in right format?
3. Do we need to give any other additional details apart from “os” & “browser” under remote settings?
4. Do we need setup/install anything on remote/virtual machine in order to execute script?

Sample script:

WebUI.openBrowser(’’)

WebUI.navigateToUrl(‘http://about:blank’)

Note:
Executing script using remote option
Executing script from my local machine

Kindly help me on this.

Regards,
Siva.B

2 Likes

sivanageswararao said:

Hi Team,
— —
Queries:
1. Am i giving the right port number?
2. Is my remote web server url in right format?
3. Do we need to give any other additional details apart from “os” & “browser” under remote settings?
4. Do we need setup/install anything on remote/virtual machine in order to execute script?
— —

Hello,
1. Yes (to check put that address to your browser and check for response)
2. Yes
3. Nope
4. Yes, you need to install/setup selenium grid on remote server otherwise no one will response to request from katalon studio to execute tests.
it’s like shouting to empty building - no one will answer unless you setup somebody who understand what you shouting and how to deal with it.

Hi,

Thanks for clarifying my queries.
As per your instructions, i have done selenium grid setup.

Below is my configuration:
Local Machine Setup:
1. Placed selenium-server-standalone-3.0.1.jar file under the same location where my katalon.exe file located
2. Open command prompt from the same folder and executed below command
java -jar selenium-server-standalone-3.0.1.jar -role hub
Output:
Selenium Grid hub launched successfully.

Remote Machine Setup:
1. Placed chromedriver.exe and selenium-server-standalone-3.0.1.jar files under C folder
2. Open command prompt from the same folder and executed below command
java -Dwebdriver.chrome.driver=C:\Eclipse/chromedriver.exe -jar selenium-server-standalone-3.0.1.jar -role node -hub http://hubmachine ip address:4444/grid/register
Output:
Selenium node launched successfully.

Hub/Local machine:
http://localhost:4444/grid/console

Katalon Studio Setup:
Access the Remote Web setting from Main Menu > Project > Settings > Execution > Default > Web UI > Remote Web
Remote web server url : http://myremotemachine ip address:5555/wd/hub
Remote web server type : Selenium
os : windows
browser : chrome

Script:

WebUI.openBrowser(’’)

WebUI.navigateToUrl(‘www.gmail.com’)

I have selected run option as “Remote”

Error message:

10-25-2018 11:49:44 AM - [START] - Start Test Case : Test Cases/Test

10-25-2018 11:49:44 AM - [INFO] - Evaluating variables for test case

10-25-2018 11:49:44 AM - [START] - Start action : openBrowser

10-25-2018 11:49:45 AM - [INFO] - Opening browser

10-25-2018 11:49:45 AM - [INFO] - Starting ‘Remote’ driver

10-25-2018 11:49:45 AM - [INFO] - User set preference: [‘os’, ‘windows’]

10-25-2018 11:49:45 AM - [INFO] - User set preference: [‘browser’, ‘chrome’]

10-25-2018 11:49:45 AM - [INFO] - Connecting to remote web server ‘http://10.64.93.189:5555/wd/hub’ with type ‘Selenium’

10-25-2018 11:49:45 AM - [INFO] - Action delay is set to 0 seconds

10-25-2018 11:49:46 AM - [FAILED] - Unable to open browser with url: ‘’ (Root cause: org.openqa.selenium.WebDriverException: The best matching driver provider org.openqa.selenium.edge.EdgeDriver can’t create a new driver instance for Capabilities [{os=windows, browser=chrome}]

Build info: version: ‘3.0.1’, revision: ‘1969d75’, time: ‘2016-10-18 09:48:19 -0700’

System info: host: ‘RemoteMachineName’, ip: ‘IPAddress’, os.name: ‘Windows 8.1’, os.arch: ‘amd64’, os.version: ‘6.3’, java.version: ‘1.8.0_121’

Driver info: driver.version: unknown

Command duration or timeout: 265 milliseconds)

10-25-2018 11:49:46 AM - [END] - End action : openBrowser

10-25-2018 11:49:46 AM - [FAILED] - Test Cases/Test FAILED because (of) Unable to open browser with url: ‘’ (Root cause: org.openqa.selenium.WebDriverException: The best matching driver provider org.openqa.selenium.edge.EdgeDriver can’t create a new driver instance for Capabilities [{os=windows, browser=chrome}]

Build info: version: ‘3.0.1’, revision: ‘1969d75’, time: ‘2016-10-18 09:48:19 -0700’

System info: host: ‘RemoteMachineName’, ip: ‘IPAddress’, os.name: ‘Windows 8.1’, os.arch: ‘amd64’, os.version: ‘6.3’, java.version: ‘1.8.0_121’

Driver info: driver.version: unknown

Command duration or timeout: 265 milliseconds)

10-25-2018 11:49:46 AM - [END] - End Test Case : Test Cases/Test

to use chrome you need to install chromedriver and let your hub know where to find it

After lot of struggle, finally resolved the issue. Below are the details

Hub
Machine Configurations:

  1. Place
    selenium-server-standalone-3.0.1.jar file under katalon.exe file location.

2. Open command prompt from the same location and execute hub command
Command:
java -jar
selenium-server-standalone-3.0.1.jar -role hub

Node Machine
Configurations:

1. Place
selenium-server-standalone-3.0.1.jar and chromedriver.exe files under C
drive any folder(i.e. C:\SeleniumGrid) location

2. Open command prompt
from the same location and execute below command

Command:
java
-Dwebdriver.chrome.driver=C:\SeleniumGrid/chromedriver.exe -jar
selenium-server-standalone-3.0.1.jar -role node -hub http://hubmachineipaddress:4444/grid/register

Note: Please provide your hub machine ip address

Hub
Machine Configurations and Script run:

1. Open any browser and access console url(http://localhost:4444/grid/console) for seeing node register

2. Katalon Studio Script

Code:

import
static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint

import
static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase

import
static com.kms.katalon.core.testdata.TestDataFactory.findTestData

import
static com.kms.katalon.core.testobject.ObjectRepository.findTestObject

import
com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint

import
com.kms.katalon.core.checkpoint.CheckpointFactory as CheckpointFactory

import
com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as
MobileBuiltInKeywords

import
com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile

import
com.kms.katalon.core.model.FailureHandling as FailureHandling

import
com.kms.katalon.core.testcase.TestCase as TestCase

import
com.kms.katalon.core.testcase.TestCaseFactory as TestCaseFactory

import
com.kms.katalon.core.testdata.TestData as TestData

import
com.kms.katalon.core.testdata.TestDataFactory as TestDataFactory

import
com.kms.katalon.core.testobject.ObjectRepository as ObjectRepository

import
com.kms.katalon.core.testobject.TestObject as TestObject

import
com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WSBuiltInKeywords

import
com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS

import
com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUiBuiltInKeywords

import
com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI

import
internal.GlobalVariable as GlobalVariable

import
org.openqa.selenium.Platform;

import
org.openqa.selenium.WebDriver;

import
org.openqa.selenium.remote.DesiredCapabilities;

import
org.openqa.selenium.remote.RemoteWebDriver;

WebDriver
driver = new RemoteWebDriver(new
java.net.URL(“http://localhost:4444/wd/hub”),
DesiredCapabilities.chrome());

driver.get(“http://www.google.com”);

Note: Please
don’t give node machine ip address in the above URL, because, that didn’t work for me

3. Remote settings on katalon studio:

Navigation:
Menu, Project --> Settings --> Execution --> Default --> Web UI
–> Remote, Provide below details

Remote
web server url : http://nodemachineipaddress:5555/wd/hub
(It’s example data: 10.19.33.125 is the node machine ip address, 5555 is the hub
registered node)

Remote
web server type : Selenium

os
: windows

Browser
: Chrome

Click Apply and OK

  1. Click
    Run and select “Remote” option

Output:

You can see the execution on remote machine(i.e. node machine)

3 Likes

nice, congratulation

Team, is remote execution option is not there for Test Suite Collections?

Hi, Remote execution option is not available under Test Suite Collections, but, when you click on “Execute” button under Test Suite Collections, script will automatically executes in Remote.

Reason: Test case and execution settings contains the remote configuration
Please let me know if things are not clear

No Siva, when i tried Execute from Test suite collections it triggered suite on my local machine instead of picking remote.

Please see my remote settings:

Remote settings on katalon studio:

Navigation: Menu, Project --> Settings --> Execution --> Default --> Web UI --> Remote, Provide below details

Remote web server url : http://nodemachineipaddress:5555/wd/hub (It’s example data: 10.19.33.125 is the node machine ip address, 5555 is the hub registered node)

Remote web server type : Selenium

os : windows

Browser : Chrome

Click Apply and OK

If possible can you help sharing your remote settings and katalon studio script or share some screens.

Done all mentioned settings , still my test cases are running on local machine. Can someone plz help if any other setting is required.

the session is created but when i use command webUI it says
“org.openqa.selenium.WebDriverException: Requested environment is not available”

any ideas?

@sivanageswararao I follow your instructions and set up hub and node on my local machine. I manually went to http://mynodemachineipaddress:5019/wd/hub and see something. Please find the attached screen capture for node.


I change my Remote settings in katalon studio as per your instructions and created a Test suites to try Remote execution. When I run my test I got following error in katalon console:

2020-01-07 10:21:22.498 DEBUG testcase.EMV_TC1_1ProdConfig - 1: baseClassPackage.MasterClass.userLogin()
2020-01-07 10:21:23.210 INFO c.k.k.c.w.util.WebDriverPropertyUtil - User set preference: [‘os’, ‘Windows’]
2020-01-07 10:21:23.211 INFO c.k.k.c.w.util.WebDriverPropertyUtil - User set preference: [‘os_version’, ‘10.0’]
2020-01-07 10:21:23.211 INFO c.k.k.c.w.util.WebDriverPropertyUtil - User set preference: [‘browser’, ‘Chrome’]localhost:
2020-01-07 10:21:23.212 INFO c.k.k.c.w.util.WebDriverPropertyUtil - User set preference: [‘rowser_version’, ‘79.0.3945.88’]
2020-01-07 10:21:23.216 INFO c.k.k.core.webui.driver.DriverFactory - Connecting to remote web server ‘http://mynodemachineipaddress:5019/wd/hub’ with type ‘Selenium’
2020-01-07 10:21:24.292 INFO c.k.k.core.webui.driver.DriverFactory - Action delay is set to 0 seconds
2020-01-07 10:21:24.669 ERROR c.k.k.core.keyword.internal.KeywordMain - :x: Unable to open browser with url: ‘https://genesis.dev.lrescorp.com’ (Root cause: com.kms.katalon.core.exception.StepFailedException: Unable to open browser with url: ‘https://genesis.dev.lrescorp.com
at com.kms.katalon.core.webui.keyword.internal.WebUIKeywordMain.stepFailed(WebUIKeywordMain.groovy:64)
at com.kms.katalon.core.webui.keyword.internal.WebUIKeywordMain.runKeyword(WebUIKeywordMain.groovy:26)
at com.kms.katalon.core.webui.keyword.builtin.OpenBrowserKeyword.openBrowser(OpenBrowserKeyword.groovy:81)
at com.kms.katalon.core.webui.keyword.builtin.OpenBrowserKeyword.execute(OpenBrowserKeyword.groovy:67)
at com.kms.katalon.core.keyword.internal.KeywordExecutor.executeKeywordForPlatform(KeywordExecutor.groovy:72)
at com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords.openBrowser(WebUiBuiltInKeywords.groovy:60)
at com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords$openBrowser.call(Unknown Source)
at baseClassPackage.MasterClass.userLogin(MasterClass.groovy:65)
at baseClassPackage.MasterClass.invokeMethod(MasterClass.groovy)
at com.kms.katalon.core.main.CustomKeywordDelegatingMetaClass.invokeStaticMethod(CustomKeywordDelegatingMetaClass.java:50)
at EMV_TC1_1ProdConfig.run(EMV_TC1_1ProdConfig:25)
at com.kms.katalon.core.main.ScriptEngine.run(ScriptEngine.java:194)
at com.kms.katalon.core.main.ScriptEngine.runScriptAsRawText(ScriptEngine.java:119)
at com.kms.katalon.core.main.TestCaseExecutor.runScript(TestCaseExecutor.java:337)
at com.kms.katalon.core.main.TestCaseExecutor.doExecute(TestCaseExecutor.java:328)
at com.kms.katalon.core.main.TestCaseExecutor.processExecutionPhase(TestCaseExecutor.java:307)
at com.kms.katalon.core.main.TestCaseExecutor.accessMainPhase(TestCaseExecutor.java:299)
at com.kms.katalon.core.main.TestCaseExecutor.execute(TestCaseExecutor.java:233)
at com.kms.katalon.core.main.TestSuiteExecutor.accessTestCaseMainPhase(TestSuiteExecutor.java:169)
at com.kms.katalon.core.main.TestSuiteExecutor.accessTestSuiteMainPhase(TestSuiteExecutor.java:142)
at com.kms.katalon.core.main.TestSuiteExecutor.execute(TestSuiteExecutor.java:91)
at com.kms.katalon.core.main.TestCaseMain.startTestSuite(TestCaseMain.java:157)
at com.kms.katalon.core.main.TestCaseMain$startTestSuite$0.call(Unknown Source)
at TempTestSuite1578421279572.run(TempTestSuite1578421279572.groovy:36)
Caused by: org.openqa.selenium.SessionNotCreatedException: Unable to create session from {
“desiredCapabilities”: {
“proxy”: {
“proxyType”: “direct”
},
“os”: “Windows”,
“rowser_version”: “79.0.3945.88”,
“browser”: “Chrome”,
“os_version”: “10.0”
},
“capabilities”: {
“firstMatch”: [
{
“proxy”: {
“proxyType”: “direct”
}
}
]
}
}

Can you please help me or guide me what I am doing wrong. Thank you in advance

@sshah,

Please follow this document to add Desired Capabilities: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities

Sample of using:

browserName: chrome
version: 79
platform: WINDOWS

Thank you @duyluong it’s working now. when I added desired capabilities, browser version I defined as ‘Chrome’ instead of ‘chrome’. It’s cases sensitive. Weird but working!

My organization bought 2 KSE and 2 KRE floating licenses. We successfully installed KSE licenses on local machines but we having issues installing floating KRE license. When I try to run Test suites through CMD line from my local machine where I have KSE license installed, I’m getting following error:
Trial license is only available for Katalon accounts registered with a business email.
Online activation for console mode failed.
Activation failed. Please make sure you are using a valid license.
All launchers terminated

Does anyone know or have any kind of information on how to Install floating KRE license? Can I install floating KRE license on my local machine with existed KSE license or floating KRE is only for DevOps, Azure and Docker.

Do I need node-locked KRE license instead? I would appreciate any feedback on this post. Thank you