383

Appendix A. Appendix

Appendix

384

1. Reporting Bugs in Ubuntu Server Edition

While the Ubuntu Project attempts to release software with as few bugs as possible, they do occur.You can help fix these bugs by reporting ones that you find to the project. The Ubuntu Project usesLaunchpad1 to track its bug reports. In order to file a bug about Ubuntu Server on Launchpad, youwill need to create an account2.

1.1. Reporting Bugs With ubuntu-bug

The preferred way to report a bug is with the ubuntu-bug command. The ubuntu-bug tool gathersinformation about the system useful to developers in diagnosing the reported problem that will thenbe included in the bug report filed on Launchpad. Bug reports in Ubuntu need to be filed against aspecific software package, thus the name of the package that the bug occurs in needs to be given toubuntu-bug:

ubuntu-bug PACKAGENAME

For example, to file a bug against the openssh-server package, you would do:

ubuntu-bug openssh-server

You can specify either a binary package or the source package for ubuntu-bug. Again using openssh-server as an example, you could also generate the report against the source package for openssh-server, openssh:

ubuntu-bug openssh

See Chapter 3, Package Management [p. 20] for more information about packages inUbuntu.

The ubuntu-bug command will gather information about the system in question, possibly includinginformation specific to the specified package, and then ask you what you would like to do withcollected information:

ubuntu-bug postgresql

*** Collecting problem information

The collected information can be sent to the developers to improve the

application. This might take a few minutes.

..........

1 https://launchpad.net/2 https://help.launchpad.net/YourAccount/NewAccount

Appendix

385

*** Send problem report to the developers?

After the problem report has been sent, please fill out the form in the

automatically opened web browser.

What would you like to do? Your options are:

S: Send report (1.7 KiB)

V: View report

K: Keep report file for sending later or copying to somewhere else

C: Cancel

Please choose (S/V/K/C):

The options available are:

• Send Report Selecting Send Report submits the collected information to Launchpad as part of theprocess of filing a bug report. You will be given the opportunity to describe the situation that led upto the occurrence of the bug.

*** Uploading problem information

The collected information is being sent to the bug tracking system.

This might take a few minutes.

91%

*** To continue, you must visit the following URL:

https://bugs.launchpad.net/ubuntu/+source/postgresql-8.4/+filebug/kc6eSnTLnLxF8u0t3e56EukFeqJ?

You can launch a browser now, or copy this URL into a browser on another

computer.

Choices:

1: Launch a browser now

C: Cancel

Please choose (1/C):

If you choose to start a browser, by default the text based web browser w3m will be used to finishfiling the bug report. Alternately, you can copy the given URL to a currently running web browser.

• View Report Selecting View Report causes the collected information to be displayed to theterminal for review.

Package: postgresql 8.4.2-2

PackageArchitecture: all

Tags: lucid

ProblemType: Bug

ProcEnviron:

LANG=en_US.UTF-8

SHELL=/bin/bash

Uname: Linux 2.6.32-16-server x86_64

Dependencies:

Appendix

386

adduser 3.112ubuntu1

base-files 5.0.0ubuntu10

base-passwd 3.5.22

coreutils 7.4-2ubuntu2

...

After viewing the report, you will be brought back to the same menu asking what you would like todo with the report.

• Keep Report File Selecting Keep Report File causes the gathered information to be written to afile. This file can then be used to later file a bug report or transferred to a different Ubuntu systemfor reporting. To submit the report file, simply give it as an argument to the ubuntu-bug command:

What would you like to do? Your options are:

S: Send report (1.7 KiB)

V: View report

K: Keep report file for sending later or copying to somewhere else

C: Cancel

Please choose (S/V/K/C): k

Problem report file: /tmp/apport.postgresql.v4MQas.apport

ubuntu-bug /tmp/apport.postgresql.v4MQas.apport

*** Send problem report to the developers?

...

• Cancel Selecting Cancel causes the collected information to be discarded.

1.2. Reporting Application Crashes

The software package that provides the ubuntu-bug utility, apport, can be configured to triggerwhen applications crash. This is disabled by default, as capturing a crash can be resource intensivedepending on how much memory the application that crashed was using as apport captures andprocesses the core dump.

Configuring apport to capture information about crashing applications requires a couple of steps.First, gdb needs to be installed; it is not installed by default in Ubuntu Server Edition.

sudo apt-get install gdb

See Chapter 3, Package Management [p. 20] for more information about managing packages inUbuntu.

Once you have ensured that gdb is installed, open the file /etc/default/apport in your text editor,and change the enabled setting to be 1 like so:

# set this to 0 to disable apport, or to 1 to enable it

# you can temporarily override this with

# sudo service apport start force_start=1

Appendix

387

enabled=1

# set maximum core dump file size (default: 209715200 bytes == 200 MB)

maxsize=209715200

Once you have completed editing /etc/default/apport, start the apport service:

sudo start apport

After an application crashes, use the apport-cli command to search for the existing saved crash reportinformation:

apport-cli

*** dash closed unexpectedly on 2010-03-11 at 21:40:59.

If you were not doing anything confidential (entering passwords or other

private information), you can help to improve the application by

reporting

the problem.

What would you like to do? Your options are:

R: Report Problem...

I: Cancel and ignore future crashes of this program version

C: Cancel

Please choose (R/I/C):

Selecting Report Problem will walk you through similar steps as when using ubuntu-bug. Oneimportant difference is that a crash report will be marked as private when filed on Launchpad,meaning that it will be visible to only a limited set of bug triagers. These triagers will review thegathered data for private information before making the bug report publicly visible.

1.3. Resources• See the Reporting Bugs3 Ubuntu wiki page.

• Also, the Apport4 page has some useful information. Though some of it pertains to using a GUI.

3 https://help.ubuntu.com/community/ReportingBugs4 https://wiki.ubuntu.com/Apport