Connection errors on iOS devices

Device fails to connect

If all indications work, but the device fails to connect, verify that you have the latest version of the DevTunnel service installed. To be sure, download the latest version and reinstall the service.

Connection error messages

The error messages listed in the following table may appear during the connection process.

Error message What you should do

Error message	What you should do
Failed to connect (in the Perfecto IDE)	Verify (using java -version) that Java JDK 1.7 or later is installed. If installed, try to reinstall DevTunnel. If not installed: Install the Java JDK. Reinstall DevTunnel.
DevTunnelRelay not running!	Check relay status: Copy `/usr/local/etc/stunnel/devtunnel_relay.sh status` If status returns that DevTunnel Relay is turned ON, turn off the relay as follows: Copy `sudo /usr/local/etc/stunnel/devtunnel_relay.sh off` Restart the relay as follows: Copy `sudo /usr/local/etc/stunnel/devtunnel_relay.sh on`

Failed to connect
(in the Perfecto IDE)

Verify (using java -version) that Java JDK 1.7 or later is installed.

If installed, try to reinstall DevTunnel.
If not installed:
- Install the Java JDK.
- Reinstall DevTunnel.

DevTunnelRelay
not running!

Check relay status:

Copy

/usr/local/etc/stunnel/devtunnel_relay.sh status

If status returns that DevTunnel Relay is turned ON, turn off the relay as follows:
Copy
```
sudo /usr/local/etc/stunnel/devtunnel_relay.sh off
```

Restart the relay as follows:

Copy

sudo /usr/local/etc/stunnel/devtunnel_relay.sh on

The connected device does not appear

If, after connecting the device with DevTunnel, the device does not appear in the list of target devices in Xcode or the Develop menu of Safari, do the following:

Check relay status, as follows:

Copy

/usr/local/etc/stunnel/devtunnel_relay.sh status

If the status indicates that the relay is ON, turn relay off, as follows:
Copy
```
sudo /usr/local/etc/stunnel/devtunnel_relay.sh off
```

Restart the relay, as follows:

Copy

sudo /usr/local/etc/stunnel/devtunnel_relay.sh on

Completely close Xcode/Safari by Using CMD+Q. Stop DevTunnel if it is connected, and Start a new DevTunnel Session.

If the device still does not appear, examine the log file /usr/local/etc/stunnel/relay.err for information that might indicate what the problem is.

The local device does not appear

If you have a device connected directly to your development station, not through DevTunnel, and it does not appear in the list of devices in the IDE, this is usually a problem with the OS software. In this case, do the following:

Reboot your development station to restart the OS service and reconnect your device.
If the device still does not appear, eliminate the possibility that DevTunnel relay is causing the problem by turning off the relay and reconnecting the device, as follows:
Copy
```
sudo /usr/local/etc/stunnel/devtunnel_relay.sh off
```