Zimbra Usage Reporting Tool

Revision as of 10:57, 19 June 2020 by Prashant Surana (talk | contribs) (Uninstall ZURT)

Zimbra Usage Reporting Tool

Zimbra Usage Reporting Tool (ZURT) is a service that collects usage against the provisioned license. You can install it on a Zimbra server or a server with access to Zimbra LDAP. Zimbra LDAP connection details help this service to capture the number of accounts based on the features individual accounts have been given. The tool gets installed as a service (ZURT) on the server which can be accessed with systemctl service commands.


  • Zimbra Collaboration 8.7.1 or above
  • Latest version of zimbra-openjdk

- or -

  • Linux Java version 1.8 or greater
  • Server should communicate with usage.zimbra.com
  • Systemctl (the Systemd utility)
  • Root user access

Download and Install

Download the Zimbra Usage Reporting Tool

Installation on Zimbra Server

  1. Download the Zimbra Usage Reporting Tool
  2. Extract it on the target server
    tar -xvzf zimbra-URT-1.0.0-BETA-xx.tgz
  3. Navigate to the extracted directory
    cd zimbra-URT-1.0.0-BETA-xx
  4. Run as root
  5. The installation process prompts you to provide installation path to install the ZURT service. The default location is
    To keep the default location press Enter.

Installation on non-Zimbra Server

  1. Download the Zimbra Usage Reporting Tool
  2. Extract it on the target server
    tar -xvzf zimbra-URT-1.0.0-BETA-xx.tgz
  3. Edit conf/zurt_ldap_config.xml located in the extracted ZURT tar and update the value for each key as defined below.
    You can get the below details by running
    zmlocalconfig -s | grep -i ldap
    as zimbra user
    1. ldap_host - set the value of ldap_host
    2. zimbra_ldap_password - set the value of zimbra_ldap_password
    3. ldap_port - by default its 389, if different set value of ldap_port
    4. zimbra_ldap_userdn - set value of zimbra_ldap_userdn

Once these details are specified, run the installation script (install.sh).

View Usage Report

Once installed, log in to Usage Portal. Please contact Zimbra sales for your login credentials.

Getting detailed usage data

  • To get account level data CSV dumps locally i.e. list of accounts CSV with features enabled for individual accounts, edit conf/zurt.properties file created on installation path (default/opt/zimbra-urt).
  • Change the value of account.level.data to true and restart ZURT service.

Consider ZURT installation location is /opt/zimbra-urt

vi /opt/zimbra-urt/conf/zurt.properties

set account.level.data to true

service zurt restart
  • Once service is restarted it will start dumping CSV files with account-level data for features enabled on individual accounts within the data folder of installation path.
  • To turn CSV dumps off, edit the properties file (conf/zurt.properties) and set the value back to false and restart the service.

ZURT Service Management

ZURT service commands
  • ZURT Start - service zurt start
  • ZURT Stop - service zurt stop
  • ZURT Restart - service zurt restart
  • ZURT Status - service zurt status

ZURT Installation Folder Contents

Files & folder at installation path (default/opt/zimbra-urt) contains

  • bin - folder contains zurt.sh script to run the usage data collection process
  • lib - contains jars for usage data collection
  • conf - contains
    • zurt.properties - property file to turn on/off for dumping account data and turn on/off collection of domain level data
    • log4j2.xml - For logging purpose
    • zurt_ldap_config.xml - For ldap details configuration in case of non zimbra server.
  • data - folder contains account level data CSV dumps
  • log - logs related the service can be accessed from this folder
Uninstall ZURT

To uninstall the ZURT service

  • stop the service
  • remove service files
  • delete the folder created as installation path
  • delete the folder extracted from ZURT tar
systemctl stop zurt
rm -rf /opt/zimbra-urt
rm /etc/systemd/system/zurt.service
rm -rf zimbra-URT-1.0.0-BETA-xx
Jump to: navigation, search