Sugar Labs

Sugar Creation Kit/sck/Advanced Topics

< Sugar Creation Kit
Revision as of 20:50, 19 September 2013 by Satellit (talk | contribs) (→‎Forth Lessions)


Sweets Distribution

Sugar Network Tutorial

  • Annotated screen shots with Links

Sweets-Getting Started

Click on title ^ to go to topic
  • Some ideas on how to present SWEETS. (Inkyfingers)
  • look at Infrastructure for an overview.

Sweets Distribution

Click on title ^ to go to topic
(Sweets Distribution is easier to use for Ubuntu' and its Derivatives (Adding an additional Repository to apt) as the packages are pre-configured, ready to use.)
(Developed for Trisquel-sugar-Toast )

Sweets

Click on title ^ to go to topic
(Advanced)
Debian, Ubuntu, Fedora, Mandriva, openSUSE, and Gentoo
(This guide describes how to run Sugar using Sugar Packaging Management System, Sweets.)
Request for better Documentation of installs
Log of Installation of sugar-sweets 0.88 and 0.94 on f16-GNOME3-shell
Installing_Sugar_via_sweets_-_in_Mint-12
Installing_Sugar_via_sweets_-_in_Debian_testing_Wheezy
(For developers)

Sugar Network

Collaboration support for Internet-less environments (but not only)

Harmonic Distribution

* The possibility to launch Base Software in heterogeneous
  software and hardware environments.
* Using Base Software, provide access to various Content
  (Sugar activities, artifacts created by Sugar activities, books, etc.)
  created within the Sugar community.
* Using Base Software, provide collaborative functionality to
  support Social activity around the Content.
* Instruments and workflows to adapt Content and Base Software
  to specific needs that Sugar Deployment might face,
  including extreme ones like off-line environments and restricting
  hardware.
  • [Sugar-devel] [SWEETS] Testing collaboration related fixes 05/07/2012
Hi all!
Following the plan for Harmonic Distribution v0.2 (which will be a basis
for Sugar Distribution to use in peruvian pilot), in Sugar Shell code
were made fixes that are intended to make Telepathy (everything related to
Neighbourhood view and Sugar Activities sharing/joining) more stable
(that was broken since global redesign started after 0.88 release).
Fixes are accessible from SweetsDistribution:Factory repository. Follow
regular Sweets Distribution installation instructions[1] to install
fixed Sugar Shell on all supported platforms[2].
Some visible changes in F1 view:
* the number of buddies should be increased from ~20 to 70-90
  some Sugar versions (maybe 0.90-0.92) don't publish information about
  nickname/colors on regular basis; this information are being stored on
  disk for now
* for some buddies, server still don't have information about colors
  (replaced by gray) and nick names (jabber ids)
If you have a time and want to help Puno deployment pilot, please,
consider possibility to install sweets-desktop from Factory repository
and do some testing of collaboration functionality.

Some tips:

* while interacting with another buddies, make sure that all
  participants use Sweets Distribution (some F1 buddies might misbehave)
* the good criteria of stability level of new Sugar is comparing with
  how collaboration happen in 0.88 Sugar.
Source code, for interested in people, can be found in top commits from:

* http://git.sugarlabs.org/desktop/sugar
* http://git.sugarlabs.org/desktop/sugar-toolkit
* http://git.sugarlabs.org/server/prosody-sugar
[1] Sweets_Distribution#Installation
[2] Sweets_Distribution/Supported_platforms

-- Aleksey
Sugar-devel mailing list Sugar-devel@lists.sugarlabs.org
http://lists.sugarlabs.org/listinfo/sugar-devel

BoxGrinder

BoxGrinder Build is an easy to use command line tool to create appliances (virtual images) from simple plaintext appliance definition files. BoxGrinder can produce appliances for a variety of virtual and cloud platforms using plugins supporting technologies such as VMware or EC2.

Pungi

Advanced
  • used to build non-live CD/DVD isos
Pungi needs to run on the arch it is composing, as root, and with an install of what it is composing, eg if you are composing Fedora 8, you need to be running Fedora 8.
This is so that the correct userland tools are used to create the images and such used by anaconda.
The eventual usage of pungi will most likely be in mock chroots to facilitate this.
It needs to run on the arch it is composing due to how anaconda-runtime determines what files to put in the boot images at this time.
Currently the releases of pungi are designed to run on an updated Rawhide system. Development of pungi always tracks Rawhide.
The following sections..." assume you have installed the mock package and prepared the mock chroot"

Build a boot.iso

  • "This section provides instruction on creating PXEboot and boot.iso images"

Build a DVD.iso

  • "This section assumes you have installed the mock package and prepared the mock chroot"

Koji

Click on title ^ to go to topic
(Very Advanced)
Koji is the software that builds RPM packages for the Fedora project

Mock

Mock creates chroots and builds packages in them. Its only task is to reliably populate a chroot and attempt to build a package in that chroot.

How to create an RPM package

  • How to create an RPM package in Fedora
https://fedoraproject.org/wiki/How_to_create_an_RPM_package

sugar-build

http://sugarlabs.org/~dnarvaez/sugar-docs/build.html
  • better j-build

Git

Advanced - Used by Sugar Developers
I installed Fedora 18 last night, and I have to say I like sugar-build
more and more.  With just this steps in a clean F18 you get Sugar
running and ready to hack each part of it:  Kudos Daniel Narvaez!
  Re: [Sugar-devel] F18.. go sugar-build, go! 01/18/2013 03:56 PM 
sudo yum install git
git clone git://git.sugarlabs.org/sugar-build/sugar-build
cd sugar-build
make build
make run

Tutorials

L10n Translations

There is a git user named "pootle" that acts as the proxy by which all
PO file translations are committed from the Pootle server.  Please
make pootle a committer on the repo and I will make the connections
between git and the Pootle server.
Some "best practices" about working with git and Pootle are described here.
 Translation Team Best Practices


UFI booting-self-signed-linux-kernel booting-self-signed-linux-kernel

"The procedures for how to boot a self-signed Linux kernel on a platform so that you do not have to rely on any
external signing authority."

systemd for Administrators

"Resource Management in one way or another has been available in systemd for a while already,
so it's really time we introduce this to the broader audience."

Vala

"Vala is a new programming language that allows modern programming techniques
to be used to write applications that run on the GNOME runtime libraries,
particularly GLib and GObject."

groupthink

Click on title ^ to go to topic
  • Very Advanced
"Groupthink is a library of self-sharing data structures written in python and shared over dbus.
Together with the D-Bus Tubes provided by the Telepathy framework, this enables data structures to be shared over a network."

OLPC XO-1 and XO-1.5 links and Notes

Click on title ^ to go to topic

Testing Introductory Page

Help/Info Wiki Page

wiki.laptop.org

http://wiki.laptop.org/go/The_OLPC_Wiki

Build 13.1.0

http://wiki.laptop.org/go/13.1.0
http://build.laptop.org/13.1.0/os15/xo-1.5/

Hexoquinasa

Olpc os builder

  • "utility that allows you to build operating system (OS) images for XO laptops"

XO-4 Touch

  • specs

XS Community Edition

  • School Server - Community Edition (XSCE) project

Dropbox working with the Journal

"If you don't have a Dropbox account, go to http://www.dropbox.com and sign up.  If you're a heavy Dropbox user,
I highly suggest creating another account just for the XO.
As with all things Linux, there are a few scenarios and use cases to consider. 
Here's a distillation, from the easiest installation and on.
1.  Gnome Desktop only, keeping Dropbox on the nand.  No USB drive required.
You're looking for an easy way to transfer notes, small files, etc. between the XO and your "regular" computers
 without having to constantly mess with USB drives.
2.  Gnome Desktop and usage under Sugar in the Terminal.  No USB drive.
The above scenario applies to you, but you'd also like to be able to access /home/olpc/Dropbox under Sugar in the Terminal.
3.  Up to 2 GB of storage as well as Sugar Journal integration.  USB drive required."
  • September 18, 2010, 10:10:02 AM by anna
http://www.olpcnews.com/forum/index.php?topic=4892.0

Testing Dextrose in a virtual machine

  • Download Image; KVM; VirtualBox

Dextrose Building

Dextrose uses olpc-os-builder, a tool create by OLPC to build official and customized system images.
The Dextrose git repository contains, olpc-os-builder, local customizations specific to Dextrose,
and fixes and enhancements waiting to be pushed upstream.

XS Schoolserver 0.7

Click on title ^ to go to topic

Install of XS 0.7 on Centos-6.4

  • Terminal output of install 08/02/2013
  • Full instructions used:
http://wiki.laptop.org/go/XS_Installing_Software_0.7

wiki4schools

Re: [support-gang] Status update of the installation of the new school server and IIAB at Rahnuma School Karachi
On 08/04/2013 06:00 AM, Braddock wrote:
 When the IIAB registers via DHCP it advertises its name as "know", and if the DHCP server and the DNSserver talk to each other the DNS server will resolve the name.
dnsmasq does this, so I suspect that might be what School Server runs?)
The only down side to this is that if you reboot the school server,you may find you need to then reboot the IIAB device so it gets afresh DHCP lease because the school server may forget it exists. 
...

