Configure Bridge in Qntrl | Bridge | Qntrl | Online Help

Install Bridge

Follow the below step-by-step procedures to configure and use Bridge in Qntrl.

Step 1: Download the Bridge agent

Only one Bridge agent can be installed per machine. To download a Bridge agent in Qntrl:
  1. Navigate to  >> Advanced >> Bridge >> select Downloads.
  1. Bridge agent is available for both Windows and Linux OS. Download the file based on your OS.
    1. Windows users have separate download links for 32-bit and 64-bit OS. You may choose the one as per your requirement.
    1. Linux users can either directly download the installable zip file using the Directly Download button or can copy the wget command and execute it in a terminal to download the zip.  
      

Step 2: Install the Bridge agent   

Setting up Bridge agent for Linux   

Once the Bridge agent is downloaded:
  1. Copy the installation link provided on the above Downloads page under the Linux section.
  2. Traverse to the directory where you have downloaded the installable zip.
  3. In your terminal, execute the installation link copied in the previous step. This action will:
    1. install a daemon and 
    2. start the Bridge agent
  4. The agent runs on JRE and it requires Java. If you do not have Java installed in your host, you can use Java bundled with this Bridge agent. 
  5. To use the bundled Java, open the file [Bridge_Home]/conf/wrapper-bridge.conf with a suitable editor and replace the value assigned to the key wrapper.java.command as /jre/bin/java. 
  6. Once the installation is successful:
    1. a new Bridge entry will be added automatically to the Bridge list page of Qntrl and
    2. the new Bridge agent will be started 
  7. Once the Bridge agent is up and running, it will automatically open the login page in the default browser.
  8. You can view the status( Active/Down) of your Bridge in the Bridge list page.
     
  1. To stop a running Bridge agent execute the command: sh [Bridge_Home]/bin/bridge.sh stop
  2. To restart the Bridge agent, execute the command: sh [Bridge_Home]/bin/bridge.sh start 
  1. Do not share Bridge files with anyone, and ensure the secure protection of the Bridge location. Otherwise, there's a risk of sensitive information being exposed.
  2. Do not modify or remove any properties within the installed Bridge configuration files. The inherent files in Bridge should not be edited, deleted, or shared.

Setting up Bridge Agent for Windows 

Once the Bridge agent installation file, (Viz., qntrl_bridge_agent.exe) is downloaded:
  1. Execute the qntrl_bridge_agent.exe file. This action will, by default:
    1. install the Bridge agent in %localappdata% /Bridge folder
    2. add it to the services list
    3. start the Bridge agent
  2. Once installation is successful:
    1. a new Bridge entry will be added automatically to the Bridge list page of Qntrl
    2. Bridge agent will be started 
  3. The agent runs on JRE and it requires Java. If you don’t have Java installed in your host, you can use Java bundled with this Bridge agent.
  4. To use the bundled Java, open the file [Bridge_Home]/conf/wrapper-bridge.conf with the suitable editor and replace the value assigned to the key wrapper.java.command as jre/bin/java.exe
  5. Once the Bridge agent is up and running, it will automatically open the login page in the default browser.
  6. You can view the status( Active/Down) of your Bridge in the Bridge list page.
  1.     To stop a running Bridge agent execute the command: sh [Bridge_Home]/bin/bridge.bat stop
  2.     To restart the Bridge agent, execute the command: sh [Bridge_Home]/bin/bridge.bat start
  1. Do not share Bridge files with anyone, and ensure the secure protection of the Bridge location. Otherwise, there's a risk of sensitive information being exposed.
  2. Do not modify or remove any properties within the installed Bridge configuration files. The inherent files in Bridge should not be edited, deleted, or shared.

Step 3: Execute a Bridge Message

