Last updated: Jul 09, 2020 16:07
The installation may fail with the following error:
DevTunnel network requirements could not be verified.
To work around this issue, verify with your IT department that the network configuration of your connection to the Perfecto Lab complies with the following:
- The workstation is set up for internet communication.
- The firewall allows communication on port 443.
- The local network employs:
- A transparent proxy to connect to the Perfecto Lab. Vrify all CQ Lab sites included in the white-list of the proxy.
- Web inspection. Verify all CQ Lab sites included in the white-list of the proxy.
- The log file is saved in the following location:
- On Windows: C:\Program Files x86\Devtunnel\devTunnelInstallerLOG.txt
- On Mac: /tmp/devTunnel.log
Installation error messages
During the installation phase, the following error messages may appear:
What should you do
Try to restart the stunnel service manually:
|STunnel not responding (Mac only)||Kill the stunnel service and reinstall DevTunnel.|
|Failed to install packages (Mac only)||Some of the installed packages require that BREW has execute permission. Verify the permissions defined for the file: |
|XXX process is using the DevTunnel communication port (Mac only)|
DevTunnel normally uses designated TCP communication ports for the connection between the workstation and the Perfecto Lab. The error indicates that a different process on the workstation is using the communication port that DevTunnel is configured for.
Try to kill the XXX process and reinstall DevTunnel.
|Failed to create DevTunnel service (Windows only)|
Manually create the service from the file that was copied to the workstation.
Run the following command (in a cmd window):
sc create "Perfecto DevTunnel Service" binPath= "$INSTDIR\DevTunnelWindowsService.exe"
|Library not loaded: /usr/local/opt/openssl/lib/libssl.1.0.0.dylib Referenced from: /usr/local/bin/stunnel Reason: image not found checking if stunnel is running... STunnel failed to start (Mac only)|
This error appears in the
To resolve the issue, switch to an older OpenSSL package, for example using the following:
Retrieve log files (Mac)
Understanding the nature of problems in the DevTunnel session may be indicated by information included in the session log files. To access the log files when activating DevTunnel from a Mac workstation:
Before activating the DevTunnel session, open the terminal window and execute the following command:
Activate DevTunnel for the selected device.
A debug window opens, displaying the log information for the session. Isolate the log information associated with the DevTunnel problem.Click to view image
Turn off the debug console with the following command (in the terminal window).
- For information on troubleshooting issues related to Android devices, see here.
- For information on troubleshooting issues related to iOS devices, see here.
Contact Perfecto support
If you experience any of the following difficulties in connecting tyour device over DevTunnel, contact the Perfecto Support Team and open a support ticket:
- After connecting the device, all of the widget indicators show that the device is connected. However, the device is not displayed by adb, chrome://inspect, or the IDE device selection interface.
When contacting Perfecto Support, try to include any log files generated by the service.