Tony Anderson:
The school server is gateway and dns for the XOs and can certainly resolve http://know to a fixed address, which is the more orthodox way to do this.
Incidentally, I believe the problem with the wiki is that the url is http://schoolserver/wiki4schools/ not http://schoolserver/wiki.
Normally, the XOs access everything from the Browse home page so that keyboard entry of urls is not needed. However, because of the xo-custom script problems this was not set up.

Manuals

OLPC Manual
Help Activity Refresh
Manuals Info

Internet in a Box

Start iiab-server

# iiab-server
werkzeug --  * Running on http://0.0.0.0:25000/
werkzeug --  * Restarting with reloader
  • Enter address in browser
http://0.0.0.0:25000/

Screenshots

  • Click on screenshot to enlarge; hit <== return arrow on browser to return
Installed on a i7 Laptop with the above installation link
This is a reduced version [1] of Internet in a Box (not the full 1 TB )
[1] IIAB_QuickStart_Sampler_20130809.tgz

  

  • iiab Main Menu
  • iiab-books Project Guttenburg

  

  • iiab-Video
  • iiab-settings (credits)

Also see:

http://wiki.sugarlabs.org/go/OLPC#XSCE_on_XO-4

 

  • Browse looking at local School Server on a XO-4 with XSCE RC-1 installed with USB containing /knowledge directory of iiab inserted