Message module is used to test/execute a task in Bridge, to do so:

  1. In Qntrl, navigate to(settings) >> Advanced >> Bridge >> select Messages.

  2. In the Message list page that loads, click the New Message button.

  3. In the New Message window, enter the following details.      

            Name: Enter a unique name for the message, so that it can be reused by different Bridges when required.
            Bridge: Select the Bridge you would like to test/execute from the dropdown list.
            Module: Select one of the modules from the dropdown list. The task related to the selected module alone will             be executed through this Message. Task Engine and DB Engine modules will be associated by default while             creating a Bridge.
      • Task Engine - To execute API tasks in third-party or internally hosted app

      • DB Engine - To perform SQL queries in a database hosted in a closed network

      • SSH Engine - To connect a remote Linux/Unix machine and to execute required commands

      • PowerShell Engine - To connect a remote Windows machine and to execute required commands

      • File Management - To transfer files from one location to another

      • AD Engine - Connects and performs secured operations in Active Directory

Type: Select the Message type:

      • Synchronous - Executes tasks in the same request and provides a response

      • Asynchronous - Executes tasks in the background

Request DataThe instructions to be executed by the Bridge have to be given here in JSON format. Based on             the module chosen, the key value parameters will change. To learn more about request data format and             parameters check Bridge Modules.

Response: If the type is Synchronous, the response to the request will be displayed under this tab.

  1. Once all the details are filled, click Execute.

      

After successfully executing a message, you can review the response (for synchronous message types) and find a server call entry in the Message list of your Bridge agent by following these steps:
  1. Navigate to  (settings) >> Advanced >> Bridge >> select Bridge. 
  2. Hover your cursor over the Bridge name, then click on the action menu, , and select Open Agent.
  3. This will direct you to the Bridge Agent login page. Log in with your User name and Password.
  4. Navigate to the Messages section in the Header bar. On the Message list page, use the dropdown menu to choose the messages you wish to access from the list.
      






Next:
            



    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                    Manage your brands on social media

                                      Zoho Desk Resources

                                      • Desk Community Learning Series


                                      • Digest


                                      • Functions


                                      • Meetups


                                      • Kbase


                                      • Resources


                                      • Glossary


                                      • Desk Marketplace


                                      • MVP Corner


                                      • Word of the Day


                                        Zoho Marketing Automation

                                          Zoho Sheet Resources

                                           

                                              Zoho Forms Resources


                                                Secure your business
                                                communication with Zoho Mail


                                                Mail on the move with
                                                Zoho Mail mobile application

                                                  Stay on top of your schedule
                                                  at all times


                                                  Carry your calendar with you
                                                  Anytime, anywhere




                                                        Zoho Sign Resources

                                                          Sign, Paperless!

                                                          Sign and send business documents on the go!

                                                          Get Started Now




                                                                  Zoho TeamInbox Resources



                                                                          Zoho DataPrep Resources



                                                                            Zoho DataPrep Demo

                                                                            Get a personalized demo or POC

                                                                            REGISTER NOW


                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now







                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.



                                                                                                  • Related Articles

                                                                                                  • Zoho Directory in Qntrl

                                                                                                    What is Active Directory?  Active Directory (AD) by Microsoft is a domain management system for centralized networks. Using AD, you can add users, define their privilege, store and manage information, and authorize and authenticate user accounts.  ...
                                                                                                  • Bridge agent settings

                                                                                                    View Bridge agent configuration Once the Bridge agent is set up, you will be able to view and modify the allowed Configuration when required. In Qntrl, navigate to (settings) >> Advanced >> Bridge >> select Bridge. Hover your cursor over the Bridge ...
                                                                                                  • Microsoft Teams for Qntrl

                                                                                                    Microsoft Teams is a cloud-based collaboration workspace that facilitates communication between different teams in your organization. Benefits of the Extension By integrating  Microsoft Teams with Qntrl , users can create cards, perform transitions, ...
                                                                                                  • Use case for Bridge: Connect with remote databases using Bridge

                                                                                                    Most organizations secure their remote databases using firewalls. If you are looking for a way to navigate these firewalls to access remote databases, Bridge can be of help. Let us try to solve a real-time business case where Bridge is used to access ...
                                                                                                  • Other actions in Bridge

                                                                                                    View / Edit Bridge properties Once you create a Bridge, you can view and edit its properties. Click the Settings gear icon at the top right of the header bar. Navigate to Advanced >> Bridge, and choose Bridge. In the Bridge list page, click the Name ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace

                                                                                                      Resources

                                                                                                      Videos

                                                                                                      Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                      eBooks

                                                                                                      Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                      Webinars

                                                                                                      Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.



                                                                                                        Zoho Show Resources