5,576
edits
Changes
From SME Server
Jump to navigationJump to search→Verifying Bugs
<noinclude>{{Languages}}</noinclude>
<noinclude>{{Languages}}</noinclude>
==Bug Tracker==
==Bug Tracker==
Please help us to make our software as reliable as possible. Please report possible bugs only via the bug tracker and to encourage others to do the same.
Please help us to make our software as reliable as possible. Please report possible bugs only via the bug tracker and encourage others to do the same.
Bugzilla is just a standard communication format for problem solving. Replies may seem abrupt but that is just the nature of the medium. Don't be concerned by a stark Wontfix or Invalid, it's how the system works. Discussions are for forums
Bugzilla is just a standard communication format for problem solving. Replies may seem abrupt but that is just the nature of the medium. Don't be concerned by a stark Wontfix or Invalid, it's how the system works. Discussions are for forums
===Bugzilla is easy===
===Bugzilla is easy===
A frequent complaint is Bugzilla is too hard or convoluted, but it is hard to justify.
A frequent complaint is Bugzilla is too hard or convoluted, but it is hard to justify the complaint.
*You open an account
*You open an account
===Searching Bugs===
===Searching Bugs===
Have you searched bugzilla, and read the SME Server Manual and FAQ ?
Have you searched bugzilla, and read the SME Server Manual and FAQ ?
* Advanced
* Advanced
You can restrict searches by using a selection or multiple selections of a category <br />
You can restrict searches by using a selection or multiple selections of a category <br />
Use Control Click to select/deselect from selection sets, if none are selected all are.
Use Control Click to select/deselect from selection sets, if none are selected the defailt is all.
* Reports
* Reports
===Reporting Bugs===
===Reporting Bugs===
Please take the time to read
Please take the time to read
[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively]
[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively]
(available in multiple languages)
(available in multiple languages)
For bugs in SME Server Release, SME Server Future & SME Server Translations the following format is suggested. It's not always appropriate eg. New Feature Requests
For bugs in SME Server Release, SME Server Future & SME Server Translations the following format is suggested. It's not always appropriate so use some discretion, see eg. New Feature Requests
When reporting a new bug, and after choosing the platform, the next screen asks for more details on your problem. There are 4 main fields that need to be completed. These are '''Component,''' '''Found-In-Version,''' '''Summary,''' and '''Description.''' Fields such as '''Flags''' and '''Requestee''' should be left blank initially by most reporters. The '''CC''' field is for other people you would like notices on this issue to be sent to. YOU will always be automatically included by default, so you don't need to 'cc' yourself. The '''Attachment''' button at the bottom of the page is used to attach additional file information such as log files that may be helpful.
When reporting a new bug, and after choosing the platform, the next screen asks for more details on your problem. There are 4 main fields that need to be completed. These are '''Component,''' '''Found-In-Version,''' '''Summary,''' and '''Description.''' Fields such as '''Flags''' and '''Requestee''' should be left blank initially by most reporters. The '''CC''' field is for other people you would like notices on this issue to be sent to. YOU will always be automatically included by default, so you don't need to 'cc' yourself. The '''Attachment''' button at the bottom of the page is used to attach additional file information such as log files that may be helpful.
===Verifying Bugs===
===Verifying Bugs===
Bugs in the SME Server Release, SME Server Future & SME Server Translations products
Bugs in the SME Server Release, SME Contribs & SME Server Translations products
need to be verified if fixed. (otherwise they can be closed)
need to be verified when fixed, see the [[Verification_Queue]] for the current list. See [[SME_Server:Documentation:QA:Verification]] for a detailed description of the verification process. <br />
An example is [[bugzilla:3727]]. You can use the text below as a template.
An example is [[bugzilla:3727]] or [[bugzilla:7364]].
'''Information from here is used in the Updates Announcements and if you use this format will save duplication of work'''
'''Information from here is used in the Updates Announcements and if you use this format, it will save duplication of work'''
Other Products can be Closed after being fixed, as they are not part of the updates process.
Other Products can be Closed after being fixed, as they are not part of the updates process.
= Environment:
The bug report will detail the exact package and version needed. These are normally in smeupdates-testing and can be installed by :
yum --enablerepo=smeupdates-testing update <package>
for example
yum --enablerepo=smeupdates-testing update e-smith-ldap
As it is a manual step to move packages into smeupdates-testing the most recent packages will be in smetest and can be installed from there if necessary.
for example
yum --enablerepo=smetest update e-smith-ldap
or if you need several repositories :
yum --enablerepo=smetest,smeupdates-testing,smedev update e-smith-ldap
When performing verification, please use the following template:
'''VERIFICATION TEMPLATE'''
= ENVIRONMENT:
= Current version installed:
= ORIGINAL PROBLEM:
= Original problem:
= RESOLUTION:
= Resolution:
= CURRENT VERSION INSTALLED:
= Updated version installed:
= TESTING:
= Problem fixed:
= UPDATED VERSION INSTALLED:
= Verified or Reopen:
= PROBLEM FIXED:
= VERIFIED OR REOPEN:
= DOCUMENTATION IMPACT:
= SUGGESTED RELEASE NOTES:
AS AN EXAMPLE:
VERIFICATION
= ~]# /sbin/e-smith/audittools/newrpms [Provide this if customised]
= ENVIRONMENT:
[description of test system (version, installation methods, upgrade history. etc).
If you have some non-core package installed, run /sbin/e-smith/audittools/newrpms and provide output]
= Original problem:
= ORIGINAL PROBLEM:
[Description]
[Summarise bug]
= Resolution:
= RESOLUTION:
[Reprint changelogs of new package being verified
[Insert changelog for new package]
In example:
Fixed in e-smith-base
* Mon Apr 21 2013 chris burnat <devlist@burnat.com> 5.4.0-27.sme
- Fix the way '.' works in bash [SME: 7532]
= Current version installed:
= CURRENT VERSION INSTALLED:
[rpm -q]
[rpm -qa <package name>]
=Testing:
=TESTING:
[Show problem being fixed by new package]
[Reproduce bug if you can, showing steps taken]
= Updated version installed:
= UPDATED VERSION INSTALLED:
[Show installation of new package]
[Update to new package, show steps taken]
and:
[rpm -qa <package name>]
= PROBLEM FIXED?:
[rpm -q again showing new package installed]
[Repeat steps carried out under TESTING above.
= Problem fixed:
= VERIFIED OR REOPEN:
[Repeat testing]
[Problem fixed, then VERIFIED - not fixed, then REOPEN]
Note: if you may not have rights to toggle resolution, someone will do it for you
= Verified or Reopen:
= DOCUMENTATION IMPACT:
[Conclusion based on testing above]
[Does something need documentation, eg a db or new procedure? if affirmative, please provide details, someone will later punt to docteam for action]
= Suggested release notes:
= SUGGESTED RELEASE NOTES:
[Summary of what has been fixed in new package]
[Summary of what was fixed]
===Testing===
It is recommended that some basic tests be carried out before resolving VERIFIED. The scope of these tests very much depends on functionality associated with the package(s) under consideration. The following list whilst not fully inclusive can be used as a guide:
*Hosting http
*Hosting https
*Access external http
*Access external https
*SSH access to server
*Send Email
*Receive Email
*Use Webmail
*Use Samba
*FTP access to SME
*Check /var/log/messages or/and any other relevant log.
===General===
===General===
====Bug Categories====
====Bug Categories====
Bugs are sorted by '''Product''', they should be mostly self explanatory. Future/7.x/8.x/9.x may need clarifying.
Bugs are sorted by '''Product''', they should be mostly self explanatory. Future/7.x/8.x/9.x may need clarifying.
With the release of SME 8.1, development is now focussed on reaching 9.0
With the release of SME 8.0, development is now focussed on reaching 9.0
*SME Server Future
*SME Server Future
*SME Server Release 7.X
*SME Server Release 7.X
- The error is severe enough that we need to fix it, taking time away from 8.x development
- The error is severe enough that we need to fix it, taking time away from 9.x development
- The bug is being worked on actively
- The bug is being worked on actively
*SME Server Release 8.X
*SME Server Release 8.X
- The error is severe enough that we need to fix it, taking time away from 8.x development
- The error is severe enough that we need to fix it, taking time away from 9.x development
- The bug is being worked on actively
- The bug is being worked on actively
====Bug Triage====
====Bug Triage====
If you can help do these steps, the developers can concentrate on fixing the bugs. <br >
The steps in this list is maybe 90% of the time of most bugs.
If you can help, the developers can concentrate on fixing the bugs. <br >
The steps in this list take approx 90% of the time in the resolving of most bugs.
Reread [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively]
Reread [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to report bugs effectively]
Now look at the bug reports in Bugzilla with your developer hat on.
Now look at the bug reports in Bugzilla with your developer hat on.
* Go into triage mode
* Go into triage mode this page can help You : [[Bugzilla_Reports]]
* Ask the questions asked by the essay
* Ask the questions asked by the essay
* Get the information from the reporter
* Get the information from the reporter
====Bug Status====
====Bug Status====
[http://www.bugzilla.org/docs/tip/html/lifecycle.html Lifecycle of a Bug]
[http://www.bugzilla.org/docs/tip/html/lifecycle.html Lifecycle of a Bug]
New bugs submitted by ordinary users are created in this state.
New bugs submitted by ordinary users are created in this state.
Note. Project Developers tend not to look at unconfirmed bugs as they only have so much time, so it's important regular users check each others bugs.
Note. Project Developers tend not to look at unconfirmed bugs as they only have so much time, so it's important regular users check each others bugs.
* NEEDINFO
This is a new state that should be used when more information is needed by the bug reporter.
* CONFIRMED
* CONFIRMED
Once bugs are confirmed, '''by anyone''' see note above, change the status to new,
Once bugs are confirmed to be valid and present in SME Server, '''by anyone''' see note above, change the status to CONFIRMED.
Only change to CONFIRMED if the bug is well written and has enough information to proceed.
* IN_PROGRESS
This indicates a developer is actively working on the bug.
* FIXED
* FIXED
====Bugzilla flags====
====Bugzilla flags====
These will be obvious to the people they are intended to serve. If you feel
These will be obvious to the people they are intended to serve. If you feel
comfortable setting them based on information contained in the bug or needs
comfortable setting them based on information contained in the bug or needs
Set the flag to ? to say someone needs to look at it
Set the flag to ? to say someone needs to look at it
[[Category:SME Server]][[Category:SME9-Development]]
[[Category:SME Server]][[Category:SME9-Development]][[Category:Developer]]
