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

The Tunneling feature is available starting with release 12.0.   It allows the developer to access a web/application server running on her own machine (Mac or PC), from a cloud device (Android or iOS).

More generally, Tunneling allows a Cloud Device to access any web resources on the developer internal network, even if there is no direct connectivity between the two.

Tunneling is most useful when the remote device and the developer machine are on distinct networks which are not normally reachable from each other due to network topology or firewall configurations.

In this release, only device sessions can be tunneled.  Browser session is not yet supported.

In order to set up the tunneling feature, perform the following steps as a Cloud Administrator: (see detailed information in Setting up the Tunneling Feature)

  1. Verify that your Cloud license includes the tunneling feature
  2. Install an NV Server version 12.0 or above and configure it to operate (also) as a tunneling server (hardware requirements are detailed here)
  3. Add this NV Server to your Cloud configuration, with correct values for "Tunneling Port" and "Wifi AP SSID"
  4. Configure one or more of the Cloud's Device Host Machines to use this NV Server

Like any user, in order to use tunneling in a Manual or Automation session, do the following: (see detailed information in Network Tunnel)

  1. Open a session on the device you want to tunnel
  2. Download and run the tunneling client on your Mac PC
  3. Tunneling will be able to operate as long as the client is running and connected to the cloud.
  4. To stop tunneling, close the client.

A session can only be tunneled when all of the following conditions apply:

  1. The tunneling feature is licensed and enabled
  2. The device's Host Machine is configured to use an NV Server which has tunneling configured
  3. The device is connected to the same WIFI network which the tunneling server (i.e., the NV server) is configured for.
  4. The session's user has an active connected tunneling client on his Mac or PC

Note - To verify which Host Machine a device belongs to, check the "Host" column in the Devices page of the web UI:

09-devices-dhm-Screen Shot 2018-09-06 at 10.00.47

For as long as a session is being tunneled, the web UI indicates it with a "Tunneling" icon on the left side of the screen:

02-tunneling-icon-on-Screen Shot 2018-09-04 at 10.59.37

To enable/disable all tunneling in the cloud :

Click on the Virtualization on the left then click on Servers, then click on the top right menu button :

Starting with release 12.1, as a Cloud Admin, you can upload custom versions of the tunneling clients to your Cloud Server installation folder.

The files should be placed in CLOUD_INSTALL_LOCATION/bin/network-tunnel/

The names of the files should be network-tunnel and network-tunnel.exe (for MacOS and Windows respectively)

Make sure the network tunnel version you use is supported by the cloud server. If you get an error in the CLI that there is no compatibility with the cloud version, then install a newer version supported by the cloud.

  • No labels