|
|
(411 intermediate revisions by 10 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] |
| | | |
− | '''As of December 2009, We started a total refactoring of how Sugar is packaged in Ubuntu.'''
| + | In relation to Sugar, Ubuntu is a downstream distribution project that can be used to run Sugar. |
| | | |
− | '''Please See the Ubuntu Sugarteam wiki at https://wiki.ubuntu.com/SugarTeam for the latest information.'''
| + | ==Ubuntu 17.04 Zesty== |
| | | |
− | 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.
| + | Sugar 0.110 is in the archive for Ubuntu 17.04 Zesty, and can be installed by typing |
| | | |
− | == Sugar on Ubuntu 10.04 (lucid) ==
| + | sudo apt install sucrose |
| | | |
− | Lucid has Sugar 0.88, 0.86, and 0.84 packages synced from [[Community/Distributions/Debian|Debian]].
| + | * 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 --> |
| | | |
| + | == Using Sugar inside another desktop environment == |
| | | |
− | The current preferred method of running Sugar on the ubuntu is via Ubuntu Sugar Remix which can be downloaded at http://people.sugarlabs.org/dfarning
| + | 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. |
| | | |
− | Packages can also be install via sudo
| + | Install the Remote Desktop packages: |
− | sudo apt-get install sugar sugar-activities | + | sudo apt install xrdp rdesktop |
| | | |
− | == Sugar on Ubuntu 9.10 (karmic) ==
| + | Create a user for Sugar: |
| + | adduser sugar |
| + | echo sugar >> /home/sugar/.xsession |
| | | |
− | The prefered way to run Sugar on karmic is via 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.
| + | Start a session: |
| + | rdesktop -g 1200x900 -u sugar -p sugar 0 |
| | | |
− | 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.
| + | ==Ubuntu 16.04 Xenial LTS== |
| | | |
− | Before attaching ppa, load gpg key
| + | Sugar 0.106 is in the archive for Ubuntu 16.04 Xenial, and can be installed by typing |
− | 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 apt install sucrose |
− | sudo sh -c 'echo deb http://ppa.launchpad.net/alsroot/trisquel-edu/ubuntu hardy main >> /etc/apt/sources.list'
| + | <!-- last tested with Ubuntu 16.04.1 Xenial) --> |
− | 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.
| + | Sugar 0.110 can be installed by careful addition of the Ubuntu 17.04 Zesty packages. |
− | 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)
| + | 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. |
− | 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
| |
| | | |
− | To use Sucrose-0.88 on 10.04(Lucid)
| + | ==OLPC Ubuntu Sugar 16.04 Xenial LTS == |
| | | |
− | * Debian's packages on the way to official Ubuntu repos
| + | 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. |
| | | |
− | ===Note from lists=== | + | ==OLPC Ubuntu Sugar 14.04 Trusty LTS == |
| | | |
− | Message: 2 ****( this did not work) satellit 01/04/2010
| + | 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. |
− | 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
| + | ===Installing a system=== |
| | | |
− | Using the command above results in both importing the GPG key for a
| + | How to install Ubuntu with Sugar 0.106: |
− | PPA and creates a file in /etc/apt/sources.list.d/ named
| + | * 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], |
− | "sugarteam-0.86-karmic.list" with all the proper magic in it. The
| + | * 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] |
− | output of the command looks like this (line-wrapped for readability):
| + | * 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. |
| | | |
− | $ add-apt-repository ppa:sugarteam/0.86
| + | ===Adding to a system=== |
− | 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)
| |
| | | |
| + | Note: only available for 64-bit systems, check that ''uname -i'' shows x86_64. |
| | | |
− | == Sugar on Ubuntu 9.04 (jaunty) ==
| + | 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. |
| | | |
− | Jaunty, the current Ubuntu release, has Sucrose 0.83 packages synced from [[Community/Distributions/Debian|Debian]].
| + | ===Upgrading a system=== |
| | | |
− | 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. | + | 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. |
| | | |
− | :That work around doesn't work.--[[User:Dennis Daniels|Dennis Daniels]] 00:38, 7 August 2009 (UTC) | + | ==See also== |
| + | * [https://wiki.debian.org/Derivatives/Census/OLPC Debian Derivatives Census - OLPC] |
| | | |
− | 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)
| + | ==Previous releases== |
| + | See [[Ubuntu/Previous]] for how to install older versions of Sugar on older releases of Ubuntu. |
| | | |
− | *works for me on 9.04 using ppa [http://wiki.sugarlabs.org/go/Community/Distributions/Ubuntu#Using_sugar_PPAs] Oct 31 2009
| + | ==Subpages== |
− | === Installing === | + | {{Special:PrefixIndex/{{PAGENAME}}/}} |
− | | |
− | 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.
| |
− | | |
− | = 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
| |
− | | |
− | = Sugar Team ==
| |
− | | |
− | 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://bugs.launchpad.net/ubuntu/+source/sugar-0.88 Sugar bug reporting Ubuntu].
| |
− | | |
− | [[Category:Supported systems]]
| |
- 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