Tableau de bord de bogues

FAQ

La page comporte des questions et des réponses de FAQ avec des liens appropriés.

Bugzilla

1. Quelles versions de Bugzilla sont soutenues ?
2. Quel accès à Bugzilla est nécessaire ?

Tableau de bord

1. Les comptes dans le tableau de bord ne semblent pas être conformes à une recherche des mêmes critères dans Bugzilla. Y a-t-il une raison pour laquelle ?
2. Pourquoi incluez la vue classique et portique ? Est-ce que je ne peux pas juste employer la vue portique ?
3. Je fais définir un portail de 3 colonnes, mais je vois seulement 2. Où est la troisième colonne ?

Installation et conditions

1. Avec quels systèmes de piste de question le tableau de bord de bogues fonctionne-t-il ?
2. J'ai suivi toutes instructions d'installer sur mon serveur de Linux avec MySQL, mais quand moi ouvrons le tableau de bord que je ne vois aucun bogue énuméré, comptes, etc.
3. J'obtiens l'erreur FileNotFound : /home/bugsd3/public_html/logs/out.log (aucun un tel dossier ou annuaire). Quel est le problème ?

Autorisation

1. Yikes ! Y a-t-il des honoraires mensuels pour autoriser le tableau de bord de bogues ?

MySQL

1. Après réglage des maxConnections dans mon dossier de db_en_US.properties, MySQL (ou Tomcat) m'indique que j'ai atteint le nombre maximum des raccordements et il est inférieur à ma propriété. Pourquoi ?
2. En chargeant une liste de bogues ou de questions ou en sauvant un commentaire très grand, j'ai reçu une erreur énonçant que j'avais excédé la quantité de mémoire disponible. Pourquoi ?
3. J'obtiens une « valeur d'arrêt est » erreur négative en essayant d'accéder à la page d'ouverture. Quel est le problème ?

Bogues exceptionnels

1. Nous avons ajouté quelques bogues aujourd'hui et voulons les voir dans le vieillissement à la page « exceptionnelle ». Si nous écrivons 0 pour le nombre de jours, ils n'apparaissent pas. Comment pouvons-nous inclure les entrées d'aujourd'hui ?

Portlets

1. Y a-t-il des honoraires pour des portlets ?
2. Comment est-ce que je change la taille de chaque colonne dans le portail ?
3. Comment est-ce que je change le nombre de colonnes dans le portail ?

Réglage des priorités et de Severities

1. Comment est-ce que j'ajoute une question à une priorité quand la priorité n'a actuellement aucune question dans elle ?
2. Que se produit quand je mets à jour une priorité ou une sévérité ?
3. Aidez, je ne peut pas laisser tomber mon bogue !

Dépannage

1. Clicking on a bug number gives me an error: The requested resource (/bugzilla/show_bug.cgi) is not available. What do I do?

Bugzilla

Q:1 What versions of Bugzilla are supported?

The Bugs Dashboard currently works with both MySQL and PostGres versions of Bugzilla 2.18.x and 2.20 through 3.0. Please note that as-of v1.4.0, Bugs Dashboard no longer supports 2.18.x versions of Bugzilla. This is in keeping with Bugzilla’s desupport notice for that version.

Q:2 What access to Bugzilla is necessary?

You must provide an account which has the authority to edit bugs. This account will be used to perform updates to the priority and/or severity. If you wish to drill down into an issue, you must also have an active account in Bugzilla. You will be prompted to login when you choose to drill down.

Back to Top

Dashboard

Q:1 The counts in the Dashboard don’t appear to agree with a search of the same criteria in Bugzilla. Is there a reason why?

In the configuration of Bugs Dashboard, you can specify projects and states which you wish to exclude from reporting in the Bugs Dashboard. Doing so can make it appear as if the counts do not agree with a search in Bugzilla. For example, if you exclude “RESOLVED” and “CLOSED” statuses in Bugs Dashboard, then do a count of “open” bugs in both it and Bugzilla, they may not agree. That’s most likely because Bugzilla considers the status “VERIFIED” to be a closed bug whereas the Bugs Dashboard was not configured to exclude that status.

Q:2 Why include both the Classic and the Portal view? Can’t I just use the Portal view?

