Maemo Wiki Mirror - User contributions [en]

Sailfish

2014-01-05T15:41:55Z

109.204.176.247: /* Step 4 - Prepare Harmattan */ added fix to prevent closing of applications during installations

= Introduction =

Introduction

= Credits =

This guide has been compiled from numerous previous sources and credits are due to lots of individuals for their original work, methods and support to the community, including:
[http://talk.maemo.org/member.php?u=20627 rzr], [http://talk.maemo.org/member.php?u=68697 souran], [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?showComment=1386385690772 Martin Brook], [http://talk.maemo.org/member.php?u=67021 vgrade], [http://talk.maemo.org/member.php?u=57370 coderus], [http://talk.maemo.org/member.php?u=60897 Nad], [http://talk.maemo.org/member.php?u=34203 mikecomputing], [http://talk.maemo.org/member.php?u=38434 TMavica], [http://talk.maemo.org/member.php?u=66860 krnlyng/liar], [http://talk.maemo.org/member.php?u=69326 max83], [http://talk.maemo.org/member.php?u=58774 flotron], [http://talk.maemo.org/member.php?u=61958 juiceme], contributors to [http://piratepad.net/nVuyI2uxrY piratepad], Nemo contributors and anyone else trying to make Sailfish run on the Nokia N9/N950.

Please help by contributing any information or methods you have to help make Nemo and Sailfish run better on the Nokia N9/N950.

=Installation environment=

The guide assumes some basic Linux knowledge although help can be obtained in [http://talk.maemo.org/showthread.php?t=90761 this] thread should the need arise.

A tested environment has been as follows:
* Windows 7 Host
* Debian v7.2 x64 as a Virtual Machine Running on VMware. [https://www.virtualbox.org/ Virtualbox] is free-ware and should work fine too. Any Linux distribution shall work but the instructions that follow have been used on '''Debian with Root Terminal'''. Live ISO's are also an option however files may not be retained on following reboot therefore it is advised to store everything on a local hard disk or removable drive.

It is strongly recommended to do everything on the Linux installation as it can easily read the EXT3/4 partitions presented by the MOSLO and Ubiboot maintenance modes.

There can be a loss of Internet connectivity (until reboot) on the Linux machine when in MOSLO/Ubiboot maintenance mode therefore a second device with internet capabilities is recommended.

For a Windows only installation, please follow the guide then proceed to Step W when prompted.

= Notes =

If your handset is factory SIM-locked, it may not be possible to install unsigned kernels, thus Sailfish. There is currently no known work-around and unlocking the handset after purchase does not seem to alleviate this issue.

To completely turn off the handset manually, hold the power button for ~8 seconds.

When extracting a tarball ending with .tar, use "tar -xvf --numeric-owner". If you get a message stating "invalid tar magic", it is probably .tar.bz2 therefore use "tar -xvjf --numeric-owner".

Lack of the package jolla-xt9 means there is no text correction engine in Sailfish. This also manifests as no Pīnyīn to Hanzi conversion for input of the Chinese language. This issue is addressed in itviewer and SourenAraya's later images however the legality of this remains divisive due to easy repository access to these packages even though they contain proprietary licensed software.

If you have any installation questions or issues, please ask them in [http://talk.maemo.org/showthread.php?t=90761 this thread] on talk.maemo.org. Please refrain from asking Ubiboot related questions in this thread. Ubiboot related questions should be posted in this [http://talk.maemo.org/showthread.php?t=89345 thread].

=Downloadable Resources=

These resources are required to get Sailfish working on your Nokia N9/N950.

==Firmwares==
Obtain Nokia N9 firmwares from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] or [http://mrcrab.net/nokia/Nokia_N9.html?productID=4823499691&productType=RM-696 mrcrab.net]

==Flasher==
This enables you to Flash your Nokia N9. Obtain v3.12.1 from [http://skeiron.org/tablets-dev/maemo-dev-env-downloads/ skeiron.org].

==Kernels==
Obtain the OpenMode kernel from [http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix swagman.org]

Obtain the MOSLO kernel from: [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or
[http://www.multiupload.nl/WLLK09RF96 multiupload.nl] (zip file; Windows only users use this file)

==Ubiboot==
Obtain SailfishOS-preconfigured ubiboot from [http://www.swagman.org/juice/ubiboot/ubiboot_for_sailfish/ swagman.org]

'''The above version is specially tailored to boot ONLY Harmattan and Sailfish. If you want to use other operating systems (Nitdroid, Nemo, Firefox OS), you should use the version below. However, please note that you need to configure it manually (advanced users only).
'''

Obtain the un-configured Ubiboot from [http://www.swagman.org/juice/ubiboot/ubiboot-02/ swagman.org]

Download the latest version available. For more information on Ubiboot, please visit the [[Ubiboot|Maemo Community Wiki article]]

==Sailfish Images==

There are numerous images available for download.

===SourenAraya's Sailfish images===

Available for download from: [http://n9.araya.su/images/mic_images/ araya.su].
Has Terminal pre-installed on Sailfish v1.0.2.5.

===vgrade's Kickstarter===

Available from https://github.com/martinbrook/jolla-n950-kickstart

This script allows compositions of an image using the MerSDK kit.

Please see [https://wiki.merproject.org/wiki/Platform_SDK Mer Project Platform SDK] and [http://martinbrook.blogspot.co.uk/2013/12/n950-and-jolla-phone-repos-ive-been.html?m=1 Martin Brook's blog] for more information about creating your own image.

=Additional Reading Material=

These are not required to be read for installation but many of the latest developments are highlighted here.

[http://www.who.is.free.fr/wiki/doku.php?id=n950club rzr's n950club] 
[http://piratepad.net/nVuyI2uxrY PiratePad] 
[irc://irc.freenode.net/#n950club IRC] - IRC Chat for support and discussion. Monthly meetings on the first Sunday of month at 19:00 UTC.

=Installation Guide=
==Step 1 - Backup your N9==
*Backup your Nokia N9 using Nokia Suite for PC or the phone's built-in utility in Setting. Also backup you EMMC (MyDocs) by connecting your Nokia N9 to your PC in "USB Mass Storage Mode".
**If you have used the built-in tool, connect your phone as "USB Mass Storage Mode" and ensure you have backed up the '''.backup folder''' on your PC.
*Close all your open applications on your Nokia N9. It is recommended that you backup up '''/home/.config''', '''/home/.local''' and '''/home/.whatsup (or/home/.wazapp)''' too so you have the configurations and settings for your installed applications. This can easily be achieved by using [http://talk.maemo.org/showthread.php?t=80600 N9QuickTweak]. Install it, choose Option "'''H'''", and select "'''Enable SSH for root'''". Now, use [http://winscp.net/eng/index.php WinSCP] or [https://filezilla-project.org/ Filezilla] to access you phone and copy these folders to your PC.
*Backup your backups.

==Step 2 - Re-flash your Nokia N9 to factory firmware==
*Note: Flashing can permanently damage or brick your Nokia N9. Do so at your own risk.
*If you have not already, download the Flasher for your system and install it. You want v3.12.1 from [http://skeiron.org/tablets-dev/maemo-dev-env-downloads/ here]
*Download the firmware you wish to use Harmattan with from [http://skeiron.org/firmware/N9/40.2012.21.3/ skeiron.org] or [http://mrcrab.net/nokia/Nokia_N9.html?productID=4823499691&productType=RM-696 mrcrab.net]. Your factory product code is printed on your SIM tray e.g. 059J245. You want the two files containing "DFL _61" e.g. A6D5F456_'''DFL61_HARMATTAN_40.2012.21-3_PR_LEGACY'''_005-OEM1-958_ARM.bin and 59BEC3BC_'''DFL61_HARMATTAN_40.2012.13-7'''.SEAP_'''EMMC'''_SEAP.bin.
*Rename your firmware to "main.bin" and "emmc.bin" respectively and copy them to the directory where the flasher program is installed (e.g. '''"C:\Program Files\Nokia\Flasher"'''). Check the [[Flashing_N9|Maemo Community Wiki Nokia N9 Flashing Guide]] for further information.
*Ensure your handset is fully charged. Disconnect from all cables from it and turn off.

*Open up a Root Terminal (Or Terminal and gain root/use sudo) or an elevated cmd.exe (by running it as Administrator on Windows Vista onwards) and set the directory to where flasher is located: 
'''cd /d "C:\Program Files\Nokia\Flasher"''' (for Windows)

*By connecting the USB cable to the computer and the turned off phone, you will initialise the Flashing Mode.
**This status can be checked with the command: '''flasher -i'''

*Flash your firmware with the command: '''flasher -F main.bin -F emmc.bin -f'''

*On Linux, if flashing fails with message '''Error claiming USB interface: Device or resource busy''', the problem is the cdc_phonet, phonet and cdc_acm modules. Add the lines '''blacklist cdc_phonet''', '''blacklist phonet''' and '''blacklist cdc_acm''' to /etc/modprobe.d/modprobe.conf to blacklist these modules.
*If flashing fails e.g. due to a Partition Mismatch, Security Code On Status or No Reply from Ping, you can try the following. There is a risk of bricking your phone and no warranty is provided by anyone!
**Completely turn off the handset.
**First, try to flash your firmware with the command: '''flasher -F main.bin -F emmc.bin -f --no-preserve''' '''--no-preserve''' should re-flash the device. If this fails, run flasher with the following command: '''flasher -f -F main.bin --erase-user-data=secure -F emmc.bin''' This securely erases the root file system and security code, taking approximately 20 minutes to complete. To format the device completely, use: '''flasher -f -F main.bin --erase-user-data=secure -F emmc.bin --erase-mmc=secure''' This should flash the handset under nearly all circumstances and takes around 30 minutes for complete.

If you do not wish to wait, you can stop the zeroising task and pull out the USB cable from the handset. This is a risky manoeuvre and could permanently brick your handset. The task can be stopped by: '''Pressing CTRL + Z''' in a Linux Terminal Opening Task Manager ('''CTRL+ALT+DEL''') and Ending the tasks '''cmd.exe''' and '''flasher.exe''' in Windows 
**Now completely turn off the phone.
**Turn it on and you will get a message asking you to "Install and Authorised Operating System"
**Turn the phone back off.
**In flasher, run: '''flasher -F main.bin -F emmc.bin -f'''
**The phone should proceed to flash normally.

==Step 3 - Flash the OpenMode!==
*Download the OpenMode kernel from [http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix swagman.org] and place it in the same directory as flasher and your firmware files.
*Flash the OpenMode kernel and reboot your phone with: 
'''flasher -a main.bin -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R'''

==Step 4 - Prepare Harmattan==
*Let Harmattan load up and run for a few minutes so you have date and time set correctly and the handset is fully functional.
*Install Developer Mode on Harmattan so Terminal is made available as it is useful later on and required if are do not Linux.
*(Optional) Install N9QT from [http://talk.maemo.org/showthread.php?t=80600 here] and choose Option "'''H'''", and select "'''Enable SSH for root'''". This will allow you to run commands on Harmattan from your PC and enables copying and pasting of commands and files to and from your PC easily.
*(Optional) Apply fix to prevent closing of applications during installations, following these simple [http://talk.maemo.org/showthread.php?t=91825 instructions].

==Step 5 - Re-partition your handset==
*Turn off your handset. If you have not already, start up a Linux computer/virtual machine.
*Download the MOSLO kernel from [http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm nemomobile.org] or [http://www.multiupload.nl/WLLK09RF96 multiupload.nl]. Windows users must download from multiupload.nl as it is a .zip file. Extract the files using "Archive Manager" or an unzipping utility and copy them to where flasher and your firmware files are.

*Flash the MOSLO kernel using: 
**'''flasher -k zImage-moslo -n initrd-moslo -l -b'''
**Allow MOSLO to repartition your handset.

*If you are a Linux user, MOSLO will now connect the "Alt_OS" partition to your PC.
*Disconnect the phone and turn it off completely. 

==Step 6 - Install Ubiboot==

===If you use the pre-configured Ubiboot for SailfishOS===

*Download and extract the '''pre-configured''' Ubiboot from [http://www.swagman.org/juice/ubiboot/ubiboot_for_sailfish/ swagman.org] into the directory where flasher, main.bin and emmc.bin reside.
*Unpack the archive: '''tar -xvf ubiboot-02_0.3.5_131213_SFOS.tar'''
*Copy the extracted u'''biboot_035_sailfishos.tar''' to your device e.g into the "MyDocs" folder by connecting it in Mass Storage Mode.
*Go to Terminal on your device, and obtain root access, then extract the archive: '''devel-su''' '''cd /home/user/MyDocs/''' '''tar -xvf ubiboot_035_sailfishos.tar -C /''' 
*Power off your device and flash it in the usual way: '''flasher -a main.bin -k zImage_2.6.32.54-ubiboot-02_301013 --flash-only=kernel -f -R'''

===If you use the non-configured Ubiboot===

*This method also allows Nitdroid and Firefox OS installation.
*Download and extract the '''latest''' Ubiboot release from [http://www.swagman.org/juice/ubiboot/ubiboot-02/ swagman.org] into the directory where flasher, main.bin and emmc.bin reside.
*Install the ubiboot kernel with: '''flasher -a main.bin -k zImage_2.6.32.54-ubiboot-02_301013 --flash-only=kernel -f -R'''

 
*If you are a Windows user, please now proceed to '''Step W - Install Sailfish (Windows only Users)'''. If you get a prompt asking you to format the newly mounted partition, '''DO NOT FORMAT THE PARTITION'''.

*If you are a Linux user: Leave the cable plugged in and allow Ubiboot to enter maintenance mode.

4 Removable Partitions will be visible in Computer. These are "'''rootfs'''" (Harmattan root filesystem, mmcblk0p2), "Alt_'''OS'''" (where nemo/sailfish lives, mmcblk0p4) "'''x767x676x7c6'''" (a random string of letters +/- numbers. This is where you can install Nitdroid and Firefox OS if you wish. It is also the "/home/" directory in Harmattan (mmcblk0p3)(but NOT "/home/user/MyDocs"). "'''Nokia N9'''" (mmcblk0p1) is "/home/user/MyDocs" directory on Harmattan [EMMC/USB Mass Storage Mode]). 

NB: If you format Alt_OS, it will get a random string of letters and numbers, like the "/home/" partition. Alt_OS is the 4.2GB partition. You can reset the disk label to "'''Alt_OS'''" by formatting it: '''df''' #Get the disk ID of the 4.2GB partition '''mkfs.ext4 /dev/sdXY -L "Alt_OS"''' # Where X and Y are your disk ID e.g. /dev/sdb2

*Go to "/media/Nokia N9" on your PC (Harmattan's Mass Storage). Make a directory called "'''boot'''".
**Copy "'''ubiboot.conf'''" and "'''ubiboot-02.menus.cpio'''" from the extracted '''ubiboot-02_310513.tar''' into "/media/Nokia N9"/boot".
**Go to "'''/media/rootfs'''" on your PC to access Harmattan's root file system. Go to the "'''boot'''" directory ("'''/media/rootfs/boot'''"). Copy "'''zImage_2.6.32.54-openmode_l2fix'''" (which was flashed earlier) into "'''/media/rootfs/boot'''".

*If you have boot issues, please consult for help in the [http://talk.maemo.org/showthread.php?t=89345 Ubiboot thread on talk.maemo.org] so the Sailfish thread remains for Sailfish issues!

==Step 7 - Install Sailfish==
*Now download the Sailfish image of choice, or compile your own using the Mer SDK. Rename it to '''sailfish.tar.bz2'''
*Extract the Sailfish archive to "'''/media/Alt_OS'''" on your PC with: 
'''tar --numeric-owner -xvjf sailfish.tar.bz2 -C /media/Alt_OS/'''

===Enable Root Access===

After the extraction has finished, this is a good time to enable root access in Sailfish and root login via SSH. This will allow you to remotely access your device after WLAN has been set up and avoid all the chrooting hassle! To reset root's password ([http://talk.maemo.org/showpost.php?p=1395095&postcount=678 MAX9's method]), enter the following into your PC terminal: 
'''nano /media/Alt_OS/etc/shadow''' # Open the shadow file where Alt_OS is mounted 

On the first line, you will have (where XXXXX are 5 numbers): 
'''root:34.random.letters.numbers.and.symbols:XXXXX:0:99999:7:::''' 

Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::''' 

For example, change: 
'''root:$1$00Z6Bfjc$vlIKUOMHIavIABL1gNuy6/:16049:0:99999:7:::''' 
into: 
'''root::16049:0:99999:7:::'''
 

Save and exit the file (CTRL+X, Y to save). 

Now, when you boot into Sailfish, '''you will not have a password for root'''. Depending on your SSH configuration, you will not be able to SSH into your handset until root has a password. 
To set a root password, open Terminal in Sailfish and enter: 
'''su''' 
'''passwd root''' 
'''nemo''' # Enter your password for root 
'''nemo''' # Repeat your password for root 

===Enable Root SSH Access===

This is also a good time to enable root SSH access. In your PC's root terminal, enter the following: 
'''nano /media/Alt_OS/etc/ssh/sshd_config''' 

Now, go to an empty line in the file and type in the following: 
'''PermitRootLogin yes''' 

Again, save and exit the file (CTRL+X, Y to save).

==Step W - Install Sailfish (Windows only Users)==

*Download Sailfish image of choice. Rename it to '''sailfish.tar.bz2'''
*In Harmattan, install Developer Mode if you haven't already. Connect the phone to Windows in "USB Mass Storage Mode ".
*Copy sailfish.tar.bz2' to the root of your MMC (X:\, where X is the letter of your removable drive).
*Disconnect the phone from the PC and remove the USB cable.
*Launch Terminal on Harmattan (or SSH in) any type the following commands: 
**'''devel-su''' 
**'''rootme''' # Or your root password 
**'''cd /home/user/MyDocs/''' 
**'''ls''' # Here, you should see all your MyDocs and sailfish.tar.bz2 

**'''mkdir /sailfish''' # Mount Alt_OS in Harmattan 
**'''mount /dev/mmcblk0p4 /sailfish''' 

**'''tar --numeric-owner -xvjf sailfish.tar.bz2 -C /sailfish/''' # This will take a while as it extracts Sailfish onto the handset 
**'''sync''' 

You can now exit Terminal and reboot into Sailfish or '''Enable root SSH access on Sailfish'''. 

'''To upgrade to a new image, simply delete everything in /media/Alt_OS ("'''rm -frv /media/Alt_OS/'''*") when on a Linux PC or "'''rm -frv /sailfish/'''*" when you have mounted Alt_OS in Harmattan. You will loose ALL your Sailfish data!''' To '''preserve user data''', '''delete everything in "Alt_OS"''' '''apart from "/home/nemo/"'''. In '''"/home/nemo/"''', '''delete''' the '''".cache"''' directory.

==Step 8 - Boot into Sailfish==

Disconnect your USB cable and turn off the handset completely. Turn it back on. If done correctly, this should present you Ubiboot boot-manager and 6 available operating system logos. Sailfish and Harmattan shall work.

If you do not select an OS, Harmattan will boot by default.

To boot into Sailfish, tap the Nemo icon (3rd one down on the left, looks like a blue padlock) and tap either "latest 2.6.32" or "vmlinuz-2.6.63.20120129.1-n950". For Harmattan, it is "openmode+l2 fix".

On your first boot, select your input and display languages. Next, select a theme colour. After going forward, you may have to go back and select your theme colour again and go forward again before the page that allows you to set the date and time appears.

You can then connect to the Internet if you wish to login or sign up for a Jolla account.

On Step 1 of the tutorial, you will be asked to do a edge left-right or edge right-left swipe to minimise the application. Due to an accelerometer bug, you have to swipe from the edge bottom upwards to minimise. You can then press and hold on the minimised Tutorial application view to close it.

To close an application, swipe from edge right to left.
To view Notifications, swipe edge left to right.
The phone cannot be turned off when the lock-screen is active.

=Bugs and Known Issues=
*No text correction engine therefore also no Pīnyīn to Hanzi conversion. Some users have managed to install jolla-xt9 from the repositories to fix this issue.
*No Android capability as of present.
*Camera does not work.
*Accelerometer does not work.

Full list on [https://github.com/romu70/sailfish-for-other/issues?state=open GitHub]

=Additional Guidance=

==Date/Time Fix==

The date/time may not set correctly in Sailfish. To fix this, boot into Harmattan and fire up terminal:

'''devel-su 
'''rootme''' # Or you root password 
'''date --set "2013-12-07 22:59"'''

===Enable Root Access (Windows Users)===

If you are using Windows or did not enable root access earlier, the following instruction will show you how. The procedure is the same as that which was explained previously in Step 7 but takes place in Harmattan as opposed to on a Linux computer.

Load Harmattan and open Terminal. Type the following: 
'''devel-su 
'''cd / 
'''mkdir sailfish 
'''mount /dev/mmcblk0p4 /sailfish 
'''nano /sailfish/etc/shadow''' # Open the shadow file where Sailfish is mounted 

On the first line, you will have (where XXXXX are 5 numbers): 
'''root:34.random.letters.numbers.and.symbols:XXXXX:0:99999:7:::''' 

Now, delete the all letters, numbers and symbols after "'''root:'''" and before ''':XXXXX:0:99999:7:::''' 

For example, change: 
'''root:$1$00Z6Bfjc$vlIKUOMHIavIABL1gNuy6/:16049:0:99999:7:::''' 
into: 
'''root::16049:0:99999:7:::'''
 

Save and exit the file (CTRL+X, Y to save). 

Now, when you boot into Sailfish, '''you will not have a password for root'''. 
To set a root password, open '''Terminal in Sailfish''' and enter: 
'''su''' 
'''passwd root''' 
'''nemo''' # Enter your password for root 
'''nemo''' # Repeat your password for root 

===Enable Root SSH Access===

This is also a good time to enable root SSH access. In Harmattan's terminal, enter the following: 
'''nano /sailfish/etc/ssh/sshd_config''' 

Now, go to an empty line in the file and type in the following: 
'''PermitRootLogin yes''' 

Again, save and exit the file (CTRL+X, Y to save).

==Chroot into Sailfish from Harmattan==

This is based on krnlyng's (liar) method. It is useful for access to Sailfish to run terminal commands such as updating the OS.

Open terminal in Harmattan and type: 
'''devel-su 
'''cd / 
'''mkdir sailfish 
'''mount /dev/mmcblk0p4 /sailfish 
'''mount -o bind /proc /sailfish/proc 
'''mount -o bind /sys /sailfish/sys 
'''mount -o bind /dev /sailfish/dev 
'''/usr/sbin/chroot /sailfish 

When you have finished in Sailfish, exit and unmount with the following commands: 

'''exit''' 

'''umount /sailfish/dev 
'''umount /sailfish/proc 
'''umount /sailfish/sys 
'''umount /sailfish''' 
'''exit''' # Exit out of devl-su 
'''exit''' # Exit out of Terminal

==Developer Mode frame rate issue==

When in developer mode, do not enable "Display Framerate". It causes random colour drawings on the screen, making it impossible to disable without SSH access. To fix (credits to [http://talk.maemo.org/member.php?u=66860 liar]), SSH into your handset and type: 
'''nano /home/nemo/.gconf/desktop/jolla/%gconf.xml''' 
 
Ensure that that there is nothing between the '''stringvalue''' option, as below: 
'''<stringvalue></stringvalue>''' 

Save and exit (CTRL + X, Y to save). Reboot the handset and it should display everything correctly again.

==Proximity sensor Fix==

To fix the proximity sensor (this must be done at every boot), in Sailfish terminal type: 
'''su 
'''nemo # Your root password 
'''echo 1 > /sys/devices/platform/i2c_omap.2/i2c-2/2-0039/prox_enable 

==Repository Replacement==

You cannot use the repositories provided by default in the Sailfish images. You must remove them and replace them with custom ones.

This is done by editing the /etc/ssu/ssu.ini file, without using "zypper ar".

[http://talk.maemo.org/showpost.php?p=1395790&postcount=772 This post] by csdozi has a working ssu.ini file attached.

This repository section is very important.

'''[repository-urls]''' 
aliendalvik=https://store-repository.jolla.com/releases/latest/aliendalvik/SbJ 
limited-nemo-mw=http://repo.merproject.org/obs/home:/vgrade:/branches:/nemo:/devel:/mw/latest_armv7hl/ 
nemoadaptation0=http://repo.merproject.org/obs/nemo:/devel:/hw:/ti:/omap3:/n9xx-common/latest_armv7hl/ 
nemoadaptation1=http://repo.merproject.org/obs/nemo:/devel:/hw:/ti:/omap3:/n950-n9/latest_armv7hl/ 
store=https://store-repository.jolla.com/SbJ/armv7hl/ 

Also, under '''[General]''' this line is important: 
disabled-repos=adaptation1, thirdparty, adaptation0

==Access Harmattan's MyDocs==

To access your EMMC (Harmattan's MyDocs, type the following into Sailfish's Terminal. Credit to [http://talk.maemo.org/showpost.php?p=1395593&postcount=729 max83]. 
'''mkdir /home/nemo/MyDocs''' 
'''chown -R nemo:nemo /home/nemo/MyDocs/''' 
'''chmod +w /home/nemo/MyDocs/''' 

'''nano /etc/fstab''' 
'''/dev/mmcblk0p1 /home/nemo/MyDocs vfat auto,users,rw,utf8,shortname=mixed,umask=000 0 0''' 
Now Save ('''CTRL+X''', '''Y''') and reboot Sailfish 
'''reboot''' 

You can also link your directories in Sailfish to those in Harmattan after rebooting by deleting the respective directory (and contents!) and using symbolic links to the corresponding Harmattan files e.g.: 
*For Documents: '''cd /home/nemo''' '''rm -frv ./Documents''' '''ln -s ./MyDocs/Documents ./Documents''' 

*For Downloads: '''cd /home/nemo''' '''rm -frv ./Downloads''' '''ln -s ./MyDocs/Downloads ./Downloads''' 

*For Music: '''cd /home/nemo''' '''rm -frv ./Music''' '''ln -s ./MyDocs/Music ./Music''' 

*For Images: '''cd /home/nemo/Pictures''' '''rm -frv ./*''' '''ln -s ../MyDocs/DCIM/ ./Camera''' '''ln -s ../MyDocs/Pictures/ ./Pictures''' If you want to include your Whatsup images in Jolla's Media application: '''ln -s ../MyDocs/Whatsup/images/ ./Whatsup.images'''

*For Videos: '''cd /home/nemo/Videos''' '''rm -frv ./*''' '''ln -s ../MyDocs/DCIM/ ./Camera''' '''ln -s ../MyDocs/Movies/ ./Movies''' '''ln -s ../MyDocs/Videos/ ./Videos''' If you want to include your Whatsup videos in Jolla's Media application: '''ln -s ../MyDocs/Whatsup/video/ ./Whatsup.video'''

There is an issue with Images and Videos not showing in the Gallery application following reboot. They show after symlink creation. This may be a permission/tracker issue.

==Battery charging==
=== bme workaround ===
right now the battery status / power management isn't handled by sailfish.
as workaround use:

systemctl start bme-rm-680-bin.service # starts it right now
bmestat # shows bat stat

the service has to be started after each reboot of Sailfish OS.

=== statefs Workaround (with GUI!) ===
Coderus has put together a statefs provider, which enables the SailfishOS battery level indicator.

The pull request has been merged into the master Nemo Mobile branch.
https://github.com/nemomobile/statefs-providers/pull/6

If your image uses an older Nemo image, you can use this [https://www.dropbox.com/s/bwznwtalao9v3cq/statefs-provider-bme-1.0.0-3.armv7hl.rpm RPM] that coderus has provided to fix the issue.

To install it, cd in the location you downloaded this file and run as root in xterm:

<pre>zypper install statefs-provider-bme-1.0.0-3.armv7hl.rpm</pre>

It will offer you two choices. Type 1 to uninstall the other packet and install this. You now have correct battery indicator thanks to Coderus:)

Ubiboot

2013-12-23T09:48:17Z

109.204.176.247: /* firefox_os instead of nitdroid */

== Introduction ==

[http://www.swagman.org/juice/ubiboot/ Ubiboot] is a boot manager for N9(50) devices. Using the example configuration it is fairly easy to hexa-boot the device between Harmattan/Nitdroid/Nemo/Firefox/Ubuntu/Sailfish Operating Systems, and change kernels at will.

Ubiboot is mainly aimed at developers and advanced users, so be warned. The procedures in this guide require understanding of the structure of an *nix filesystem and knowledge to work on a shell prompt (i.e. Terminal/Command Line).

== Benefits of Ubiboot N9 ==

# You can have multiple boot Operating Systems, each with multiple optional kernels on the device.
# Selecting the boot kernel is quick and easy with the graphical touchscreen menus.
# You will not need to flash the device to install and test a new kernel, just copying the kernel and modules to the device is enough.
# You have integrated repair/maintanance mode on the device, where you can export all partitions for backup/restore to a PC automatically.
# You can telnet and ssh to the device in maintanance mode, to do any desired repair operations. You can tranfer backup archives to / from the device via sftp

== Prerequisites ==

To ensure that most of your efforts are focused on actual Ubiboot installation/setting up of a Hex Boot system, please make sure to fulfill the following prerequisites:

=== Flash the device (for a fresh start/clean state) ===

{{ambox
|type=delete
|text=It is assumed that you have backed up your important files (messages, contacts, pictures, videos, music, etc.) before flashing the device.
}}

'''TIP''': The sequence of flashing commands below combines the usual flashing steps found in the [http://wiki.maemo.org/Flashing_N9 N9 Flashing Wiki], plus actual flashing of the Open-Mode Kernel so that upon first boot, the device will already be in "Open-Mode". This is called Back-to-Back Closedmode/Openmode flashing. If you follow this style of flashing the device, you will no longer need to delete some folders (.accounts/, ./aegis, and ./activesync) for the device to store passwords correctly. The additional benefits of the Back-to-Back flashing is that you get rid of a lot of unstability in the device caused by some parts still being accessed with closed-mode aegis keys.

'''TIP''': If you want to be rid of the "Scary Warranty Warning", which a device displays when booting in Open Mode you have to remove that '''Before entering open mode'''.

Flash your device with rootfs, omit the parameter "-R" (which means "reboot")

sudo flasher -F <yourmainfirmware.bin> -f

or

sudo flasher -F <yourmainfirmware.bin> -F <youremmc.bin> -f

or "Zeroize Method" of flashing, which "wipes" user data and EMMC. Note that this command flashes the eMMC twice and takes many hours to complete the process. You will see a notification/warning of eMMC "unnecessarily being flashed twice") in the Terminal when flashing via this method.

sudo flasher -f -F <yourmainfirmware.bin> --erase-user-data=secure -F <youremmc.bin> --erase-mmc=secure

Next, take care to directly flash the open mode kernel (do NOT boot up, nor pull USB cable, do not wait too long) with

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R

(All credits to [http://maemo.org/profile/view/rainisto jonni/rainisto])

--[[User:Peterleinchen|peterleinchen]] 16:27, 25 June 2013 (UTC)

==== When Not Starting From A Fresh Flash ====
# Open Terminal on the device.
# Type the following commands and press Enter after typing each command ('''NOTE:''' this will delete all configured Accounts):
disclaimer-cal remove View-openmode
rm -rf /home/user/.accounts/
rm -rf /home/user/.aegis/
rm -rf /home/user/.activesync/

Shut down the device, plug to a USB cable and to a computer, and proceed with flashing the Open-Mode kernel as mentioned above:

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-openmode_l2fix --flash-only=kernel -f -R

Upon first boot, you may set up your Accounts (email, social media accounts, i.e. Facebook etc.) once again.

'''REMINDERS:'''

# In MS Windows, just omit the word “sudo” from the command.
# In MS Windows, the “zImage_2.6.32.54-openmode_l2fix” file needs to be in the same location as the Flasher Application, FIASCO, and eMMC images. Usually you would have installed the Flasher Application to C:\Program Files\Nokia\Flasher.
# For Linux users, usual “best practice” is to save the FIASCO, eMMC, and whatever Kernels at the main directory (/home/yourusername).
# "Device Lock Request" should be disabled when you are using Open-Mode.

=== Download Needed Files ===

==== Ubiboot Files ====

Find the latest versions at http://www.swagman.org/juice/ubiboot/. Files are also mirrored at http://juiceme.cloud-7.de/ubiboot/

# '''[http://www.swagman.org/juice/ubiboot/other/preinits.tar preinits.tar]:''' this is a compressed file, like Zip (Windows users: use 7zip application). We will extract this later on once this is copied to the device.
# '''[http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix zImage_2.6.32.54-openmode_l2fix]:''' this is used for flashing your device to “Open-Mode” (Windows users: save this in the same location as your flasher application and files...usually C:\Program Files\Nokia\Flasher).
# '''[http://maemo.cloud-7.de/HARM/N9/1.3/openmode-kernel/zImage-2.6.32.54-dfl61-20121301 zImage-2.6.32.54-dfl61-20121301] from http://maemo.cloud-7.de/HARM/N9/1.3/openmode-kernel/:''' this is the “default” or “plain Open-Mode” kernel. Including this to your ubiboot-02 setup is optional.
# '''http://www.swagman.org/juice/ubiboot/ubiboot-02/ubiboot-02_0.3.5_301013.tar''' or '''http://juiceme.cloud-7.de/ubiboot/ubiboot-02/ubiboot-02_0.3.5_301013.tar''': this is the latest ubiboot archive (v.0.3.5) that contains the files needed for ubiboot. TAR file is a compressed file, like ZIP. After downloading, extract the contents of this file (Windows users: use 7zip application). This compressed file contains 3 files and a checksum file.
## '''ubiboot.conf''' this is the configuration file that contains all the changeable options and tunables for your boot, including the list of bootable OS'es and kernels. You need to copy this into MyDocs/boot/ directory of your device.
## '''ubiboot-02.menus.cpio''': this is the kernel extension file which contains the graphical menu system presented to user on boot. You need to copy this into MyDocs/boot/ directory of your device.
## '''zImage_2.6.32.54-ubiboot-02_301013''': This is the ubiboot kernel that you need to flash to your device. (Windows users: save this in the same location as your flasher application and files, usually C:\Program Files\Nokia\Flasher).

You should create the boot folder inside MyDocs before copying the ubiboot.conf and ubiboot-02.menus.cpio to the device.

==== NITDroid Files ====

Find the latest versions at http://downloads.nitdroid.com/e-yes/n9/

# '''[http://downloads.nitdroid.com/e-yes/n9/nitdroid_n9_jellybean_alpha5.tar.bz2 nitdroid_n9_jellybean_alpha5.tar.bz2]:''' latest “Jelly Bean” version available as of this writing.
# '''[http://downloads.nitdroid.com/e-yes/n9/apps2sd_fix_alpha5.tar.bz2 apps2sd_fix_alpha5.tar.bz2]:''' this fix allow apps to install into the SD Card.
# '''[http://downloads.nitdroid.com/e-yes/n9/ubiboot/zImage zImage]:''' ('''recommended''') this is the “new version” of zImage.pr13, which is tailored for use with ubiboot. '''IMPORTANT:''' Rename this to “zImage_e-yes_nitdroid+l2fix” (without the quotes).
# '''[http://downloads.nitdroid.com/e-yes/n9/zImage.pr13 zImage.pr13]:''' ('''not recommended''') before Ubiboot was published, this was the latest zImage being used for dual-booting or multi-booting NITDroid.

==== Nemo Files ====

Find the latest versions at http://releases.nemomobile.org/snapshots/images/

# '''[http://releases.nemomobile.org/releases/0.20130620.0.1/images/nemo-armv7hl-n950/nemo-armv7hl-n950-0.20130620.0.1.tar.bz2 nemo-armv7hl-n950-0.20130620.0.1.tar.bz2]:''' this contains the actual Nemo OS image as of this writing.
# '''[http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm]:''' this is the MOSLO file needed for flashing when installing Nemo. You may alternatively download this file via the "wget" Terminal Command in Linux, as outlined in the [https://wiki.merproject.org/wiki/Nemo/Installing#Single_Boot_by_Loading_The_Kernel_.28Not_recommended.29 official Nemo Wiki]:

wget -r -l1 -nd --no-parent -Amoslo-0.*.rpm http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/

==== FirefoxOS Files ====

Find the latest version at '''http://romaxa.info/b2g/b2g_n9_droid_hal_fs.tar.gz'''

==== SailfishOS Files ====

Find the latest versions at '''http://n9.araya.su/images/mic_images/'''

=== Using command lines ===

If you have no idea what are those lines, then skip this chapter and do using the GUI as explained later

you need to install wget (ie: from RzR shared repo)

sudo flasher-3.12 -a ${bin_file} -k "zImage_2.6.32.54-openmode_l2fix" --flash-only=kernel -f -R

ssh user@tel # devel-su # /sbin/halt

ssh user@tel

mkdir -p '/home/user/MyDocs/boot'
wget http://www.swagman.org/juice/ubiboot/ubiboot-02/ubiboot-02_040613.tar | tar xf -C '/home/user/MyDocs/boot' -

md5sum /home/user/MyDocs/boot/*
#5176490dc2184bb5869824c29b1be244 /home/user/MyDocs/boot/ubiboot-02.menus.cpio
#a1fcf98f77fbd38ef5ad456aee7cc235 /home/user/MyDocs/boot/ubiboot.conf

devel-su # gain root

cd /boot
wget -c http://www.swagman.org/juice/ubiboot/other/zImage_2.6.32.54-openmode_l2fix
wget -c http://maemo.cloud-7.de/HARM/N9/1.3/openmode-kernel/zImage-2.6.32.54-dfl61-20121301
wget -c http://www.swagman.org/juice/ubiboot/ubiboot-02/zImage_2.6.32.54-ubiboot-02_040613
wget -c http://downloads.nitdroid.com/e-yes/n9/ubiboot/zImage -O 'zImage_e-yes_nitdroid+l2fix'
wget -c http://downloads.nitdroid.com/e-yes/n9/zImage.pr13

md5sum /boot/* | sort
# 22114bd3cbaa88ee8c49c022f53080a1 /boot/zImage_e-yes_nitdroid+l2fix
# 35da7f3dc5218be835487d6ec6b9b71e /boot/zImage-2.6.32.54-dfl61-20121301
# 3f354a2b48a0b571ca32d6082391108a /boot/zImage.pr13
# a4d9c7ad4a7721b1aac3130d530644a4 /boot/zImage_2.6.32.54-ubiboot-02_040613
# b64bc24b96faf6763f5e403eb5c7f528 /boot/zImage_2.6.32.54-openmode_l2fix

wget -O- http://www.swagman.org/juice/ubiboot/other/preinits.tar | tar xfv - -C /
md5sum /sbin/preinit_harmattan /sbin/preinit_nitdroid
# 659af796bb8e33977abbfdabd92c11b0 /sbin/preinit_harmattan
# 2e28b1905ebdc3feb1062a4cb940e25c /sbin/preinit_nitdroid

# devel-su

mv /home/nitdroid /home/nitdroid.tmp
mkdir -p /home/nitdroid
wget -O- http://downloads.nitdroid.com/e-yes/n9/nitdroid_n9_jellybean_alpha5.tar.bz2 | tar xfj - -C /home/nitdroid
echo $?

wget -O- http://downloads.nitdroid.com/e-yes/n9/apps2sd_fix_alpha5.tar.bz2 | tar xfj - -C /home/nitdroid
echo $?

Later :

# http://releases.nemomobile.org/snapshots/images/0.20130411.1.NEMO.2013-04-26.1/nemo-armv7hl-n950/nemo-armv7hl-n950-0.20130411.1.NEMO.2013-04-26.1.tar.bz2
# wget -c http://releases.nemomobile.org/releases/0.20130620.0.1/images/nemo-armv7hl-n950/nemo-armv7hl-n950-0.20130620.0.1.tar.bz2
# wget -c http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm

== Prepare the Device ==

=== Enable Developer Mode and Installation of non-store sources ===
# Enable “Allow installations from non-store sources (Settings → Applications → Installations).
# Enable “Developer Mode” (Setitngs → Security → Developer mode)...your device will restart. Upon restart, you will now see Terminal being available for use.

=== Install and Prepare Filebox and Filebox Root ===
# Install Filebox from Nokia Store on your device.
# Install [http://wiki.maemo.org/N9QTweak N9 Quick Tweak]. Upon installation, run N9 Quick Tweak and enable “Root Filebox” (as of the latest version, this is under [http://wiki.maemo.org/N9QTweak#Tweak_H:_Enable_ROOT-SSH_Access_.26_Root_Filebox Tweak H].
# You should now have Filebox Root. Open Filebox Root and navigate to “MyDocs” (usually at first use of Filebox, you are already at “MyDocs”) and create a new folder called “boot” (without the quotes).
# In the “Settings” (the gear icon at the lower-right), enable the following:
#* Show root filesystem
#* Show hidden filesystem
#* Show thumbnails

=== Moving files using Filebox Root ===

This section guides you on where to move/copy the files that were downloaded in the [http://wiki.maemo.org/index.php?title=Ubiboot&action=submit#Download_Needed_Files Download Needed Files] section above.

Place/move/copy the following files inside the newly-created “boot” folder under “MyDocs”:

ubiboot.conf
ubiboot-02.menus.cpio

Next is to move the "zImage..." files.

# Go up three (3) levels by pressing the “up” arrow (found at the lower-left of Filebox Root) . You should be at the “root” folder (you can confirm this when you see that the blue banner at the top of Filebox Root shows only a forward-slash “/”).
# Find the “/boot” folder...we are looking for the "/boot" under root directory, '''not the “/home/user/MyDocs/boot” folder (i.e. that we created inside “MyDocs”)''' and go inside that folder.
# Paste the three (or four) "zImage..." files:

zImage_2.6.32.54-openmode_l2fix
zImage.pr13
zImage
zImage-2.6.32.54-dfl61-20121301 '''(Optional)'''

'''REVIEW/RECAP:''' These are the locations where the "needed files" are to be moved/pasted/located.

/home/user/MyDocs should contain:
preinits.tar
nitdroid_n9_jellybean_alpha5.tar.bz2
apps2sd_fix_alpha5.tar.bz2
b2g_n9_droid_hal_fs.tar.gz
/home/user/MyDocs/boot should contain:
ubiboot.conf
ubiboot-02.menus.cpio
/boot should contain:
zImage_2.6.32.54-openmode_l2fix
zImage.pr13
zImage (which by now, has been renamed to '''“zImage_e-yes_nitdroid+l2fix”''', without the quotes)
zImage-2.6.32.54-dfl61-20121301 '''(Optional)'''

=== Extract preinits.tar, the NITDroid and the FirefoxOS files ===

'''NOTE:''' Terminal should still be open at this point.

Type the following commands in the Terminal and press Enter after typing each command (NOTE: do not change the order of the commands):

devel-su '''(default password is "rootme", without quotes)'''
mkdir /home/nitdroid '''(creates the “nitdroid” directory under the /home directory)'''
cd /home/user/MyDocs '''(navigates to the directory where the NITDroid image is located)'''
tar -xvf preinits.tar -C / '''(extracts preinits to /sbin directory of the device)'''
tar xjvf nitdroid_n9_jellybean_alpha5.tar.bz2 -C /home/nitdroid '''(extracts the NITDroid image to /home/nitdroid)'''
tar xjvf apps2sd_fix_alpha5.tar.bz2 -C /home/nitdroid '''(extracts the Apps2SD fix to /home/nitdroid)'''
mkdir /home/firefox_os '''(creates the “firefox_os” directory under the /home directory)'''
tar xvzf b2g_n9_droid_hal_fs.tar.gz -C /home/firefox_os '''(extracts the FirefoxOS image to /home/firefox_os)'''

== Install Nemo Mobile OS ==

{{ambox|text=At this point, it is highly recommended that you are using a Linux-based Operating System (Ubuntu will work fine). It is still okay to continue using MS Windows, however in order to use the "maintenance mode" feature of Ubiboot, such as viewing the contents of partitions via a File Manager you will need to install a 3rd party application that allows you to view the contents of Linux-based Filesystems. '''Note that for installing Nemo, this guide focuses on using Linux to ensure conformity of a default, fool-proof procedure of a quadru-boot system with Harmattan, NITDroid, FirefoxOS, and Nemo.'''
}}

In Linux, enter the following commands as per the [https://wiki.merproject.org/wiki/Nemo/Installing#Single_Boot_by_Loading_The_Kernel_.28Not_recommended.29 Nemo Wiki Page]:

wget -r -l1 -nd --no-parent -Amoslo-0.*.rpm http://releases.nemomobile.org/snapshots/repos/hw/ti/omap3/n950-n9/latest/armv7hl/armv7hl/
rpm2cpio moslo-*.armv7hl.rpm | cpio -vidu
sudo flasher -k usr/share/moslo/zImage-moslo -n usr/share/moslo/initrd-moslo -l -b

Alternative: for the "wget" command above, you may download the MOSLO directly as I have mentioned in the “[http://wiki.maemo.org/Ubiboot#Nemo_Files Download Needed Files]” section above. Then you may proceed with the second and third commands.

'''MS Windows users:''' you can install 7-Zip and use that to go inside the '''moslo-0.0.13.2-1.5.Nemo.Adaptation.N9xx.armv7hl.rpm''' file. Keep going one directory deeper until you find two files:

* initrd-moslo
* zImage-moslo

Next, extract those files and place them in the same directory as the Flasher application. Once done, the command will be now modified as follows:

flasher.exe -k zImage-moslo -n initrd-moslo -l -b

[[Image:13060003.jpg|500px|]]

# The Terminal will give you a message that it is waiting for a suitable USB device. Make sure your device is turned off and plug it to your computer via the USB cable. The flashing procedure should finish in a few seconds.
# Keep the device plugged. What happens next is that the N9 is being repartitioned for Nemo (on the device, you will see some green text/writing on the screen; just wait for it to finish) , you'll see the led blinking for 10min or so.
# You will also notice that the File Manager of your Linux Distribution will open and will show a folder named “Alt_OS”. This is the newly-created partition.
# Next, we will extract the Nemo image into the newly-created partition. Enter this command in the Terminal (for Linux only):

sudo tar --numeric-owner -xf nemo-handset-armv7hl-n950-*.tar.bz2 -C /media/Alt_OS/

Now, unplug the device from the USB Cable. The screen should tell you to "push Volume Up" to boot into Harmattan, or "push Volume Down" to boot into Nemo.

'''TIPS:'''

# Sometimes, the name of the partition is Alt_OS_, with a single underline/underscores after “S” instead of the default Alt_OS (without underscore). Sometimes it has two (2) underlines/underscores. In my case, it had three (3) underlines/underscores.
# Sometimes, the path of the Alt_OS partition is /media/'''yourusername'''/Alt_OS.
# To be sure, before extracting the Nemo image, you may want to check the correct name by entering the Linux command of “lsblk” (without the quotes).
# As a matter of “best practice” it is recommended to have a File Manager open and navigating to "Alt_OS" during the extraction command to verify that the files are being extracted to the correct location.
# By experience, booting the device at this stage will result to either a reboot loop or the device not turning on at all. Sometimes, upon unplugging of the USB cable as mentioned above and selecting "Volume Down" to boot into Nemo, nothing happens (device is unresponsive and stays black). '''It is highly recommend not to turn on the device until you complete the setup/process from this point onward.'''

== Flash the Device with Ubiboot-02 ==

'''NOTE: for this step, the device should be turned off.'''

Flash the ubiboot-02 Kernel with the command below. Replace <yourmainfirmware.bin> with the filename of your N9 FIASCO image if you have renamed it differently.

sudo flasher -a <yourmainfirmware.bin> -k zImage_2.6.32.54-ubiboot-02_301013 --flash-only=kernel -f -R

Once the device reboots, keep the USB cable plugged in to enter “maintenance mode”. You will notice that the File Manager of your Linux Distribution will open and will mount/show all the partitions:

Nokia N9 '''(this is the “MyDocs” directory)'''
rootfs '''(this is the “/” directory or partition of the Nokia N9's Harmattan OS)'''
another partition with a long series of alpha-numeric '''(this is the /home/nitdroid directory/partition)'''
Alt_OS '''(this is the Nemo directory/partition)'''

Double-check that the files we have moved earlier are in their correct places. Once confirmed, you can "eject" all the partitions from your File Manager. Unplug the USB Cable and the device will restart. When it restarts, you should now see the Ubiboot menu.

'''Congratulations, you now have Ubiboot completely set up with a Triple-Boot configuration of Harmattan, NITDroid, and Nemo!'''

== Known Issues ==

This section attempts to document some user-reported issues and solutions with respect to Ubiboot usage, installation, etc.

=== Charging ===
Ubiboot handles rtc and usb events to boot up device from power off state:

a) to Ubiboot telnet console (when connected to PC USB), device will not be charged.

b) to configured default kernel (harmattan) to charge (when connected to wall charger).

c) to configured default kernel (harmattan) to trigger alarm.

"Case a" works flawlessly.

"Case b" sometimes does not work, but reboots and then starts up Ubiboot console/screen (not charging).

"Case c" needs some precondition. Make sure you have shutdown your device from Harmattan. Otherwise the alarm may not be triggered in NITDroid or will not be triggered in Nemo.

=== Alarm Clocks ===

http://talk.maemo.org/showpost.php?p=1355247&postcount=374
http://talk.maemo.org/showpost.php?p=1355278&postcount=377

The default behavior of the device, particularly with the default OS (Harmattan), is that clock alarms can be triggered even when the device is turned off. The posts above suggest that you need to ensure that the "last OS booted" should be Harmattan prior to turning the device off, because between Harmattan, NITDroid, and Nemo, the alarm clock system behavior of Harmattan is most stable. Based on the above posts linked, alarms of NITDroid and Nemo (when the device is turned off) don't behave as good as Harmattan does.

== References ==

# [http://talk.maemo.org/showthread.php?t=89345 Official thread at talk.maemo.org]
# [http://www.swagman.org/juice/ubiboot/ Official download site of Ubiboot]
# [http://downloads.nitdroid.com/e-yes/n9/ Official download site of NITDroid]
# [https://wiki.merproject.org/wiki/Nemo/Installing Official Wiki Page of Nemo]

== Tutorials ==

# [http://www.mediafire.com/folder/4zuayx3h8e6cy/ubiboot-02 PDF and Document]
# YouTube [http://www.youtube.com/playlist?list=PLcAjLdlFZWmC6UqdrIUz6Uqc3YtnCpqc2 (to follow/in progress)]

[[Category:N9]]
[[Category:HowTo]]
[[Category:Power users]]