http://schoolserver.org/

Unleash Kids

" all-volunteer Unleash Kids efforts shipping XO-4 community kits (hopefully including XS Community Edition!) to volunteers a bit later this summer, at the most minimal cost we can muster,
to be announced soon @ http://facebook.com/UnleashKids"

Forth Lessions

  • A series of lessions on the OLPC wiki

Kernel Userspace Interfaces

ARM

References
http://elinux.org/RPi_Distributions
http://en.wikipedia.org/wiki/List_of_ARM_microprocessor_cores
http://www.linaro.org/downloads/
http://fedoraproject.org/wiki/Fedora_ARM_Installer
fedora 17 and fedora 18 (arm/armhpf)

TrimSlice

Firmware Updater

Ubuntu on a TrimSlice

  • Testing of TrimSlicePro
TrimSlicePro-Update
  • Testing of TrimSlice H250
Install of Ubuntu to 320 GB HD
Install of Ubuntu to a SDXC Card

 

  • TrimSlicePro Setup Booted from 64 GB SDXC Card in front slot
(SDXC card is expanded to 30 GB with gparted)

 

  • TrimSlicePro Running KDE-Desktop -plus sugar-emulator (0.90.1)
Beautiful Display on Samsung SyncMaster S20B350 HDMI 1600x900 @60Hz PP

Fedora on a TrimSlice

