Changes

1,307 bytes removed ,  04:45, 5 January 2010
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.
2,751

edits