This article describes possible error messages and possible solutions to them
Perfecto Connect network requirements
The Perfecto Connect executable requires outgoing network access to the following URL. Add them to your system's security white-list (may require assistance from your IT personnel):
<lab-name> is the "name" of your Perfecto Lab, for example if you connect to the Perfecto Lab at: "mytest.perfectomobile.com" then the <lab-name> is "mytest" and you should add the URLs: mytest.connect.perfectomobile.com andto your network's white-list.
tests-executor.perfectomobile.com - The Perfecto Connect execution service.
Possible 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||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|
|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.
Accessing local app or data troubleshooting
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-listing the STunnel Addresses
Start the perfectoconnect client in the foreground (with -f flag set):
The client will output the different process steps to the console. Including steps with the following format:
The <address> included in the line should be added to your network's white-list.