Fedora with XFCE
References
http://scotland.proximity.on.ca/arm-nightlies/vault/f17arm-latest-arm-rpi-xfce-mmcblk0.img.xz
http://fedoraproject.org/wiki/Architectures/ARM
http://fedoraproject.org/wiki/Architectures/ARM/Fedora_17_Beta
https://fedoraproject.org/wiki/Architectures/ARM/Fedora17_rawhide
http://dl.fedoraproject.org/pub/fedora-secondary/releases/test/17-Beta/Images/armhfp/
f17-arm RC-1: http://scotland.proximity.on.ca/arm-nightlies/vault/to-mirrors/RC1/armhfp/
Boot from CD: http://www.trimslice.com/forum/viewtopic.php?f=25&t=412
linux-tegra-drm:https://gitorious.org/linux-tegra-drm/pages/Host1xIntroduction
Tegra
http://developer.nvidia.com/tegra-2-technical-reference-manual
http://www.trimslice.com/wiki/index.php/OS_Installation_and_update
http://www.trimslice.com/wiki/index.php/Trim-Slice_Linux_Kernel
http://lists.linux-foundation.org/pipermail/ksummit-2012-discuss/2012-June/000304.html
https://gitorious.org/linux-tegra-drm
linux-tegra-drm:https://gitorious.org/linux-tegra-drm/pages/Host1xIntroduction

f17-fedora-arm

f17 Nightly Images
live media creator on arm
http://fedoraproject.org/wiki/Anaconda/Features/ReworkLiveCD
http://www.redhat.com/archives/anaconda-devel-list/2011-November/msg00081.html
http://lists.fedoraproject.org/pipermail/arm/2012-May/003358.html
Trimslice Pro and H250
Serial interface ONLY
  • Mac-Trimslice Pro Connections:
Nice Terminal Emulator for Mac:http://www.macupdate.com/app/mac/31352/coolterm
  • Connection Diagram:
[MacBookPro USB port]---[usb to serial adapter (&)]---[null modem]--[serial cable]--(TrimSlice serial to mini cable]--[TrimSlice serial port]
(&) DYNEX USB_PDA/Serial Adapter (Dynex DX-UD889)
  • Console Speed 115200 bps, 8n1,
  • root password: -Displays in serial terminal-
root=fedoraarm
  • Note these are experimental FOR TESTING ONLY - Still in development; use with caution
  • The kernel used does not support startx
No graphical interfaces are available at this time for TrimSlicePro and TrimSlice -h
  • dd will write a live USB but it will not boot in arm devices.
works in intel PC's
  • livecd-tools does not work
SD Card Install
This is a Fedora 17 Hard Float Trimslice Image suitable for writing to an SD card and placed in the Trimslice's Full Size SD slot (Front slot)
and booting without further modification.
Write with xzcat file.xz > /dev/mmcblkX, put in the device, and you're ready to go. Boots to a serial console.

Most of the SD card images can be used with a USB storage device drive using the following method:
Write the image to both the USB storage device and an SD card. IE, write the image using xzcat file.xz > /dev/sdX then xzcat file.xz > /dev/mmcblkX.
Once written, use a partition editor such as fdisk to delete the VFAT partition from the USB drive and the Linux partition from SD card.
Plug the SD and USB storage into your ARM device and power up. 
The ARM system will load any applicable bootloader pieces, kernel, and initramfs from the SD card, but use the USB storage for the root filesystem.

Nearly images are self-sufficient, but a kernel tarball is optionally available with the contents of the image's /boot and /lib/modules directories.
These can be used in conjunction with the tarball root filesystems to create your own images.
Resizer
  • Resizer Script and systemd file
http://scotland.proximity.on.ca/fedora-arm/rootfs-resize/rootfs-resize-0.3/
expects 2 partitions on SD card; will not work if a 3rd exists
http://scotland.proximity.on.ca/arm-nightlies/vault/mknightly.tar.xz

Archlinux-TrimSlice

Raspberry Pi / RPi

