Zoomdata Version

Setting Up the Screenshot Feature for Ubuntu

The screenshot feature provides periodic snapshots of your saved dashboards on Zoomdata's home screen. Zoomdata only supports 64-bit version of Firefox.

Downloading and Installing from Firefox

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

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

sudo apt-get install xvfb libasound2 libgtk2.0-0 
  1. Download the Firefox tarball.
  2. sudo curl -O https://ftp.mozilla.org/pub/firefox/releases/45.7.0esr/linux-x86_64/en-US/firefox-45.7.0esr.tar.bz2 
  3. Extract the Firefox package:
    sudo tar jvxf firefox-45.7.0esr.tar.bz2
  4. Move the Firefox package to your /opts/ direcoty and change the access permissions:
    sudo mv firefox /opt/firefox45
    sudo chown -R root:root /opt/firefox45
  5. You now need to link back to Firefox's binary. Run the following command:
    sudo ln -s /opt/firefox45/firefox /usr/bin/firefox
  6. Access and modify the zoomdata.properties file. In addition to enabling the Screenshot functionality, it also sets the time period for capturing screenshots of your visuals for display on your Home screen.
    • 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

  7. Specify the frequency rate at which 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.
  8. Restart zoomdata-xvfb and the Zoomdata services to ensure the changed Firefox program has been enabled. For the approproate Linux command, see Restarting Zoomdata Services.

Screenshots may not immediately populate your home screen, but are 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?