Editing Community SSU

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

<div style="float: right">
<imagemap>
Image:Bugsquad-logo-wazd-small.png|84px|center|thumb|Report bug
desc none
default [https://bugs.maemo.org/enter_bug.cgi?product=Maemo%205%20Community%20SSU]
</imagemap>
</div>
<div style="float:right">
<imagemap>
Image:Cssu_testing_5.png|center|thumb|Testing_one-click-install
desc none
default [http://repository.maemo.org/community-testing/community-testing-fremantle.install Install testing]
</imagemap>
</div><div style="float:right">
<imagemap>
Image:Cssu_stable_5.png|center|thumb|Stable_one-click-install
desc none
default [http://repository.maemo.org/community/community-fremantle.install Install stable]
</imagemap>
</div><div style="float: right">
[[Image:Cssu_both_5.png‎]]
</div>

==What is it?==
Seamless Software Update ([[Seamless Software Update|SSU]]), is the term Nokia formerly used for over-the-air updates of Maemo (generally marketed as Maemo Update as of Maemo 5).

The Community Seamless Software Update (CSSU) is being developed by the Maemo community as a continuation of, and expansion on, Nokia's update support. It aims to deliver fixes which would be difficult to deliver through Extras (like core Maemo packages). It won't, however, bundle software which can (or could) be installed through the Extras repositories.

'''There are two such efforts for the Maemo platform.''' This page describes the one for Fremantle (Maemo 5, as used in the Nokia N900). The '''[[Diablo Community Project]]''' is doing the same for Diablo (Maemo 4.1, as used in the Nokia N800, N810 and N810 WiMAX Edition).
<br clear="all">

So this CSSU is the recommended '''update method''' for '''Maemo 5 Fremantle'''. It's not a new version of maemo distribution.

==Whom is it for?==

===Everyone===
Since the release of the stable branch CSSU-S is meant to be the LongTermSupport hotspot for all N900 users/owners.

Maximum compatibility for all N900 owners is CSSU primary guidance.

===Testers===
Power-users, developers, Nokia/Maemo/MeeGo engineers, testers, documentation writers and those willing to risk a re-flash in order to help can still install the testing version and stay as bleeding edge as possible inside CSSU universe, not implying CSSU will be the bleeding edge and pacemaker of development away from maemo5 towards something above and beyond (that's not what CSSU is meant to be and never will be, see above note about maximum compatibility).

===Thumbers===
Tired of the [[N900]]'s memory bottleneck, look no further.
CSSU-Thumb is reducing code size by compiling packages with Thumb2 ISA.

CSSU-Thumb is based on CSSU-Testing flavor, but uses a very low level patch to '''kernel''' to overcome the bugs in OMAP chip related to thumb/ARM mixed code. Thus the binaries from CSSU-Thumb will '''not work''' in a "normal system", and several things like uBoot or flashing --flash-only=kernel stop working the way they used to, and you need to take special care regarding the changed behaviour of those. If you don't, our system might start segfaulting like mad and probably not even boot up anymore. Thus to go back from thumb-enabled kernel to stock- or any other non-thumb-kernel is not an option for CSSU-Thumb users.  Generally this solution is deprecated for you if you don't feel familiar with kernel installation stuff.

{{main|Community SSU/Thumb}}
[http://talk.maemo.org/showthread.php?t=84829 CSSU-Thumb talk.maemo.org Thread]

==Installation==

"Newbie" Video Tutorial: http://www.youtube.com/watch?v=uMHxo1ALXNE

Another nice one (I (jr/docS) prefer it better): http://www.youtube.com/watch?feature=fvwp&NR=1&v=DPVHOpGVzZY

Nevertheless read this full page as well, before starting CSSU installation, so you understand what it's all about.

Note that both videos show installation (and features) of CSSU-T - for (on first glance missing) features of CSSU-S see http://wiki.maemo.org/Community_SSU#Features

'''THIS IS THE ONE AND ONLY SUPPORTED AND TESTED WAY TO INSTALL CSSU''', please follow instructions faithfully!

'''There's no way to "uninstall" CSSU!''' Although you hardly ever want to do that. So:

# '''[NEW]:''' ''Since original Nokia system repositories vanished together with Nokia, please see http://wiki.maemo.org/Repository#Mirrors_of_standard_Nokia_repos_.28using_Application_manager.29 to get working source of core system components. You'll need that to satisfy dependencies of packages you're going to install during the process.''
# Install [http://maemo.org/packages/view/backupmenu/ backupmenu] . Do a full backup of your system, by rebooting with keyboard open. Get your battery charged up to state "green". All this is not mandatory but highly recommended, as usual. Plug in wallcharger. Get a softdrink of your choice :-)
# If you haven't done yet (unlikely): Upgrade to at least [[Maemo 5/PR1.3|PR1.3]], Nokia's last official major Maemo 5 update. PR1.3.1 is fine as well. If you're unsure if you have, ''Settings > About product'' should show ''Version'' beginning with '''20.2010.36'''(PR1.3) or '''21.2011.38'''(PR1.3.1). Make sure you have no too weird catalog settings in Application manager, esp <s>it's recommended you never disable the core Nokia SSU repositories.</s> see 1.
# In case you have modified hildon-desktop installed (you will know when you did that) remove it before taking further steps, all your settings will work since cssu does include all m-h-d changes. Rebooting the N900 prior to next step is probably a good idea, to make sure no memory hogs or anything is running. Make sure your device has a working connection to internet prior to next step, preferably via WLAN or a high bandwidth 3G data connection.
# Open this page in N900 webbrowser. Think a minute if you want to be a tester supporting CSSU bleeding edge, or you rather need a rock solid CSSU, then click on the according Install [http://repository.maemo.org/community/community-fremantle.install stable] or [http://repository.maemo.org/community-testing/community-testing-fremantle.install testing] icon at top of this page, or directly on the links in this very sentence.
# Hildon Application Manager (HAM) will launch and begin processing (be patient as nothing seems to happen for some minutes). There are a series of installations for which it will prompt you with messages and warnings. Click "Accept" and "Done" for each to install.
# Once this is completed, close HAM and go into the applications menu. Tap the ''Community SSU'' icon. This will run through a series of scripts to ensure the community repository are set up.
# HAM will re-open and present you '''the real thing''': a system upgrade called '''Maemo 5 Community SSU''' - probably you want to install it ;-D. This will take a while. Once installed, your device will reboot "into" CSSU.
# If you installed the stable version and have edited your ''transitions.ini'' before installing, then you'll find your old settings in the file ''/usr/share/hildon-desktop/transitions.ini.precssu''. You can either just copy it over the new one and miss out on the new features, or incorporate your changes.

Problems? Check the [[Community_SSU/Installation_FAQ|Installation FAQ]]

==Features==
{{main|Community SSU/Features}}
{{main|Community SSU/FeaturesStable}}

You find there how to use new features such as [http://thpmaemo.blogspot.com/2011/02/community-ssu-features-to-look-forward.html Thomas Perl's hildon-desktop improvements] and the status of applications in [[Portrait Mode]] with <code>forcerotation</code>.

==Changelog==
{{main|Community SSU/Changelog}}
{{main|Community SSU/ChangelogStable}}

lists all changes from stock PR1.3 to CSSU and between various CSSU releases.

==Contributing==
{| style="background: #e8d8c8; border: 1px solid #666; width: 100%; text-align: center"
| Get involved on [[IRC]] (<code>#maemo-ssu</code>), [http://talk.maemo.org/showthread.php?t=67905 Talk], [https://bugs.maemo.org/buglist.cgi?resolution=FIXED&resolution=WONTFIX&resolution=---&classification=Extras&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Maemo%205%20Community%20SSU Bugzilla] and [https://github.com/community-ssu Github].
|}

'''Can you write documentation?''' If so, it'd be great to flesh out the wiki page with installation instructions (to make it easy for users to install without worrying about missing a step or getting it wrong); explain more about the SSU and generally spruce up the wiki page and maintain things like the changelogs etc.

'''Were you involved in developing Maemo?''' If so, with Nokia now looking to Harmattan and MeeGo, we'd love to see your itches addressed in the Community SSU (CSSU). Have you always wanted to implement something in hildon-desktop, but Management stood in your way? We'd love to have it!

'''Have you written a patch for Maemo?''' Raise a bug and let's get it in the CSSU.

'''Are you a developer?''' There are numerous patches floating around for hildon-desktop; but they can't be included in the CSSU until they are configurable (via gconf) and default to off.

Want to test? Not only testing this release, but writing test scripts so that each release of the CSSU can get sanity checked before unleashing it into a "stable" repo for end-users. How do we do it? What should be tested? How is it organised?

'''Want to organise?''' There's still lots of process left to organise; hopefully there'll be bugs and features to triage and manage in bugs.maemo.org as well as communication of the testing, releases and end-user readiness of the CSSU.

'''Have great ideas?''' If you have suggestions that you think could be picked up by the CSSU developers, please add them here: [[CSSU Requests]]. However see the notice above about CSSU not going to include anything that better gets implemented as a normal app. Nonetheless CSSU actually will host apps that are specific to CSSU core system, the orientation-lock applet being first of a possibly ever increasing number.

For more information: contact MohammadAG on #maemo-ssu on FreeNode IRC or [mailto:council@maemo.org council@maemo.org].

== QA and bugs ==
{{main|Community SSU/QA}}

Quality is of paramount importance to the Community SSU. There are, therefore, two repositories: ''testing'' and ''stable''. Changes are carefully tested, with an extensive set of tests, before things are made "stable". Packages in cssu-testing are supposed to be crafted and tested to be in a shape where the contributor and cssu maintainers expect them to pass those tests for "stable".

If you have found a bug, in either the ''testing'' or ''stable'' releases, please [https://bugs.maemo.org/enter_bug.cgi?product=Maemo%205%20Community%20SSU raise a bug]. Getting involved through testing, bug triaging and running of the tests is a good way to get involved; as, of course, is writing documentation!

== Development ==

The Community SSU is developed and managed through [https://github.com/community-ssu Github]. Bugs are tracked in [https://bugs.maemo.org/buglist.cgi?resolution=FIXED&resolution=WONTFIX&resolution=---&classification=Extras&query_format=advanced&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&product=Maemo%205%20Community%20SSU Bugzilla]. Collaboration largely [http://mg.pov.lt/maemo-ssu-irclog/ happens on IRC]. Getting involved through development, bug triaging and managing developers is a good way to get involved.

[[Category:Community]]
[[Category:Fremantle]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Main (view source) (protected)

Retrieved from "http://wiki.maemo.org/Community_SSU"

Personal tools

Navigation

Views

Editing Community SSU

@@ Line 104: / Line 104: @@
 '''Are you a developer?''' There are numerous patches floating around for hildon-desktop; but they can't be included in the CSSU until they are configurable (via gconf) and default to off.
-'''Want to test?''' Not only testing this release, but writing [[Community_SSU/QA#Test scripts|test scripts]] so that each release of the CSSU can get sanity checked before unleashing it into a "stable" repo for end-users. How do we do it? What should be tested? How is it organised?
+Want to test? Not only testing this release, but writing test scripts so that each release of the CSSU can get sanity checked before unleashing it into a "stable" repo for end-users. How do we do it? What should be tested? How is it organised?
 '''Want to organise?''' There's still lots of process left to organise; hopefully there'll be bugs and features to triage and manage in bugs.maemo.org as well as communication of the testing, releases and end-user readiness of the CSSU.