TestProject Documentation
PlatformAddonsBlogForum
Search…
Welcome to TestProject!
Getting Started
Register and Collaborate
Installation and Setup
Create Your First Test
Why TestProject
Why Should You Use TestProject
What Makes TestProject Unique
Using AI to Improve Testing
TestProject Agents
What is a TestProject Agent?
How Does an Agent fit into the Ecosystem?
Hybrid Cloud and Offline Mode
TestProject Agent in Docker
TestProject Agent on Kubernetes
TestProject Agent CLI
Silent Deployment
Unregistered/Offline Agent
Smart Test Recorder
Web Testing
Mobile Testing
Create a Test Step
Finding and Using Elements
Available Actions
Available Validations
Step output validations
Using Data Driven Tests and Jobs in TestProject
Schedule and Run Tests
Manage TestProject Agents
Create and Schedule Jobs
Parallel Execution
Reports
Introduction to Reports in TestProject
Types of Plots in TestProject Reports
Individual Run Reports
Get Test Reports via API
Deleting old reports
TestProject Addons
What is an Addon?
Installing Community Addons from the store
Using Addons in the TestProject Recorder
Creating an Addon
Available Addons
Open Source SDK
Overview
OpenSDK (v2)
Using OpenSDK within CI/CD
Using OpenSDK with BDD
Legacy SDK (v1)
Integrations
qTest Integration
BrowserStack Integration
Genymotion Desktop Integration
Jenkins Integration
TeamCity Integration
Sauce Labs Integration
Setting up Email Notification
Slack Integration
CircleCI Integration
GitHub Integration
TestProject API
RESTful API v2
Getting Started With Using the TestProject API
Articles
Help Articles
Tips And Tricks
Supported Environments
Releases
v3.5.0
v3.4.0
Older Versions
Contact us
Support
Knowledge Base
FAQs
Powered By GitBook
Unregistered/Offline Agent
Unregistered or Disconnected Agent
TestProject Agent uses the TestProject cloud in oder to operate. Trough this communication channel, it can download an up-to-date dependencies, such as the Web or Mobile drivers or other components needed to operate correctly.

Unregistered Agent and Offline Mode

When the Agent is not registered and not authenticated with your TestProject account, it can still operate using the components that were bundled into the installer. However this implies several limitations, for example a version mismatch might occur, between the installed browser or the connected device and the bundled driver version.
Same limitations apply to a scenario when the Agent is offline and is not able to communicate with the TestProject cloud (even after it has been successfully registered). Not being able to update the drivers and other component to match the version of the installed browsers or the connected devices, won't allow the TestProject Agent to function correctly and will lead to:
  • Failure to open a recording session
  • Failure to mirror devices
  • Failure to execute tests or job
  • Failure to open a Development session using the SDKs
These errors will be clearly outlined in one of the following:
  • Popup presented in the browser
  • SDK console logs
  • Execution reports
The best solution in order to resolve this situation is to ensure that:
  • TestProject Agent is registered
  • TestProject Agent can connect to the internet
  • TestProject Agent is not restricted from communicating with the TestProject cloud.
Common scenarios for communication failures might be:
  • Firewall blocking any external communication with https://testproject.io
  • VPN routing the all traffic to an internal network and not to the internet (outside world).
  • DNS settings are invalid or do not allow resolution of internet addresses.
  • Antivirus or Security software communication.

Manual Drivers Update

When resolving the issues above and ensuring a proper communication channel is not possible, there is a manual way for updating the web drivers used by the Agent to operate the web browsers.
Agent stores the drivers in:
  • Windows - %appdata%\TestProject\Agent\deps\drivers
  • MacOS - ~/Library/Application Support/TestProject/Agent/deps/drivers
  • Linux - ./testproject/agent/deps/drivers
  • Docker - /var/testproject/agent/deps/drivers

Update Procedure

  1. 1.
    Download the relevant driver and place it in the right location.
    1. 1.
      Chrome - https://chromedriver.chromium.org/downloads​
    2. 2.
      Firefox - https://github.com/mozilla/geckodriver/releases​
    3. 3.
      Chromium Edge - https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver​
  2. 2.
    Determine yo browser version:
    1. 1.
      In Chrome open chrome://version/
    2. 2.
      In Firefox, check in the about menu.
    3. 3.
      In Chromium Edge open edge://settings/help
  3. 3.
    Create a "version" folder under the Browser folder with the exact version number
  4. 4.
    Extract the driver executable and place it into the version folder
  5. 5.
    Place the same executable in the workdir folder

Unregistered Agent and the SDK

When using the TestProject SDK with a not registerred or an offline TestProject Agent, there is no need to supply the development token, as the Agent is not able to verify and validate it with the TestProject Cloud. Even so, the development session will still be established without it when the Agent is not registered or offline.
TestProject Agents - Previous
Silent Deployment
Next - Smart Test Recorder
Web Testing
Last modified 11mo ago
Copy link
Contents
Unregistered Agent and Offline Mode
Manual Drivers Update
Update Procedure
Unregistered Agent and the SDK