Zoomdata Version

Setting Up the Screenshot Feature for CentOS and RedHat Linux

The screenshot feature provides periodic snapshots of your saved dashboards on Zoomdata's Home page. At this time, Zoomdata only supports 64 bit versions.


Downloading and Installing from Firefox

The Screenshot functionality requires the Firefox browser and the Xvfb file installed and running within the Zoomdata Server.

To install Xvfb and its dependencies, run the following command:

sudo yum install curl xorg-x11-server-Xvfb xorg-x11-fonts-Type1 gtk2 alsa-lib
  1. Download the Firefox tarball by running the following command:
    sudo curl -O https://ftp.mozilla.org/pub/firefox/releases/45.7.0esr/linux-x86_64/en-US/firefox-45.7.0esr.tar.bz2
  2. After downloading the tarball package, you need to extract the Firefox package. Run the following command:
    sudo tar jvxf firefox-45.7.0esr.tar.bz2
  3. Move the Firefox package to your /opt/ directory and then change the access permissions:
    sudo mv firefox /opt/firefox45
    sudo chown -R root:root /opt/firefox45
  4. You now need to link back to Firefox's binary. Run the following command:
    sudo ln -s /opt/firefox45/firefox /usr/bin/firefox
  5. Modify zoomdata.properties file to enable and setup the Screenshot functionality.  In addition to enabling the Screenshot functionality, you can also set the time period for capturing screenshots of your visuals to be displayed on your Home page.
    • To create screenshots in the background, set the following option to true :
      screenshot.daemon.enabled
    • Specify which types of screenshots you want to enable:
      screenshots.dashboards.enabled - set this option to true if you want to enable capturing and displaying the screenshots for the dashboards.

screenshot.daemon.enabled

screenshots.dashboards.enabled

Result
true true
  • Screenshots are created in background.
  • Screenshots can also be created manually by sending cURL calls.
  • Screenshots are shown on the Home page
false true
  • Screenshots are created only one time, when the dashboard is saved.
  • Screenshots are not created in background.
  • Screenshots can be created manually by sending proper cURL calls.
  • Screenshots are shown on the Home page
false false
  • Screenshots are not created in background.
  • cURL calls to create screenshot on demand take no effect.
  • Screenshots are replaced by the default thumbnails
true

false

  • Screenshots are not created in background.
  • cURL calls to create screenshot on demand take no effect.
  • Screenshots are replaced by the default thumbnails
  1. Specify the frequency rate when the screenshots are refreshed by configuring the following property: screenshot.daemon.schedule.rate= # h The default timeframe is every 6 hours, but you can set your own time period (in hours) by replacing # with your desired timeframe.
  2. Restart zoomdata-xvfb and the Zoomdata services to ensure the changed Firefox program has been enabled. For the appropriate Linux commands, see Restarting Zoomdata Services.

Screenshots may not immediately populate your home screen, but become available based on the 'schedule.rate' that you set.

UPGRADE NOTES

After upgrading, by default, the screenshots on the Home page may look different. This occurs due to the change of the screenshot aspect ratio. In v2.5 the default screenshot aspect ratio is 16:9, while in previous releases it was 3:4. To make the screenshots look correct, make sure that the screenshot.daemon.enabled property in the zoomdata.properties file is set to true. After this you can update the screenshots in one of the following ways:

  1. Modify the screenshot.daemon.schedule.rate property and set more frequent refresh rate.
  2. Execute the cURL call to update a screenshot for a specific dashboard.
  3. Execute the cURL call to upload a custom image for a specific dashboard. Otherwise, the screenshots will be updated when the refresh screenshot procedure runs according to the configured refresh rate.

Was this topic helpful?