Ubuntu Wiki

Where to start when things don't work?

The suggestions here are from a newcomers perspective. This is not an advanced user's troubleshooting guide. It aims to offer a simple means of troubleshooting that can provide useful information when seeking help through the Ubuntu Forums or by using Google to search error messages.

Finding your way in Linux can be a frustrating thing when applications and hardware don't seem to work as they should. Linux has many ways to troubleshoot problems, but they may be different from what you are used to with other operating systems.

This page tries to help you pinpoint the cause of trouble, and point you to places where you might get help solving the problem. Troubleshooting information on this page is of a general nature. That means it shows general techniques that can be used in "almost" all situations, and it suggests some techniques for finding the causes of some problems.

Run in a Terminal

While Windows programs generally display a dialog box in case of an error, the Linux standard way to display error messages is through the stderror device. Running an application from the Gnome menu, you won't see much if an error occurs, but running the same application from a terminal window, you will see the error messages (if there are any) in the terminal window. Try to see if you can find errors telling you that some component is missing or malfunctioning.

Application Commands

You can find Terminal under Applications > Accessories > Terminal. More information on the Terminal can be found in TerminalHowto and TerminalAdvanced.

Most applications can be run straight from the Terminal by typing their command name. Most of the time, this is not the application name you will see in the Gnome menu. There are several ways to find the command name that is associated to an application in the menu.

The Main Menu contains a list of available (installed) applications. The Main Menu is configurable to display more or fewer applications. Navigate to System > Preferences > Main Menu, and select an application from the menu on the left, for example, "Office."

Then a list of applications will open on the right side of the window. The checked items are ones that display as options when you open the Applications menu from the panel icon. Checking more items will make more items available from the Applications menu on the panel. Select one with a right mouse click, and choose the properties dialog.

From the properties dialog window, the command can be seen in the "command field" of the dialog window. This is the command the can be entered into the Terminal window. In the example here, "ooffice -impress" is the command. If you were to use the %U flag, you would be warned if you did not have any presentation documents in you home directory.

Finally, in this case, the application is launched with no error reported.

The terminal will continue to keep track of the program as long as it is running. This can be useful for determining where and why a program fails.

• Synaptic Package Manager System > Administration > Synaptic Package Manager. Use the search function to locate the application's package name. Installed packages show a green square. Highlight the package containing the application. Right-click, and choose Properties. Then go to the Installed Files tab. Entries that start with "/usr/bin/" are commonly commands that can be executed from the Terminal. If the package name is added to /usr/bin/example the program will likely launch.

• Execute ls /usr/bin/ from Terminal. This will show you most application command names on your system.

Run as another user

Some problems are connected to the user-settings. Try to run a program as another user. Go to System > Administration > Users and Groups, and create a new user. If your problem involves running admin tasks, be sure to go to the User Privileges tab and check "Executing system administration tasks". Now, log off and log in as your newly created user, and check if your problem still persists.

Getting help

Equipped with the information you gathered in the pinpointing chapter, you can now help others help you. Enter the forums to ask about your problems, giving the collected information. Or use a web search engine to search for the error messages you've gotten. Lots of links can be found under HowToGetHelp.

Use the Ubuntu Forums: [http://ubuntuforums.org/index.php "UbuntuForums"] The Absolute Beginners Talk and General Help forums are one of the communities best resources.