How to debug Firefox problems

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
m (moved Bug info Firefox to How to debug Firefox problems: Use a plain language title for searchability)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page explains information that should be included when filing bugs related to Firefox. Problems involving Firefox should be filed against [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=firefox firefox].
+
= '''Bug reporting overview''' =
  
* Is the bug being triggered by an add-on or is it in Firefox itself?  Likely if other testers are not seeing the same problem, or if the bug is associated with file types typically handled by plugins (e.g. Flash, PDFs, RealAudio, QuickTime).
+
Details for each of these items are covered below with references at the bottom.
** Go to "Tools -> Add-ons" in the Firefox menu to see what you have installed.  To experiment, you can disable Plugins, Extensions, etc. one by one.  You may need to restart the browser for changes to take effect.
+
** You can run "firefox -safe-mode" to get the application started without any Extensions or Themes.  (Plugins are still loaded.)
+
** At the very least, reporting what Plugins and Extensions you have installed is a useful part of a Firefox bug report.
+
* Is the bug being triggered by some other customization you made?  Likely if other testers are not seeing the same problem.
+
** Try running Firefox as a different Unix user, who has never run Firefox before.
+
** If this solves the problem, it will probably be necessary to find the specific customization (or set of customizations) which triggers the bug.
+
  
For crashes, see the Firefox section of [[StackTraces]].
+
# Clear out cache, cookies and session history.
 +
# Remove all plugin-ins, extensions, non-default themes.
 +
# Restart the application and see if you are still able to reproduce the issue.
 +
# Startup in Safe-Mode and reproduce.
 +
# Create a new profile. (See profile manager section below)
 +
# Download a copy of Mozilla and see if the issue persists. [https://www.mozilla.com/en-US/firefox/all.html]
  
[[Category:Debugging]]
+
These steps can help isolate where the issues may reside.
 +
 
 +
= '''Standard troubleshooting steps''' =
 +
 
 +
== Restart Firefox ==
 +
 
 +
Close Firefox completely: From the menu at the top of the Firefox windowbar, select ''File'' and then select the ''Quit'' menu item. Then restart your computer and start Firefox again.
 +
 
 +
== Clear cookies and cache ==
 +
 
 +
Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:
 +
 
 +
# Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
 +
# In the Time range to clear drop-down menu, select Everything
 +
# Click the arrow next to Details to display the list of items to clear, then select the following items:
 +
#* Cache
 +
#* Cookies
 +
# Click Clear Now.
 +
# Exit your browser
 +
# Clear Flash cookies
 +
#* '''find ~/.macromedia/ -type f -name \*.sol -exec rm '{}' \;'''
 +
 
 +
