Nemo/Updating

NOTE: There is no guarantee that the update instructions in this page work and that your device boots after the update. So it is recommended to backup all your essential data before doing the update.

Updating via Packages application

1. Make sure your device is connected to network
2. Choose "Refresh cache" button from the center of the toolbar
3. After cache has been refreshed choose "Update"
4. Packages creates a list of available updates (may take some time), choose "Update selected" (all should be selected by default)
5. System solves the dependencies and creates a list of packages that it needs to update and install, this may take long time. After the list is shown confirm update.
6. System downloads and installs the packages. Once the app shows "Finished" all packages have been installed. Now you can close the application
7. Reboot device

NOTE: This method doesn't download new packages that might have been added to the patterns, for this see the cmdline method.

Updating via command line

NOTE: If the network connection breaks and display goes black (See: https://bugs.nemomobile.org/show_bug.cgi?id=416) during the update give the device 15 minutes time to finish the update and after that restart the device manually (removing battery, holding powerbutton, or similar).

To update Nemo image you need to have Nemo installed and need to have internet connection enabled. When device is connected to the Internet open terminal and run following commands:

# Take root permissions (standard pasword for root is: nemo)
su 

# Update the repository database
zypper ref

# We run the update inside screen so that if something breaks (UX or network it doesn't get interrupted)
zypper install screen

# Start screen, this makes sure that even if for example Xorg crashes during update the update doesn't stop in the middle
screen

# Start update process
zypper dup

# At times there are new packages introduced in the patterns that are not installed automatically,
# thus following command is needed to get rest of the stuff.
# Here <DEVICE> is n900, n950, x86-generic or x86-vm
zypper install -f -t pattern nemo-<DEVICE>

# After update reboot the device
reboot

SSU

Nemo has taken ssu in to use which handles the repositories. These repositories are currently devided to two groups, release and rnd. Release repositories are using repos from http://releases.nemomobile.org/snapshots/repos/ which are static and published every now and then when there are new tested changes. rnd repositories are live OBS repositories which are dynamic and constantly changing these repositories are available at http://repo.merproject.org/obs/nemo:/.

SSU version < 0.31

To change between release and rnd repositories currently you need to first install nemo-ssu-repos-*-rnd or nemo-ssu-repos-*-release depending which one you are using now.

With rnd repositories there is also possibility to change between flavours. In nemo we have three flavours (stable, testing and devel). From these flavours currently only testing and devel are populated as we don't have the automation and QA in place yet between testing and stable. If you are using rnd repositories you can change between flavours by changing flavour value in /etc/ssu/ssu.ini file. After you have installed the repository files you wanted (and removed the other ones). You can follow the normal update process that is described above.

NOTE: Changing between rnd and release or between different flavours in rnd some packages will be at times older so "zypper dup" will also notify you about downgrading packages. As long as you know about the changes you are making this is usually a safe operation.

SSU version 0.31 and newer

In new ssu versions the repository handling was merged to the ssu itself. For handling the repositories there is binary called ssu available.

First one should select either release or rnd. Also in case of rnd one needs to select also the flavour from devel, testing and stable.

ssu re latest

or in case you want to use rnd release then

ssu re -r latest

and with rnd release the flavour is selected with

ssu fl devel

Next thing is to update the repository files. This is done by calling.

ssu ur

After this you should have repository files at /etc/zypper/repos.d/ssu_*.repo

Now you can continue the zypper usage as previously. NOTE: When ever you change between release and rnd with ssu re command you need to call ssu ur or the repository files will point to the previously selected version.

Known Issues

• When doing update the network connection might break if the connman is updated see https://bugs.merproject.org/show_bug.cgi?id=141
  • WORKAROUND: Do update inside screen