Difference between revisions of "Ubuntu"

From Sugar Labs
Jump to navigation Jump to search
(436 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{TOCright}}
+
Moved to https://github.com/sugarlabs/sugar/blob/master/docs/ubuntu.md
[[Image:Ubuntu.jpg]]
 
 
 
= Sugar on Ubuntu =
 
 
 
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.
 
 
 
It is a much simpler platform to set up for activity developers than jhbuild, although is not bleeding-edge.
 
 
 
@the below:
 
I am building a package for 9.04 as we speak. should be done in a few days. (by the 20th of August)
 
-Colin Applegate
 
 
 
:{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 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.
 
 
 
[https://launchpad.net/sugar Sugar bug reporting Ubuntu].
 
 
 
 
 
== Sugar on Ubuntu 9.04 (jaunty) ==
 
 
 
Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from [[Community/Distributions/Debian|Debian]].
 
 
 
Sugar does not work out-of-the-box under Jaunty as of 2009-07-01, although there is a workaround. See the [[Talk:Community/Distributions/Ubuntu|discussion here]] for more information.
 
 
 
:That work around doesn't work.--[[User:Dennis Daniels|Dennis Daniels]] 00:38, 7 August 2009 (UTC)
 
 
 
0.84 Works for me from  https://launchpad.net/~alsroot/+archive/ppa package name is sugar-platform --[[User:Satyaakam]] 22:00,12 August 2009 (IST)
 
 
 
=== Installing ===
 
 
 
Installation instructions:
 
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.
 
 
 
== 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]
 
 
 
== Using sugar PPAs ==
 
 
 
Another way to start sugar on Ubuntu is using sugar-* PPA. The purposes to have these PPAs are that for now there is a lack of official sugar packages in ubuntu(hope it will be resolved soon by porting Debian packages) and give users a chance to test last development releases.
 
 
 
Its possible because these PPAs are based on packages generated by [[Deployment_Team/jhconvert|jhconvert]], its not a problem to support them. These packages are pretty simple and straightforward and were generated with one idea in mind - start sugar, so they don't follow any Debian/Ubuntu policies and aren't intended to be official packages.
 
 
 
'''NOTE''' If you have sugar packages installed by another method you need to remove them all(karmic 0.86 packages have Conflicts tags but it wasn't tested yet):
 
sudo apt-get remove -f $(dpkg-query -l | grep -e sugar -e olpc | awk '{print $2}')
 
 
 
Before attaching ppa, load gpg key
 
gpg --keyserver keyserver.ubuntu.com --recv F265806A9BFFF0F4
 
gpg --export --armor F265806A9BFFF0F4 | sudo apt-key add -
 
 
 
To use sugar-0.84 on 8.04(Hardy)
 
sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/trisquel-edu/ubuntu hardy main >> /etc/apt/sources.list'
 
sudo apt-get update
 
sudo apt-get install sugar-platform
 
 
 
To use sugar-0.84 on 9.04(jaunty)
 
sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu jaunty main >> /etc/apt/sources.list'
 
sudo apt-get update
 
sudo apt-get install sugar-platform
 
 
 
To use sugar-0.84 on 9.10(karmic)
 
sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/ppa/ubuntu karmic main >> /etc/apt/sources.list'
 
sudo apt-get update
 
sudo apt-get install sugar-platform
 
 
 
To use sugar-0.86 on 9.05(jaunty)
 
sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/trisquel-edu-3/ubuntu jaunty main >> /etc/apt/sources.list'
 
sudo apt-get update
 
sudo apt-get install sugar-platform
 
 
 
To use sugar-0.86 on 9.10(karmic)
 
sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/sugar-0.86/ubuntu karmic main >> /etc/apt/sources.list'
 
sudo apt-get update
 
sudo apt-get install sugar-platform
 
 
 
= 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 01:35, 31 January 2018