Datamining
What is this?
This is a simple Tool to get an idea how a specific installation of Open-Xchange is used. Operating on the MySQL-database exclusively for now it is quite fast and uses few resources. Off-hours are still recommended for its usage to limit any performance-impact, though. It will find its required parameters automatically in the file /opt/open-xchange/etc/groupware/configdb.properties. It is also possible to specify all parameters explicitly. Output is a single text-file. The filename starts with "open-xchange_datamining" and includes the current date in YYYY-MM-DD format. The content of the file is camelCased-Parameters, unique and one per line. This should make using these files as input, for example for a visualization, pretty easy.
Install on OX {{#if:|{{{version}}}| AppSuite}}
Debian GNU/Linux 10.0
Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:
deb https://{{#if:%7C{{{ldbaccount}}}@%7C}}software.open-xchange.com/{{#if:%7C{{{toplevel}}}%7Cproducts}}/stable/DebianBuster/ /{{#if:||
# if you have a valid maintenance subscription, please uncomment the
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/{{#if:|{{{toplevel}}}|products}}/stable/updates/DebianBuster/ /
}}
and run
$ apt-get update $ apt-get install open-xchange-datamining
Debian GNU/Linux 11.0
Add the following entry to /etc/apt/sources.list.d/open-xchange.list if not already present:
deb https://{{#if:%7C{{{ldbaccount}}}@%7C}}software.open-xchange.com/{{#if:%7C{{{toplevel}}}%7Cproducts}}/stable/DebianBullseye/ /{{#if:||
# if you have a valid maintenance subscription, please uncomment the
# following and add the ldb account data to the url so that the most recent
# packages get installed
# deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/{{#if:|{{{toplevel}}}|products}}/stable/updates/DebianBullseye/ /
}}
and run
$ apt-get update $ apt-get install open-xchange-datamining
Usage
/opt/open-xchange/sbin datamining
Available Parameters
-?, -h, --help Print the available parameters
-d, --dbName <dbname> Name of the MySQL-database that contains the Open-Xchange configDB (default: configdb)
--dbPort <port> Port where MySQL is running on the host specified with "-hostname" (default: 3306)
-n, --hostname <hostname> Host where the Open-Xchange MySQL-database is running
-p, --dbPassword <dbpassword> Password for the user specified with "-dbUser"
--reportfilePath <path> Path where the report-file is saved (default: )
-u, --dbUser <dbuser> Name of the MySQL-User for configdb
-v, --verbose With this the tool prints what it is doing live
What questions are answered?
- numberOfSchemata
- averageFilestoreSize
- numberOfContexts
- numberOfUsers
- numberOfUsersWithEventsInPrivateCalendar
- numberOfUsersWithEventsInPrivateCalendarThatAreInTheFutureAndAreNotYearlySeries
- numberOfUsersWhoChangedTheirCalendarInTheLast30Days
- numberOfInfostoreObjects
- averageNumberOfInfostoreObjectsPerContext
- averageNumberOfInfostoreObjectsPerSchema
- numberOfNewInfostoreObjectsInTheLast30Days
- numberOfChangedInfostoreObjectsInTheLast30Days
- numberOfUsersWithNewInfostoreObjectsInTheLast30Days
- numberOfDocumentsBetween1ByteAnd3KB
- numberOfDocumentsBetween3KBAnd10KB
- numberOfDocumentsBetween10KBAnd30KB
- numberOfDocumentsBetween30KBAnd100KB
- numberOfDocumentsBetween100KBAnd300KB
- numberOfDocumentsBetween300KBAnd1MB
- numberOfDocumentsBetween1MBAnd3MB
- numberOfDocumentsBetween3MBAnd10MB
- numberOfDocumentsBetween10MBAnd30MB
- numberOfDocumentsBetween30MBAnd100MB
- numberOfDocumentsBetween100MBAnd300MB
- numberOfDocumentsBetween300MBAnd1GB
- numberOfDocumentsBetween1GBAndINFINITE
- numberOfContacts
- numberOfUsersWhoCreatedContacts
- numberOfUsersWhoChangedTheirContactsInTheLast30Days
- averageNumberOfContactsPerUserWhoHasContactsAtAll
- numberOfUsersWithLinkedSocialNetworkingAccounts
- numberOfUsersWhoSelectedTeamViewAsCalendarDefault
- numberOfUsersWhoSelectedCalendarViewAsCalendarDefault
- numberOfUsersWhoSelectedListViewAsCalendarDefault
- numberOfUsersWhoSelectedCardsViewAsContactsDefault
- numberOfUsersWhoSelectedListViewAsContactsDefault
- numberOfUsersWhoSelectedListViewAsTasksDefault
- numberOfUsersWhoSelectedHSplitViewAsContactsDefault
- numberOfUsersWhoSelectedListViewAsInfostoreDefault
- numberOfUsersWhoSelectedListViewAsContactsDefault
- numberOfUsersWhoActivatedMiniCalendar