Line 1: |
Line 1: |
− | {{TOCright}}
| + | Moved to https://github.com/sugarlabs/sugar/blob/master/docs/ubuntu.md |
− | [[Image:Ubuntu.jpg]]
| + | :Ubuntu educational software |
− | | + | ::https://sourceforge.net/projects/cyberorg-home/files/Li-f-e/ |
− | = 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)
| |
− | | |
− | *works for me on 9.04 using ppa [http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu#Using_sugar_PPAs] Oct 31 2009
| |
− | === 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.
| |
− | | |
− | Before attaching ppa, load gpg key
| |
− | gpg --keyserver keyserver.ubuntu.com --recv 86ABE8AE363C5DAC
| |
− | gpg --export --armor 86ABE8AE363C5DAC | sudo apt-key add -
| |
− |
| |
− | gpg --keyserver keyserver.ubuntu.com --recv F265806A9BFFF0F4
| |
− | gpg --export --armor F265806A9BFFF0F4 | sudo apt-key add -
| |
− | | |
− | To use Sucrose-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 Sucrose-0.86 on 9.04(Jaunty). You need to update metacity from this PPA.
| |
− | 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 metacity
| |
− | sudo apt-get install sugar-platform
| |
− |
| |
− | | |
− | To use Sucrose-0.86 on 9.10(Karmic)
| |
− | sudo sh -c 'echo deb http://ppa.launchpad.net/sugarteam/0.86/ubuntu karmic main >> /etc/apt/sources.list'
| |
− | sudo apt-get update
| |
− | sudo apt-get install sugar-platform
| |
− | (**NOTE: use sugar instead of sugar-platform)satellit 01/04/2010
| |
− | | |
− | ===Note from lists===
| |
− | | |
− | **( this did not work, enter 2 gpg keys as shown above ) satellit 01/04/2010
| |
− | --
| |
− | | |
− | Message: 2
| |
− | Date: Mon, 23 Nov 2009 15:02:19 -0500
| |
− | From: Kevin Cole <dc.xxxxxx.com>
| |
− | Subject: Re: [IAEP] 'apt-get install sugar-platform' available for
| |
− | Ubuntu9.10.
| |
− | Ubuntu (Karmic) now provides a nicer way to add repositories. Type the
| |
− | following at a shell prompt:
| |
− | | |
− | sudo add-apt-repository ppa:sugarteam/0.86
| |
− | | |
− | Using the command above results in both importing the GPG key for a
| |
− | PPA and creates a file in /etc/apt/sources.list.d/ named
| |
− | "sugarteam-0.86-karmic.list" with all the proper magic in it. The
| |
− | output of the command looks like this (line-wrapped for readability):
| |
− | | |
− | $ add-apt-repository ppa:sugarteam/0.86
| |
− | Executing: gpg --ignore-time-conflict \
| |
− | --no-options \
| |
− | --no-default-keyring \
| |
− | --secret-keyring /etc/apt/secring.gpg \
| |
− | --trustdb-name /etc/apt/trustdb.gpg \
| |
− | --keyring /etc/apt/trusted.gpg \
| |
− | --keyserver keyserver.ubuntu.com \
| |
− | --recv 74F3C222CB79383175656A6986ABE8AE363C5DAC
| |
− | gpg: requesting key 363C5DAC from hkp server keyserver.ubuntu.com
| |
− | gpg: key 363C5DAC: public key "Launchpad PPA for Sugar Team" imported
| |
− | gpg: Total number processed: 1
| |
− | gpg: imported: 1 (RSA: 1)
| |
− | | |
− | = 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]]
| |