You can use just the Portal view, but then you burn a lot of real estate for those metrics you can view via the Classic Dashboard. The real purpose of the Portal view is to allow you to extend the Bugs Dashboard by creating and adding your own portlets. You can modify the portlets.properties file to REMOVE the default portlets after you have added other portlets. This should provide you with the best of both worlds. Of course, you can leave the default portlets there and add your own as well. You’ll just need to scroll some more.

Q:3 I have a 3-column portal defined, but I only see 2. Where’s the third column?

We have seen this behavior in Internet Explorer 7 when it is maximized to the full width of the screen. Interestingly, the solution is to minimize IE7 which will cause the columns to line up correctly. You can then manually expand it back out to the width of the screen - just do not use the maximize button in the window!

Back to Top

Installation and Requirements

Q:1 What issue tracking systems does the Bugs Dashboard work with?

The Bugs Dashboard currently works with Bugzilla releases 2.18 through 3.0, both with MySQL and PostGres. We are currently working on interfacing to Scarab. If you are interested in this work effort or have another system you would like us to investigate, please drop us an e-mail!

Q:2 I’ve followed all the instructions to install on my Linux server with MySQL, but when I open the dashboard I don’t see any bugs listed, counts, etc.

You must ensure that you can connect to MySQL via TCP/IP. Simply using a command-line to test can be misleading as that uses a socket. For further information, see: http://dev.mysql.com/doc/refman/5.0/en/can-not-connect-to-server.html

Q:3 I’m getting the error FileNotFound: /home/bugsd3/public_html/logs/out.log (No such file or directory). What is the problem?

Step 1: shoot the guy who packaged the zip! (Wait, that’s me! Don’t shoot!!) This is an artifact of testing and we apologize for the inconvenience. The log4j.properties file was still referring to the location on our hosted server. Please open the properties file at /bugs/WEB-INF/log4j.properties and look at line 1. It should say

log4j.rootLogger=fatal, R

Then change the path on line 5 to something like

./logs/out.log

If the logs directory isn’t one level up from your Tomcat binaries, please set the appropriate path. I promise not to make you do this again. Well, not on purpose anyway!

Back to Top

Licensing

Q:1 Yikes! Is there a monthly fee to license Bugs Dashboard?

No! The license is written in such a way as to cover a host of different scenarios. One that we have contemplated offering is an Application Service Provider (ASP) model. Large development shops have their own servers, backups, staff, etc. Smaller development efforts (e.g. “garages” and home offices) may be more comfortable with web access to a service. Thus, that portion of the license would relate to their use. (If you’d like to use a hosted service, please contact us at sales@bugsdashboard.com.) Otherwise, the fees are quite simple: a one-time $19.95 for the developer (single user reporting access) license or $199.95 for the enterprise (reporting all bugs from an instance). Ongoing support, beyond the first 30-days, is also available should you wish.

Back to Top

MySQL

Q:1 After setting maxConnections in my db_en_US.properties file, MySQL (or Tomcat) tells me I’ve reached the maximum number of connections and it’s lower than my property. Why?

You may need to set the MySQL property “max_connections” to zero (for unlimited connections) or to the same value you set the maxConnections property. On Windows, you can do this in your my.ini file.

Q:2 When loading a list of bugs or issues or when saving a very large comment, I received an error stating I had exceeded the amount of memory available. Why?

MySQL has a default maximum packet size of 1M. If you are entering large reports (perhaps citing a source), you may need to increase the “max_allowed_packet” size in your my.ini file. If it doesn’t exist, add it to the .ini file and use a larger setting, e.g. 20M or 32M or as appropriate for your largest updates.

Q:3 I get a “timeout value is negative” error when trying to access the login page. What’s the problem?

If you see something like the following:

java.lang.IllegalArgumentException: timeout value is negative java.lang.Object.wait(Native Method)
com.wmpnj.statusreports.components.ConnectionPool.getConn(ConnectionPool.java:191)
com.wmpnj.statusreports.components.ConnectionPool.getConn(ConnectionPool.java:206)
com.wmpnj.statusreports.components.ConnectionPool.getConnection(ConnectionPool.java:174)
com.wmpnj.statusreports.authentication.Login.doPost(Login.java:83)
com.wmpnj.statusreports.authentication.Login.doGet(Login.java:62)
javax.servlet.http.HttpServlet.service(HttpServlet.java:689)
javax.servlet.http.HttpServlet.service(HttpServlet.java:802)

