This section may be outdated for version 2.0. It was copied from the version 1.7.0 documentation, and has not yet been updated. Once updated, please remove this note.

In order to increase the amount of positive feedback that we get from our communities we are introducing a version checker.

For information on the benefits to the community and to the software of a version checker please read The Case For Positive Feedback

The Pre-Configured Installation (PCI) will be the first package that will include the version checker. Our plan is to add the version checker to the design tools and ETL, OLAP and Reporting engines in upcoming releases.


This is our charter for our version checker:


The version checker can be disabled by editing the pentaho-solutions/system/systemListeners.xml file. See below for more details. The version checker can be removed entirely from the software without causing degradation of any kind.

No Discrimination

The data collected through the version checker will never be used to discriminate against any group, individual, or field of endeavor.


Data Transmitted

The data sent by the version checker to our server is described below.


The purpose of the version checker is to help focus the efforts of the community on the latest version of the software. This increases the number of contributions that are submitted and helps improve the functionality and stability of the software. 

The data from the version checker will provide us with more accurate data during the release cycle when estimating how many people are using the software and how hardened the new features are.

In addition data from the version checker will help us to plan and prioritize platform certifications, testing plans, and localization plans. 

Source Code

The source code for the version checker is available via an http interface into our subversion source code repository. Use these links to view the packages and code:

The source code that integrates the version checker into the Bi platform can be viewed using these links:


The data collected through the version checker will not be used in a manner that violates Pentaho's privacy policy.


The BI Platform Version Checker is a scheduled quartz job that determines if a new version of the platform is available, and if so, writes information to the BI Server log notifying the system administrator.  The Version Checker is configured in the pentaho-solutions/system/systemListeners.xml as a System Listener:

<bean id="versionCheckerSystemListener" class="org.pentaho.platform.scheduler.versionchecker.VersionCheckSystemListener">
  <property name="repeatIntervalSeconds">
  <property name="requestedReleases" value="Minor, GA" />
  <property name="disableVersionCheck">

The version check system listener makes calls to the pentaho-commons jar file pentaho-versionchecker.jar.  This jar file makes an http request to a webservice at which returns a list of available updates based on the release-flags and your operating system, determined by the java system property "".  To avoid repeated update notifications, a properties file is created in the user's home directory under .pentaho/.vercheck, which contains a unique identifier and a list of updates that have already been detected and logged.

WebService Call to

 The webservice call to pentaho is simply an HTTP GET request with the following GET parameters:

Here is an example parameter string that is sent to the server:


Disabling the Version Checker

There are varying degrees of removing the version checker from the platform: