Installing Tunnel
1. Download and Install Tunnel Application
Zoho QEngine supports testing privately or locally hosted web applications in the cloud. It allows you to manage network traffic and ensures the privacy and security of your testing activities. To do this, you need to configure the tunnel for your network. Learn more about tunnel.
To initiate the tunnel setup, begin by verifying that your system meets the necessary requirements, then proceed with the appropriate steps based on your operating system.
Note: The tunnel feature is supported for Mac, Windows, and Linux operating systems.
1.1 System requirements
Hardware | Minimum |
RAM | 4 GB |
Processor | 2 CPU cores |
1.2 Installation of Tunnel Application
To install the tunnel application:
Navigate Setup > Test Execution > Tunnels to download the installable for your machine.
or
From Projects, navigate to Settings > Tunnels for the same.
Select and download the file for the required OS.
1.2.1 Install tunnel for macOS:
- To initiate the installation process, double-click the downloaded installable.
- In the popup, drag and drop the tunnel application to the Applications folder.
- Run the tunnel by clicking on the installed application. If the tunnel is successfully running, you should see the Zoho QEngine (
) icon in the system tray.
- Click OK. Navigate to System Settings > Privacy & Security and scroll down to the Security section. Select the App Store and identified developers option. Give permission to your system to make the changes.
- Upon clicking the icon (
), the drop-down will allow you to perform various actions.
1.2.2 Install tunnel for Windows:
- To start the installation, double-click the downloaded installable.
- Click Next in the InstallShield Wizard for Zoho QEngine.
- Read the License Agreement, then accept the terms and conditions.
- Set the Destination Folder, then click Next.
- Once the installation is complete, click Finish.
If the tunnel is successfully running, you should see the Zoho QEngine (
) icon in the system tray.
1.2.3 Install tunnel for Linux:
- Download the Linux Installation file (.bin) file
- Open terminal and navigate to the file downloaded path
- Change the bin file to executable mode, using the following command:
chmod +x ZohoQEngine-Tunnel-64bit-<version>.bin - To start the installation, run the following command:
./ZohoQEngine-Tunnel-64bit-<version>.bin - After executing the bin file, the InstallationShield will be open. Follow the steps in the InstallationSield Wizard and complete the installation.
Upon successful installation, the tunnel will be started automatically.
Steps for Uninstalling Linux Tunnel:
- Navigate to the folder where the Zoho QEngine Tunnel is installed using the terminal.
- Execute the command below:
./Uninstall\ ZohoQEngine - Follow the steps in the wizard and complete the uninstallation.
Steps to update to the Latest Version:
- Download the .bin file from qengine.zoho.com
- Open the terminal and navigate to the path where the file is downloaded.
- Change the bin file to executable mode using the following command:
- To start the installation, run the following command:
- After executing the bin file, InstallationShield will be open.
- If the user tries to update the tunnel while the older instance is already running, the Prerequisite window will pop up.
Clicking on Yes will remove the older version of tunnel and the new version will be installed. - If the user tries to update the tunnel on the existing tunnel's path, the confirmation window will pop up.
Clicking on Yes will remove the older version of the tunnel and new version will be installed.
Upon successful installation, the tunnel will be started automatically.
Note:
- Tunnel will only start automatically at the time of installation. For manual start, navigate to the /home/<user-name>/Desktop/ZohoQEngine folder in the terminal and run the command below:
./StartServer - For stopping the tunnel, navigate to the /home/<user-name>/Desktop/ZohoQEngine folder using the terminal and run the command below:
./StopServer