Difference between revisions of "Ubuntu"

From Sugar Labs
Jump to navigation Jump to search
(Instructions on bug reporting and debug logs)
(464 intermediate revisions by 18 users not shown)
Line 1: Line 1:
= Sugar on Ubuntu =
+
<noinclude>[[Category:Supported systems]]</noinclude>
 +
[[File:Ubuntu-small.jpg]]
  
[[Image:Ubuntu.jpg|right]]The Sugar packages for Ubuntu provide a Sugar environment that is easy to install and can be configured as an X session in gdm or run in a window with sugar-emulator.
+
:''Ubuntu is a [[Debian]]-based Linux operating system, with Unity as its default desktop environment.'' -- [http://en.wikipedia.org/wiki/Ubuntu_%28operating_system%29 wikipedia.org]
  
It is a much simpler platform to set up for activity developers than jhbuild, although is not bleeding-edge.
+
In relation to Sugar, Ubuntu is a downstream distribution project that can be used to run Sugar.
  
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.
+
==Ubuntu 18.04 Bionic==
__TOC__
 
== Sugar on Ubuntu 8.10 (intrepid) ==
 
  
Intrepid, the current Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
+
Sugar 0.112 will be in Ubuntu 18.04 Bionic.
  
=== Installing ===
+
==Ubuntu 17.10 Artful==
  
Installation instructions:
+
Sugar 0.110 is in the archive for Ubuntu 17.10 Artful, and can be installed by typing
sudo apt-get install sugar sugar-activities
 
  
=== Running Sugar ===
+
sudo apt install sucrose gir1.2-webkit-3.0
  
Run sugar in a window under a gnome login, using the Applications menu > Other > Sugar Emulator, or running the following in a terminal:
+
* log out,
sugar-emulator
+
* log in with the Sugar desktop selected.
  
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.
+
Installing the package gir1.2-webkit-3.0 is a workaround for [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=877812 Debian bug #877812].
<!--
 
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 ===
+
==Using Sugar inside another desktop environment on Ubuntu==
  
If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:
+
Sugar is a desktop environment. For developers who use Ubuntu Unity, Gnome or another desktop environment, Sugar can be run inside that environment as a window.
sudo apt-get purge sugar sugar-\*
 
and repeat the installation command outlined above to install only the new packages.
 
  
=== Reporting Bugs ===
+
Install the Remote Desktop packages:
 +
sudo apt install xrdp rdesktop
  
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:
+
Create a user for Sugar and set a default desktop environment:
  SUGAR_LOGGER_LEVEL=debug PRESENCESERVICE_DEBUG=1 sugar-emulator
+
sudo adduser sugar
 +
  sudo su - sugar -c 'echo sugar >> .xsession'
  
This generates log files in the .sugar/default/logs directory under your home directory.
+
Start a session:
 +
rdesktop -g 1200x900 -u sugar -p sugar 0
  
To report a bug on Sugar or one of the Sugar activities on Ubuntu, use the following steps:
+
==Ubuntu 17.04 Zesty==
* 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.
+
Sugar 0.110 is in the archive for Ubuntu 17.04 Zesty, and can be installed by typing
  
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.
+
sudo apt install sucrose
  
'''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.
+
* log out,
 +
* log in with the Sugar desktop selected.
 +
<!-- last tested with Ubuntu 17.04 Zesty daily live image dated 2017-03-21 plus updates on 30th March 2017 -->
  
== Sugar on Ubuntu 8.04 LTS (hardy) ==
+
==Ubuntu 16.04 Xenial LTS==
  
hardy includes an old version of Sugar, 0.79. You can install the current stable release of Sugar, 0.82, with the instructions below.
+
Sugar 0.106 is in the archive for Ubuntu 16.04 Xenial, and can be installed by typing
  
For bug reporting, please follow the instructions above as for intrepid.
+
sudo apt install sucrose
 +
<!-- last tested with Ubuntu 16.04.1 Xenial) -->
  
=== Sugar 0.79.0 ===
+
Sugar 0.112 can be installed by careful addition of the Ubuntu 18.04 Bionic packages; temporarily change sources.list, update, and install the Sugar packages again, then restore sources.list.
  
'''Old, but included in Hardy'''
+
Organisations that require Ubuntu 16.04 support for Sugar may consider getting involved in the Ubuntu [https://wiki.ubuntu.com/StableReleaseUpdates Stable Release Updates] process.
  
Sugar was packaged in Universe for Hardy (Ubuntu 8.04) by Jani Monoses. The version packaged is 0.79.0, similar to the version in OLPC Release 8.1.0.
+
==OLPC Ubuntu Sugar 16.04 Xenial LTS ==
  
[http://janimo.blogspot.com/2008/02/sugar-finally-in-hardy-universe.html Installation instructions]
+
One Laptop per Child has been curating Sugar 0.112 and Activities on the Ubuntu 16.04 Xenial operating system.  This build has entered production, and can be acquired through private negotiation or by ordering laptops from OLPC.
  
There are extra packages in a [https://launchpad.net/~sugar/+archive/ PPA], including activities that could not be included in the Ubuntu archive due to license issues, as well as updated abiword packages.
+
==See also==
 +
* [https://wiki.debian.org/Derivatives/Census/OLPC Debian Derivatives Census - OLPC]
  
We do recommend using the version 0.82 packages instead, as mentioned below:
+
==Previous releases==
 +
See [[Ubuntu/Previous]] for how to install older versions of Sugar on older releases of Ubuntu.
  
=== Sucrose 0.82 ===
+
==Subpages==
 
+
{{Special:PrefixIndex/{{PAGENAME}}/}}
'''Up-to-date version, extra repository'''
 
 
 
The Ubuntu packages were updated to the latest [[DevelopmentTeam/Release/Releases/Sucrose/0.82|0.82]] point release in the [https://launchpad.net/~sugarteam/+archive Sugar Team PPA].
 
 
 
Installation instructions:
 
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
 
 
 
= 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
 
 
 
For Ubuntu 8.04 you need to build from source: http://wiki.laptop.org/go/Installing_ejabberd
 
 
 
[[Category:Supported systems]]
 

Revision as of 20:34, 17 January 2018

Ubuntu-small.jpg

Ubuntu is a Debian-based Linux operating system, with Unity as its default desktop environment. -- wikipedia.org

In relation to Sugar, Ubuntu is a downstream distribution project that can be used to run Sugar.

Ubuntu 18.04 Bionic

Sugar 0.112 will be in Ubuntu 18.04 Bionic.

Ubuntu 17.10 Artful

Sugar 0.110 is in the archive for Ubuntu 17.10 Artful, and can be installed by typing

sudo apt install sucrose gir1.2-webkit-3.0
  • log out,
  • log in with the Sugar desktop selected.

Installing the package gir1.2-webkit-3.0 is a workaround for Debian bug #877812.

Using Sugar inside another desktop environment on Ubuntu

Sugar is a desktop environment. For developers who use Ubuntu Unity, Gnome or another desktop environment, Sugar can be run inside that environment as a window.

Install the Remote Desktop packages:

sudo apt install xrdp rdesktop

Create a user for Sugar and set a default desktop environment:

sudo adduser sugar
sudo su - sugar -c 'echo sugar >> .xsession'

Start a session:

rdesktop -g 1200x900 -u sugar -p sugar 0

Ubuntu 17.04 Zesty

Sugar 0.110 is in the archive for Ubuntu 17.04 Zesty, and can be installed by typing

sudo apt install sucrose
  • log out,
  • log in with the Sugar desktop selected.

Ubuntu 16.04 Xenial LTS

Sugar 0.106 is in the archive for Ubuntu 16.04 Xenial, and can be installed by typing

sudo apt install sucrose

Sugar 0.112 can be installed by careful addition of the Ubuntu 18.04 Bionic packages; temporarily change sources.list, update, and install the Sugar packages again, then restore sources.list.

Organisations that require Ubuntu 16.04 support for Sugar may consider getting involved in the Ubuntu Stable Release Updates process.

OLPC Ubuntu Sugar 16.04 Xenial LTS

One Laptop per Child has been curating Sugar 0.112 and Activities on the Ubuntu 16.04 Xenial operating system. This build has entered production, and can be acquired through private negotiation or by ordering laptops from OLPC.

See also

Previous releases

See Ubuntu/Previous for how to install older versions of Sugar on older releases of Ubuntu.

Subpages