Ubuntu: Difference between revisions

Dfarning (talk | contribs)
m move section on reporting bugs
Line 13: Line 13:


Lucid has Sugar 0.88, 0.86, and 0.84 packages synced from [[Community/Distributions/Debian|Debian]].
Lucid has Sugar 0.88, 0.86, and 0.84 packages synced from [[Community/Distributions/Debian|Debian]].


The current preferred method of running Sugar on the ubuntu is via Ubuntu Sugar Remix which can be downloaded at http://people.sugarlabs.org/dfarning
The current preferred method of running Sugar on the ubuntu is via Ubuntu Sugar Remix which can be downloaded at http://people.sugarlabs.org/dfarning


Packages can also be install via sudo
Packages can also be install via sudo
  sudo apt-get install sugar sugar-activities
  sudo apt-get install sugar-0.88
 
=== Reporting Bugs ===
 
If you need log files for debugging, use the following command in a GNOME terminal ''(not Sugar Terminal)'' to run sugar with debug logs turned on:
SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator
 
This generates log files in the .sugar/default/logs directory under your home directory.
 
To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:
* Go to https://launchpad.net/sucrose which represents all the Sugar components and activities supported in Ubuntu.
* Click on the appropriate component at the bottom of the page. If in doubt, click "Sugar shell" which is the base Sugar component.
* On the resulting page, scroll down to "Packages" and click on the hardy or intrepid package.
* On the resulting page, click on the "Bugs" tab at the top of the page.
* That takes you to a page listing known bugs on the package, and with a red "Report a bug" button.
 
Please include any relevant log files in a bug report: activity log files usually are named similarly to "org.laptop.Chat-1.log" (which is the log file for Chat). If you have run the activity multiple times in the current Sugar session, there will be Chat-2, Chat-3, etc so try to include the appropriate one.
 
If a problem or bug involves seeing (or not seeing) people in Neighborhood View, or activity sharing/collaboration, please also include presenceservice.log in the bug report.
 
'''Please note''': The Ubuntu Sugar team will do their best to provide fixes for bugs, but it does take time to get an updated package uploaded through Ubuntu's [https://wiki.ubuntu.com/StableReleaseUpdates Stable Release Updates] process. Where possible we'll suggest a workaround, or provide a fix in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] first.


== Sugar on Ubuntu 9.10 (karmic) ==
== Sugar on Ubuntu 9.10 (karmic) ==
Line 101: Line 120:
Installation instructions:
Installation instructions:
  sudo apt-get install sugar sugar-activities
  sudo apt-get install sugar sugar-activities
== Sugar on Ubuntu 8.10 (intrepid) ==
Intrepid, the previous Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
=== Installing ===
Installation instructions:
sudo apt-get install sugar sugar-activities
=== Running Sugar ===
Run sugar in a window under a gnome login, using the Applications menu > Other > Sugar Emulator, or running the following in a terminal:
sugar-emulator
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.
<!--
The following does not currently work, but should in the future:
Some activities could not be included due to missing dependencies - notably Read and Write. These will be published in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] soon, which can be accessed via
sudo -s
echo deb http://ppa.launchpad.net/sugarteam/ubuntu hardy main > /etc/apt/sources.list.d/sugar.list
apt-get update
apt-get install sugar sugar-emulator sugar-activities
-->
=== Upgrading ===
If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:
sudo apt-get purge sugar sugar-\*
and repeat the installation command outlined above to install only the new packages.
=== Reporting Bugs ===
If you need log files for debugging, use the following command in a GNOME terminal ''(not Sugar Terminal)'' to run sugar with debug logs turned on:
SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator
This generates log files in the .sugar/default/logs directory under your home directory.
To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:
* Go to https://launchpad.net/sucrose which represents all the Sugar components and activities supported in Ubuntu.
* Click on the appropriate component at the bottom of the page. If in doubt, click "Sugar shell" which is the base Sugar component.
* On the resulting page, scroll down to "Packages" and click on the hardy or intrepid package.
* On the resulting page, click on the "Bugs" tab at the top of the page.
* That takes you to a page listing known bugs on the package, and with a red "Report a bug" button.
Please include any relevant log files in a bug report: activity log files usually are named similarly to "org.laptop.Chat-1.log" (which is the log file for Chat). If you have run the activity multiple times in the current Sugar session, there will be Chat-2, Chat-3, etc so try to include the appropriate one.
If a problem or bug involves seeing (or not seeing) people in Neighborhood View, or activity sharing/collaboration, please also include presenceservice.log in the bug report.
'''Please note''': The Ubuntu Sugar team will do their best to provide fixes for bugs, but it does take time to get an updated package uploaded through Ubuntu's [https://wiki.ubuntu.com/StableReleaseUpdates Stable Release Updates] process. Where possible we'll suggest a workaround, or provide a fix in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA] first.


= ejabberd collaboration server on Ubuntu =
= ejabberd collaboration server on Ubuntu =
Line 158: Line 127:
For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd
For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd


= Sugar Team ==
= Sugar Team =


Sugar on Ubuntu is packaged and maintained by the [https://wiki.ubuntu.com/SugarTeam Ubuntu Sugar team], who welcome new contributors to test, document, triage, and make packages.
Sugar on Ubuntu is packaged and maintained by the [https://wiki.ubuntu.com/SugarTeam Ubuntu Sugar team], who welcome new contributors to test, document, triage, and make packages.