Ubuntu: Difference between revisions

Line 10:

Intrepid, the current Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].

=== Installing ===

Installation instructions:

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

~~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 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:

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 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) ==

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 ===

Line 59:

Line 87:

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

@@ Line 10: / Line 10: @@
 Intrepid, the current Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
+=== Installing ===
 Installation instructions:
   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
-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 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:
 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 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) ==
+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 ===
@@ Line 59: / Line 87: @@
   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