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 Zoho applications.
With Zoho DataPrep, you can use Zoho Databridge to allow the import of data from local databases such as MySQL, MS SQL Server, Oracle, and PostgreSQL in your local network and you can also incrementally import data from FTP servers and local files using Zoho Databridge.
Zoho Databridge solely transfers data from your local network to Zoho DataPrep. It does not retrieve data back to your local network, ensuring no security breach.
Downloading and adding a Databridge to your network
Follow the steps below to install Databridge on your local machine.
Prerequisites
Mac
RAM - 3GB
Disk space - 3GB min
Processor type - 64-bit
Processing speed - 64 bit
Versions tested - macOS Sonoma Version 14.3.1
Package distribution - .app file contains JRE, JavaFX runtime, JARs, lib, config files
Downloading the Databridge installer
a) From the Import options:
1. Click Databases or click Files or FTP from the Choose a Datasource box and enable the Import from local network toggle. If you don't have any Databridge previously installed, you will be shown an intro to Databridges.
2. Click the Download button to redirect to the Download Zoho Databridge page.
Download the Mac installer based on the OS of your machine in which Databridge should be installed.
US, IN, JP, EU, AU, CA, SA DCs:
Databridge installer for MacOS
CN DC:
Databridge installer for MacOS
If you have a Databridge previously installed, and if it is inactive, you can choose to add a new Databridge by clicking the Add Databridge button from the Databridge dropdown in the import configuration page of Database or import from local network of FTP and Files.
b) From the Settings page:
1. In the Settings page, select Databridge from the side panel, click Add Databridge to add a new databridge.
2. Download the Mac installer based on the OS of your machine in which the Databridge should be installed.
US, IN, JP, EU, AU, CA, SA DCs:
Databridge installer for MacOS
CN DC:
Databridge installer for MacOS
Special instructions for MacOS
Follow the below steps to install Databridge on your MacOS:
- Click one of the below links to download the Databridge installer.
Databridge installer - US, IN, JP, EU, AU DCs
Databridge installer - CN DC - Extract the zip file to a folder in your preferred location.
- Right-click the folder and choose New terminal at folder, or go to the Databridge folder location in the terminal using the "cd " command and enter the below command.
- Open the extracted file. A popup would appear as shown below.
- Click Cancel.
- Go to System Preferences -> Security & Privacy -> General and click Open Anyway.
- A popup would appear as shown below.
- Click Open and now the Zoho Databridge Setup will be opened.
Installing Databridge in your network
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.
Steps to install Databridge in a MacOS system:
- Double click the databridge*.dmg (for MacOS) to run the installation wizard.
- Click Next to start installing Zoho Databridge.
- Read and accept the License Agreement terms and click Next.
- You can install Databridge in the default folder or choose the folder where you wish to install the application and clickNext.
Info: You can also reset the location to the default folder using the Restore Default Folder option.
- To use a proxy server, select the Use Proxy Server checkbox and click Next.
- Enter the Proxy Server hostname, Proxy server port, Username, Password, and click Next.
- Review the configuration in the Pre-Installation Summary and click Install to proceed.
- Once the installation is complete, you can start Zoho Databridge. Click Done to complete and exit the setup.
- Log into Zoho Accounts with the username and password for your account with Zoho.
- Click Accept.
- Select one of your existing Organization portals.
- Give a name to your Databridge under Databridge name and click Setup.
- The setup is complete and the Databridge is ready to be used. Please make sure the Auto start Databridge on system reboot box is checked. Click Done.
- The Overview section shows details such as the Databridge name, status, uptime, and last started time.
- Zoho Databridge installation is now completed and is registered to your Zoho account.
Note: You can also verify this by viewing the Databridge dropdown in the import options or the Databridge section from the settings menu.To start the Databridge
If your databridge doesn't start automatically then enter the below commands to restart your databridge.
1. Right-click the Zoho Databridge2.0 folder and choose Open in Terminal, or go to the Zoho Databridge2.0 folder in the terminal using the below "cd" command.
2) Enter the below command from Databridge installed location in the terminal to restart your databridge in MacOS.
To stop the Databridge
1. Right-click the Zoho Databridge2.0 folder and choose Open in Terminal, or go to the Zoho Databridge2.0 folder in the terminal using the below "cd" command.
2) Enter the below command from Databridge installed location in the terminal to stop the databridge in MacOS.
Databridge installer links
US, IN, JP, EU, AU DCs:
Databridge installer for MacOS
CN DC:
Databridge installer for MacOS
Troubleshooting - FAQs
1. My Databridge doesn't seem to work. How can I reinstall Zoho Databridge?
If you have installed Zoho Databridge earlier on the same machine, make sure to uninstall it completely and delete the existing version. You can then proceed with installing the newly downloaded Databridge package.
2. How to uninstall Databridge in Mac?
To uninstall Databridge, you can simply close Databridge and delete the Zoho Databridge2.0 folder in your machine.
3. I have installed Databridge from Zoho Analytics. Can I use the same for Zoho DataPrep?
No, there is a separate application for Zoho DataPrep. Please use Zoho Databridge 2.0 for DataPrep.
4. What should I do if my Databridge is inactive ?
You can restart Databridge, if your Databridge is inactive.
5. How to restart Databridge in Mac OS?
1) Close the Zoho Databridge.
3) Enter the below command to restart Databridge.
6. Zoho Databridge doesn't restart in Mac?
1. Right-click the Zoho Databridge2.0 folder and choose Open in Terminal, or go to the Databridge folder location in the terminal using the below "cd " command.
7. What should I do if my Databridge did not start after restarting my machine in Mac?
If your Databridge doesn't restart automatically,
1. Right-click the Zoho Databridge2.0 folder and choose Open in Terminal, or go to the Databridge folder location in the terminal using the below "cd " command.
8. Can I install Zoho Analytics Databridge if Zoho DataPrep Databridge is already present in the system?
Yes, you can install Zoho Analytics Databridge along with Zoho DataPrep Databridge in your system.
9. Can I run both Zoho Analytics and Zoho DataPrep Databridges at the same time?
Yes, you can run both Zoho Analytics and DataPrep databridges simultaneously.
10. Can I have more than one Zoho Databridge installed on my machine for Zoho DataPrep?
No, you can have only one Databridge installed in your machine for your DataPrep organization. But you can have multiple databridges for one organization in different machines.
11. How to delete Databridge from DataPrep organization?
Click Databridges under the Settings page. Click the delete icon to permanently remove the databridge from your organization. Also delete the Zoho Databridge2.0 folder from your machine.
12. How to fix connectivity issues with Zoho Databridge and my database?
We try to throw appropriate errors in the UI to let the users know about the kind of error. But to debug connectivity related problems, we rely on the logs that are available in the Databridge installation folder. This helps us understand what kind of issue is stopping us from successfully connecting with your database. However, this might not make sense to an end user.
If there is an unknown error, the best way to move forward is to reach us at support@zohodataprep.com along with the logs present in "~/ZohoDatabridge2.0/logs"
One of the other ways to simplify testing is to use a database client tool in the same machine as the Databridge and try to connect to the database. This could let you know whether the problem is with connectivity to your database, or with the Databridge.
13. Where can I find the logs and config files?
~/ZohoDatabridge2.0/conf/ - serveragent.config file
Please find the screenshots below for reference.
MacOS
Windows OS
Linux OS
SEE ALSO
How to perform silent installation?
What is Databridge and how to import data using Databridge in Windows?
What is Databridge and how to import data using Databridge in Linux?
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 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 Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
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.
Zoho Sheet Resources
Zoho Forms Resources
Zoho Sign Resources
Sign, Paperless!
Zoho TeamInbox Resources
Zoho DataPrep Resources
Design. Discuss. Deliver.
Related Articles
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 ...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 ...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 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 ...