OXReportClient

Introduction

The open-Xchange Report Client extension of the Open-Xchange Server > 6.12 will enable you to generate and send usage reports of your environment to Open-Xchange. The report will contain information of how many contexts and users have been created in the given Open-Xchange environment. This article will guide you trough the installation of the Open-Xchange Report Client, it describes how to setup the software extension itself, and which additional configurations need to be done to execute this extension.

Installation

If the package open-xchange-report-client hasn't already been installed during the Open-Xchange Server setup you will need to install it now:

Debian

$ apt-get update
$ apt-get install open-xchange-report-client

SLES 10 / 11

$ zypper install open-xchange-report-client

RHEL 5

$ yum update
$ yum install open-xchange-report-client

Configuration

A requirement to execute the Open-Xchange Report Client is to have your Open-Xchange license key stored in one specific file on your Open-Xchange installation. The latest version of our installation guide documentation will automatically enable you to store your license key on disk by using a new oxinstaller command.

If you want to use the report client on an already installed environment you need to store your license key manually on disk. To do so create and edit the following file on your Open-Xchange server:

$ vim /opt/open-xchange/etc/common/license.properties 

com.openexchange.licensekey.1=PUT_YOUR_OPEN-XCHANGE_LICENSE_KEY_HERE

Using the Report tool

Now as the package has been correctly installed and you provided your license key in the according propertie file your are ready to launch the report client to generate a report. By default (if no option is given) the report client will display and send the generated report to an Open-Xchange service on activation.open-xchange.com. Note that only data will be transfered to Open-Xchange which will be displayed in the console.

If you want to know which data would be transfered to activation.open-xchange.com execute the report client with the option "-d" (display_only). If this option is given to the report client no data will be transfered to activation.open-xchange.com:

$ /opt/open-xchange/sbin/report -d

If you don't want to have the report displayed in the console (which might be the case for automated executions of the report client) execute the report client with the option -s (send_only). Now no report will be displayed after the report has been sent to activation.open-xchange.com.

$ /opt/open-xchange/sbin/report -s

List of all options for the Open-Xchange report client:

Starting the Open-Xchange report client. Note that the report generation may take a little while.
Usage: report
 -h,--help                                         Prints a help text          
    --environment                                  Show info about commandline environment
    --nonl                                         Remove all newlines (\n) from output
 -H,--host <host>                                  specifies the host          
 -J,--jmxauthuser <jmxauthuser>                    jmx username (required when jmx authentication enabled)
 -P,--jmxauthpassword <jmxauthpassword>            jmx username (required when jmx authentication enabled)
 -s,--sendonly                                     Send report without displaying it (Disables default)
 -d,--displayonly                                  Display report without sending it (Disables default)
 -c,--csv                                          Show output as CSV

Automatic reports

Creating a cron entry which will automatically execute the report client once a week saves a lot of work. To create this cron entry execute:

$ vim /etc/cron.d/open-xchange_report

0 3 * * 7	open-xchange	/opt/open-xchange/sbin/report -s 1> /dev/null 2>&1

What will be reported using the send method?

The report client will display and / or transfer the following information:

1. Version number of the Open-Xchange server package
2. Version number of the Open-Xchange admin package
3. Total user count
4. Total context count
5. Detailed context information: Age, creating date, user count, context id
6. Detailed user information (per context): User access comination flags (which modules have been activated for the users)