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
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
Create a "version" folder under the Browser folder with the exact version number
Extract the driver executable and place it into the version folder
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.