updated 09/12/2013
Coder is a free, open source project that turns a Raspberry Pi into a simple platform that educators and parents can use to teach the basics of building for the web.
New coders can craft small projects in HTML, CSS, and Javascript, right from the web browser.
Fedora 18 Remix: https://fedoraproject.org/wiki/Architectures/ARM/F18/Remixes
http://zenit.senecac.on.ca/wiki/index.php/Raspberry_Pi_Fedora_Remix_Installation
"Pidora is a Fedora Remix optimized for the Raspberry Pi computer."
Good overview of RaspberryPi
http://www.collabora.com/services/case-studies/raspberrypi
Script: http://scotland.proximity.on.ca/raspberrypi/f17-releases/v5/latest/rpfr17-xfce-compose
Order Page: http://www.newark.com/jsp/search/productdetail.jsp?SKU=83T1943
New 03/28/2013

Write SD in a MAC:http://alltheware.wordpress.com/2012/12/11/easiest-way-sd-card-setup/

http://zenit.senecac.on.ca/wiki/index.php/Raspberry_Pi_Fedora_Remix
http://elinux.org/RaspberryPiBoard#Software_.26_OS_Distribution
http://elinux.org/RPi_Distributions#What_is_armhf
"...BCM2835 used in the Raspberry Pi is the first ARM-based multimedia SoC with fully-functional,
vendor-provided (as opposed to partial, reverse engineered) fully open-source drivers,..."
RPi resolution fix:"disable_overscan=1"
http://www.raspberrypi.org/phpBB3/viewtopic.php?f=24&t=4691
http://elinux.org/R-Pi_Troubleshooting
http://rpmfusion.org/Architectures/ARM
  • Chromium Browser for RPi (beta)
http://hexxeh.net/?p=328117859
  • Update and install software before flashing .img using chroot
http://raspberrypi.stackexchange.com/questions/855/is-it-possible-to-update-upgrade-and-install-software-before-flashing-an-image

Projects and Courses

Kernel Testing

Kernel Compilation

raspberry-pi-root-fs-on-usb-drive
Xorg and LXDE
http://www.raspbian.org/PiscesImages
Mate on RPi
http://www.raspbian.org/RaspbianMate
DL: http://www.raspbian.org/PiscesMATEImages

Testing Pages

List of Test Pages

Testing/Reports/ARM_RPi

Tests of f18/ f17-remixes; Raspbian-PiscesMATE; and rasbian Debian on the RPi

http://scotland.proximity.on.ca/raspberrypi/test-releases/rpfr17/
http://www.raspbian.org/PiscesMATEImages
http://downloads.raspberrypi.org/images/raspbian/2012-07-15-wheezy-raspbian/2012-07-15-wheezy-raspbian.zip

Testing Sweets on a RPi armhf

  • Install of Sweets Sugar 0.94 on a RPi

xmbc

Gentoo

Mageia-arm

This ARM port supports the Kirkwood series from Marvell.
Most frequent are: Open-RD, computer plugs (SheevaPlug, GuruPlug).
It runs also in qemu as a virtual machine.
Install to QEMU: http://packages.rtp-net.org/mageia/1/armv5tl/docs/README.ARMv5TL
Prebuilt Images: http://packages.rtp-net.org/mageia/1/imgs/


http://dx.com/p/u2-mini-android-4-0-network-multi-media-player-w-wi-fi-hdmi-tf-black-4gb-ddr-iii-1gb-145864?Utm_rid=93072394&Utm_source=affiliate
http://www.cnx-software.com/2013/01/03/smallart-u-host-allwinner-a10-mini-pc-is-available-for-20/

CubieBoard

  • "Cubieboard is a small (10x6cm), hacker friendly, extendable and very low-cost while powerful ARM board with Allwinner A10 SoC."

Getting Started

http://linux-sunxi.org/Cubieboard
Download:http://cubieboard.org/\
https://fedoraproject.org/wiki/Architectures/ARM/F18/Remixes#Allwinner_A10
http://scotland.proximity.on.ca/contrib-images/hansg/README
http://sourceforge.net/projects/berryboot/?source=dlp

Pengpod

"The PengPods are a line of Linux/Android tablets and mini PCs. All devices have an Allwinner A10 or A13 processor. They are designed to run Android on their internal flash and boot Linux from an SD card for the best of both. These devices are hacker friendly and there is an active community working to make them better. You can pre-order a PengPod from our crowd funding project on Indiegogo. "

Software

