wiki:Stabilizing

What this is about

In the past there were numerous breakages in the shr feeds(shr-unstable and shr-core) that resulted in the impossibility to make a phone call.

To address that we will involve users and developers in the testing shr-core: Feeds will be divided in 2 parts:

  • The staging area will get the last software and images are built.
  • The SHR-core feeds will only be synced with the staging area at each successful testing(when telephony is confirmed to work).

The testers will have to fill in the details of their tests in one of the forms below. In order to test the tester is expected to have a separate installation for testing purposes as the staging area can and will break things. The best way to test would be to make a free phone call to a free operator number that plays back your voice, such as voice messages(for instance with my operator you can choose to play a welcome message that you record). That has to be done in order to be sure that the other person could hear you, because there could be some breakage with the fsodeviced alsa state files resulting in the sound working only one way.

How to test

 http://build.shr-project.org/shr-core-staging/ will contain one directory for each major feature we want to test (like EFL or FSO upgrades) or sometimes just rotated weekly when there isn't something major or "dangerous".

Each directory has by 3 digit name which identifies the feed (lets call it NNN).

Each NNN directory has info.NNN file (and info -> info.NNN symlink) where you can read on which revisions was this feed started, which commits were used during populating this feed and when this feed gets closed (or lets say marked as ready for testers). You can also read how all our branches looked when it was closed.

For example if there is 001, 002 and latest. 002 is still getting more stuff from live build, so it wasn't "closed" yet. When we decide that there is enough stuff for testing and the feature is complete, we'll close 002 and redirect build output to new 003. Latest link will point to latest but closed feed (so usually highest -1) which would be 001.

If you want to help testing, then best way is to prepare 2nd partition (not the one you're using for daily phone you depend on) and redirect default shr-core feeds to latest closed:

sed -i 's#/shr-.*/ipk/#/shr-core-staging/latest/ipk/#g;' /etc/opkg/*-feed.conf

or of course you can lock it to whatever number you want to test later ie:

sed -i 's#/shr-.*/ipk/#/shr-core-staging/007/ipk/#g;' /etc/opkg/*-feed.conf

Also you should also download info file from selected directory so you'll know what you are testing after latest link is moved to newer feed.

wget http://build.shr-project.org/shr-core-staging/latest/info

Then you can upgrade with opkg or reflash to newer image (if images are available in staging area too). If you have reflashed new image from staging NNN, then you need to update opkg configuration (with those sed calls) to point to same NNN feed or to latest, otherwise it will install incompatible older versions.

opkg update && opkg upgrade

Now you can test whatever is important for you (telephony, music, video, ...) and if you're happy with new testing feed you should report it on our  StagingTests page. There is table for each NNN feed and you should report there if you're fine with it moving to default public feed or if you have found some issues with it.

You should include the bug numbers from  http://www.shr-project.org/trac/report where you've reported your issues and it would be fantastic if you'd also include which NNN feed was last known to work for you and the first one where it was broken in that report.

That's where those info files you've downloaded will get handy.

For End User testers

 StagingTests

For builders

 BuildingTests