How to install Zoho Databridge on systems without a graphical user interface?

Zoho Databridge Silent Installation

Performing silent installation allows you to install Zoho Databridge on a Linux machine from the command line. This is especially handy for retrieving data from systems that do not have a graphical user interface.

 Steps to perform silent installation of Databridge: 


Prerequisites
  


Linux

RAM - 3GB

Disk space - 3GB min

Processor type - 32bit, 64bit

Processing speed - 64 bit and 32 bit

Versions tested - Ubuntu 22.04.2 LTS

Package distribution - .bin file contains JRE, JavaFX runtime, JARs, lib, config files


Downloading the Databridge installer

1. Open the command prompt and connect to the required host using the ssh command.

Example:
ssh user_name@host(IP/Domain_name) 

2. Type your password and press enter.

Example:
Linux machine's password: **** 

3. Navigate to the folder where you would like to download Zoho Databridge using the cd command.

Example: 
cd Documents/ 

4. Download Zoho Databridge using the below command.
 
wget [Enter the Databridge installer link here]


Copy the required installer link from the list below:

Note: The Databridge installer links are based on the Data Center your DataPrep account is hosted. Click here to know your Data Center.

Please use the below links if you DataPrep account is hosted in US, IN, JP, EU, CA, SA or AU Data Center:

 

        Databridge installer for Linux - 64 bit 

        Databridge installer for Linux - 32 bit 

 

Please use the below links if you DataPrep account is hosted in CN Data Center:

     

      Databridge installer for Linux - 64 bit 

      Databridge installer for Linux - 32 bit

Example:
wget https://static.zohocdn.com/streamline/databridge/test/common/ZohoDatabridge_64bit.bin


 

 Installing Zoho Databridge 


Notes:

1. Install Databridge on a computer that is always ON and connected to the internet. A wired network is preferred so that the data transfer is faster and more reliable.
2. Ensure the JDBC jar file required for database is placed at "~Zoho Databridge 2.0/lib/jars/<.jar>" folder.

5. Once the download is complete, type the below command to provide access permissions to execute Zoho Databridge in the same folder.
chmod +x ZohoDatabridge_64bit.bin


 



6. Type the below command and press Enter to launch the installer (InstallAnywhere).
./ZohoDatabridge_64bit.bin

You can read through the InstallAnywhere introduction which will guide you through the Databridge installation. Enter to accept the licence agreement.




7. You can either provide the absolute path of the folder where you wish to install the Databridge, or simply press
Enter to install in the default folder.


 

 

8. Review the configuration in the Pre-Installation Summary that contains the product name, install folder, link folder, and disc space information. Press Enter to proceed with the installation.


 


9. The installer is now ready to install Zoho Databridge into your system. Press Enter to complete.

 


 

10. Once Zoho Databridge has been successfully installed, press Enter and exit the installer.

 

Configuring silent installation 


11. Type cd .. and press Enter to move back to the parent directory.

 

Example: 
Linux machine:~/Documents$ cd .. 

12. Navigate to the ZohoDatabridge2.0 folder using the below cd command.

 

cd ZohoDatabridge2.0/ 

 

13. After installing Zoho Databridge, setup silent installation by running the below command in the ZohoDatabridge2.0 folder.
 
sh  SilentInstallationSetUp.sh <DC> <Refresh token> <organisation name>

 To find your DC:

 Click here to know your Data Center where your Zoho account is hosted.


To generate refresh token:
 

Please follow the below instructions for generating the refresh token which authenticates the server communication.
  • Copy and paste the below link based on your DC (Data Center where your Zoho account is hosted) into the browser client using which you have logged into your Zoho account.

    Info:  Click here to know your Data Center.

 

US DC:

https://accounts.zoho.com/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.com/redirect_uri&response_type=code&access_type=offline&prompt=consent

 

EU DC:

https://accounts.zoho.eu/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.eu/redirect_uri&response_type=code&access_type=offline&prompt=consent

 

AU DC :

https://accounts.zoho.com.au/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.com.au/redirect_uri&response_type=code&access_type=offline&prompt=consent

 

IN DC:

https://accounts.zoho.in/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.in/redirect_uri&response_type=code&access_type=offline&prompt=consent

 

JP DC:

https://accounts.zoho.jp/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.jp/redirect_uri&response_type=code&access_type=offline&prompt=consent

 

CN DC:

https://accounts.zoho.com.cn/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.com.cn/redirect_uri&response_type=code&access_type=offline&prompt=consent


CA DC:

https://accounts.zohocloud.ca/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zohocloud.ca/redirect_uri&response_type=code&access_type=offline&prompt=consent

SA DC:

https://accounts.zoho.sa/oauth/v2/auth?scope=zohodataprep.dataprepapi.ALL,ZohoFiles.files.ALL&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&redirect_uri=https://dataprep.zoho.sa/redirect_uri&response_type=code&access_type=offline&prompt=consent

  • Click Accept to allow Databridge to access data in your Zoho account.





  • In the address bar of your browser, copy the code displayed between "code=" and "&location" from the url.

    Example: 1000.580ae5be7120fab22b78069d45aed1ce.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    Important: The code is valid only for two minutes.



  • Replace the copied code value in the highlighted portion of the below command (again, based on your DC) and press Enter to generate the refresh token.

    Info:  Click here to know your Data Center.


