sosreport #5

Description

Sos is a set of tools that gathers information about system hardware and
configuration. The information can then be used for diagnostic purposes and
debugging. Sos is commonly used to help support technicians and developers.
.
This charm will install sosreport on the designated unit. Two actions are
available :
collect - will run sosreport and create a tarball to be copied
cleanup - will delete tarballs previously created


Overview

This is a "source" charm, which is intended to be strictly the top layer of a built charm.

Peparation

To build this charm, issue the following command from the top charm directory :

$ charm -v build

Usage

This charm is meant to be deployed concurrently with an existing unit from whic
we want to gather sosreport data. A typical syntax to deploy to a unit running
on machine #1 would be :

$ juju deploy sosreport_charm --to=1

The charm will deploy to this machine and install sosreport. No actual data will
be collected. Sosreport installation will default to the version available in
the official Ubuntu archive. This can be changed by using the repository parameter.

Optional parameter

The sosreport_charm has one optional paramter :

  • repository : Any valid repository URL as understood by the add-apt-repository
    such as :
    ppa:canonical-support/support-tools
    deb http://archive.ubuntu.com/ubuntu/ trusty main

Actions

This charm defines two actions :
* collect : Action responsible for running sosreport and creating the report
* cleanup : Action responsible for deleting all previously created reports

Action's parameters

The collect action has the following optional parameters :
* options : Valid options to be passed unchanged to sosreport
* homedir : Alternate directory where reports will be stored. The directory
must exist (default: /home/ubuntu)
* minfree : Minimum of free diskspace to run sosreport expressed in percent,
Megabytes or Gigabytes. Valid suffixes are % M or G
(default 5%)

The cleanup action has the following optional parameter :
* homedir : Alternate directory where stored reports needs to be deleted. The
directory (default: /home/ubuntu)

Configuration

repository
(string) The repository to use to install sosreport
apt