Changes

Jump to navigation Jump to search
2,056 bytes added ,  04:29, 11 December 2008
Instructions on bug reporting and debug logs
Line 10: Line 10:     
Intrepid, the current Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
 
Intrepid, the current Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
 +
 +
=== Installing ===
    
Installation instructions:
 
Installation instructions:
 
  sudo apt-get install sugar sugar-activities
 
  sudo apt-get install sugar sugar-activities
   −
Run sugar in a window under a gnome login, with:
+
=== 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
 
  sugar-emulator
  −
If you need log files for debugging, use the following command:
  −
SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator
      
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.
 
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.
 
+
<!--
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.
  −
 
   
The following does not currently work, but should in the future:
 
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
 
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
Line 32: Line 29:  
  apt-get update  
 
  apt-get update  
 
  apt-get install sugar sugar-emulator sugar-activities
 
  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.
    
== Sugar on Ubuntu 8.04 LTS (hardy) ==
 
== Sugar on Ubuntu 8.04 LTS (hardy) ==
 +
 +
hardy includes an old version of Sugar, 0.79. You can install the current stable release of Sugar, 0.82, with the instructions below.
 +
 +
For bug reporting, please follow the instructions above as for intrepid.
    
=== Sugar 0.79.0 ===
 
=== Sugar 0.79.0 ===
Line 59: Line 87:  
  apt-get install sugar sugar-emulator sugar-activities
 
  apt-get install sugar sugar-emulator sugar-activities
   −
= ejabberd on Ubuntu =
+
= ejabberd collaboration server on Ubuntu =
    
We use ejabberd for a collaboration server. Ubuntu 8.10 ships with the required patches included in ejabberd, so you can install ejabberd, configure it and have working collaboration within minutes, using these installation instructions: http://wiki.laptop.org/go/Installing_ejabberd/deb
 
We use ejabberd for a collaboration server. Ubuntu 8.10 ships with the required patches included in ejabberd, so you can install ejabberd, configure it and have working collaboration within minutes, using these installation instructions: http://wiki.laptop.org/go/Installing_ejabberd/deb
135

edits

Navigation menu