Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Mar 05, 2018 09:54

This article describes possible error messages and possible solutions to them

Important: This feature is available only for limited release, to add support for the feature contact support.

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):

  • vpn.<lab-name>*
  • <lab-name> -


    <lab-name> is the "name" of your Perfecto Lab, for example if you connect to the Perfecto Lab at: "" then the <lab-name> is "mytest" and you should add the URLs:  and vpn.mytest* to your network's white-list.

  • - The Perfecto Connect execution service.

Possible error messages

Error MessageMeaningWhat to do
Proxy requires authenticationYour 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.comThe 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 -

  • The wrong Perfecto Lab URL was supplied
  • The security-token used was rejected.
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.comPerfecto 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 failedPerfecto Connect was unable to prepare the device for the session.Please contact Perfecto support.
tunnelId=<tunnelId> not existsWill 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 clientThe 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):

macosx:/usr/local/etc/perfecto$ ./perfectoconnect start -c -s eyJhbGciOiJSUz...DxAkAuw82Hao7qrA -f

The client will output the different process steps to the console. Including steps with the following format:

11:11:38.340 launchTunnels ▶ DEBUG 003 Starting up channel on <port> [<address>]

The <address> included in the line should be added to your network's white-list.

Note: There may be more than one tunnel to add to the network white-list.