Last updated: Dec 09, 2019 15:28
Error messages
| Error Message | Meaning | What to do |
|---|---|---|
| Proxy requires authentication | Your machine is behind an authenticated proxy, and Perfecto Connect requires your credentials in order to continue. | Proxy credentials can be supplied using the outgoingproxyusername and outgoingproxypassword parameters. |
| Can't reach Perfecto Connect service at https://<lab_name>.connect.perfectomobile.com | The Perfecto Connect executable was unable to communicate with the Perfecto Connect service. | Verify network access to the URL provided. See what to whitelist. |
| Can't start Perfecto Connection session: Failed to create a new session, authentication failed using ClientAuthentication | Either -
| Verify that the Perfecto Lab URL is correct and/or generate a new security token. |
| Connectivity test failed to Perfecto node server vpn.demo.perfectomobile.com | Perfecto Connect unable to access the described host on port 443. | Verify outgoing network access to this host on port 443 |
| Can't start ssh on tunnel to port <port> - <URL> | Perfecto Connect utilizes several STunnel servers to connect your client to the service. One of these tunnels is being blocked by your network security. | Add the STunnel address to your network's white-list. To see how see below. |
Failed to connect to at least one node | Perfecto Connect was unable to initiate any connection to the Perfecto Connect nodes. | Please contact Perfecto support. |
| Failed to execute command wifi.settings set: setWifiSettings command failed | Perfecto Connect was unable to prepare the device for the session. | Please contact Perfecto support. |
| tunnelId=<tunnelId> not exists | Will appear during the Automation Script execution - the value in the tunnelId capability does not point to a valid STunnel connection. | Verify that the value of the capability corresponds to the tunnel that was opened. Try reconnecting the client to obtain a new tunnel id and update the capability value appropriately. |
| Failed to activate tunnel - tunnelId=<tunnelId> not opened for this Perfecto Lab | The tunnel identified by the capability is connected to a different Perfecto Lab from the one identified in the automation driver initialization URL. | Verify that the URL of the automation script is the same as the one used when running the Perfecto Connect client. Rerun the client on the correct Perfecto Lab and use the new tunnel identifier. |
| Failed to activate tunnel - tunnel is not connected - please rerun the client | The client is running but failed to connect to specific regions. | Rerun the client on the Perfecto Lab and use the new tunnel identifier. If problem persists, contact Perfecto support. |
Troubleshoot access to local apps or data
When accessing resources from the user's workstation from an iOS device use the IP address of the workstation, not "localhost" - iOS interprets addresses at localhost to refer to information on the device, rather than on the hosting machine
White-list the STunnel Addresses
Start the Perfecto Connect client in the foreground (with the -f flag set):
macosx:/usr/local/etc/perfecto$ ./perfectoconnect start -c demo.perfectomobile.com -s eyJhbGciOiJSUz...DxAkAuw82Hao7qrA -f
The client outputs the different process steps to the console, including steps in the following format:
11:11:38.340 launchTunnels ▶ DEBUG 003 Starting up channel on <port> [<address>]
Make sure to add the <address> included in the line to your network's white list.