Click2try Bugzilla30 Tutorial

download Click2try Bugzilla30 Tutorial

of 18

Transcript of Click2try Bugzilla30 Tutorial

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    1/18

    2009 Presage Technologies, LLC.

    click2try Tutorial

    Bugzilla

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    2/18

    2009 Presage Technologies, LLC.

    Copyright 2009 Presage Technologies, LLC.

    You may freely distribute or publish this content provided you publish the content in its

    entirety and include all existing copyright notices, attributions, links, and acknowledgementsto click2try, Presage Technologies, LLC. and to organizations mentioned explicitly orimplicitly herein.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    3/18

    Bugzilla

    2009 Presage Technologies, LLC. 3

    Contents

    Introduction .............................................................................5Setting Parameters and Default Preferences ............................6Creating a New User.................................................................7Impersonating a User............................................................... 9Adding Products .....................................................................10Adding Product Components ..................................................11Modifying Default Field Values ............................................... 13Creating a New Bug................................................................15Viewing Bug Reports ..............................................................16Modifying Bug Reports ........................................................... 17Conclusion..............................................................................17Resources............................................................................... 18

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    4/18

    Bugzilla

    2009 Presage Technologies, LLC. 4

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    5/18

    Bugzilla

    2009 Presage Technologies, LLC. 5

    Introduction

    Bugzilla is the most popular bug tracking system available today. Bugzillas

    popularity is due to its highly customizable interface, easy configuration, and

    a large community of very active users. With Bugzilla, you can beginconfiguring your products, users, and bugs within minutes of starting up the

    system. Bugzilla provides you with many features, including:

    LDAP integration SMTP and Sendmail support Internationalized User authentication, group security, and SSL support Voting system Shortcut flags Custom fields Keyword tagging Saved searches Voting module Multiple report types

    In this tutorial, youll learn how to:

    Set parameters and default preferences Create new users Create products and components Modifying default field values Creating new bugs and modifying existing bugs

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    6/18

    Bugzilla

    2009 Presage Technologies, LLC. 6

    Setting Parameters and Default Preferences

    When you start using Bugzilla, youll need to set a small number of

    parameters and preferences. At a minimum, you should change the following

    items, to suit your particular need: Set the maintainer Set the mail_delivery_method Set bug change policies Set the display order of bug reports

    To set parameters and default preferences:

    1. Click Parameters at the bottom of the page.2. Under Required Settings, add an email address in the maintainer

    field.

    3. Click Save Changes.4. In the left side Index list, click Email.5. Select from the list of mail transports to match the transport youre

    using. If youre evaluating a click2try application, select Test. If youre

    using SMTP, set any of the other SMTP options for your environment.

    6. Click Save Changes.7. In the left side Index list, click Bug Change Policies.8. Select On for commentoncreate, which will force anyone who enters

    a new bug to enter a comment, to describe the bug.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    7/18

    Bugzilla

    2009 Presage Technologies, LLC. 7

    9. Click Save Changes.10.Click Default Preferences at the bottom of the page.11.Select the display order from the drop-down list next to the When

    viewing a bug, show comments in this order field.

    12.Click Submit Changes.

    Take the time to review the other parameters and preferences. This task has

    only covered a few of them and many others may be useful for you in yourprojects.

    Creating a New User

    Before you begin entering bugs, make sure you add some new users. You

    can enter users very easily, with a minimum of information. Bugzilla uses theemail address as the user ID, because users are frequently notified when a

    bug is entered, either because they entered the bug, because the bug is

    assigned to them, or because theyve chosen to track bugs in a certainproject.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    8/18

    Bugzilla

    2009 Presage Technologies, LLC. 8

    To create a new user:

    1. Click Users.2. Click add a new user.3. Enter the Loginname, in the form of an email address.4. Enter the Real name, a password, and then click Add.5. Select the Group access options. Youll probably want to enable the

    following options in the row titled User is a member of these groups:o canconfirmo editbugso editcomponents

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    9/18

    Bugzilla

    2009 Presage Technologies, LLC. 9

    6. Click Update when you are done setting options.Impersonating a User

    Why would you want to impersonate a user? Well, its possible, though

    rare, that you may need to file or manage a bug in an area that is the

    responsibility of another user when that user is not available. Perhaps theuser is on vacation, or is temporarily assigned to another project. You can

    impersonate the user to create or manage bugs that belong to that user.Keep in mind, however, that your actions are logged and the user is notified

    that you are impersonating him or her.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    10/18

    Bugzilla

    2009 Presage Technologies, LLC. 10

    Adding Products

    Youll add a product in Bugzilla for every product you are developing. To start

    with, when you first login to Bugzilla, youll find a test product called

    TestProduct. You should delete this and create a new product.

    To add a product:

    1. At the bottom of the page, click Products.2. In the TestProduct listing, click Delete.3. Click Yes, Delete.4. Now click Add a product.5. Enter a product name, such as Widget Design Kit.6. Enter a description.7. Click Add. A message appears telling you that youll need to add at

    least one component.

    Thats next.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    11/18

    Bugzilla

    2009 Presage Technologies, LLC. 11

    Adding Product Components

    Products are comprised of components. Software products, in particular, are

    typically made up of many functional components, which in turn are made up

    of program elements, like classes and functions. Its not unusual in asoftware development team environment for different individuals to be

    responsible for the bugs that are reported against a given component. Even if

    there are other programmers working on that component, its not uncommonfor one person, either a project lead or manager, to be the gatekeeper for

    bugs. Often, they will review the bugs as they are reported, in order toredirect them to the appropriate developer or even another team, to review

    the priority and severity supplied by the reporter, and sometimes to rejectbugs as duplicates or enhancement requests, for example.

    To add a component:

    1. Click the link add at least one component in the message thatappears after you create a new product.

    2. Enter the Component name.3. Enter a Description.4. Enter a default assignee. Use one of the users youve created.

    Remember to enter the assignee in the form of an email address.

    5. Click Add.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    12/18

    Bugzilla

    2009 Presage Technologies, LLC. 12

    6. To add more components, click the name of your product in themessage that reads edit other components of product .

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    13/18

    Bugzilla

    2009 Presage Technologies, LLC. 13

    Modifying Default Field Values

    Once you begin to enter new bugs, youll see a number of drop-down lists

    containing default values. Some of these may work just fine for your product.

    Others may not. You can modify the values of these fields, adding newvalues and deleting old ones. Lets take a look at the OS category.

    To modify default field values:

    1. At the bottom of the page, in the Edit section, click Field Values.2. Click the link, in this case OS, for the field you want to edit.

    The OS field contains a list of operating system names. You are going

    to add browsers to this list. In reality, you might create a custom fieldinstead, but for the sake of this example, just add them to the OS list.

    3. Click Add a value.4. In the Value field, enter IE7.5. Click Add.6. Click Add a value again.7. In the Value field, enter Firefox 3.8. Click Add.9. Where it reads Add other values for the op_sys field, click op_sys.

    This redisplays the table. You should now see the two new entries at

    the top of the table. These values will also appear in the OS drop-downlist when you create a new bug.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    14/18

    Bugzilla

    2009 Presage Technologies, LLC. 14

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    15/18

    Bugzilla

    2009 Presage Technologies, LLC. 15

    Creating a New Bug

    Of course, this is the part youve been waiting for. Creating bugs is a big part

    of what Bugzilla does best.

    To create a new bug:

    1. In the top menu, click New.2. If youve defined more than one component, choose the component

    from the component list.

    3. Select a Severity and a Priority. Severity is self-explanatory, butPriority is generally assumed to be the lower the number, the higher

    the priority. So, a P1 is the highest priority bug, a showstopper.

    4. Click the OS drop-down list to see the options, including the newbrowser names you entered.

    5. Select one of the options.6. Enter a summary and a description. You can add any other information

    you like, but it is not required by the system, although you maydetermine that your bug reporting policy requires certain information.

    7. Click Commit. Bugzilla adds your bug report to the database anddisplays the detail page for that bug.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    16/18

    Bugzilla

    2009 Presage Technologies, LLC. 16

    Viewing Bug Reports

    Eventually, youll end up with thousands of bugs listed in your system. Thereare several ways to view the bugs. The easiest is to click the My Bugs link at

    the bottom of the page. You can also save other common searches to make

    life a little easier for yourself. Because weve only got one bug reported, welluse the standard Search function.

    To find a bug:

    1. Click Reports.2. Click the Search link on the page, not the one in the top menu. This

    opens a page titled Find a Specific Bug.

    3. Select the Status.4. Select the Product.5. Enter a word that you think might be in the title of the bug.6. Click Search. If any bugs meet the criteria you entered, Bugzilla

    displays them in a list summary.

    7. Click the ID number link to view the full bug report.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    17/18

    Bugzilla

    2009 Presage Technologies, LLC. 17

    Modifying Bug Reports

    Lets assume you want to change the status of the bug. Youve reviewed it

    and have determined that it belongs to one of the users you created earlier

    in this tutorial.

    To modify a bug report:

    1. Scroll down the full bug description and enter a comment in theAdditional Comments field.

    2. Select Reassign bug to and replace the default user ID with one ofthe other user IDs you created. Remember it must be in the format of

    an email address.

    3. Click Commit.

    Thats it. Youve modified a bug.

    ConclusionThere are many other features to Bugzilla, including custom fields, quips,groups, keywords, and a whining feature (which is a type of scheduled email

    reminder, or a nag). You should now have a fairly good grasp of how tonavigate around Bugzilla and how to create new elements and modify others.

  • 8/9/2019 Click2try Bugzilla30 Tutorial

    18/18

    Bugzilla

    2009 Presage Technologies LLC 18

    Resources

    For more information about Bugzilla, visit the following resources:

    Bugzilla.orghttp://www.bugzilla.org Main Bugzilla community anddevelopment page.

    Bugzilla Wikipediahttp://en.wikipedia.org/wiki/Bugzilla Great

    description of Bugzilla on Wikipedia, with graphics and links.

    Bugzilla Documentation http://www.bugzilla.org/docs/ Documentationin multiple formats for several releases.

    Landfillhttp://landfill.bugzilla.org/ Several running demos of Bugzilla,

    against different database backends.