check your db_en_US.properties file. The most probable cause for this type of error is that you’ve mistyped some part of the jdbc URL. For example, if the database instance is incorrect, you’ll see the above error.

Back to Top

Outstanding Bugs

Q:1 We added some bugs today and want to see them in the aging on the “Outstanding” page. If we enter 0 for the number of days, they don’t appear. How can we include today’s entries?

The calculation for the Outstanding page is to find bugs entered “less than” the current date minus any days you specify. If you wish to see bugs older than 30 days, you enter 30. That will give you bugs entered 31+ days ago. To see today’s bugs, enter a -1 for the days. (Current date - (-1) = tomorrow, meaning you’ll see all bugs older than 1 day from today or, in other words, all bugs including today’s.)

Back to Top

Portlets

Q:1 Is there a fee for portlets?

We have a forum for sharing portlets and those portlets WE post are free for your use. If others wish to develop significant portlets and charge for them, we’re happy to announce them and will let the market determine the best cost, etc.

Q:2 How do I change the size of each column in the portal?

Locate the portal.css file in the deployed css directory (e.g. /webapps/bugs/css). Open it with a text editor. You’ll see three columns defined as “#widget_col_0″, “#widget_col_1″, and “#widget_col_2″. Each of these have a “width” property. The defaults are: 30, 50 and 20% respectively. You may change the width of the columns by adjusting the “width” property of one or more columns. Now, locate the “page.css” file in the same directory. Open it with a text editor and find the same three widget_col entries. Change their width properties as well, saving both files. Changes to these files may necessitate a restart of your web application server.

Q:3 How do I change the number of columns in the portal?

You cannot increase the number of columns in v2.0, but you can decrease them, thus giving you larger columns if you wish. Locate the portal.css file in the deployed css directory (e.g. /webapps/bugs/css). Open it with a text editor. You’ll see three columns defined as “#widget_col_0″, “#widget_col_1″, and “#widget_col_2″. Each of these have a “width” property. The defaults are: 30, 50 and 20% respectively. Setting the width of #widget_col_2 to 0% will cause it to not appear on the portal. You should remember to not only increase the remaining columns, but also update the portal.properties file (i.e. /webapps/bugs/WEB-INF/classes/portal.properties) so that the portlets appear in the proper column of those that remain. You may also set #widget_col_1 to 0% if you wish to have only one large column on the portal. Now, locate the “page.css” file in the same directory. Open it with a text editor and find the same three widget_col entries. Change their width properties as well, saving both files. Changes to these files may necessitate a restart of your web application server.

Back to Top

Setting Priorities and Severities

Q:1 How do I add an Issue to a Priority when the Priority currently has no issues in it?

When you drag your Issue over the empty container (as represented by an empty box), it will expand to incorporate your Issue. Simply drop the Issue while the container is expanded in the background.

Q:2 What happens when I update a priority or severity?

We first check to see that the account provided in our configuration has the authority to edit issues in the issue tracking system you use. We then use that account to update the issue, setting the new priority. We also log an entry into the history file with your comments. Finally, we trigger an e- mail notifying the users configured in your issue tracking system of the change (assuming you have this configured properly.

Q:3 Help, I can’t drop my bug!

We’ve noticed that after recent updates to Firefox, dragging and dropping bugs in both Priorities and Severities can seem a little sticky. That is, you click on the bug and drag it just fine, but when you release the mouse, the bug continues to follow you around. If this happens to you, double-click when releasing the mouse.

Back to Top

Troubleshooting

Q:1 Clicking on a bug number gives me an error: The requested resource (/bugzilla/show_bug.cgi) is not available. What do I do?

This is most likely due to the “bugURL” property not being set to match your installation of Bugzilla. Go to any bug in Bugzilla and note the url to display the bug. It will typically end in something like ?id=. Open your db_en_US.properties (or localized copy) file from /bugs/WEB-INF/classes and look for the bugURL property. Set the bugURL to be that which matches your installation of Bugzilla. For example, the default is /bugzilla/show_bug.cgi?id=, but one of our testing platforms would require this to be changed to: /bugzilla313/show_bug.cgi?id=.

Back to Top