Please use the required command from the following list:


US DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.com/redirect_uri" https://accounts.zoho.com/oauth/v2/token


EU DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.eu/redirect_uri" https://accounts.zoho.eu/oauth/v2/token

AU DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.com.au/redirect_uri" https://accounts.zoho.com.au/oauth/v2/token

IN DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.in/redirect_uri" https://accounts.zoho.in/oauth/v2/token

JP DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.jp/redirect_uri" https://accounts.zoho.jp/oauth/v2/token

CN DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.com.cn/redirect_uri" https://accounts.zoho.com.cn/oauth/v2/token

CA DC:
curl -X POST --data "code=<PasteCodeHere>&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zohocloud.ca/redirect_uri" https://accounts.zohocloud.ca/oauth/v2/token

SA DC:
curl -X POST --data "code=<PasteCodeHere>
&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.sa/redirect_uri" https://accounts.zoho.sa/oauth/v2/token


Example:

curl -X POST --data "code=
1000.580ae5be7120fab22b78069d45aed1ce.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&client_id=1000.Q1AK5RAPB8BL813859R04YCVTY08WH&client_secret=ccb7180963588bde539d6288d94cfc2cb2fbadd8b9&grant_type=authorization_code&state=1234&redirect_uri=https://dataprep.zoho.com/redirect_uri" https://accounts.zoho.com/oauth/v2/token



 

  1. Now the refresh token has been generated. The screenshot below helps you identify the refresh token.

    Example:
    1000.d1b2d561ee711b9375as9ddf068b854e.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



 

To view your portal name:

  1.  You can view your portal name under the Organization URL option in the Organisation settings tab under the Settings page.



14. Run the below command in the ZohoDatabridge2.0 folder by specifying the DC, refresh token, and portal name to which the Databridge needs to be mapped.

sh  SilentInstallationSetUp.sh <DC> <Refresh token> <portal name>

 

Example:   
 sh SilentInstallationSetUp.sh us 1000.d1b2d561ee7711b9375ae9ddf068b854e.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Zylkerr


 

 

15. The silent installation is successfully completed. The silent installation process is a one-time activity.

Start you Databridge

1. After the silent installation is complete, you can start the Databridge in your machine using the below command.
sh StartServer.sh



 

2. Once the Databridge starts, it will be listed under Settings -> Manage Databridge in your organization in Zoho DataPrep.



Important notes 

 

1. Silent installation is exclusively for configuring the portal and should not be used routinely. Installation should only be performed once.

 

2. After installation, each time the user needs to import files from the host machine, then the user has to only initiate the Databridge using the below command.

 To start the Databridge 
  1.  Navigate to the ZohoDatabridge2.0 folder in the Linux host machine using the below cd command in the terminal.
    cd Zoho Databridge2.0/

  2. Enter the below command from ZohoDatabridge2.0 folder in the terminal to restart the databridge in your Linux host machine.
    sh StartServer.sh
 
3. If Zoho Databridge doesn't restart in Linux then stop the Databridge using the below command and restart it again.

 To stop your Databridge

  1. Navigate to the ZohoDatabridge2.0 folder in the Linux host machine using the below cd command in the terminal.
    cd Zoho Databridge2.0/ 

  1. Enter the below command from ZohoDatabridge2.0 folder in the terminal to stop the databridge in your Linux host machine.
    sh  StopServer.sh  -force
 4. To uninstall Databridge, you can simply stop Databridge and delete the Zoho Databridge2.0 folder from your host machine using command line. 

SEE ALSO

Incremental fetch from FTP files
Manage databridges


    Access your files securely from anywhere

      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









                                                                                                              • Related Articles

                                                                                                              • Databridge in Zoho DataPrep

                                                                                                                Zoho Databridge is a lightweight independent utility that connects your on-premise data source and Zoho applications to import data. In other words, you can quickly and securely transfer local files and local databases from your internal network to ...
                                                                                                              • Installing Zoho databridge in Linux

                                                                                                                Zoho Databridge is a lightweight independent utility that connects your on-premise data source and Zoho applications to import data. In other words, you can quickly and securely transfer local files and local databases from your internal network to ...
                                                                                                              • Installing Zoho databridge in MacOS

                                                                                                                Zoho Databridge is a lightweight independent utility that connects your on-premise data source and Zoho applications to import data. In other words, you can quickly and securely transfer local files and local databases from your internal network to ...
                                                                                                              • Installing Zoho databridge in Windows

                                                                                                                Zoho Databridge is a lightweight independent utility that connects your on-premise data source and Zoho applications to import data. In other words, you can quickly and securely transfer local files and local databases from your internal network to ...
                                                                                                              • Manage Databridge

                                                                                                                In the Settings page, select Databridges from the side panel to manage the linked databridges. If you have added Databridges already, you can view details such as: The name of the Databridge, the host server, and the OS it runs on. Status of the ...
                                                                                                                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