Difference between revisions of "Ubuntu"

From Sugar Labs
Jump to navigation Jump to search
(445 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{TOCright}}
+
<noinclude>[[Category:Supported systems]]</noinclude>
[[Image:Ubuntu.jpg]]
+
[[File:Ubuntu-small.jpg]]
  
= Sugar on Ubuntu =
+
:''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]
  
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.
+
In relation to Sugar, Ubuntu is a downstream distribution project that can be used to run Sugar.
  
It is a much simpler platform to set up for activity developers than jhbuild, although is not bleeding-edge.
+
==Ubuntu 17.04 Zesty==
  
:{I might get flamed for this; I know I shouldn't post on a wiki like this, but no one will read the discussion: can we list a simple way of installing from jhbuild on Ubuntu 9.04 or installing from a PPA?  Is 0.83 in the Ubuntu sugar PPA recent enough?  How about installing from source (not git/jhbuild) and then adding an X session?  With Ubuntu being the most popular Linux distribution, it is in the interest of this project to flesh out these details.}
+
Sugar 0.110 is in the archive for Ubuntu 17.04 Zesty, and can be installed by typing
  
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.
+
sudo apt install sucrose
  
 +
* 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 9.04 (jaunty) ==
+
== Using Sugar inside another desktop environment ==
  
Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from [[Community/Distributions/Debian|Debian]].
+
Sugar is a desktop environment.  For developers who use Ubuntu Unity or another desktop environment, Sugar can be run inside that environment as a window.
  
=== Installing ===
+
Install the Remote Desktop packages:
 +
sudo apt install xrdp rdesktop
  
Installation instructions:
+
Create a user for Sugar:
  sudo apt-get install sugar sugar-activities
+
  adduser sugar
 +
echo sugar >> /home/sugar/.xsession
  
 +
Start a session:
 +
rdesktop -g 1200x900 -u sugar -p sugar 0
  
 +
==Ubuntu 16.04 Xenial LTS==
  
[satellit] 04/30/2009
+
Sugar 0.106 is in the archive for Ubuntu 16.04 Xenial, and can be installed by typing
*NOTE 1: Also tried synaptic install of sugar, neither method runs correctly. sugar-emulator will not start, terminal: sugar-emulator shows errors and will not start.??
 
(VMworkstation 6.5.2 install (runnng Ubuntu 8,04 Hardy) and Ubuntu 9.04 VM install of Ubuntu 9.04 made 2Gb SD startup disk with persistence tested in EeePC900
 
both installations were updated before trying install of sugar.
 
  
Here are error messages from terminal:
+
sudo apt install sucrose
 +
<!-- last tested with Ubuntu 16.04.1 Xenial) -->
  
robert@ubuntu:~$ sugar
+
Sugar 0.110 can be installed by careful addition of the Ubuntu 17.04 Zesty packages.
root window unavailible (maybe another wm is running?)
 
/usr/lib/python2.6/dist-packages/jarabe/desktop/meshbox.py:19: DeprecationWarning: the sha module is deprecated; use the hashlib module instead
 
  import sha
 
/usr/lib/python2.6/dist-packages/jarabe/desktop/keydialog.py:17: DeprecationWarning: the md5 module is deprecated; use hashlib instead import md5
 
Traceback (most recent call last):
 
  File "/usr/bin/sugar-session", line 173, in <module>
 
    main()
 
  File "/usr/bin/sugar-session", line 134, in main
 
    cleanup_logs()
 
  File "/usr/bin/sugar-session", line 74, in cleanup_logs
 
    os.remove(os.path.join(root, f))
 
OSError: [Errno 13] Permission denied: '/home/robert/.sugar/default/logs/1241095852/datastore.log'
 
robert@ubuntu:~$
 
  
sugar command Does not work from sudo either..
+
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.
  
 +
==OLPC Ubuntu Sugar 16.04 Xenial LTS ==
  
*Note 2: Ubuntu 9.04 USB Startup disk program makes SD which can be updated. If you add user and switch to new user,  
+
One Laptop per Child has been curating Sugar 0.110 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.
the Install icon goes away from the desktop and is now located in System Administration unlike Fedora 11 Preview where it is not removed from a user's desktop, And a system update fails.
 
  
 +
==OLPC Ubuntu Sugar 14.04 Trusty LTS ==
  
*Note 3: sugar-emulator in terminal results in a black screen with mouse coursor. Have to Alt-Tab get out..
+
One Laptop per Child was curating Sugar and Activities on the Ubuntu 14.04 Trusty operating system, but support for this version has since ended.
  
== Sugar on Ubuntu 8.10 (intrepid) ==
+
===Installing a system===
  
Intrepid, the previous Ubuntu release, has Sucrose 0.82 packages synced from [[Community/Distributions/Debian|Debian]].
+
How to install Ubuntu with Sugar 0.106:
 +
* you must already be familiar with how to install Ubuntu, if not, see [http://www.ubuntu.com/download/desktop Download Ubuntu Desktop], and [http://www.ubuntu.com/download/desktop/install-ubuntu-desktop Install Ubuntu Desktop],
 +
* download [http://people.sugarlabs.org/quozl/ubuntu/trusty/sugar-0.106/olpc-ubuntu-sugar-14.04.2-desktop-amd64-1436317817.iso our installer image] (1.2 GB) [http://people.sugarlabs.org/quozl/ubuntu/trusty/sugar-0.106/olpc-ubuntu-sugar-14.04.2-desktop-amd64-1436317817.iso.md5 md5]<!-- b5584db2d995041c5c732d22320645f8 -->, [http://people.sugarlabs.org/quozl/ubuntu/trusty/sugar-0.106/olpc-ubuntu-sugar-14.04.2-desktop-amd64-1436317817.iso.packages.txt package list]  
 +
* boot our image and install in the [http://www.ubuntu.com/download/desktop/install-ubuntu-desktop usual way],
 +
* log out of the Unity desktop, and then log in with the Sugar desktop selected.
  
=== Installing ===
+
===Adding to a system===
  
Installation instructions:
+
Note: only available for 64-bit systems, check that ''uname -i'' shows x86_64.
sudo apt-get install sugar sugar-activities
 
  
=== Running Sugar ===
+
How to add Sugar 0.107 to an Ubuntu 14.04 Trusty system:
 +
* edit <tt>/etc/apt/sources.list</tt> to add the OLPC archive,
 +
deb [trusted=yes arch=amd64] <nowiki>http://dev.laptop.org/pub/us</nowiki> trusty main
 +
* update the package lists, and install Sugar,
 +
sudo apt update && sudo apt install olpc-ubuntu-sugar
 +
* log out of the Unity desktop, and then log in with the Sugar desktop selected.
  
Run sugar in a window under a gnome login, using the Applications menu > Other > Sugar Emulator, or running the following in a terminal:
+
===Upgrading a system===
sugar-emulator
 
  
If everything is working fine, you can log into Sugar from the gdm login screen instead of running sugar-emulator.
+
How to upgrade to Sugar 0.107 on an existing Ubuntu 14.04 Trusty system with an earlier version of Sugar already installed:
<!--
+
* update the package lists, and apply all pending updates,
The following does not currently work, but should in the future:
+
  sudo apt update && sudo apt dist-upgrade
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
+
* log out, and then log in with the Sugar desktop selected.
  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 ===
+
==See also==
 +
* [https://wiki.debian.org/Derivatives/Census/OLPC Debian Derivatives Census - OLPC]
  
If you are experiencing problems after upgrading from 8.04 (Hardy), please do the following to uninstall the partially-upgraded packages:
+
==Previous releases==
sudo apt-get purge sugar sugar-\*
+
See [[Ubuntu/Previous]] for how to install older versions of Sugar on older releases of Ubuntu.
and repeat the installation command outlined above to install only the new packages.
 
  
=== Reporting Bugs ===
+
==Subpages==
 
+
{{Special:PrefixIndex/{{PAGENAME}}/}}
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 ===
 
 
 
'''Old, but included in Hardy'''
 
 
 
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.
 
 
 
[http://janimo.blogspot.com/2008/02/sugar-finally-in-hardy-universe.html Installation instructions]
 
 
 
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.
 
 
 
We do recommend using the version 0.82 packages instead, as mentioned below:
 
 
 
=== Sucrose 0.82 ===
 
 
 
'''Up-to-date version, extra repository'''
 
 
 
The Ubuntu packages were updated to the latest [[Development Team/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
 
 
 
Not working, tried it from Hardy Install 05/06/2009 [satellit]
 
 
 
= 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 02:51, 8 May 2017

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

Using Sugar inside another desktop environment

Sugar is a desktop environment. For developers who use Ubuntu Unity 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:

adduser sugar
echo sugar >> /home/sugar/.xsession

Start a session:

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

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.110 can be installed by careful addition of the Ubuntu 17.04 Zesty packages.

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.110 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.

OLPC Ubuntu Sugar 14.04 Trusty LTS

One Laptop per Child was curating Sugar and Activities on the Ubuntu 14.04 Trusty operating system, but support for this version has since ended.

Installing a system

How to install Ubuntu with Sugar 0.106:

Adding to a system

Note: only available for 64-bit systems, check that uname -i shows x86_64.

How to add Sugar 0.107 to an Ubuntu 14.04 Trusty system:

  • edit /etc/apt/sources.list to add the OLPC archive,
deb [trusted=yes arch=amd64] http://dev.laptop.org/pub/us trusty main
  • update the package lists, and install Sugar,
sudo apt update && sudo apt install olpc-ubuntu-sugar
  • log out of the Unity desktop, and then log in with the Sugar desktop selected.

Upgrading a system

How to upgrade to Sugar 0.107 on an existing Ubuntu 14.04 Trusty system with an earlier version of Sugar already installed:

  • update the package lists, and apply all pending updates,
sudo apt update && sudo apt dist-upgrade
  • log out, and then log in with the Sugar desktop selected.

See also

Previous releases

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

Subpages