Qntrl Bridge Online Help | Qntrl Bridge Troubleshooting FAQ

Troubleshooting FAQs

1. What are the pre-requisite for installing and using a Bridge in Qntrl? 

  • Ensure administrative privileges for installation.
  • Java Runtime Environment (JRE) is required. If not available, the bundled Java with Bridge Agent can be used.
 

2. What are the system requirements to install and use Qntrl Bridge?   

Component

Minimum

Recommended

Processor

4 cores

16 cores

Processor Speed

2 GHz

3 GHz or above

RAM

2 GB

16 GB

Storage

2 GB**

5 GB**

Notes
Storage refers to the amount required for Bridge installation and operation logs.

 

3. Why is Bridge installed as a non-root user?   

Due to security best practices and PostgreSQL compatibility requirements bridge must run as a non-root (non-administrator) service user. Running Bridge as a root user may lead to permission conflicts and database issues.

4. Which operating systems are supported for Qntrl Bridge installation?   

Qntrl Bridge is supported on:

Windows:

  • Windows 8, 10, 11

  • Windows Server 2012, 2016, 2019

Linux:

  • Ubuntu 18+

  • CentOS 7+

  • Red Hat 6+

Other OS versions may work, but performance is not guaranteed.

 

5. Why does Bridge not start when installed in a different folder (Linux/macOS)?   

  • Ensure that the installation directory is accessible to the Bridge service and the service user.

  • macOS: Avoid installing Bridge in protected folders such as Desktop, Documents, etc.


6. How do I download and install the Bridge?   

  • Navigate to (settings) >> Advanced >> Bridge >> Downloads.
  • Choose the appropriate OS and download the Bridge ZIP.
  • Extract and follow the installation steps provided in the help page. 

7. How do I start or stop the Bridge?   

You can start or stop the Bridge by running the following commands in the terminal.
Linux/Mac:

sh <Bridge-path>/bin/bridge.sh start     # Start
sh <Bridge-path>/bin/bridge.sh stop      # Stop

Windows:

<Bridge-path>\bin\bridge.bat start       # Start
<Bridge-path>\bin\bridge.bat stop        # Stop

 

8. Why is Bridge failing to start on Linux?  

  • Check system service logs using the command journalctl -u qntrl_bridge.service

  • If wrapper.log is not available in the logs folder, permissions may not be correctly configured. Run the command sh /Bridge/bin/set_permissions.sh as the bridge service user.

 

9. Why is Bridge failing to start on macOS?  

If wrapper.log is not available in the logs folder, permissions may not be correctly configured. Run the command sh /Library/Bridge/bin/set_permissions.sh as the bridge service user.

10. How do I restart the Bridge in Linux/Mac OS?  

By running the following commands in the terminal:

sh <Bridge-path>/bin/bridge.sh restart

 

11. How do I restart the Bridge in Linux/Mac OS?  

You can restart the bridge by running the following command in the terminal:

<Bridge-Path>\bin\bridge.bat restart

or

Goto settings(settings) >> Services >> Qntrl Bridge, and restart the service

 

12. My Bridge isn’t working. How do I reinstall it? 

In your terminal, go to bridge terminal and execute the below commands.  

Linux/Mac:

sudo sh bin/bridge.sh remove
sudo sh bin/bridge.sh installstart

Windows:

sudo bin\bridge.bat remove
sudo bin\bridge.bat installstart

 

13. The Bridge is inactive. What should I check?   

  • Make sure the Bridge has started and is running on the correct port.
  • If not running, use sh<Bridge-path>/bin/bridge.sh start
  • If the bridge is running on the correct port but still inactive, check the log files in the <Bridge-path>/logs directory - especially logs.txt and wrapper.log for errors.
 

14.  What should I do if my bridge did not start after system reboot (Windows)  ?

  • Go to Services, check if Qntrl Bridge is running.
  • If not, manually start the bridge by running the given command in your windows terminal: <Bridge-path>\bin\bridge.bat start .
  • If it fails, check the Bridge logs for errors.
 

15. How do I uninstall the Bridge?   

Windows:

You can uninstall the bridge by running the following command in the terminal:

<Bridge-path>\bin\bridge.bat remove

To manually remove all bridge files, use the following command in Command Prompt (cmd):

rd /s /q <Bridge-path>    # (CMD)
Remove-Item -Recurse -Force <Bridge-path>   # (PowerShell)

 

Linux/Mac:

You can uninstall the bridge by running the following command in the terminal:

sh <Bridge-Path>/bin/bridge.sh remove

If you want to remove all bridge files manually, use the following command:

rm -rf <Bridge-Path>

Ensure you have the necessary permissions before executing these commands.  

 

16. Can I install multiple bridges in one org?

Yes, you can install and link multiple bridges to the same Qntrl account.

 

17. Can multiple bridges run on the same machine?

Yes. Configure individual bridges appropriately by modifying their config files.

18. Can Bridge use an external PostgreSQL instance?   

Yes, Bridge supports external PostgreSQL.

  • You can configure it during installation or later using bin/bridge.sh configure_postgres

  • Alternatively, by altering properties in conf/postgres.xml.


19. Why am I getting certificate errors when calling local domains or IPs from the Bridge?   

This usually occurs if you're calling a non-public domain without a trusted certificate.

To resolve:

  1. Extract the Certificate
    1. openssl s_client -connect <domain:port> -showcerts
    2. Copy only the certificate section and save it as .pem file.
    3. Alternatively, export it via browser.
  2. Upload to Bridge
    1. Go to /account/ssl in the Bridge Agent UI.
    2. Upload the .pem file to the Truststore section.

 

20.  Bridge installed and started, but not visible in Bridge section?  

  • Confirm if the machine has network access to the Qntrl domain.

  • If using a proxy, make sure proxy settings are correctly configured in the Bridge.

  • Refer to logs for debugging.

 

 

    • Related Articles

    • Troubleshooting FAQs - Data Transformation States

      1. When should I use a Data Transformation state instead of a Function state? Use Data Transformation states when the required logic can be achieved using built-in capabilities such as JSONata, JSLT, or dataset operations. This helps avoid custom ...

    • Troubleshooting

      1. WSDL URL fetch failure Invalid WSDL URL: Verify the WSDL URL and ensure it is accessible. Test the URL in a browser. Authentication required: If authentication is needed, provide the correct credentials. 2. Cannot modify WSDL contract Downloaded ...

    • Troubleshooting

      1. Cannot create Inbound soap Missing required fields: Ensure Name, URI, and Authentication Type are provided. Duplicate URI: Use a unique URI for each request. 2. Cannot receive incoming SOAP requests Incorrect endpoint URL: Ensure clients are ...

    • Troubleshooting

      1. Cannot create inbound REST module Missing required fields: Ensure Name, Base URI, and Authentication Type are provided. Duplicate base URI: Use a unique base URI for each module. Invalid base URI format: The base URI should begin with a / and ...

    • Troubleshooting

      1. Cannot execute API Make sure all required fields are filled in correctly — this includes the URL, query parameters, headers, and request body. Missing or incorrect values can prevent the API from executing successfully. 2. Unauthorized or ...