For more information, see Clear Recent History. [http://support.mozilla.com/en-US/kb/Clear+Recent+History]
 +
 
 +
== Test in Safe Mode ==
 +
 
 +
''firefox -safe-mode''
 +
 
 +
== Reset preferences ==
 +
 
 +
( Safe mode option ) [http://support.mozilla.com/en-US/kb/Safe+Mode]
 +
 
 +
== Troubleshoot extensions and themes ==
 +
 
 +
Sometimes add-ons for Firefox (extensions or themes) can cause problems. To confirm whether your problem is caused by an add-on, launch Firefox's Safe Mode:
 +
 
 +
# Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
 +
# Go to your Terminal and run: '''firefox -safe-mode'''
 +
# In the Firefox Safe Mode dialog, click ''Continue in Safe Mode''.
 +
# Test for your problem.
 +
 
 +
If the problem does not occur in Safe Mode, an extension or theme is likely the cause. For more information about troubleshooting extensions and themes, and how to narrow down which add-on is causing problems, see Troubleshooting extensions and themes. [http://support.mozilla.com/en-US/kb/Troubleshooting+extensions+and+themes]
 +
 
 +
== Troubleshoot Add-ons / plugins ==
 +
 
 +
Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, RealPlayer/HelixPlayer, Rhythmbox, Totem and VLC) can cause problems.
 +
 
 +
# Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
 +
# Click on the Plugins icon at the top of the Add-ons window.
 +
# Click each plugin in the list and then click Disable.
 +
# Test for your problem.
 +
 
 +
For more information about various plugins, and what to do if you find the plugin that causes problems, see the Troubleshooting plugins article.
 +
 
 +
 
 +
== Further troubleshooting steps ==
 +
 
 +
If the steps above don't fix your problem, continue by following these instructions.
 +
 
 +
'''Make a new profile'''
 +
 
 +
A corrupt profile can cause various problems with Firefox. You can try to make a new profile test whether that solves the problem, and if so, copy your data (bookmarks, saved passwords, etc.) to the new profile.
 +
 
 +
'''Important: Before you can start the Profile Manager, Firefox must be completely closed.'''
 +
 
 +
# Exit Firefox. To close Firefox, at the top of the Firefox window, select the File menu, and then select Quit.
 +
# In Terminal run: '''firefox -ProfileManager'''
 +
#* If the Profile Manager window does not open, Firefox may have been running in the background, even though it was not visible. Close all instances of Firefox or restart the computer and then try again.
 +
#* If you are connected to another host, and the above is not working properly, run: '''firefox -ProfileManager -no-remote'''
 +
# To start the Create Profile Wizard, click ''Create Profile...'' in the Profile Manager.
 +
# Click Next and enter the name of the profile. Use a profile name that is descriptive, such as your personal name. This name is not exposed on the Internet.
 +
# You can also choose where to store the profile, which is useful if you plan on exporting your data and settings to another computer or setup in the future. To choose its storage location on your system, click ''Choose Folder...''.
 +
# To create the new profile, click ''Finish''.
 +
# Click on the newly created profile in the Profile Manager and click Start Firefox.
 +
 
 +
Test to see if your problem occurs with the new profile. If it doesn't, you can copy your data to the new profile - see Recovering important data from an old profile for instructions. For troubleshooting purposes, only copy the files that correspond to your bookmarks and saved passwords.
 +
 
 +
== Collect information for a bug report ==
 +
 
 +
In the URL bar, visit this link:
 +
 
 +
''about:support''
 +
 
 +
Copy this information to your bug report. [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=firefox]
 +
 
 +
 
 +
= Additional Reading =
 +
 
 +
* Additional accessibility prefs can be found here: [http://kb.mozillazine.org/Accessibility_features_of_Firefox]
 +
 
 +
* Additional hidden prefs can be found here: [https://www.mozilla.org/unix/customizing.html]
 +
 
 +
* Mozilla's own basic trouble-shooting page: [http://support.mozilla.com/en-US/kb/Basic+Troubleshooting]
 +
 
 +
* Mozilla support page: [http://support.mozilla.com/en-US/kb/]
 +
 
 +
* Bug info Firefox: [https://fedoraproject.org/wiki/Bug_info_Firefox]
 +
 
 +
* StackTraces - Firefox: [https://fedoraproject.org/wiki/StackTraces#Firefox]

Latest revision as of 23:01, 18 January 2011

Contents

[edit] Bug reporting overview

Details for each of these items are covered below with references at the bottom.

  1. Clear out cache, cookies and session history.
  2. Remove all plugin-ins, extensions, non-default themes.
  3. Restart the application and see if you are still able to reproduce the issue.
  4. Startup in Safe-Mode and reproduce.
  5. Create a new profile. (See profile manager section below)
  6. Download a copy of Mozilla and see if the issue persists. [1]

These steps can help isolate where the issues may reside.

[edit] Standard troubleshooting steps

[edit] Restart Firefox

Close Firefox completely: From the menu at the top of the Firefox windowbar, select File and then select the Quit menu item. Then restart your computer and start Firefox again.

[edit] Clear cookies and cache

Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:

  1. Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
  2. In the Time range to clear drop-down menu, select Everything
  3. Click the arrow next to Details to display the list of items to clear, then select the following items:
    • Cache
    • Cookies
  4. Click Clear Now.
  5. Exit your browser
  6. Clear Flash cookies
    • find ~/.macromedia/ -type f -name \*.sol -exec rm '{}' \;

For more information, see Clear Recent History. [2]

[edit] Test in Safe Mode

firefox -safe-mode

[edit] Reset preferences

( Safe mode option ) [3]

[edit] Troubleshoot extensions and themes

Sometimes add-ons for Firefox (extensions or themes) can cause problems. To confirm whether your problem is caused by an add-on, launch Firefox's Safe Mode:

  1. Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
  2. Go to your Terminal and run: firefox -safe-mode
  3. In the Firefox Safe Mode dialog, click Continue in Safe Mode.
  4. Test for your problem.

If the problem does not occur in Safe Mode, an extension or theme is likely the cause. For more information about troubleshooting extensions and themes, and how to narrow down which add-on is causing problems, see Troubleshooting extensions and themes. [4]

[edit] Troubleshoot Add-ons / plugins

Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, RealPlayer/HelixPlayer, Rhythmbox, Totem and VLC) can cause problems.

  1. Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
  2. Click on the Plugins icon at the top of the Add-ons window.
  3. Click each plugin in the list and then click Disable.
  4. Test for your problem.

For more information about various plugins, and what to do if you find the plugin that causes problems, see the Troubleshooting plugins article.


[edit] Further troubleshooting steps

If the steps above don't fix your problem, continue by following these instructions.

Make a new profile

A corrupt profile can cause various problems with Firefox. You can try to make a new profile test whether that solves the problem, and if so, copy your data (bookmarks, saved passwords, etc.) to the new profile.

Important: Before you can start the Profile Manager, Firefox must be completely closed.

  1. Exit Firefox. To close Firefox, at the top of the Firefox window, select the File menu, and then select Quit.
  2. In Terminal run: firefox -ProfileManager
    • If the Profile Manager window does not open, Firefox may have been running in the background, even though it was not visible. Close all instances of Firefox or restart the computer and then try again.
    • If you are connected to another host, and the above is not working properly, run: firefox -ProfileManager -no-remote
  3. To start the Create Profile Wizard, click Create Profile... in the Profile Manager.
  4. Click Next and enter the name of the profile. Use a profile name that is descriptive, such as your personal name. This name is not exposed on the Internet.
  5. You can also choose where to store the profile, which is useful if you plan on exporting your data and settings to another computer or setup in the future. To choose its storage location on your system, click Choose Folder....
  6. To create the new profile, click Finish.
  7. Click on the newly created profile in the Profile Manager and click Start Firefox.

Test to see if your problem occurs with the new profile. If it doesn't, you can copy your data to the new profile - see Recovering important data from an old profile for instructions. For troubleshooting purposes, only copy the files that correspond to your bookmarks and saved passwords.

[edit] Collect information for a bug report

In the URL bar, visit this link:

about:support

Copy this information to your bug report. [5]


[edit] Additional Reading

  • Additional accessibility prefs can be found here: [6]
  • Additional hidden prefs can be found here: [7]
  • Mozilla's own basic trouble-shooting page: [8]
  • Mozilla support page: [9]
  • Bug info Firefox: [10]
  • StackTraces - Firefox: [11]