Revision as of 13:50, 28 May 2014

Creating an OX Support Tarball

The 'oxsysreport' tool is able to collect in a incident scenario a lot of useful log and system information into a tar archive. This so called OX Support Tarball contains Apache and OX configurations, OX logs and system information. This and a qualified Error Report makes sure that our support department get all needed details for a fast qualified help. We always recommend to encrypt your E-Mail with our Support Key when attaching this tarball.

Parameter Overview

Option	Default Values	Possible Values	Required Tools
--tempdir	/tmp	<directory>
--logdir	ox_support_infos-<timestamp>	<folder name>
--log-archive	/tmp/ox_support_infos-<timestamp>.tar	<path to tarball>
--keep-tmp-files	false	true false
--thread-dump	false	true false
--heap-dump	false	true false	jmap, sudo (Only if not IBM Java)
--skip-compression	false	true false
--exclude-old-logs	disabled	0 ... n Days
--exclude-ox-secrets	false	true false
-h,--help	disabled

Required Tools

We recommend to check if all required tools are installed before a incident happens. In case your are running IBM Java on e.g. SUSE Linux Enterprise, heap dumps will be created differently. Please note, we do not list package names which are usually get installed in a default installation.

Tool	Debian	SuSE	Redhead	CentOS	Univention
bzip2	bzip2
jmap	sun-java<version>-jdk openjdk-<version>-jdk	N/A	java-<version>-openjdk-devel	java-<version>-openjdk-devel	openjdk-<version>-jdk
sudo	sudo

Features

Directory for Temporary Process Data (--tempdir)

Root Folder Name of the Support Tarbal (--logdir)

OX Support Tarball Name and Storage Location (--log-archive)

Keep Temporary Process Data (--keep-tmp-files)

By this new feautures it is possible to generate additional information which are potentially required to deal with high load, cpu or memory usage incidents.