http://pengpod.net/dl/images/
http://linux-sunxi.org/Main_Page
http://linux-sunxi.org/Fedora
http://scotland.proximity.on.ca/contrib-images/hansg/
pengpod as touchscreen for solidoodle 3d printer

"I now have a fully-functional touchscreen pronterface installation that can drive the Solidoodle..."

Ubuntu images for ARM Devices

Ubuntu 13.04 (Raring Ringtail)

PPC

Power PC
Doing builds again for fedora 16
  • IRC: #fedora-ppc on irc.freenode.net

Chromebook

https://www.berrange.com/posts/2013/03/31/automated-install-of-fedora-18-arm-on-a-samsung-google-chromebook/
Complete step by step procedure to install fedora on SD or internal ssd of Chromebook
Manual: http://www.denx.de/wiki/DULG/Manual

Automated install of fedora 18

Fedora-17-on-samsung-chromebook-series-3-arm

EXPERIMENTAL run Fedora 17 on Chromebook
  • Note danger of blowing out the speakers.

Building your own kernel and installing it in the Chromebook

using-nv-u-boot-on-the-samsung-arm-chromebook

Recover your Chrome device

Install a new version of the Chrome operating system on your Chrome device by going through the recovery process. You may want to go through this process if you’re having problems updating your Chrome device or if your Chrome device stops working.

Fedora on a Chromebook

  • NEW--Satellit 01:57, 6 December 2012 (EST)

Chrubuntu-1204

  • ChrUbuntu 12.04 for the new Google Chromebook with ARM processor!

Ubuntu on Chromebook

http://www.samsung.com/global/business/semiconductor/minisite/Exynos/products5dual.html
http://www.tigerdirect.com/applications/SearchTools/item-details.asp?EdpNo=4917324

Debian on Chromebook

  • Entering Developer Mode
http://goo.gl/TSZxs
"On this device, both the recovery button and the dev-switch have been virtualized.
Our partners don't really like physical switches - they cost money, take up space on the motherboard, and require holes in the case.
To invoke Recovery mode, you hold down the ESC and Refresh keys and poke the Power button.
To enter Dev-mode you first invoke Recovery, and at the Recovery screen press Ctrl-D (there's no prompt - you have to know to do it).
It will ask you to confirm, then reboot into dev-mode.
Dev-mode works the same as always: It will show the scary boot screen and you need to press Ctrl-D or wait 30 seconds to continue booting.
You'll still have to run "crossystem dev_boot_usb=1" and reboot once to boot from USB drives with Ctrl-U. 
To leave Dev-mode and go back to normal mode, just follow the instructions at the scary boot screen. It will prompt you to confirm.
If you want to leave Dev-mode programmatically, you can run "crossystem disable_dev_request=1; reboot" from a root shell  .
Th ere's no way to enter Dev-mode programmatically, and just seeing the Recovery screen isn't enough -  
you have to use the three-finger salute which hard-resets the machine first.
 That's to prevent a remote attacker from tricking your machine into dev-mode without your knowledge.
An unrelated note: Holding just Refresh and poking the Power button hard-resets the machine without entering Recovery.
 That's occasionally useful, but use it with care - it doesn't sync the disk or shut down politely,
 so there's a nonzero chance of trashing the contents of your stateful partition."

gitweb

Fedora

  • TESTING Section
  • Hope to install Fedora on it.--Satellit 02:32, 26 October 2012 (EDT)
  • IRC #fedora-arm freenode

openSUSE

Detailed instructions: https://plus.google.com/u/0/109993695638569781190/posts/b2fazijJppZ
opensuse-on-arm-release-candidate-1
http://news.opensuse.org/2012/10/01/announcing-opensuse-on-arm-release-candidate-1/
http://download.opensuse.org/repositories/openSUSE:/12.2:/ARM:/Contrib:/Origen/images/

Cloud-OpenStack

http://git.fedorahosted.org/cgit/cloud-kickstarts.git/

SoaS in Parallels for OS X

(experimental)
(Not very current)

Sugar Patches

http://patchwork.sugarlabs.org/project/sugar/list/
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Sugar_Creation_Kit/sck/Advanced_Topics&oldid=89716"