summaryrefslogtreecommitdiffstats
path: root/src/plugins/abrt-action-bugzilla.txt
blob: 313e5b19a6a188e764927c3df9a5282470201f72 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
abrt-action-buzilla(1)
====================

NAME
----
abrt-action-bugzilla - Sends problem information to bugzilla.

SYNOPSIS
--------
'abrt-action-bugzilla' [-v] [-c CONFFILE] -d DIR

DESCRIPTION
-----------
The tool reads a problem dump direcotry. Firstly, the tool is trying to find
duplication of bug. If duplication is 'not' found, then a new bug is created.
Otherwise if duplication 'is' found and bug is closed as duplication of the
other bug, than, so called, 'hoping' begin. It means, that tool is going to try
track the origin bug.

Example of bug stages are:
------------
CLOSED DUPLICATE -> CLOSED DUPLICATE -> NEW
------------
Third one is the origin of the same problem. The tool adds a new comment to bug,
logouts from bugzilla and return link to bug.

Properties of bugzilla can be specified in a configuration file,
and via environment variables.

Configuration file
~~~~~~~~~~~~~~~~~~
Configuration file contains entries in a format "Option = Value".

The options are:

'Login'::
	Login to Bugzilla account.

'Password'::
	Password to Bugzilla account.

'BugzillaURL'::
	Bugzilla http address. (default: https://bugzilla.redht.com)

'SSLVerify'::
	Use yes/true/on/1 to verify Bugzilla ssl certificate. (default: yes)

Integration with ABRT events
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
'abrt-action-bugzilla' can be used as a reporter, to allow users report
problems to bugzilla when they decide to do it. This usage is
pre-configured in /etc/abrt/events.d/ccpp_events.conf and
/etc/abrt/abrt_events.conf.

For python problems (/etc/abrt/abrt_events.conf)
------------
EVENT=report_Bugzilla analyzer=Python
      abrt-action-bugzilla -c /etc/abrt/plugins/Bugzilla.conf
------------

For C/C++ problems (/etc/abrt/events.d/ccpp_events.conf)
------------
EVENT=report_Bugzilla analyzer=CCpp
      abrt-action-bugzilla -c /etc/abrt/plugins/Bugzilla.conf
------------

OPTIONS
-------
-d DIR::
   Path to dump directory.

-c CONFFILE::
   Path to configration file. When used in ABRT event system, the file
   contains site-wide configuration. Users can change the values via
   environment variables.

ENVIRONMENT VARIABLES
---------------------
Environment variables take precedence over values provided in
the configuration file.

'Bugzilla_Login'::
	Login to Bugzilla account.

'Bugzilla_Password'::
	Password to Bugzilla account.

'Bugzilla_BugzillaURL'::
	Bugzilla http address. (default: https://bugzilla.redht.com)

'Bugzilla_SSLVerify'::
	Use yes/true/on/1 to verify Bugzilla ssl certificate. (default: yes)

AUTHORS
-------
* ABRT team