Ubuntu Wiki

This page provides instructions on how to retrieve debug logs from an Ubuntu device for debugging purposes

Before you start

Prerequisites

1. A device running the Ubuntu development release (Utopic Unicorn)
2. A host computer with ADB (Android Debug Bridge) installed. It's recommended to use Ubuntu 13.04 or later, but it can also be executed from other platforms (e.g. Windows or OS X)

Install ADB on Ubuntu

1. On the Ubuntu host computer, open a terminal with Ctrl+Alt+T
2. Type the following command, followed by Enter

    sudo apt-get install android-tools-adb

Extracting debug information

Update apps and the OS

Ubuntu uses the same interface via the System Setting app to handle 2 types of updates independently:

• OS updates
• App updates

The visual workflow below shows how to update either of them.

Run the application

1. On the device, go to the Apps Scope
2. Type the name of the app in the search bar
3. Tap on the result icon to start the app

Retrieve logs from the device

1. Connect the mobile device running Ubuntu to the host computer also running Ubuntu via USB
2. On the Ubuntu host computer, open a terminal with Ctrl+Alt+T
3. Type the following commands, each followed by Enter

    mkdir logs
    cd logs
    adb pull /home/phablet/.cache/upstart/
    adb pull /var/crash
    cd ..
    tar -zcf logs.tar.gz logs

The final step will result in a file called logs.tar.gz. Please send that file to those debugging those logs.

Known issues

Account settings won't start

Due to a change in the Online Accounts API it might be possible that some leftover files are in the device, preventing the Online Accounts settings page to load (see bug 1328614).

To remove the leftover files:

1. On the Ubuntu host computer, open a terminal with Ctrl+Alt+T
2. Type the following command, followed by Enter:

    ls .local/share/accounts/applications

1. Remove the duplicate entries that have a version number in their name.

E.g. If the two following files are shown, please delete the one with the 0.4.161 version appended to its name

    com.ubuntu.reminders_reminders.application
    com.ubuntu.reminders_reminders_0.4.161.application

    rm .local/share/accounts/applications/com.ubuntu.reminders_reminders_0.4.161.application