Managing the Upload API as a Streaming Source
Zoomdata supports live streaming sources via its Upload API data connector. However, keep in mind that this source requires a storage medium for the incoming data flow. Zoomdata utilizes MongoDB to handle the caching of the data.
If you upgraded from Zoomdata v2.2 or earlier, then MongoDB already exists in your Zoomdata environment and no additional setup is necessary. If Zoomdata v2.5 is a new installation and you do not already have MongoDB in your network environment, then review this article to install and setup MongoDB.
The Zoomdata Administrator needs administrator level access to the Linux environment in order to access and set up MongoDB along with the necessary parameters in the Zoomdata property file.
If you do not have MongoDB in your network environment, then you will first need to download and install MongoDB to your server. Refer to the MongoDB Install documentation .
- If you upgraded your Zoomdata Server from v2.2 or earlier, then MongoDB is already available in your Zoomdata environment and you will be able to access it. For more information about upgrades, see Upgrading the Zoomdata Server .
- For the MongoDB version that is supported by Zoomdata, see Data Sources Quick Reference Sheet .
To set up and enable Zoomdata to support your streaming source, you first need to add the MongoDB parameters to the
file. To do this, the Zoomdata Administrator needs to stop the Zoomdata Client and access the Linux prompt.
- Log out of the Zoomdata Client and close the browser window.
- Access the Linux prompt and log into your Zoomdata Server (via Secure Shell or SSH).
- Stop the Zoomdata Server.
- Use the following command to access and open the properties file:
If you are not logged in as a root user, then you to need to enter
sudo vi /etc/zoomdata/zoomdata.propertiesin order to create the file.
- If the file does not exist, this command creates it.
Make sure the file is readable by the
- Add the following parameters into the file:
zoomdata.db.host= yourHostIP : PortAddress
- yourHostIP and PortAddress : enter your MongoDB's connection information
- MongoDB_Name : enter the space in MongoDB where data for streaming sources will be stored
- MongoDB_Username : if needed, otherwise there is no need to include this parameter
- MongoDB_User's_Password : if needed, otherwise there is no need to include this parameter
- Save and exit the configuration file.
- Restart the Zoomdata Server.
To disable the streaming source, do the following:
Log in using the Supervisor credential
Select the Connectors tab
In the Connectors section, locate Upload API in the Connector column
Clear the box in the Enabled column (as shown in Figure 4) for the desired connector type