Vyatta uses the Bugzilla bug tracking system to manage bugs and enhancement requests. Vyatta's Bugzilla instance can be found at http://bugzilla.vyatta.com/bugzilla/.

Step 1: Create Account

In order to do anything other than browse the issues database, you'll need to create an account with the Bugzilla system. Navigate to https://bugzilla.vyatta.com/bugzilla/createaccount.cgi and fill in the requested information. Note that the email address must be a functioning address and you will have to receive an email there before the account will be activated.

Step 2: Search for your Bug

You'll probably want to search the database for one of two reasons:
1. To see whether there is a workaround to a particular issue you have found.
2. To see whether there is an issue report already filed documenting a bug you have found or an enhancement request you want to make.
To search, you can either enter a search term on the main page (http://bugzilla.vyatta.com/bugzilla/) or you can use the search page (http://bugzilla.vyatta.com/bugzilla/query.cgi).

Find your Bug? Vote for it!
Bugzilla allows you to vote for a bug that you think is a high priority candidate for fixing. You can vote for a bug by viewing the detailed information about the bug. Right above the Additional Comments field, you'll see a link that says Vote for this bug. Simply select that link and then click the checkbox next to the bugs you want to vote for on the Change Votes screen  (http://bugzilla.vyatta.com/bugzilla/votes.cgi).

Note: Currently users are allowed a maximum of 10 votes in the Vyatta Bugzilla database. You can allocate one or more of your 10 votes to various bugs. If something is really important to you, feel free to use all 10 votes on a single bug. As bugs are closed or you decide that your priorities have changed, you can reassign your votes to other bugs.

Step 3: Filing a Bug

If you find a bug, please following this procedure:

1. If the bug is fairly complex or difficult to reproduce, you might want to verify that it's really a bug by discussing it on the mailing list.

2. Search for a similar bug in Bugzilla to avoid populating the database with duplicates. This is never an exact science, so if you can't find something that looks like it's the same thing, file a new bug and we'll take care of closing it if we think it's a duplicate. If you find a bug that is very similar but you seem to have found another manifestation, add an additional comment to the existing bug describing your new manifestation.

3. If you really think you bug might be new and unreported, enter it on the Enter Bug page (http://bugzilla.vyatta.com/bugzilla/enter_bug.cgi).

4. Please select the appropriate version number in the Version field. You can determine the version you are running by typing show version at the operational mode command line.

5. Select an appropriate component. If you can't determine what component to use, leave it blank or make your best guess; we'll take care of sorting it out.

6. You can ignore the Platform and OS fields for now. We know what you're running.

7. Please leave the Priority and Severity fields at their defaults. We'll set these appropriately when we triage the new bugs.

8. Ignore most of the other fields except for Summary and Description.

9. When writing the Summary field, try to keep it short but provide keywords that ease later searching. For instance, if the BGP process crashes when it receives a malformed route update, write a title like "BGP process crashes when sent a corrupt route update," not simply "System crashes".

10. When writing the Description field, try to provide as much detail about how to reproduce the problem as possible. If you can, cut and paste actual CLI transcript into the Description field such that we can see the actual commands you executed. The biggest problem for the engineering team in fixing bugs is to reproduce them such that they can diagnose the underlying problem. The more specific you can be, the more it helps us.

SEE ALSO

• More information about the Bugzilla voting process
• Current list of Vyatta bugs with votes